NEW INSTALL

  1. Copy the package contents to your webspace.
  2. Set thumb dir and settings.inc.php as writable if necessary
  3. Edit settings.inc.php and change DES_PASS constant (AdminBoard password)
  4. Login into AdminBoard with the password you set and change the settings to meet your preferences, also initiate the logs by clicking the refresh icons
  5. Inside AdminBoard point "Albums dir" to where your images are located (default "./albums/" value is ok if you don't have any images yet)

UPGRADE 2.4 RC1/RC2/RC3 -> 2.5

  1. Make a backup of your files.
  2. Copy v2.5 files to your website overwriting the existing ones.
  3. Set the admin password in the new config.inc.php file. (DES_PASS constant at the top of the file)
  4. Login to admin panel interface to repose your settings and preferences.
  5. Browse your gallery to update the df files.
  6. Refresh Logs.
Files from v2.4 not longer used in v2.5: ./anima.css ; ./graph ; ./templates.php

FAQ

When I load a directory, the images do not show?
If the images are large they will take some time to be processed, that's normal. The page will always finish loading before all images show up (parallel processing)
What is the Upload date?
Simply put it's the date of when the image was upload by HTTP or first processed from FTP, it's invariable and never changes, its stored inside the df file in the attributes line (line 2).
How do I customize the log's thumbnail dimensions.
Each theme has a separate css file and it contains the dimensions of the log's thumbnails. You can set different dimensions for each theme. Do not forget they're nothing but css-resized versions of the real thumbnails so their quality is inferior.
How do i customize the recaptcha style?
In the anima.js, at the very bottom of the file you can specify the theme. Consult recaptcha website for the available themes.
What's the difference between the old date, the new upload date and the EXIF date?
old date (Image modification date) = last modification date of an image, upload date = date when file was uploaded. When you upgrade an image its modification date will change but the upload date will remain the same. The date in EXIF is the date when the photo was taken, usually in a digital camera. NOTE: The upgrade process uses Modification dates to set upload dates.
What happens when I disable an album?
The album contents won't be displayed, also the logs and search will ignore contents from that album. The disabled.log file helps the other pages know the album is disabled.
I received lots of spam in version 2.4 RC2/RC3, do I need to use recaptcha?
Try using the forum default captcha first, there were a lot of flaws that have been fixed.
I customized a new language or a cool theme, can I share it with others?
Yes ofcourse, just upload it in the forums "Language & Templates" section. All you have to do is zip and upload.
Is there any way I can process all images in a directory without browsing all pages?
While logged as admin The refresh button scans and processes missing df files.
What types of files are stored in thumb folder?
*.df - The Images and albums data files. The sfv code is related to their path.
*.cd - The album's image count.
blog_*.df - The blog entries.
*.jpg - The thumbnails.
p_*.jpg - The previews (medium thumbnails).
*.log - The logs (Comments, Most Commented, Most Viewed, Recent Comments, Top Rated, HTTP Uploads, News)
What is album "."?
The root of albums directory, it's the only one that cannot be renamed/moved.
How are templates and languages integrated with the code?
The code calls the templates using the function "popt" which loads the templates and replaces it's variable and language tokens "Ex.: {contents}", language tokens always start with an L "Ex.: {L45}"

FAQ - OLDER ENTRIES

I cannot access Admin Board?
Edit settings.inc.php file and set the DES_PASS constant.
There are no images!
You must set the location of a directory with images [AdminBoard -> Albums dir] or upload some through the gallery.
I moved gallery to another site and the image's comments/ratings are absent?
Each data file inside thumb directory is set to match the combination "Albums dir + image relative path", you must be sure the "albums dir" is the same as the previous location, image's relative paths must be the same as well.
I cannot Upload images!
The directory has no write permissions or guest upload is disabled (If you're not logged in)
How do i batch upload images?
Upload all your images through FTP and they will appear in the gallery. (Note that images uploaded by FTP are not present in "last web uploads" log.)
Where does the directory tree comes from, i didnt make it?
The tree comes from your website directory system (That you access through FTP), [AdminBoard -> Default Tree Depth] sets the levels for the tree, [AdminBoard -> Albums dir] is the root
How do i make an album or remove images
You can either do it using an ftp client or through the gallery's interface.
I'm getting outdated statistic log entries?
Make refresh, it may happen if you removed/moved the related items, after performing maintenance you must refresh the logs, logs are made static to not affect gallery performance, despite this they auto-update when comments/ratings are performed.
The exif data is not being displayed / Captcha no working
EXIF Requires php compiled with --enable-exif; Captcha requires FreeType library, you may have to ask you system administrator to install those if they're not present. Also be sure the {captcha} and {corr_exif_or} tags are present in templates.
I tried to search for an image but despite it exists it won't show up in search?
For images to appear in search they need to have a .df file generated, if the image was uploaded through FTP and nobody viewed/previewed, the .df file is absent. It may also mean the directory where the image has been disabled. ([DISABLED] tag in description)
Sometimes i get exclamation signs in logs?
The image was not indexed yet or outdated. Refresh the log or access the image's album.
Why there are red and bold entries in move's select list?
Those entries are the ones the file cannot be moved to, red = no permission, bold = current dir.
In some albums or images the manipulation controls (move, rename, delete, update) are not available!
The respective server files/dirs are not writable.