SYSTEM REQUIRMENTS:
-------------------
- PHP 4.3 or higher
- MySQL 3+ database
- FTP server access



INSTALLATION:
-------------
1. Create a mysql database
2. Fill in server information in the config.inc.php file, including database user/pass, 
admin password, as well paths to various components
3. Make /thumbs folder writable (777)
4. Run install.php from the web, for example, http://www.yoursite.com/galleries/install.php
5. Delete install.php from the server, it's no longer needed
6. Ask your host to cron gotd.cron.php once per day (see gallery of the day section below)
7. Installation is complete!



ADDING GALLERIES:
-----------------
When adding galleries add {id} wherever you want the webmasters id to go,
for example: 
http://www.yoursite.com/galleries/gal01/?id={id}
http://www.yoursite.com/galleries/gal1.php?id={id}


PREPARING GALLERIES:
--------------------
Galleries need to passthrough the affiliate id variable, this is usually done by naming the gallery page ___.php
and then inserting <?=$_GET['id'];?> wherever you want the gallery id to go, so for example:

<a href=http://www.yoursite.com/?id=<?=$_GET['id'];>">Link To your site</a>





THUMBS:
-------
The script supports unlimited number of thumb sizes, the default ones are 88x88 and 90x120
To enable additional sizes in config.inc.php add additional sizes in the form:
$THUMB_SIZE['ID']='DESCRIPTION'; 
for example:
$THUMB_SIZE['88x88']='88x88';

Note: thumbs are completely optional.  Script will function correctly even if only some
galleries have thumbs uploaded.



RANDOM GALLERY:
---------------
Optional 'Random Gallery' feature can be enabled by setting $RANDOM_GALLERY_ENABLED=1
Random Gallery sends the visitor to a random gallery within a given category.  
Note: Each category has it's own random gallery.


GALLERY OF THE DAY:
-------------------
To enable the 'gallery of the day' feature, gotd.cron.php needs to be cronned once per day.
Note: gotd.cron.php needs to be run at least once to initilize the gotd module.
cron once per day: http://www.yoursite.com/galleries/gotd.cron.php?pass=password  where password is the $CRON_PASS selected in the config.inc.php

for example:
1 1 * * * /usr/bin/curl http://www.yoursite.com/galleries/gotd.cron.php?pass=password


CCBILL LINK:
-----------------------
http://refer.ccbill.com/cgi-bin/clicks.cgi?CA=YOURCODE&PA=<?=$_GET['id'];?>&HTML=http://www.YOUR SITE.com


ADMIN PASSWORD:
----------------
default admin password is: u:woj p:php this password can be changed by modifying the config.inc.php file





RSS FEEDS
---------
Hosted galleries manager includes an rss feed feature, which allows your affiliates to easilly import your galleries into their blogs or other scripts supporting rss.

The rss template is stored in the /feed_templates/
Following 'variables' can be used in the rss template:
{description} - 'description' from the admin
{description2} - 'description2' from the admin
{description3} - 'description3' from the admin
{description_sel} - description that was selected by the affiliate on the generate rss page, if "short description" is selected, then description2 is used, if "long description" is selected then description3 is used
{url} - url to your hosted gallery
{thumb_url} - url of the thumb
{id} - affiliate id

What you will most likely need to edit is the description field of the rss:
  <description><![CDATA[

<img src='{thumb_url}'><p>{description_sel}

]]></description>

Everything between <![CDATA[   and   ]] is what will be shown as the "post"



CUSTOM FIELDS
------------------------
In the admin section there are 3 'custom' fields, you can use those to enter addtional information about the gallery, for example: template name, model's name, content type, etc

In the /templates/galleries.html template you can use {custom1} {custom2} {custom3} variables to display those custom fields.



SORTING GALLERY RESULTS BY CUSTOM FIELDS
------------------------------------------
This is a custom advanced featured, most affiliate owners will not need this functionality.

In addition to just display the custom fields, you can also allow webmaster to search by a custom field.  For example, you can allow them to search by a model name or perhaps a template name.  To acomplish this, a new form element needs to be added to /templates/main.html

For example to add searching by "custom 1" field the following needs to be added:


(this will automatically generate the choices for you)

         <select name="c1d">
           <option value="0">All</option>
           {customchoices1}
         </select>

(or you can manually include search terms)

         <select name="c1d">
           <option value="0">All</option>
           <option value="hardcore">Hardcore</option>
           <option value="nonnude">Non-Nude</option>
           <option value="softcore">Softcore</option>
         </select>

for custom 2, c2d needs to be added, and for custom 3, c3d



ADDITIONAL HELP/SUPPORT
-----------------------
If you have any questions contact woj @ icq: 33375924 or woj@wojfun.com