Installation

Media Gallery follows the standard glFusion plugin installation procedure. Below we will document two methods to install the Media Gallery files, via FTP and via standard shell access to the server.

If you do not have shell access to your server and can only use an FTP client to access your server, follow these instructions.

To install Media Gallery, or any glFusion plugin, you will need to un-archive the plugin on your local computer. The Media Gallery distribution will automatically create all the proper directories when it is un-archived.

To un-archive a .gz file, you can use later copies of WinZIP or WinRAR. If you are running Mac OSX, please ensure you have the latest version of StuffIt installed.

• Create a temporary directory on your local hard drive to hold the Media Gallery files (let's use C:\tmp for our example).
• Open the mediagallery-1.6.0-1.4.0.tar.gz file with WinRAR.
• Select Extract All Files and point to the C:\tmp directory as the destination.

Now we should have a local copy of the Media Gallery Plugin in C:\tmp

The directory should look like this:

Now that you have a copy on your local hard drive, it is time to FTP upto your server.

Start your FTP program, I recommend FileZilla if you do not have a program you use already. FileZilla is free and supports many different operating systems (Windows, Linux, etc.).

Connect to your web server with your FTP program.

Our first FTP will be the entire Media Gallery distribution to your server. You will want to use the diagrams below to find the proper directory on your server and move the entire c:\tmp\mediagallery\ directory to the path-to-glfusion/plugins/ directory.

To find the path-to-glfusion you can look in your glFusion config.php file and see what directory is defined in the $_CONF['path'] line.

tmp\                path-to-glfusion/
   |                               |
   + mediagallery\--+              + backups/
                    |              + data/
                    |              + include/
                    |              + language/
                    |              + logs/
                    |              + pdfs/
                    +------------->+ plugins/
                                   + public_html/
                                   + sql/
                                   + system/
                                   + config.php

Next, you will need to make a sub-directory under the public_html directory on your server called mediagallery. For most FTP programs you can create directories by highlighting the parent directory, public_html in this case, then right click the mouse, select New Folder and name it mediagallery. This procedure may be a little different depending on which FTP program you are using, check their documentation.

path-to-glfusion/
               |
               + backups/
               + data/
               + include/
               + language/
               + logs/
               + pdfs/
               + plugins/
               + public_html/
                            |
                            + mediagallery <--- Make this subdir
               + sql/
               + system/
               + config.php

Next you will need to FTP all the files from the c:\tmp\mediagallery\public_html\* directory to your server. Here you will want to select all the files and sub-directories in the public_html\ directory, not just the public_html\ folder. Follow the diagram below:

tmp\                 path-to-glfusion/
   |                                |
   + mediagallery\                  + backups/
                 |                  + data/
                 + public_html/*-+  + include/
                                 |  + language/
                                 |  + logs/
                                 |  + pdfs/
                                 |  + plugins/
                                 |  + public_html/
                                 |               |
                                 +-------------->+ mediagallery/
                                    + sql/
                                    + system/
                                    + config.php

Next, you will need to make a sub-directory under the admin/plugins/ directory on your server called mediagallery.

path-to-glfusion/
               |
               + backups/
               + data/
               + include/
               + language/
               + logs/
               + pdfs/
               + plugins/
               + public_html/
               |       |
               |       + admin\
               |           |
               |           + plugins\
               |                  + mediagallery <--- Make this subdir
               + sql/
               + system/
               + config.php

Next you will need to FTP all the files from the c:\tmp\mediagallery\admin\* directory to your server. Here you will want to select all the files and sub-directories in the admin\ directory, not just the public_html\ folder. Follow the diagram below:

tmp\            path-to-glfusion/
   |                           |
   + mediagallery\             + backups/
                 |             + data/
                 + admin/---+  + include/
                            |  + language/
                            |  + logs/
                            |  + pdfs/
                            |  + plugins/
                            |  + public_html/
                            |            + admin/
                            |                 + plugins/
                            +-----------------------> + mediagallery/
                               + sql/
                               + system/
                               + config.php

Congratulations! You should now have all the files uploaded to your server and you are ready to skin to the Online Installation step below.

• Backup your glFusion database because the Media Gallery plugin adds tables. You can do this with the built in database backup facility in the Admin menu.
• Uncompress the Media Gallery plugin archive while in the path-to-glfusion/plugins directory. The archive will create a directory called mediagallery.
• Under your <public_html> directory, create a directory called mediagallery.
• Under <public_html>/admin/plugins/ directory, create a directory called mediagallery.
• Change to your path-to-glfusion/plugins/mediagallery directory.
• Copy the files in the admin directory to the admin/plugins/mediagallery directory you created in step 4.
• Copy the files in the public_html directory to the public_html/mediagallery directory you created in step 3.

Now that you have the files loaded on your server, it is time to actually perform the Media Gallery installation into glFusion.

• Go to the plugin administration page. The Media Gallery plugin should show up with a link to install it. Click this link. The install page will tell you if it was successful or not. If not, examine the glFusion error.log in path-to-glfusion/private/logs/ to see what the problem was. Fix the problem and re-install.
• The install page will offer you a link to the configuration page of Media Gallery. You should select this link and make the necessary changes to Media Gallery configuration to suit your environment.