Configuration

Included Files/Folders

ubergallery/
|  cache/                        - Default cache directory
|  images/                       - Default image directory (put your images here)
|  resources/
|  |  css/                       - Script styles
|  |  |  colorbox.css
|  |  |  ubergallery.css
|  |  images/                    - Script images
|  |  |  bg.png
|  |  |  border.png
|  |  |  controls.png
|  |  |  images.png
|  |  |  loading.gif
|  |  |  loading_background.png
|  |  |  page_white_stack.png
|  |  js/                        - Script JavaScript
|  |  |  jquery.colorbox.js
CHANGELOG.txt                    - UberGallery changelog
GPL-LICENSE.txt                  - GNU Public License v2.0
MIT-LICENSE.txt                  - MIT License
README                           - Basic README file
index.php                        - Main gallery script

Pagination

To enable pagination, open index.php, find $imgPerPage = 0; at the top and set this value to the number of images you would like to display per page.

NOTE: If pagination is enabled, the script will generate thumbnails on a per-page basis. You do not have to worry about this though, the first time a visitor visits a page without thumbnails, it will automatically generate the thumbnails, however this may cause the page to take several seconds to load the first time it processes.

Page Caching

Page caching can drastically reduce the CPU load on your server and is more efficient for servers with high traffic. To enable page caching, edit the "$expireTime = 0;" value found at the top of the ubergallery/ubergallery.php script. This value is the time in minutes after which a new cach file will be generated.

NOTE: At the moment, if you upload new images or make a change to the script while caching is enabled, you will have to delete the cache files or wait the ammouont of time specified before your changes will be reflected on the page.

To delete the cache files, use an FTP program or shell access to delete the "gallery-cache" folder and all of it's contents.

Update Notifications

To enable the update notification, open index.php, find $verCheck = false; and change this value to true. Once done, whenever an update to UberGallery is available, a message will appear at the bottom of your gallery informing you of this new version and providing a link to the new version.

You may also get update notifications by following @ubergallery on Twitter.

Customizing your Gallery

The UberGallery comes with class and id elements already in place, this allows for customization of the look and feel of your gallery. All you have to do is edit the CSS style sheet, or create your own, and you'll be off in no time.

This is the typical structure of the XHTML output:

<div id="gallery-wrapper">
  <div id="gallery-constraint">
    <div id="gallery-header">UberGallery Image Gallery</div>
    <div id="gallery-images">
      <a href="#"><img src="#" /></a>
      <a href="#"><img src="#" /></a>
      <a href="#"><img src="#" /></a>
    </div>
    <div id="uber-footer">
      <div id="credit">Credit...</div>
    </div>
  </div>
</div>

Also, here's the pagination navigation structure:

<ul id="uber-pagination">
  <li class="inactive">&lt;</li>
  <li class="current-page">1</li>
  <li><a href="?page=2">2</a></li>
  <li><a href="?page=3">3</a></li>
  <li><a href="?page=4">4</a></li>
  <li><a href="?page=2">&gt;</a></li>
</ul>