To menu

Something about modules and work with them


Basic informations

We have two module sets. They has difference in path and usage. Presentation modules normally only show information from server. Administration also update them. Whole system basically depends on files, so you can backup it on flash disc or restart anywhere else. There is no problem with creation new module with new functions, only "dumbly" add them into system.

Presentation modules are divided by level for which returns output. User can use a few of them directly by adding call into page. Most of presentation modules are shown in my administrated projects.

Administration modules are divided by administration class (or some group). So user cannot use some of them.

Next important thing is "pairing". That means every module look for dir or other context depends on current file path. In real life it shows as not only file "desc.htm" in dir, but also file "desc.htm.mkd" and directory "desc/". That means user uses Markdown editor for updating page content and he has some files to add into page.

Administration modules

In normal style are administration modules in upper left corner and system modules and logout in upper right. Forget about "Back" button in browser, especially if you edit something (like login form :) ). Browser tabs are better choice.

If is not possible to load module it doesn't appear and rests calling line (in administration it's creator's fail or low authorization, in pages can appears the error).

Callable presentation modules

Modules for presentation are loaded as

{MODUL}
{MODUL}param=val{/MODUL}
{MODUL}param1=val1&m2=val2...{/MODUL}

. If module doesn't know the parameter or it contains wrong value, it normally ignore them and use default value.

In description of each module they're disabled with dash after first composed brace.

Modules for presentation

SHORTM
Show short messages. No parameters.

IFRAME
Include frame with external pages. Usually for guest books and galleries outside manager. Parameter is "link" with URL to outside page.

LANGS
If you have content in more than one language, this module split them. He has only parameters "vsize" and "hsize" for set size of language flags. Outside index has no sense.

DIRLIST
Directory reading. It shows on pages file listing. He has five parameters; "row" and "col" for count lines and columns per page (and makes paging), "style" - list, icon and compact (other options may return unexpected results), "path" with target dir in tree and "ext" as extension selection (ex. packages here). From address bar goes next - "s" -, for count page for begin read.

GALLERY
Image gallery. Add images into page. The parameters are same as for Dirlist. Needs module IMAGE for display them as large.

THUMB
Single thumbnails. Add single thumbnail into page with link into large one. The parameters are two - path (to image) and more (extra description). Needs module IMAGE for display them as large.

IMAGE
Show one image. It can be displayed as page or in new window. The parameters goes from address bar. It's recommended to call it with anything else.

PEDIGREE
Shows pedigree. It can be displayed as page or in new window. The parameters goes from address bar. It needs set database. Now private.

FVIDEO
Shows video gallery with player. The parameters are same as for Dirlist.

RSS
Show RSS feed from short messages. By it's principle it needs show only self and no other content. It returns as link in page or complete feed.

Modules for administration

TEXTS - texts
Text editor for direct updating page content. Here also you add modules into pages.

FILES - and dirs
Work with files and directories. Now depends on action and objects (atypically). For faster moving I recommend use browser tabs and upper menu bar. Tree expands with every single file and dir, so it's really good idea have some system.

IMAGES - pictures
Basic operations with pictures such as upload, move, title and remove.

TREE - menu
Manage menu. You can change name, description, position and visibility of files in current dir.

SHORT - messages
Short messages. You can manage messages in current dir. It cannot be swapped since it's ordered by time of add.

UPLOAD - uploading
Large files. With drag-drop onto green area in it you can upload large files into current dir.

PEDIGREE - pedigree
Work and manage Pedigree. Now private.

Programmer view

Every module is own class with head. It's added by pre-defined style into modules tree. It can use basic functions from part's core and other modules. The connection depends on part - if ti is presentation one or administration one.

kwcms{mailchar}kalanys.com