Location: PHPKode > scripts > E-Store Kit-1 Pro (PHP/MySQL) PayPal Edition > e-store-kit-1-pro-phpmysql-paypal-edition/manual/manual.htm
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>E-store Kit navigation bar.</title><link href="1.css" type="text/css" rel="stylesheet">
<SCRIPT language="JavaScript" TYPE="text/javascript" src="1.js"></SCRIPT></head>
<body topmargin="0" leftmargin="0" text="#C0C0C0" bgcolor="#FFFFFF"><a name="#7"></a>
<div align="center">
  <center>
<table border="1" cellpadding="0" cellspacing="1" style="border-collapse: collapse" bordercolor="#111111" width="620" id="AutoNumber1">
<tr>
<td width="100%" bgcolor="#DEE9F5">
<h3 align="center">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;E-store Kit-1 Pro Manual</h3>
<blockquote>
<b>Content</b>
<ul>
<li><a href="#1">Installation</a></li>
<li><a href="#2">Customizing  Catalog Pages</a></li>
<li><a href="#3">Customizing Catalog Main Page</a></li>
<li><a href="#4">Customizing Menu</a></li>
<li><a href="#5">Customizing View Details Page</a></li>
<li><a href="#9">Customizing Download Page</a></li>
<li><a href="#6">Files Map</a></li>
<li><a href="#8">Tips</a></li>
</ul>
<hr noshade color="#808080" size="1">
<br>
<a name="#1">Installation</a>
<br>
<br>
Server Requirements:
<ul>
<li>PHP/MySQL support.</li>
<li>One MySQL database installed.</li>
<li>Zend Optimizer version 2.1.0 or later installed (get <a href="http://magicscripts.com/getfree.php?pid=zotest">free script</a> to check you server).
</li>
</ul>
We recommend <a href="http://www.yourmagichost.com/">www.YourMagicHost.com</a><br>
<br>
Installation Steps:
<ol>
<li>Unzip archive on your hard drive (You'll get <i>catalog</i> folder containing all necessary files).</li>
<li>Upload <i>catalog</i> folder to your site's root directory using any FTP client.</li>
<li>Set read/write/execute permissions to <i>catalog/productimages</i>, <i>catalog/productthumbnails</i> directories and <i>ek1pvars.php</i> file (Chmod&nbsp;777) using FTP client.<br>
<u>Note</u>: If you do not have privileges to assign appropriate permissions to your files, 
you should ask server administrator of your web-host provider to do it for you.</li>
<li>Run <b>catalog/install.php</b> to configure your MySQL database.<br>
You will be asked to enter host name or IP address of MySQL server, username , password and database name.<br>
Ask your host provider about this information if you don't have it.<br>
<b>Important:</b><br>
<i>Delete <b>catalog/install.php</b> and <b>catalog/uninstall.php</b> after installation.</i></li>
<li>Open admin page (catalog/adm/index.htm) and make all necessary settings according to you preferences.<br>
<br>
Default Control Panel password: <i>admin</i><br>
<ul>
<li>Change this password A.S.A.P. and keep it in a safe place!
<li>Enter your PayPal settings.<br>
- e-mail<br>
- return URL<br>
- cancel return URL<br>
<li>Create categories and subcategories of your Catalog.
<li>Create Product Option Setfor your products.
<li>Enter your products data into the Catalog database.
</ul>
</ol>
<a href="../help/help.htm">Control Panel Help</a> contains detailed instructions on how to manage your web-store.<br>
<br>
Now you are ready to call your Catalog from anywhere on your site:<br>
&lt;a href=&quot;/catalog/catalog.php&quot;&gt;Our Products&lt;/a&gt;
<a href="#7"><img border="0" src="back.jpg" align="right" width="82" height="14"></a><hr noshade color="#808080" size="1">
<br><a name="#2">Customizing  Catalog Pages</a><br>
        <br>
        Design and layout of your Catalog pages can be changed by editing the following 
        files:
        <ul>
          <li><i>catalog/style.css</i> - Style sheet file.</li>
          <li><i>catalog/menuvars.js</i> - DHTML dropdown menu settings.</li>
          <li><i>catalog/catalogtemplate.htm</i> - Catalog Main Page template.</li>
          <li><i>catalog/menutemplate.htm</i> - Menu (edit only if you use your own menu).</li>
          <li><i>catalog/viewdetailstemplate.htm</i> - View Details Page template.</li>
        </ul>
        <font color="#FF3300"><b>Very Important: Do not edit any other files!</b></font><br>
        <br>
        Open template files in any HTML editor and make all necessary changes to 
        adjust design/layout of your Catalog according to your preferences. Also 
        you can design your own styles by editing style sheet
        file <i>catalog/style.css<br>
        <br>
        </i>Meta-variables (###variables###) and meta-tags (meta-variables inside 
        HTML comments) are used to display attributes of your products. If you 
        delete some variables - corresponding data won't be displayed.<font color="#FF3300"><b><br>
        <br>
        Do not delete meta-tags even if you don't need any variables to be 
        displayed (just put two meta-tags together with a space character 
        between).</b></font><a href="#7"><img border="0" src="back.jpg" align="right" width="82" height="14"></a><hr noshade color="#808080" size="1">
       <br>
         <a name="#3">Customizing Catalog Main Page</a><br>
        <br>
        <i>catalog/catalogtemplate.htm</i> -  Catalog Main Page template file 
        displays list of products, you can edit this page in any HTML editor.<br>
        Please don't remove or edit &quot;catalogue&quot; form and it's hidden inputs 
        - 
        it may cause an error.<br>
        <br>
        You can use the following meta-variables to display your products: <br>
        <br>
        <b>General</b><ul>
          <li>###Menu###
        - Container for Menu.
        If you want to use our dynamic DHTML menu, do not change or remove any &lt;script&gt; 
        tags 
          between &lt;HEAD&gt;&lt;/HEAD&gt; HTML tags of template file and&nbsp;in the bottom of 
        HTML code (just before &lt;/BODY&gt; tag).
        If you want to use your own menu - you can put it wherever you need (see 
        <a href="#4">Customizing Menu</a>).</li>
          <li>###ViewCartURL###
        - Link to view PayPal shopping cart (you can use text link, graphic 
        image or standard button and place this meta-variable 
        wherever you want on your page).</li>
          <li>&quot;JavaScript: sortColumn('title','###ToSortOrder###');&quot;<br>
          &quot;JavaScript: sortColumn('price','###ToSortOrder###');&quot;
        - Built-in functions for  sorting list of products by Title and by Price. You can put 
        this meta-variables wherever you want on your page and design your own text links or 
        graphic buttons.</ul>
        <b>Navigation</b><u><br>
        </u>All available pages of your product list are displayed using HTML 
        code inside &lt;!--###NAVDATA###--&gt; meta-tags and the following 
        meta-variables:</li>
        </ul>
        </p>
        <ul>
          <li>###Previous### and ###Next###
        - navigation buttons to browse through product list. If there are no 
          corresponding links, &quot;Previous&quot; and &quot;Next&quot; 
        buttons turn invisible (transparent blank image <i>images/blank.gif</i> 
        is used for that). If you want to use custom buttons, simply replace 
          existing image files <i>images/prev.jpg,</i> <i>images/next.jpg</i> and 
          <i>images/blank.gif</i> with your own images.</li>
          <li>###Page###
        - Links to jump directly to the specific page of the product list.
        The maximum number of pages shown in navigational bar can be set in Control 
          Panel (see <a href="../help/help.htm#3">Control Panel Help</a> for details).</li>
        </ul>
        You can put navigation bar wherever you want on your Catalog Main Page. <br>
        <br>
        <b>Search</b><br>
        Please don't rename the form &quot;search&quot; and it's input &quot;keyword&quot;. You can place 
        this form wherever on your page, just make sure not to put it inside the 
        main form - &quot;catalogue&quot;.
        If you don't want to use search on Catalog Main Page - just remove this form.<br>
        <br>
        <b>Product list</b><br>
        All products are displayed using HTML code inside &lt;!--###ROWDATA###--&gt; 
        meta-tags and the following meta-variables:</p>
        <ul>
          <li>###productnumber### - displays product number (article number).</li>
          <li>###title### - displays product title.</li>
          <li>###description### - displays product description.</li>
          <li>###price### - displays product price.</li>
          <li>###Option1### - displays product option #1 pull down menu (see
          <a href="../help/help.htm#5">Control Panel Help</a> for details).</li>
          <li>###Option2### - displays product option #2 pull down menu (see
          <a href="../help/help.htm#5">Control Panel Help</a> for details).</li>
          <li>###thumbnail### - displays product thumbnail image with link to View 
          Details Page (see Customizing View Details Page). Settings of how to 
          display this page can be set in Control Panel (see
          <a href="../help/help.htm#3">Control Panel Help</a> for details).</li>
          <li>###image### - displays product  image.</li>
          <li>###AddToCartURL### - URL of PayPal shopping cart to add a product 
          to (you can use text 
        link, graphic image or standard).</li>
        </ul>
        <a href="#7"><img border="0" src="back.jpg" align="right" width="82" height="14"></a><hr noshade color="#808080" size="1">
        <br><a name="#4">Customizing Menu</a><br><br>
        Open <i>catalog/menuvars.js</i> file in any text editor. You'll see variables 
        and their descriptions to 
        customize a dropdown DHTML menu according to your preferences. <br>
        <i>catalog/menuTemplate.htm</i> is a dropdown DHTML menu file - do not edit this file if you 
        would like to use our dropdown menu.<br>
        <br>
        If you're going to use a permanent tree of Categories/Subcategories of 
        your Catalog, you can create graphic buttons and assign  them direct 
        links to corresponding Categories or Subcategories using Link Codes from 
        Control Panel. The sample of such technique is shown in 
        <a href="http://www.sitesoutlet.com/demo/catalogue1/catalogue.asp">Demo 2</a>. You can 
        also use this technique to create a custom dropdown menu using Dreamweaver. In this case you don't need 
        to use container ###Menu### and <i>menutemplate.htm</i> file.<br>
        <br>
        If you have some programming skills and want to create your own custom 
        dynamic menu - a simple basic menu template is included in package: <i>catalog/blank_menuTemplate.htm</i>.<br>
        This is how it works:<br>
        Main Catalog Page outputs full list of categories/subcategories stored in 
        catalog database ordered by title: </p>
        <ul>
          <li>###CID### - category ID.</li>
          <li>###CT### - category title.</li>
          <li>###SID### - subcategory ID. </li>
          <li>###ST### - subcategory title.</li>
        </ul>
        &lt;!--###Data###--&gt; - meta-tag delimits header/footer parts of a menu template.<br>
        &lt;!--###CatData###--&gt; - meta-tag of category.<br>
        &lt;!--###SubData###--&gt; - meta-tag of subcategory.
        <a href="#7"><img border="0" src="back.jpg" align="right" width="82" height="14"></a><hr noshade color="#808080" size="1"><br>
        <a name="#5">Customizing View Details Page</a><br>
        <br>
        catalog/viewdetailstemplate.htm is a product View Details Page 
        template file.<br>
        You can edit this page in any HTML editor.
        If you delete some meta-variables, corresponding data won't be displayed.<br>
        <br>
        <b>The following meta-variables are used to display product details</b>:</p>
        </p>
        <ul>
          <li>###productnumber### - displays product number.</li>
          <li>###title### - displays product title.</li>
          <li>###description### - displays product description.</li>
          <li>###price### - displays product price.</li>
          <li>###thumbnail### - displays a product thumbnail image with link to 
          View Details Page (link settings can be set in Control panel. See
          <a href="../help/help.htm#3">Control Panel Help</a> for details).</li>
          <li>###image### - displays product image.</li>
          <li>###AddToCartURL### - Opens PayPal shopping cart to add current product 
          to it. Contains product 
        number, product title, price and your PayPal account settings (see
          <a href="../help/help.htm#3">Control Panel Help</a> for details). You can design text link, graphic image 
        or standard button by your choice.</li>
          <li>###ViewCartURL###
        - Opens PayPal shopping cart. You can design text link, graphic 
        image or standard button by your choice.</li>
        </ul>
