The template consists of two parts: HTM and PHP. Both versions are packed into one archive, PHP version is located in /www folder, HTM version is in /www/htm folder. The internal structure of these versions is identical, but with several differences in HTM version:
.php files in root folder are changed to .htm.{product name|category name}.htm. These files have input parameters that are passed to the engine, for example : $_GET['product']= 'viagra';..php in /lang folder and its' subfolders are changed to.htm.
Further in this article when we mention files with .php extension in root folder, it shall be assumed that for HTM version these files would have .htm extension.
Files in the root folder (e.g. /about.php) are main engine wrappers. Their main functionality consists of:
$PAGE_ID='about', and, in some cases, other parameters are set./header.php is included. This file outputs the header of the page and list of product categories./footer.php is included. This file outputs the right menu and the footer of all pages.
The engine core is stored in /.htclasses folder. During initialization a global $Page object is created. This object is a Page class instance and enables most of the methods that output the contents of the page. Page class is a descendant of CommonPage, BasePage and LocalCache classes. List of main output methods:
Page::draw_head_meta() – outputs DOCTYPE tags, head (including content-type, stylesheet, shortcut icon, keywords, description и script).Page::menu() - accepts identificator and returns html related to the menu , for example: print $Page->menu('top');.Page::draw_lang_switch() – outputs language switch panel. List of languages is stored in /aff_camp.php.Page::cart_summary() – returns html with information about customers' cartPage::link_cart() – returns html with link to cart pagePage::draw_categories_menu() – outputs menu with category listPage::draw_subtitle() – outputs subtitle of current pagePage::draw_filetext() – outputs html pages with selected identificatorPage::draw_product_list() – outputs html with product list for selected category or search resultsPage::draw_product_page() - outputs html pages of selected productPage::title() - returns site title
Text for each page are stored in /lang/{lang}/{page_id}.html folders. For example, text for about.php page in English version is stored in /lang/en/about.html file.
Description of categories and products are stored in /lang/{lang}/descr/[{description_type|category}-]{product_name|category_name}.html files. There are three types of product descriptions:
short - the shortest description, consists of 1 or 2 scentences. It is shown at the page with product list. pre - short description, shown at the top of product page.
During generaton of file name spaces in product and category names are replaced with -symbol, ' symbols are replaced with ___, capital letters are changed into lower case. For example, short description for Viagra Soft product in English version is stored in /lang/en/descr/pre-viagra-soft.html file. File names for full product descriptions are generated without type prefix. So, full description for Viagra Soft in English version is stored in /lang/en/descr/viagra-soft.html file. File names for category description are generated with category prefix. For example, description of Mens's Health category is stored in /lang/en/descr/category-men___s-health.htmlfile.
Default description and keywords of the site are stored in /description.txt and /keywords.txt files accordingly.
/www folder into root folder of the site. /htm folder should not be copied./www/htm folder into root folder of the site. /.htcache/ folder and it's subfolders and files are writable for web-server.AllowOverride All should be enabled for the folder, into which the template is instaled.
General settings are stored in /aff_camp.php. /aff_camp.php variables:
$CURRENT_LANG - default site language$TITLE - site title$SELECTED_OPTIONS - enable/disable Bookmark this site link (BOOKMARKUS), Affiliate Program link (JOINUS), Subscribe for News link (SUBSCRIBE), Free Shipping (AIRMAIL_FREE_SHIPPING) and type of currency for languages en-us (USA_EUROS).$LANG_AVAIL - array of available languages (possible values: en, en-us,es,pt,de,fr,jp,it.
JAX admin area allows to edit title, description and keywords for each page and product descriptions. Use the following link to enter the admin area: http//{your_domain}/admin.php?password={your_password}.
The password to admin area is set during template compilation (before downloading) or automatic setup to free hosting. It is the same as password as the one for FTP account of free hosting (we are working to add the “set password” feature to template master in the nearest future). Password is stored in /.htcache/.httitles file as __password of serialized array. It is not recommended to edit the password via this file if you don't have a sound knowledge of data serializaton in PHP. For security resons JAX will display a 404 error if incorrect password ws entered.
After successfull login the upper left corner of the page will show a set of edit links. Product descriptions will also have a edit this text lik next to them. Click on any edit link to open the editor popup window. Click on exit editmode to leave the interface.
All changes made in admin area are saved in /.htcache folder. Default data is not deleted but it will not be used if custom data is available.
These parameters are edited separately for each page. To start editing please click on the required link at the top of the page (edit page title, edit page keywords or edit page description).
Page title for English verion is stored in /.htcache/.httitles , or /.htcache/lang/{lang}/.httitles for other languages, as serialized array element (spaces in names are replaced by + symbol), page keywords and page description - in /.htcache/lang/{lang}/{keywords|description}-{page_id}[-{product_name}].html files (spaces are replaced by - symbol). Accordingly, product page title for Viagra Soft in English version is stored in /.htcache/.httitles in product-cialis+soft element, keywords for faq.php page in German version are stored in /.htcache/lang/de/keywords-faq.html file, description for Anti Bacterial category page in English version - in /.htcache/lang/en/description-category-anti-bacterial.html file.
Default data is not deleted but it will not be used if custom data is available. To reset the date click on reset to default button or delete the required file or array element manually.
To edit descrioptions click on edit this text next to the text that you wish to modify. Product descriptions are stored in /.htcache: /.htcache/lang/{lang}/descr/[{description_type}-]{product_name}.html.
At present category descriptions cannot be edited.