“Facebook Gallery” Documentation by “Jordie Bodlay” v1.5.0

“Facebook Gallery - Installation Guide”

Originally Created: 14th July 2011
By: Jordie Bodlay
Email: jordie@jordie.org

Thank you for purchasing Facebook Gallery. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here.

If you like this product, please consider rating it 5 stars on CodeCanyon.net via the page you downloaded it from.

Table of Contents

Introduction - top

Facebook Gallery is a PHP script designed to allow you to quickly add and display a collection of albums on your website from multiple Facebook pages or user accounts.

Installing Facebook Gallery is easy. If you have any problems or require any help, don't hesitate to contact me via my profile page on codecanyon.net.

Facebook Gallery requires the use of a MySQL database. Please ensure you have your database details ready for installation. These can usually be found in your web-hosting control panel.

Step 1 - Database Details - top

Before you upload anything to your website, in the fbgallery directory you will find a file called fbg_config.php. Edit this file with a text editor and insert your MySQL database details. These are the lines to change: define ('FBG_DB_HOST', 'localhost');
define ('FBG_DB_USER', '');
define ('FBG_DB_PASS', '');
define ('FBG_DB_NAME', '');

As an example, lets say your hostname stays as localhost (usually the case, and if you can't find what your hostname is, it will probably be 'localhost'), your username is my_user, your password is example and your database name is my_database, then this is what you should have: define ('FBG_DB_HOST', 'localhost');
define ('FBG_DB_USER', 'my_user');
define ('FBG_DB_PASS', 'example');
define ('FBG_DB_NAME', 'my_database');

Step 2 - Upload - top

Upload the files from the package using FTP to a location that is accessible via the web. It is usually best to upload these files to their own folder, such as a folder called fbgallery that would be located at http://www.example.com/fbgallery/.

Once the files are uploaded, you will see a folder called photos. You must make this directory writeable. For unix-based servers, this means using your FTP client to CHMOD this diretory to 757 or 775 (depending on your server set up).

Step 3 - Web Installation - top

Once the files are located somewhere that is accessible via the web, you'll be able to install the script (provided your MySQL details are correct). Navigate to the admin folder in your installation. For example, if you installed the Facebook Gallery script at http://www.example.com/fbgallery/ then point your web-browser to http://www.example.com/fbgallery/admin/

Once the page has loaded, it will ask you for a username and a password to set for the control panel access. Enter your desired username and password and click 'Install'. If the installation is successful, you'll be redirected to the control panel to login.

From here you can use the control panel to add albums.

Step 4 - Accessing the Control Panel - top

After the web installation, you will be directed to your control panel. You can login using the username and password you selected during installation.

For future use, your control panel can always be accessed at http://www.example.com/fbgallery/admin/.

For more information on using the Control Panel, see the Gettings Started Guide.

Step 5 - Viewing the Gallery - top

Using the above installation example, you can view your gallery at http://www.example.com/fbgallery/fbgallery.php. When viewing the control panel, you can click on the "View Gallery" link in the top right and it will take you to this page.

Installing the Facebook Gallery Plugin to Wordpress - top

Facebook Gallery is really easy to include into Wordpress. A plugin has been included to make this step simple. In the ZIP file that you downloaded from CodeCanyon, you will see a directory called wordpress_plugin. Inside this directory is a file called fbgallery.php. Upload this file into the plugins directory in your Wordpress installation. This should be: wp-content/plugins/.

Once it is located in the correct folder, login to your Wordpress admin and click on 'Plugins' on the left menu. You will now see "Facebook Gallery" listed among the plugins. Click the "Activate" link below it to enable the plugin.

Once activated, click the arrow next to "Settings" on the left menu to expand the sub-menu.

Then click the "Facebook Gallery" link.

You will then be presented with a page like the following, with 2 options.

The "Gallery Path" will be blank to begin with, you need to enter the path on your server to the Facebook Gallery directory. (note: this is the server path and not the URL). You can click the "Find it for me" button and the plug-in will attempt to find the installation. If it is not successful in finding the Facebook Gallery, see below. The other options allow you to select what Page in Wordpress the FAQ should be displayed on. If you haven't yet made a page, create a page (not a post) now, then return to this page and select that page from the list. Once you click "Save Changes", you will be able to view the specified page and your gallery will display.

If the "Find it for me" button was not successful in finding the Facebook Gallery, you'll need to go to your Facebook Gallery admin and click on the 'Script Info' in the top right. You should see something like the below:

Copy the section that reads /full/path/to/fbgallery/ (you don't need the filename "fbgallery.php", but even if you copy it the plugin will remove it for you).

Including into another PHP Script - top

If you're installing into any other PHP script, you can use the following code:

<?php
include("/full/path/to/fbgallery/fbgallery.php");
?>

Make sure you replace /full/path/to/fbgallery with the correct full path to where the Facebook Gallery script resides on your server (Note: this is the path on your server, NOT the URL that you may use in a web browser)

If you are unsure what your full path is, navigate to your Facebook Gallery control panel and in the top right, click 'Script Info'. At the middle of the dialog that pops up, there will be the code you can use specific for your server.

Once again, thank you so much for purchasing this script. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. If you have a more general question relating to the themes on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.

If you like this product, please consider rating it 5 stars on CodeCanyon.net via the page you downloaded it from.

Jordie Bodlay

Go To Table of Contents