Skip to content

Installation

How to Install

ThePhig was built around the idea that the installation and maintaning of an image gallery should be simple and straight forward. Check the steps and requirements for ThePhig.

Requirements

  • PHP version 5.2+
  • The GD library plugin for PHP (this is installed on many servers by default)
  • MySQL Database

Steps for a Fresh Installation

  1. Download and extract ThePhig to your local machine
  2. Edit config.php, filling out the information for your database (username, password, hostname, and database name)
  3. Upload the gallery files to your webserver
  4. Upload your albums to the gallery_images directory. Each album should be it’s own directory (ie gallery_images/album1/image1.jpg, etc)
  5. Change the permissions of the uploaded album folders to 777 or read/write/execute
  6. Point your browser to the install.php file (ie http://www.website.com/gallery/install.php)
  7. Fill out all the details required, hit submit, and delete the install.php file
  8. You can now administrate your gallery by going to the admin.php page. From the admin page, you can add albums to the database, create the thumbnails, etc
  9. Visit index.php to view your new gallery

Steps for Upgrading to the Latest Version

  1. Backup your database and files as a precaution
  2. Download and extract ThePhig to your local machine
  3. Replace all files (or those listed in changelog) except for inc/config.php
  4. Run any upgrade scripts included. These upgrade scripts are important for updating the database.
  5. Delete install.php and upgrade-* scripts

Integrating Into A Pre-Existing Webpage

If you’d like to integrate ThePhig into a pre-existing site, you’ll only need to create your own theme. In the templates/ directory, each directory is a separate theme.

Template Files

  • albumEntry.php => Template for each individual album on the main page
  • commentForm.php => Comment form for individual images
  • comment.php => Template for each individual comment
  • footer.php => Footer for the gallery
  • header.php => Header for the gallery
  • htmlHead.php => Additional scripts, css, etc in the head of the html
  • imageEntry => Template for each individual image and exif info
  • search.php => The search bar to tags. Can be used in other template pages (currently not functional)
  • singleImage.php => Template for specific image view (ex index.php?imageID=300)
  • style.css => The CSS related to this specific theme

Available Template Variables

  • $apiKey => Google’s API Key for Google Maps
  • $copyrightLink
  • $copyrightOwner
  • $elementsPerPage => The number of images or albums displayed on current page
  • $galleryPath
  • $galleryTitle
  • $imageName
  • $imagesPath
  • $jsOverlay
  • $tags => Tag that user searched for
  • $theme
  • $thumbnailName
  • $version => thePhig version
  • $albumDate
  • $albumDesc => The album description provided in that admin panel for the album
  • $albumFolder
  • $albumIcon
  • $albumID
  • $albumLink => The link to the album (ie index.php?albumID=1)
  • $albumName
  • $imageLink => A link to the original/resized image (the image that the template links to)
  • $originalImage => Full path to the original image
  • $resizedImage => Full path to the resized image
  • $thumbnailImage => Full path to the resized Image
  • $imageInfo['albumID']
  • $imageInfo['albumFolder']
  • $imageInfo['albumName']
  • $imageInfo['camera']
  • $imageInfo['fstop']
  • $imageInfo['geoCoords']
  • $imageInfo['id'] => Image ID
  • $imageInfo['imageDate']
  • $imageInfo['imageName']
  • $imageInfo['imageTitle']
  • $imageInfo['iso']
  • $imageInfo['orientation']
  • $imageInfo['tags']
  • $imageInfo['thumbnailName']