<a name="#6"></a><a href="#7"><img border="0" src="back.jpg" align="right" width="82" height="14"></a><hr noshade color="#808080" size="1"><br>
<table border="0" cellspacing="1" cellpadding="4" bordercolor="#999999" bgcolor="#999999">
<tr><td bgcolor="#006699" align="center" colspan="2"><p>Files Map</td>
  </tr>
<tr><td bgcolor="#EEEEEE" align="center"><b>Location</b></td><td bgcolor="#EEEEEE" align="center"><b>Description</b></td></tr>
<tr><td bgcolor="#EEEEEE">catalog/catalog.php</td><td bgcolor="#EEEEEE">Main script</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/viewdetails.php</td><td bgcolor="#EEEEEE">View Details script</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/ek1pvars.php</td><td bgcolor="#FFFFFF">Variables for MySQL connection</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/style.css</td><td bgcolor="#FFFFFF">Style sheet</td></tr>
<tr><td bgcolor="#FFFFFF" valign="top">catalog/menuvars.js</td>
  <td bgcolor="#FFFFFF" valign="top">DHTML 
  dropdown menu settings<br>(you can delete this file if you want to use your own menu)</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/adm</td><td bgcolor="#EEEEEE">Control Panel folder</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/adm/top.htm</td><td bgcolor="#FFFFFF">Logo frame file</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/adm/1.css</td><td bgcolor="#FFFFFF">Style sheet file</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/adm/help.gif</td><td rowspan="3" bgcolor="#FFFFFF">Control Panel images</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/adm/help_sm.gif</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/adm/logo.jpg</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/cls/</td><td bgcolor="#EEEEEE">Classes folder</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/manual/</td><td bgcolor="#EEEEEE">E-store Kit Manual</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/help/</td><td bgcolor="#EEEEEE">Control Panel Help</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/images/</td><td bgcolor="#EEEEEE">Images folder</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/productimages/</td><td bgcolor="#EEEEEE">Product images folder </td></tr>
