File Structure
The following guide explains the include file structure, to better help those resellers who wish to modify their systems.
- The /enc/ Folder: This folder contains all the main includes for the front end pages.
- General Page Includes: These files correspond to the main level pages. For instance, if you go to http://yourwebsite.com/articles.php, that page will call the articles.php page in the /enc/ folder.
- affiliates.php - creates the content for http://yoursite.com/affiliates.php
- articles.php - creates the content for http://yoursite.com/articles.php
- catalog.php - creates the content for http://yoursite.com/catalog.php
- certificates.php - creates the content for http://yoursite.com/certificates.php
- contact.php - creates the content for http://yoursite.com/contact.php
- error.php - creates the content for http://yoursite.com/error.php
- events.php - creates the content for http://yoursite.com/events.php
- faqs.php - creates the content for http://yoursite.com/faqs.php
- guestbook.php - creates the content for http://yoursite.com/guestbook.php
- index.php - creates the content for http://yoursite.com/index.php
- orders.php - creates the content for http://yoursite.com/orders.php
- registry.php - creates the content for http://yoursite.com/registry.php
- search.php - creates the content for http://yoursite.com/search.php
- sitemap.php - creates the content for http://yoursite.com/sitemap.php
- sitesearch.php - creates the content for http://yoursite.com/sitesearch.php
- weblinks.php - creates the content for http://yoursite.com/weblinks.php
- wholesale.php - creates the content for http://yoursite.com/wholesale.php
- Search Includes: These files create a search box of some kind on the site
- categories.php - drop down list of categories
- catnum.php - drop down list of catalog numbers
- coupon.php - coupon search box
- price.php - price range selector box
- search_catalog.php - search box to locate products with a certain keyword
- search_site.php - search box to locate pages, categories, products, articles and/or faqs with a certain keyword
- Cart Links: These files create links that take the customer to the Mals shopping cart
- viewcart.php - link only
- viewcontents.php - link plus quantity/totals if general window shopping cart is used
- Site Logo: These are used to display the site's logo (storeadmin -> Images -> Update under 'Catalog Images' -> Logo)
- logo.php - shows the logo if it exists
- sitelogo.php - shows the logo if it exists; otherwise, shows the site name
- Content Includes: These files show content pieces
- content.php - creates the main content that displays the page 'Description' field
- copyright.php - creates the site's copyright notice
- description.php - creates a category description (only if a category is selected)
- email.php - creates the 'Email a Friend' link on non-catalog pages
- sitemessage.php - shows the 'Site Message' in the 'Site Settings' of the storeadmin
- sitename.php - displays the name of the site (can be used anywhere)
- title.php - displays the page title (Item Name for products, Category Name for categories, Page Name for pages)
- Internal Files: These files are used internally and are only modified if functionality needs to be adjusted
- formaccept.php - creates the internal checks needed for the contact, guestbook and wholesale forms
- openinfo.php - opens the database connection and creates system variables
- Header Includes: These files are displayed within the HTML header
- meta.php - creates the meta keywords and description (place within the tag of the template)
- metatitle.php - creates the meta title of the site (place in the
tag within the tag of the template) - style.php - creates the style link, linking to stylecss.php
- canonical.php - creates canonical link reference
- Product Displays: These files create a list of products on non-catalog pages
- featured.php - creates a vertical list of the first five featured items (usually added to a side bar on the site)
- itemlist.php - creates the item display needed for the /go/itemlist.php catalog display
- Category Navigation: These files create a list of category links on the site
- navbar_bar.php - displays a list of the site's categories in a horizontal bar
- navbar_bullets.php - displays a list of the site's categories in a vertical list with bullets
- navbar_buttons.php - displays a list of the site's categories in a vertical button list
- navbar_horizontal.php - displays a horizontal list of the site's categories
- navbar_list.php - creates a bread crumb navigation showing the current category and its parents
- navbar_lists.php - creates an unordered list of all categories and subcategories
- navbar_table.php - creates a table displaying the site's categories
- navbar_tabs.php - displays the site's categories in a tab format
- navbar_vertical.php - creates a vertical list of category links (subcategories may or may not show, depending on the 'Text Nav Bar' setting in 'Catalog Setup')
- Page Navigation: These files create a list of pages on the site. Note that you can utilize grouping to display only certain pages if desired.
- pagelist_bar.php - displays a list of the site's pages in a horizontal bar
- pagelist_bullets.php - displays a list of the site's pages in a vertical list with bullets
- pagelist_buttons.php - displays a list of the site's pages in a vertical button list
- pagelist_horizontal.php - displays a horizontal list of the site's pages
- pagelist_lists.php - creates an unordered list of all pages
- pagelist_table.php - creates a table displaying the site's pages
- pagelist_tabs.php - displays the site's pages in a tab format
- pagelist_vertical.php - creates a vertical list of page links
- mobile.php - creates the mobile navigation in version 2.84 and higher
- Page + Category Navigation: These combo files show the pages on the site as it does in the Page Navigation includes. When the catalog page appears, it also includes a list of all the site's categories as in the Category Navigation.
- pagenav_horizontal.php - displays a horizontal list of site pages, with all the categories shown under the 'catalog' link
- pagenav_vertical.php - displays a vertical list of site pages, with all the categories shown under the 'catalog' link
- Product Listings: These files create the product listings in the catalog.
- products_detail.php - this file creates the main item screen (ie. yoursite.com/catalog.php?item=77)
- products_list.php - this file creates a simple text list of products, with a 'more' button to view details
- products_maincat.php - this file creates a list of product categories that displays a category name (and picture if one exists) in a three column format
- products_multiple.php - this file creates a list of items that displays the product name (and picture if one exists) and price, with the number of categories shown determined by the 'Layout Style' and 'Item Rows' - clicking the link takes you to the detail page (calling products_detail.php)
- products_multisingle.php - this file creates a list of items with all options and order buttons, in either two or three columns (no longer used)
- products_single.php - this file creates a list of items with all options and order buttons, in one column
- Product Helper Pages: These files create structures used in the above product listing pages.
- products_options.php - this creates the list of options (ie. colors, sizes, styles), displaying text boxes, drop down boxes, radio boxes, check boxes or memo fields
- products_pages.php - this creates the page numbers on a product display page
- products_related.php - this creates the list of related items for any given product
- products_variables.php - this creates the variables which you can use in the product display pages - change catalog wording here
- social.php - displays social media links in a product listing (newer versions)
- Registry Includes:
- registry_add.php - this file adds a new item to the registry when the registry button under an item is clicked
- registry_cookie.php - this file creates the cookie needed to log the registrant
- registry_delete.php - this file deletes an item from the registry
- registry_forgot.php - this file creates the 'forgot password' functionality for the registry
- registry_link.php - this file creates a simple link that public registrants can use to share with family or friends (no longer used)
- registry_login.php - this file creates the login screen to sign in to the registry
- registry_register.php - this file creates the registration screen to create a new registry
- registry_results.php - this file displays the registrant's account details
- registry_search.php - this file creates the registry search box
- registry_showlist.php - this file creates the list of items in someone's registry
- registry_update.php - this file updates an item in the registry
- General Page Includes: These files correspond to the main level pages. For instance, if you go to http://yourwebsite.com/articles.php, that page will call the articles.php page in the /enc/ folder.
- The /go/ Folder: This folder contains the action pages for the shopping cart.
- Cart Processes: These files handle the processing of the shopping cart pieces
- finish.php - this file is used in the Remote Call area of Mals, to add orders and decrement inventory counts after an order is placed - it may be renamed for security reasons (also rename the reference in the return.php file if it is used)
- iframe.php - this file creates the internal frame used to add the shopping cart to the site if the iframe method is selected (Catalog Setup -< Order Process -< Inline Frame)
- order.php - this file processes input after a customer clicks the order button, and sends information to the Mals cart
- return.php - this file calls the finish.php page immediately after an order is placed (it is optional) - it may be renamed for security reasons
- tempinv_file.php - renaming this to tempinv.php allows a customer to better control inventory for stores that need stricter count checks (see instructions for more details)
- itemdetail.php - used in 2.9x to create a large image for the optional zoom
- Page Processes: These files address different functions within the site pages
- email.php - this creates the email a friend processes
- itemlist.php - this creates a list of items in a catalog link format (ie. go to http://yoursite.com/go/itemlist.php)
- popup.php - this creates the "Pop Up Page" pop up screen when a Pop Up Page link is clicked
- view.php - this creates a large image view if a smaller image is clicked in the single, double or triple product layouts
- html5shiv.min.js - script to allow older IE versions to use HTML 5
- Cart Processes: These files handle the processing of the shopping cart pieces