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 <head> tag of the template)</li> <li><span>style.php</span> - creates the style link, linking to <span>stylecss.php</span></li> <li><span>canonical.php</span> - creates canonical link reference</li> </ul> </li> <li><span class="pretext">Product Displays:</span> These files create a list of products on non-catalog pages <ul> <li><span>featured.php</span> - creates a vertical list of the first five featured items (usually added to a side bar on the site)</li> <li><span>itemlist.php</span> - creates the item display needed for the /go/itemlist.php catalog display</li> </ul> </li> <li><span class="pretext">Category Navigation:</span> These files create a list of category links on the site <ul> <li><span>navbar_bar.php</span> - displays a list of the site's categories in a horizontal bar</li> <li><span>navbar_bullets.php</span> - displays a list of the site's categories in a vertical list with bullets</li> <li><span>navbar_buttons.php</span> - displays a list of the site's categories in a vertical button list</li> <li><span>navbar_horizontal.php</span> - displays a horizontal list of the site's categories</li> <li><span>navbar_list.php</span> - creates a bread crumb navigation showing the current category and its parents</li> <li><span>navbar_lists.php</span> - creates an unordered list of all categories and subcategories</li> <li><span>navbar_table.php</span> - creates a table displaying the site's categories</li> <li><span>navbar_tabs.php</span> - displays the site's categories in a tab format</li> <li><span>navbar_vertical.php</span> - creates a vertical list of category links (subcategories may or may not show, depending on the 'Text Nav Bar' setting in 'Catalog Setup')</li> </ul> </li> <li><span class="pretext">Page Navigation:</span> These files create a list of pages on the site. Note that you can utilize grouping to display only certain pages if desired. <ul> <li><span>pagelist_bar.php</span> - displays a list of the site's pages in a horizontal bar</li> <li><span>pagelist_bullets.php</span> - displays a list of the site's pages in a vertical list with bullets</li> <li><span>pagelist_buttons.php</span> - displays a list of the site's pages in a vertical button list</li> <li><span>pagelist_horizontal.php</span> - displays a horizontal list of the site's pages</li> <li><span>pagelist_lists.php</span> - creates an unordered list of all pages</li> <li><span>pagelist_table.php</span> - creates a table displaying the site's pages</li> <li><span>pagelist_tabs.php</span> - displays the site's pages in a tab format</li> <li><span>pagelist_vertical.php</span> - creates a vertical list of page links</li> <li><span>mobile.php</span> - creates the mobile navigation in version 2.84 and higher</li> </ul> </li> <li><span class="pretext">Page + Category Navigation:</span> 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. <ul> <li><span>pagenav_horizontal.php</span> - displays a horizontal list of site pages, with all the categories shown under the 'catalog' link</li> <li><span>pagenav_vertical.php</span> - displays a vertical list of site pages, with all the categories shown under the 'catalog' link</li> </ul> </li> <li><span class="pretext">Product Listings:</span> These files create the product listings in the catalog. <ul> <li><span>products_detail.php</span> - this file creates the main item screen (ie. yoursite.com/catalog.php?item=77)</li> <li><span>products_list.php</span> - this file creates a simple text list of products, with a 'more' button to view details</li> <li><span>products_maincat.php</span> - this file creates a list of product categories that displays a category name (and picture if one exists) in a three column format</li> <li><span>products_multiple.php</span> - 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)</li> <li><span>products_multisingle.php</span> - this file creates a list of items with all options and order buttons, in either two or three columns (no longer used)</li> <li><span>products_single.php</span> - this file creates a list of items with all options and order buttons, in one column</li> </ul> </li> <li><span class="pretext">Product Helper Pages:</span> These files create structures used in the above product listing pages. <ul> <li><span>products_options.php</span> - this creates the list of options (ie. colors, sizes, styles), displaying text boxes, drop down boxes, radio boxes, check boxes or memo fields</li> <li><span>products_pages.php</span> - this creates the page numbers on a product display page</li> <li><span>products_related.php</span> - this creates the list of related items for any given product</li> <li><span>products_variables.php</span> - this creates the variables which you can use in the product display pages - change catalog wording here</li> <li><span>social.php</span> - displays social media links in a product listing (newer versions)</li> </ul> </li> <li><span class="pretext">Registry Includes:</span> <ul> <li><span>registry_add.php</span> - this file adds a new item to the registry when the registry button under an item is clicked</li> <li><span>registry_cookie.php</span> - this file creates the cookie needed to log the registrant</li> <li><span>registry_delete.php</span> - this file deletes an item from the registry</li> <li><span>registry_forgot.php</span> - this file creates the 'forgot password' functionality for the registry</li> <li><span>registry_link.php</span> - this file creates a simple link that public registrants can use to share with family or friends (no longer used)</li> <li><span>registry_login.php</span> - this file creates the login screen to sign in to the registry</li> <li><span>registry_register.php</span> - this file creates the registration screen to create a new registry</li> <li><span>registry_results.php</span> - this file displays the registrant's account details</li> <li><span>registry_search.php</span> - this file creates the registry search box</li> <li><span>registry_showlist.php</span> - this file creates the list of items in someone's registry</li> <li><span>registry_update.php</span> - this file updates an item in the registry</li> </ul> </li> </ul> </li> <li><b>The /go/ Folder:</b> This folder contains the action pages for the shopping cart. <ul> <li><span class="pretext">Cart Processes:</span> These files handle the processing of the shopping cart pieces <ul> <li><span>finish.php</span> - 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)</li> <li><span>iframe.php</span> - 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)</li> <li><span>order.php</span> - this file processes input after a customer clicks the order button, and sends information to the Mals cart</li> <li><span>return.php</span> - this file calls the finish.php page immediately after an order is placed (it is optional) - it may be renamed for security reasons</li> <li><span>tempinv_file.php</span> - renaming this to tempinv.php allows a customer to better control inventory for stores that need stricter count checks (see instructions for more details)</li> <li><span>itemdetail.php</span> - used in 2.9x to create a large image for the optional zoom</li> </ul> </li> <li><span class="pretext">Page Processes:</span> These files address different functions within the site pages <ul> <li><span>email.php</span> - this creates the email a friend processes</li> <li><span>itemlist.php</span> - this creates a list of items in a catalog link format (ie. go to http://yoursite.com/go/itemlist.php)</li> <li><span>popup.php</span> - this creates the "Pop Up Page" pop up screen when a Pop Up Page link is clicked</li> <li><span>view.php</span> - this creates a large image view if a smaller image is clicked in the single, double or triple product layouts</li> <li><span>html5shiv.min.js</span> - script to allow older IE versions to use HTML 5</li> </ul> </li> </ul> </li> </ul></div> </div><!-- START FOOTER --> </div> </main> <div class="container"> <ul class="faqnumbers pagination justify-content-center"> <li class="page-item pg_first"> <a class="page-link" href="index.php?f=7&c=8" aria-label="First"> <i class="fa fa-lg fa-angle-double-left" aria-hidden="true"></i> <span class="sr-only">First</span> </a> </li> <li class="page-item pg_previous"> <a class="page-link" href="index.php?f=8&c=8" aria-label="Previous"> <i class="fa fa-lg fa-angle-left" aria-hidden="true"></i> <span class="sr-only">Previous</span> </a> </li> <li class="page-item"><a class="page-link" href="index.php?f=7&c=8">1</a></li> <li class="page-item"><a class="page-link" href="index.php?f=8&c=8">2</a></li> <li class="page-item active"><a class="page-link" href="index.php?f=91&c=8">3</a></li> <li class="page-item"><a class="page-link" href="index.php?f=229&c=8">4</a></li> <li class="page-item"><a class="page-link" href="index.php?f=387&c=8">5</a></li> <li class="page-item pg_next"> <a class="page-link" href="index.php?f=229&c=8" aria-label="Next"> <i class="fa fa-lg fa-angle-right" aria-hidden="true"></i> <span class="sr-only">Next</span> </a> </li> <li class="page-item pg_last"> <a class="page-link" href="index.php?f=90&c=8" aria-label="Last"> <i class="fa fa-lg fa-angle-double-right" aria-hidden="true"></i> <span class="sr-only">Last</span> </a> </li> </ul> </div> <div class="footpad"></div> <footer class="container-fluid"> <div class="container">We use cookies to enhance your web site experience. By using this site, you agree to our use of cookies. Please view our <a href="https://keys.pappashop.com/privacy.php">privacy policy</a> for details.<br />© 2018. All rights reserved.</div> </footer> <i id="scrolltop" class="fa fa-chevron-up"></i> <link rel="stylesheet" href="https://keys.pappashop.com/assets/font-awesome/css/font-awesome.min.css"> <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/css/bootstrap.min.css" integrity="sha384-Gn5384xqQ1aoWXA+058RXPxPg6fy4IWvTNh0E263XmFcJlSAwiGgFAW/dAiS6JXm" crossorigin="anonymous"> <script src="https://keys.pappashop.com/assets/tinycolor.js"></script> <script src="https://keys.pappashop.com/assets/jscolor/jscolor.js"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.12.9/umd/popper.min.js" integrity="sha384-ApNbgh9B+Y1QKtv3Rn7W3mgPxhU9K/ScQsAP7hUibX39j7fakFPskvXusvfa0b4Q" crossorigin="anonymous"></script> <script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/js/bootstrap.min.js" integrity="sha384-JZR6Spejh4U02d8jOt6vLEHfe/JQGiRRSQQxSfFWpi1MquVdAyjUar5+76PVCmYl" crossorigin="anonymous"></script> <!-- END FOOTER --> </body> </html>