Chameleon Installation and Upgrading Instructions

Chameleon follows the standard glFusion plugins procedure. Below we will document 2 methods to install the Chameleon 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 Chameleon, or any glFusion plugin, you will need to un-archive the plugin on your local computer. The Chameleon 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.

1. Create a temporary directory on your local hard drive to hold the Chameleon files (let's use C:\tmp for our example).
2. Open the chameleon-2.0.0-1.0.0.tar.gz file with WinRAR.
3. Select Extract All Files and point to the C:\tmp directory as the destination.

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

The directory should look like this:

+tmp\
    + chameleon\
               + admin\
               + docs\
               + language\
               + public_html\
               + templates\
               + themefiles\
               + functions.inc

Now that you have a copy on your local hard drive, it is time to FTP up to 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 Chameleon 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\chameleon\ directory to the path-to-glfusion/private/plugins/ directory.

To find the path-to-glfusion/private you can look in your glFusion siteconfig.php file and see what directory is defined in the $_CONF[‘path’] line.

SPECIAL NOTE: For the initial FTP of the Chameleon distribution, you will want to actually drag the chameleon folder from your local computer to the plugins directory on your server. The remaining FTP’s below you will actually drag the files, not the parent directory.

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

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

path-to-glfusion/
               |
               + private/
               + public_html/
                            |
                            + admin\
                                   |
                                   + plugins\
                                             + chameleon <--- Make this subdirectory

Next you will need to FTP all the files from the c:\tmp\chameleon\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 map below:

tmp\       path-to-glfusion/
   |                       |
   + chameleon\            + private/
             |             |
             + admin/---+  + public_html/
                        |               + admin/
                        |                      + plugins/
                        +---------------------------->  + chameleon/

Next, you will need to make a sub-directory under the layout/ directory on your server called chameleon.

path-to-glfusion/
               |
               + private/
               + public_html/
                             |
                             + layout\
                                     |
                                     + chameleon <--- Make this subdirectory

Next you will need to FTP all the files from the c:\tmp\chameleon\themefiles\* 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 map below:

tmp\           path-to-glfusion/
   |                           |
   + chameleon\                + private/
             |                 |
             + themefiles/+    + public_html/
                          |                + layout/
                          +--------------------->  + chameleon/

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

1. Uncompress the Chameleon plugin archive while in the path-to-glfusion/private/plugins directory. The archive will create a directory called chameleon.
2. Under public_html/admin/plugins/ directory, create a directory called chameleon.
3. Under public_html/layout/ directory, create a directory called chameleon.
4. Change to your path-to-glfusion/private/plugins/chameleon directory.
5. Copy the files in the admin directory to the admin/plugins/chameleon directory you created in step 2.
6. Copy the files in the themefiles directory to the public_html/layout/chameleon directory you created in step 3.

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

• Go to the plugin administration page. The Chameleon 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.

• If you would like to change the theme for only you, login to your site as the root administrator and click on My Account in the User Functions block. Then click on the Layout & Language tab, and choose “Chameleon” under the Theme dropdown box. If you would like to make your entire site use the chameleon theme, go into the online configuration, choose Theme and set chameleon as the default theme.

• Navigate to {your_site}/admin/plugins/chameleon/index.php and change the theme elements as you desire, and click Save to update your theme.

1. BACK UP YOUR EXISTING ENVIRONMENT!
2. SAVE YOUR TEMPLATES IF YOU HAVE MADE MODIFICATIONS! You will need to re-apply your customizations to the templates after the upgrade.
3. Refer to the installation instructions for New Installations for detailed instructions on uploading the new Chameleon distribution to your server.
   
   If you are prompted to overwrite existing files, be sure to answer Yes.
   
   
4. Go to the glFusion Plugins Menu (from the glFusion Administrator's menu).
5. Select the Chameleon plugin.
6. You should have an UPDATE button, select it.
7. If all goes well, the upgrade should be complete. If there were errors, please review your logs/error.log and correct any issues and try the UPDATE again.