Configuration
The files 'index.php and 'window.php (x_frame_navi.php and x_frame_main.php or x_simple_index.php and x_simple_window.php) are the same script with different configuration. Those files contain following options:
$image_path
If you want to use a different image folder than the default you can change the path in this variable. You can enter the relative path (default setting) or the complete server path to the image folder (e.g.: /usr/local/etc/httpd/...).
$image_url
This variable is the image path to call up the pictures in the HTML pages. You can enter the relative path (default setting) or the complete web path to the image folder (e.g.: if the www address to the image is http://www.server.com/images/picture.gif, the absolute path is /images/picture.gif).
$picture_count
In this variable you can define the number of images that you want to be in a row. The default value of index.php is 2 pictures in a row and the default value of window.php is 1 pictures in a row.
$pictures_per_page
This variable contains the number of images on one page.
$order
This variable contains the order direction of the images. Available are 'ascending' (a, b, c, 1, 2, 3) and 'descending' (c, b, a, 3, 2, 1). The order consists of the filenames.
Example:
$order = "ascending";
or
$order = "descending";
$language
With this variable you can set the language. Enter here the abbreviation that also is used in the name of the language file in the directory 'languages' (en in languages.en.inc.php and de in languages.de.inc.php).
$global_template
Enter here the path to the layout template.
$cell_template
Enter here the path to the table cell template. In the cell template you can customize the layout of the images, the links to the large images and the table cells.
$large_image_page
Enter here the name of the file that you want to show the large images by clicking on the thumbnail images. That means if the file index.php contains the thumbnails and the file window.php contains the large images value of this variable in index.php is window.php.
$path['log']
You can let the script count the image views. This variable contains the path to the directory, where the log file is stored.
If you want to use the counting feature please make sure the log directory is writable (chmod 777).
$logging_file
If you want to let the script count the image views, enter here a name for the logging file. White spaces and special characters are not allowed.
This variable is empty by default, no image views will be counted unless you enter a log file name.
If you want to use the counting feature please make sure the log directory is writable (chmod 777).
$statistic_file
If you want to display the image views to your visitors please enter here the name of the logging file you want to be analyzed. The values appear in the placeholder {views} within the HTML templates.
As example file the script contains the log file 'gallery_one.txt' in the log directory. That is to demonstrate the display of image views.
If you want to use the counting feature please make sure the log directory is writable (chmod 777).
$add_text
You can add further values, text, variables or other content to this variable. That content can be displayed in the HTML templates by using markers/placeholders within curly brackets { and }.
If you want to add your own values to the variable $add_text please follow the pattern from the example entries.
$add_text =
array(
'txt_additional => 'Additional,
'txt_more'
=> 'More'
);
The first part of each entry is the name of the placeholder. In case you want to use the value of txt_addition in your template enter the name of the entry with curly brackets - {txt_addition}. The name must not contain white spaces or special characters. Only allowed is the _ .
When you open the script in your browser and get an empty screen (no error message) you ran probably into a know but still unsolved problem. Please let us know what server operating system, web server version, and PHP version your web host uses.
Multiple Galleries
You are able to run several picture galleries with the same layout templates. Copy the files 'index.php and 'window.php and give them a new file name. You need then to change the path to the image directory.