Frequently Asked Questions

General Usage:
How do I view an image?
1. First you must make sure that the image has been uploaded to the specified Gallery folder on your web server.
2. Once the file is uploaded, phpg will show you a thumbnail image of it.
3. Simply click this thumbnail image to view a larger sized version and with more options.
Top

How do I create a new folder?
1. First, browse to where you want to create the folder by clicking on the folder names on the main page.
2. Once you are in the location you wish the new folder to be created in, click the "Add" icon at the top right of the page.
3. A box will appear for you to type the folders name into.
4. Finally, click the "Create Folder" button.
Once your new folder is created, you will automatically be taken to the Upload Files page to upload files into your new folder.
Top

How do I upload my files?
1. First, browse to where you want the new files to be uploaded to.
2. Click the "Upload" link in the top right corner of the page.
3. Once the "Upload Files" page loads, user the "Add" button to locate and add your files.
4. Finally, click the upload button in the bottom left corner.

You can also upload your files via FTP directly into the Gallery folder. As there are no database entries to update, just upload your files and hit refresh. Top

How do I rename a folder?
1. First you must navigate to where the folder is located.
2. Click the "Rename Folder" icon to the far right of the folder you want to rename.
3. In the Rename Folder box that appears, type the new name of the Folder.
4. Finally, click the "Rename Folder" button.
Top

Why can't I delete files/folders with phpg?
The reason there is no option to delete either files or folders is to prevent new users from accidently deleting entire folders of files unwittingly. This feature may be brought in later on with some safe guards but for now it has been left out intentionally.
Top

I try and upload my files but nothing happens, what's wrong?
Due to security issues with uploading files, you are only aloud to upload certain file types. The file uploader software that is used with phpg doesn't allow you to select file types that are not supported by the Gallery. By default the following files ARE supported by phpg but may have been changed by the administrator. For a live list of supported file types visit the "Gallery Info" link at the top of your Gallery page.
Supported Upload File Types:
Images:
.gif (image/gif)
.jpe, .jpeg, .jpg (image/jpeg)
.png (image/png)
.tif, .tiff (image/tiff)
.bmp (image/bmp)

Video's:
.avi (video/x-msvideo)
.mov, .qt (video/quicktime)
.mpe, .mpeg, .mpg (video/mpeg)
.mp4 (video/mp4)
.3gp (video/3gpp)

Another issue to check is the "upload_max_filesize" variable in your php.ini file. If for instance, this is set to say "2M", then your max upload file size will only be a 2MB file.
To fix this you must have access to your web servers php.ini file.
1. Open php.ini
2. Browse to the line "upload_max_filesize ="
3. Set it to "upload_max_filesize = 10M" (or what ever size you prefer)
4. Save the file
Top

Sometimes when I rotate a photo it doesn't rotate, what's wrong?
When your computer downloads an image, it stores it in a cache so that it doesn't have to download it again. If you ever rotate an image and find that it doesn't do anything, it's most likely because your computer is just using this cached photo instead of downloading the new, rotated photo. To fix this, hold the CTRL key and click the Refresh button of your browser, this will force your computer to re-download the photo again and you should find that it is rotated.
Top


Installation:
Where can I download the latest version from?
The latest version of phpg is available to download for free from here.
Top

How do I point phpg to MY Gallery?
1. Brose to your Gallery on the web and click the "ADMIN" button at the bottom, then log in.
2. In the "Gallery Path:" section, enter in the relative path to your files.
For example, if you have a folder in the same directory as your phpg code called "My Gallery" you would change this variable to "My Gallery". This variable also works if the Gallery is up or down a number of directories, simply use "../My Gallery" for up a directory or "Sub-Dir/My Gallery" for down a directory.
Top

How do I set the password for my Gallery?
1. Brose to your Gallery on the web and click the "ADMIN" button at the bottom, then log in.
2. In the "Gallery Password:" section, click the "Change Gallery Password" button.
3. A new popup should appear. Enter in the old Gallery password ("password" by default), and then enter in your new password and click "Save Changes".
Top

How do I set the heading for my Gallery?
1. Brose to your Gallery on the web and click the "ADMIN" button at the bottom, then log in.
2. In the "Gallery Heading:" section, enter in the heading for your Gallery.
Top

How should I setup phpg's file structure on my web server?
It is recommended to setup the file structure as described below. The main folders (not bolded) shouldn't be moved as this will break the code, however the "Gallery" folder that houses all of your Photo's and Video's can be moved anywhere so long as your "Gallery Path" is updated. It is suggested to keep your Gallery folder as shown though as this is how the testing environment is setup and thus the phpg code will most likely work better with this structure.
- Gallery
 -> Admin
 -> Gallery
 -> Images
 -> Javascripts
 -> phpThumb
 - phpg files...
Top


Trouble Shooting:
Why does it keep saying my Google Maps key is wrong?
This is because you haven't setup the global variable $GOOGLEMAPS_KEY.
1. Go to: http://code.google.com/apis/maps/signup.html
2. Sign up your specific domain name for the Google Maps API.
3. Once assigned a key, save it to a file.
4. Brose to your Gallery on the web and click the "ADMIN" button at the bottom, then log in.
5. In the "Google Maps Key:" section, copy and paste the saved key into the text box and click "Save Changes".
Top

Why can't I view or create folders/files with an apostrophe (') in them?
PHP normally comes with a feature automatically turned on called "Magic Quotes". Magic Quotes is a process that automagically escapes incoming data to the PHP script. Basically, when phpg "gets" the data from the URL or from a previous page, Magic Quotes automatically inserts a "\" where ever there is an apostrophe. This then causes errors as there is no such file as "John\'s Cake.jpg".
To fix this you must have access to your web servers php.ini file.
1. Open php.ini
2. Browse to the line "magic_quotes_gpc ="
3. Set it to "magic_quotes_gpc = Off"
4. Save the file
Top


Upgrading:
How will I know when I need to upgrade?
phpg has built in code that will notify you of when there is a new version present. Simply go to the "Gallery Info" link at the top of your Gallery and it will check if your version is up to date. Another way is to simply check the download page.
Top

What do I need to do to upgrade my version of phpg?
When you are notified that you can upgrade your phpg code (or you just wish to) follow these steps.
1. Download the latest phpg version from here.
2. Extract the files and upload the code to your web server.
3. Browse to the location you uploaded the new files to and click the "ADMIN" link at the bottom.
4. Once you have logged in (the default password is "password"), you can setup phpg.
NOTE: It is highly suggested you keep a backup copy of your previous phpg code before performing the upgrade.
It is also suggested that you don't overwrite the "phpThumb\cache" folder, otherwise your server will have to generate all it's thumbnails again from scratch which can slow things down.
Top