Chameleon Installation and Upgrading Instructions

Chameleon follows the standard Geeklog plugins procedure.  Below we will
document 2 methods to install the Chameleon files, via FTP and via standard
shell access to the server.


Recommended Installation method(Windows limitation)

I will recommend the installation that uses wkyGeeklogInstaller. 

wkyGeeklogInstaller is software that can easily install Geeklog. 
Only Drug & Drops on the screen after downloading, acquiring a special file 
that writes the setting for the installation etc. that are called recipe 
corresponding to the installation of the plug-in and the theme, and starting 
wkyGeeklogInstaller and it is possible to install it. 

wkyGeeklogInstaller download
http://hiroron.com/filemgmt/viewcat.php?cid=3
- Please choose the one of the latest version and download it. 

Recipe download http://hiroron.com/filemgmt/index.php? for chameleon 
theme plug-in installationid=148


FTP Installation

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 Geeklog 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-1.0.1-1.4.1.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-geeklog/plugins/ directory.

To find the path-to-geeklog you can look in your Geeklog config.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 FTPs below you will actually
drag the files, not the parent directory.

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

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

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

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-geeklog/
   |                      |
   + chameleon\            + backups/
             |             + data/
             + admin/---+  + include/
                        |  + language/
                        |  + logs/
                        |  + pdfs/
                        |  + plugins/
                        |  + public_html/
                        |               + admin/
                        |                      + plugins/
                        +---------------------------->  + chameleon/
                           + sql/
                           + system/
                           + config.php


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

path-to-geeklog/
               |
               + backups/
               + data/
               + include/
               + language/
               + logs/
               + pdfs/
               + plugins/
               + public_html/
               |             |
               |             + layout\
               |                     |
               |                     + chameleon <--- Make this subdirectory
               + sql/
               + system/
               + config.php

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-geeklog/
   |                          |
   + chameleon\               + backups/
             |                + data/
             + themefiles/+   + include/
                          |   + language/
                          |   + logs/
                          |   + pdfs/
                          |   + plugins/
                          |   + public_html/
                          |                + layout/
                          +--------------------->  + chameleon/
                              + sql/
                              + system/
                              + config.php

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

Standard Shell Access Installation

   1. Uncompress the Chameleon plugin archive while in the
      path-to-geeklog/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-geeklog/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.

Online Installation

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

   1. 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 Geeklog
      error.log in path-to-geeklog/logs/ to see what the problem was. Fix the
      problem and re-install.

   2. 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, edit your {path_to_geeklog}/config.php and on
      line 199 change the default theme from "professional" to "chameleon":

      $_CONF['theme']             = 'chameleon';  // default theme

   3. Navigate to http://yoursite/admin/plugins/chameleon/index.php and change
      the theme elements as you desire, and click Save to update your theme.


Standard Upgrade Process

   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 Geeklog Plugins Menu (from the Geeklog 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.