<tr><td bgcolor="#EEEEEE">catalog/productthumbnails/</td><td bgcolor="#EEEEEE">Product thumbnails folder </td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/</td><td bgcolor="#EEEEEE">JavaScript files</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/catalog.js</td><td bgcolor="#EEEEEE">Catalog navigation JavaScript</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/ie4.js</td>
	<td rowspan="9" bgcolor="#EEEEEE">Dropdown menu JavaScript files.<br>(You can delete these files if you want to use your own menu)</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/ie5.js</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/moz.js</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/ns4.js</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/op5.js</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/op6.js</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/menu.js</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/menuinit.js</td></tr>
<tr><td bgcolor="#EEEEEE">catalog/res/menustyle.js</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/catalogtemplate.htm</td><td bgcolor="#FFFFFF">Pre-designed Catalog Main Page template</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/viewdetailstemplate.htm</td><td bgcolor="#FFFFFF">Pre-designed View Details Page template</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/menutemplate.htm</td><td bgcolor="#FFFFFF">Pre-designed dropdown menu template</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/blank_catalogtemplate.htm</td><td bgcolor="#FFFFFF">Blank Catalog Main Page template</td></tr>
<tr><td bgcolor="#FFFFFF">catalog/blank_menutemplates.htm</td><td bgcolor="#FFFFFF">Blank Menu template</td></tr>
</table>
        <br>
        <b>Legend</b>:<ul>
          <li>White color indicates that you can edit these files.</li>
          <li>Yellow color indicates that you can rename these files  according to your PayPal settings.</li>
          <li>Do not edit or rename all other files and folders.</li>
        </ul>
</a><a href="#7"><img border="0" src="back.jpg" align="right" width="82" height="14"></a><hr noshade color="#808080" size="1">        
        <br>
        <a name="#8">Tips</a><ul>
          <li>You can use E-store Kit-2 to create a non-commercial database-driven website (for example: Gallery of pictures), to do that simply 
          hide &quot;Add to Cart&quot; and &quot;View Cart&quot; buttons.</li>
          <li>You can insert HTML tags into &quot;Product Description&quot; field (for&nbsp; 
          example: insert additional images and/or links). Using this technique 
          can dramatically extend possibilities of E-store Kit.</li>
        </ul>
        <hr noshade color="#808080" size="1">
        We can customize E-store Kit-1 Pro for you for an additional negotiable charge.<br>
        <br>
        If you have any problems or suggestions please contact us at 
<SCRIPT LANGUAGE="Javascript">
username="admin";
at="@";
domainname="magicscripts.com";
document.write("<A HREF='mailto:"+username+""+at+""+domainname+"'>"+username+""+at+""+domainname+"</a>")
        </script><br>
<BR>Good Luck and Best Wishes from <b>MagicScripts™</b> Team!<br>
&nbsp;</p>
        </p>
        </p>
        <hr noshade color="#808080" size="1">
        &copy; MagicScripts, 2003-2005</blockquote>
      </td>
    </tr>
  </table>
  </center>
</div>
</body>
</html>
Return current item: E-Store Kit-1 Pro (PHP/MySQL) PayPal Edition