+In-Portal is object-oriented php framework, that allows to build websites quick and easy way. Framework has modular structure and allows for new features to be added to if via new modules. In standard package In-Portal aready contains 3 live modules - In-Link, In-News, In-Bulletin and one sample module "Custom".
+
+
+1. Purpose of Custom
+====================
+"Custom" module is sample In-Portal module, that can be used to create your own modules. This module contains of samples of most basic and widely used features of In-Portal. Despite that given sample code seems to very simple, though it provides quick and effective way to unlock most powerful In-Portal customization abilities.
+
+2. Content of folders
+=====================
+Each module has same folder structure as other modules, that allows quick access to each aspect of it's functionality. Top folder is module name in lowecase and it is "custom" for "Custom" module, "in-link" for "In-Link" module and so on. Then there are 3 main folders: "admin_templates" - templates and resources (images, javascript, etc.), that given module uses only in administrative console; "units" - business logic, that given module will provide on both front-end and administrative console and "install" folder, that contains files, used to install given module into existing In-Portal installation.
+
+2.1. About "admin_templates" folder.
+This folder contains one sub-folder for each item in administrative console's main menu (in left frame). Each such folder will only contain templates ("*.tpl" files) used for displaying given main menu item in administrative console. Besides that there are one special purpose folder called "img". This folder contains all kind of images divided by categories. Images from each category are located in special sub-folder associated with given image category. There are three main folders - "icons" (images, that will be shown on the left from main menu item titles; one image per one menu item; one image could be used for multiple menu items); "itemicons" (images, that will be shown on the left from each row in grid, when grid, driven from given menu item will be shown); "toolbar" (images, that are used to draw buttons on toolbar on only module template, that uses toolbar based interface). It is possible to create any number of other folders and place images inside them or in the "img" folder itself. It is also common to create "js" sub-folder and place all javascript scripts related to administrative console in it.
+
+2.2. About "units" folder.
+This folder can contain unlimited number of folders. Each folder will contain "*.php" files used to create business logic part of given module. Usually there are three files - unit config file (main file, that allow to integrate given unit into system) and can't be absent; event handler file (all code, that will manipulate with data is located here); tag processor file (all code, that is used to output data to user in any requested form is located here). There is not permitted to create files in "units" folder itself, only sub-directories. Although it is not prohibited to place group of unit folders into other folders under "units" folder to logically divide them into groups.
+
+2.3. About "install" folder.
+This folder contains files used to add phrases, email events and to apply database changes (e.g. new tables) associated with given module. There are also "upgrades.sql" (required) and "upgades.php" (not required), that allow to maintain module version based database structure control, e.g. allows to upgrade database structure associated with given module depending on module version.
+
+3. Basic mechanisms / usage
+===========================
+Administrative console consists of 3 parts (top, left, right). Top part contains website logo, logout link and some other things. Left part contains main administrative console's menu used to control all it's functionality. When menu item is clicked, then template associated with given menu item is shown in right part of administrative console.
+
+3.1 Adding menu item
+====================
+Left part of administrative console contains menu, that have various menu items in it. Menu items are added using configuration files of units. Each unit can add unlimited number of menu items at any place inside main menu. New menu items are added using "Sections" option in configuration file as follows: