Location: PHPKode > projects > Maian Gallery > maian_gallery/docs/setup/install.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Maian Gallery v2.0 Documentation - Documentation - Installation/Usage</title>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<link href="stylesheet.css" rel="stylesheet" type="text/css">
</head>

<body>
<a name="top"></a>
<div align="center">
<table width="760" border="0" cellpadding="0" cellspacing="0" align="center">
<tr>
    <td align="left" valign="top" colspan="2" height="60"><img src="images/logo.gif" alt="Documentation" title="Documentation"></td>
</tr>
</table>
<table width="760" border="0" cellpadding="0" cellspacing="0" style="border:1px solid #FFFFFF">
<tr>

    <td>
    <table width="760" border="0" cellpadding="0" cellspacing="0" align="center">
    <tr>
        <td align="center" class="nav_menu">&lt; <a href="index.html" title="Home">Home</a> - <a href="install.html" title="Installation/Usage" style="color:#A4E4F5">Installation/Usage</a> - <a href="paypal.html" title="Paypal Setup">Paypal Setup</a> - <a href="themes.html" title="Themes">Themes</a> - <a href="faq.html" title="F.A.Q">F.A.Q</a> - <a href="info.html" title="Script Info">Script Info</a> &gt;</td>
    </tr>
    <tr>
        <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
        <!-- BEGIN TEMPLATE LOADING -->
Please read the following installation instructions carefully:
   </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>SETUP REQUIREMENTS</b></td>

</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    &#8226; A server running <b>PHP v4.3</b> or higher. Some of the syntax will <b>NOT</b> work on earlier versions.<br>
    &#8226; A <b>MySQL</b> database to hold the script tables.<br>
    &#8226; <a href="http://uk2.php.net/gd" target="_blank" title="GD2 Library"><u><b>GD2 Graphic Library</b></u></a> support for auto thumbnail creation, captcha &amp; watermark display.<br />
    &#8226; <a href="http://www.php.net/curl" target="_blank" title="Curl"><u><b>CURL</b></u></a> enable for the Paypal IPN system.<br /><br />
    The script auto checks your configuration when you load the installer.<br>
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>SETUP (AUTO INSTALL)</b></td>
</tr>

<tr>                          
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    <b>1</b> => Create a database to hold the script tables. If you are unsure of this procedure contact your web hosting company.<br><br>
    <b>2</b> => Open up the <b>'inc/db_connection.inc.php'</b> file in a text editor and edit it to point to the database you just created. DO NOT comment out the prefix function. If you don`t need to change it leave it as it is. You MUST also specify a cookie name and a secret key. DO NOT use the defaults!!<br><br>
    <b>3</b> => Again in your text editor, open up the <b>'admin/inc/password.inc.php'</b> file and choose a username and password for your admin area.<br><br>

    <b>4</b> => Upload all the files/folders into a directory on your web server. Example: /gallery/<br><br>
    <b>5</b> => Chmod the following folders to 777 to make them world writeable. (If your server accepts 755, then you should choose this as its known to be more secure):<br><br>
    <table border="0" cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #FFFFFF;background-color:#0F5B96">
    <tr>
        <td align="left" style="padding:5px"><b>/galleries/<br>
        /galleries/categories/<br>
        /galleries/categories/*folder (any folder you create)<br>
        /log/<br></b>
        </td>
    </tr>
    </table><br>
    <span style="color:#083253;font-weight:bold">NOTE:<br>It is recommended you remove the write permissions on your image folders when you have added your images.</span><br><br> 
    <b>6</b> => Access the <b>'/install/index.php'</b> file in your browser and follow the set up instructions to complete installation. Once setup is complete, delete the install dir.<br><br>

    <b>7</b> => If the setup was successful log in to your admin area and select <b>'Settings'</b> from the top menu. Update the settings to your own preferences.<br><br>
    <table border="0" cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #FFFFFF;background-color:#0F5B96">
    <tr>
        <td align="left" style="padding:5px"><b><u>http://www.yoursite.com/gallery/admin/</u></b></td>
    </tr>

    </table><br>
    <b>8</b> => Rename the 'admin' folder if you want to for additional security. If you do rename it, update the admin folder name in the 'inc/defined.inc.php' file.<br><br>
    <b>9</b> => Thats it, all done. For script usage see below.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>SETUP (MANUAL INSTALL)</b></td>

</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    If the auto install has aborted or if you prefer to manually install the system, follow these instructions:<br><br>
    <b>1</b> => Create a database to hold the script tables. If you are unsure of this procedure contact your web hosting company.<br><br>
    <b>2</b> => Open up the <b>'inc/db_connection.inc.php'</b> file in a text editor and edit it to point to the database you just created. DO NOT comment out the prefix function. If you don`t need to change it leave it as it is.<br><br>
    <b>3</b> => Again in your text editor, open up the <b>'admin/inc/password.inc.php'</b> file and choose a username and password for your admin area.<br><br>

    <b>4</b> => Upload all the files/folders into a directory on your web server. Example: /gallery/<br><br>
    <b>5</b> => Chmod the following folders to 777 to make them world writeable. (If your server accepts 755, then you should choose this as its known to be more secure):<br><br>
    <table border="0" cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #FFFFFF;background-color:#0F5B96">
    <tr>
        <td align="left" style="padding:5px"><b>/galleries/<br>
        /galleries/categories/<br>
        /galleries/categories/*folder (any folder you create)<br>
        /log/<br></b>
        </td>
    </tr>
    </table><br>
    <span style="color:#083253;font-weight:bold">NOTE:<br>It is recommended you remove the write permissions on your image folders when you have added your images.</span><br><br> 
    <b>6</b> => Access your database using your MySQL admin program. PHPMYADMIN? Browse for and run the <b>'docs/schematic/tables.sql'</b> file to set up the script tables.<br><br>
    <b>7</b> => Log in to your admin area and select <b>'Settings'</b> from the top menu. Update the settings to your own preferences.<br><br>
    <table border="0" cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #FFFFFF;background-color:#0F5B96">

    <tr>
        <td align="left" style="padding:5px"><u><b>http://www.yoursite.com/gallery/admin/</b></u></td>
    </tr>
    </table><br>
    <b>8</b> => Rename the 'admin' folder if you want to for additional security. If you do rename it, update the admin folder name in the 'inc/defined.inc.php' file.<br><br>
    <b>9</b> => Thats it, all done. For script usage see below.
    </td>

</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>SCRIPT USAGE</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    Firstly, you`ll need to create some categories and/or sub categories. Once this is done you can add your pictures. See the folder information below.
    Manage your pictures in your admin area. Disable and enable things to see how they work.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>AUTO THUMBNAIL CREATION</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    For the auto thumbnail creation feature to work, you will need to have GD graphic support enabled on your server.
    See the F.A.Q page for information on how to check for this feature. If you don`t have this you can manually create
    and upload your thumbnails.<br><br>
    There is no option in Maian Gallery to improve thumbnail quality. Generally if your image is good quality, the thumbnail should be too. If you aren`t
    happy with the thumbnails generated, create your own manually and upload. See the F.A.Q page for some auto thumbnail software links.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>IMAGES PER ROW</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    There is no setting for this because the amount of rows is determined by the width of the main div in the stylesheet
    and also the width of the li tags. Altering this is a combination of the thumbnail display size and the settings in the
    stylesheet. This may be a little complicated if you don`t know how .CSS files work. Have a play around and see what
    happens.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>CATEGORY FOLDERS</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    When you create your categories you`ll need to specify and manually create your category folders. The current script
    version does not create the folders. So, if you have specified a category called 'Flowers', you might specify 'flowers'
    as your folder name and then create a folder in the main 'galleries/categories/' folder. If you then want a sub category called 'roses',
     specify 'flowers/roses' as your folder name and create a new folder inside the 'galleries/categories/flowers/' folder
     called 'roses'. Note that all categories you create must be writeable. 
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>WATERMARKS</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    The watermark feature enables you to mask original images. You may want to enable this if you are selling images. To enable the watermark
    function update your settings in your admin area. Various options can be changed for the watermarks. Watermarks work for the slideshow and are also category specific.<br><br>
    The <a href="http://uk2.php.net/gd" target="_blank" title="GD2 Library"><u>GD2 Library</u></a> is required for the watermark feature.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>SLIDESHOW</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    Integrated into Maian Gallery is Jonathan Schemoul's superb <a href="http://smoothgallery.jondesign.net/" target="_blank" title="Smooth Gallery"><u>Smooth Gallery</u></a> slideshow. This slideshow
    is javascript based and can be enabled in your settings. The main control/layout settings can be found in the following files:<br /><br />
    <table border="0" cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #FFFFFF;background-color:#0F5B96">
    <tr>
        <td align="left" style="padding:5px">
        <b>themes/*theme/jd.gallery.css<br />
        themes/*theme/layout.css<br />
        themes/*theme/js/jd.gallery.js
        </b>
        </td>
    </tr>
    </table><br>
    Default speed for slideshow is set in the 'inc/defined.inc.php' file. Image display sizes for the slideshow are in the slideshow stylesheets.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>SLIDESHOW MUSIC</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    I updated the Smooth Gallery slideshow to also include background music in .mp3 format. Music paths can be specified in your admin area. You
    can use a different file for each category or revert to the default one in the slideshow settings. .mp3 files need to be added to the 'mp3' folder.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>COMMENTS</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    If you wish you can enable user comments so visitors can comment on your pictures. Comments can be site wide or category specific. When
    enabling comments you also have the option of approving entries and also enabling the e-mail verification feature. Both features
    can be enabled together if you wish. Once a visitor has verified their e-mail address, they won`t need to again unless you delete it from
    the allowed e-mails or they use a different address.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>CART SYSTEM</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    Maian Gallery has an integrated cart system. This feature is ideally suited to photographers who may have images they
    wish to sell. Paypal is used for processing, so you`ll need a Paypal business account. See the IPN setup instructions. When pictures are purchased, download links are not sent. You`ll
    need to deal with the shipping seperately. You`ll see a couple of basic shipping options in the settings.<br /><br />
    The cart system is enabled in the settings. See the notes in the admin area on how to add buy options. For quickness you
    can batch add pricing options to an entire category of pictures if they have the same options.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>SEARCH ENGINE FRIENDLY URLS</b></td>

</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    Maian Gallery supports search engine friendly urls via mod_rewrite. To enable this function, rename the 'htaccess_COPY.txt' file to '.htaccess'
    and enable the option in your settings. Your server must support this feature. If it doesn`t you`ll see an internal server error. If your server does support it and you see
    an error, check your server error logs.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>EDITING TEMPLATES</b></td>

</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    To edit the script templates you need a text editor. Notepad will be fine., but a better, colour coded text editor is recommended.
    It is important that the data between <b>&lt;?php ?&gt;</b> tags remains in place or else the template may fail.<br><br>
    Advanced users will know which variables are not so important.<br><br>The '.tpl' files in the 'themes/*theme/tpl_files/' folder
    use data between braces which is parsed by the system. These files keep 99% of the HTML out of the main processing files. For more information
    see the 'themes/*theme/README.txt' file for more info.<br /><br />
    The e-mail templates also use braces. ie: <b>{NAME}</b> Again, be careful when editing not to remove these variables. All site paths are
    automatically parsed by the system, so no need to manually update paths in the e-mail templates.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>LANGUAGE</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    All the script language is in the 'lang/english.php' language file.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>CASCADING STYLESHEETS (.CSS)</b></td>

</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    v2.0+ has all style control elements/colours in the stylesheets. Besides the slideshow css files mentioned earlier, the main interface has the following stylesheets:<br /><br />
    <table border="0" cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #FFFFFF;background-color:#0F5B96">
    <tr>
        <td align="left" style="padding:5px">
        <b>themes/*theme/stylesheet.css (Main Control)<br />
        themes/*theme/calendar.css (For Search Calendar)<br />
        themes/*theme/greybox/gb_styles.css (For Greybox pop up windows)<br />
        themes/*theme/rss_style.css (RSS Styling)<br>
        themes/*theme/category_menu.css (Category Styling) **<br>
        themes/*theme/mgallery.css (Generic Maian Gallery CSS File) **
        </b>
        </td>
    </tr>
    </table><br>
    Note that if you can`t find a colour, what you are seeing on screen may be a background image. The RSS stylesheet may not be applicable for all browsers.<br><br>
    <span style="color:#083253;font-weight:bold">**</span> CSS file relevant to some themes ONLY.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>CAPTCHA CODE</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    All the settings and fonts for the captcha are in the 'captcha' directory. The reload gif is in the 'themes/*theme/images/captcha' directory. If you have multiple themes, also check
    the 'themes' page to see how to change the captcha text colour per theme on the fly.
    </td>
</tr>
<tr>
    <td class="header" colspan="2" align="left">&raquo; <b>CLOSING NOTES</b></td>
</tr>
<tr>
    <td align="left" valign="top" style="padding:10px;" colspan="2" class="main">
    Hopefully this installation guide has helped you get the script up and running. Check out the F.A.Q page for some solutions to common problems.<br><br>
    If you require any help at all, please post on the <a href="http://www.maianscriptworld.co.uk/support-forum.html" title="Forums" target="_blank"><u>support forums</u></a>. Thank you.
    </td>
</tr>
<tr>
    <td align="right" valign="top" style="padding:10px;" colspan="2" class="main">
    <a href="#top"><img src="images/up.gif" border="0" alt="Back to Top" title="Back to Top"></a>
    </td>
</tr>
</table>
</td>
</tr>
</table>
</div>

<!-- Footer -->
<div id="footer">
	<p>Maian Gallery v2.0. Copyright &copy; 2006-<script type="text/javascript">var d = new Date(); document.write(d.getFullYear());</script> <a href="http://www.maianscriptworld.co.uk/free-php-scripts/maian-gallery/free-photo-gallery-system/index.html" title="Maian Script World">Maian Script World</a>. All Rights Reserved</p>
</div>
<!-- End Footer -->
</body>
</html>
Return current item: Maian Gallery