I. Setting up ...

  1. Make a backup of your files!
    Always nice to have a backup befor you mess arround with the system

  2. Install the plugin loader, if not already done!
    More informations about the plugin loader can be found here http://www.cmsimplewiki.com/doku.php/pluginloader/start

  3. Download the gallery plugin, unzip and keep the folder structure

    The folder structure will look something like this:
    +-GALLERY
    | index.php
    | admin.php
    | |
    | +-LANGUAGES
    | | da.php
    | | de.php
    | | en.php
    | | nl.php
    | |
    | +-CSS
    | | stylesheet.css
    | |
    | +-CONFIG
    | | config.php
    | |
    | +-HELP
    | | help.htm
    | |
    | +-LIBS

  4. Upload the folder gallery and it's content to the folder called PLUGINS (the plugin loader)

    After the upload to the plugin folder your structure should look like below:

    The folder structure will look something like this:
    +-PLUGINS
    | index.php
    | admin_common.php
    | |
    | +-GALLERY
    | | index.php
    | | admin.php
    | | |
    | | +-LANGUAGES
    | | | da.php
    | | | de.php
    | | | en.php
    | | |
    | | +-CSS
    | | | stylesheet.css
    | | |
    | | +-CONFIG
    | | | config.php
    | | |
    | | +-HELP
    | | | help.htm
    | | |
    | | +-LIBS

  5. Login to CMSimple to edit/create pages in cmsimple.dk

  6. Create a gallery page
    Code like this:

    <h1>Gallery</h1>
    #CMSimple $output.= gallery('gallery/test/');#

    This code will create a page called Gallery in CMSimple and on the webserver it will create a folder called gallery with the subfolder test insinde it.

    If you after saving the page go to 'NORMAL MODE' you should see a page like below

    #########


    Now your gallery have been setup and you are ready to use it.

  7. Putting pictures to the gallery
    You can upload pictures to the gallery using 2 methods,

    1. FTP upload via your favorite FTP program, this method is prefered if you have to upload a lot of pictures. You must put your .jpg pictures in the forlder created by the script in step 6. gallery/test/

    2. Upload via the gallery admin part, login to the CMSimple, select the gallery from the avaliable plugins dropdown box and then press the Gallery settings button up load via the upload form at the bottom of the page (see below).
      Also the version of GD is read out when in this menu.

      #########

  8. Generating the files
    If you access your gallery page Gallery, created in step 6 the gallery plugin should generate the thumbnails and the files for comments and other stuff.

  9. Change the settings
    In the gallery plugin configuration different settings for the gallery can be changed.

    #########

  10. Trouble shooting
    If you run into problems during the installation please go to http:// and look for advice.



II. Advanced usage ...

  1. Use a Lightbox-script to show your pictures:
    There are two ways to replace the PopUp with a lightbox-script:


  2. Multiple configurations and / or css-files on your site:

    You can define different css and / or config - settings to every CMSimple-page that contains a gallery on your site.
    Just call your gallery with a additional parameter:

    #CMSimple $output.= gallery('gallery/test/','MyOtherConfig');#


    and make sure that 'MyOtherConfig' refers to a copy of config.php and / or stylesheet.css with
    the different settings you prefer for this gallery-page.

    Note: 'MyOtherConfig' must give without an extension, but you have to create a file 'MyOtherConfig.php' and / or 'MyOtherConfig.css' in the config- or stylesheet-folder.
    Unfortunaly you can't create or edit this additional configuration-files by the plugins admin-area until now.
    Please use your local editor and ftp these files on your webhotel.

  3. How to get rid from the gallery-mainpage with the comments and extra-infos:

    Follow this steps, if you don't need the details-page and you want to show the big picture direct from the thumbs-page:



Config settings:

Setting Values Description
addcomment redir to thumbview: true/false Set to "true" to redirect to thumb-page after a comment is added
check for gd true/false If set to "true" the gallery checks for installed GD-Lib and show the version
main max size xxx Max. size of the picture on main(details)-page in px
memory limit xxM The memorylimit for uploads in Mb accepted by the gallery (maybe your server accept another value)
multilanguage comments true/false Set to "true" to enable multilanguage-comments
nav position details top/bottom/both Position of navigation on the main(details)-pages
nav position thumb top/bottom/both Position of navigation on the thumb-pages
number of thumbs xx The number of thumbs per page
on the fly images true/false Set "true" to enable watermarking of your pictures
show bigpic direct from thumb true/false Set to "true" to skip the details-page and get a PopUp or Lightbox direct from thumb-page
show comments true/false Set to "true" to show the comments and the comment-form
show extrainfo true/false Set to "true" to show the extrainfo-fields
show nbr of pics true/false Set to "true" to show the headline "xx Pictures in this folder"
show search true/false Set to "true" to show the search-form
show title true/false Set to "true" to show the picture-title
thumb crop true/false Set to "true" to get quadrate thumbs with height = width
thumb quality xx The quality of the thumbs created by the plugin (75)
thumb size xxx The size (width in px) of the thumbs created by the plugin
title placement top/bottom The placement of the title
use external lib xxxxxxxxx External JS-library to load by the plugin (refers to a subfolder-name of "/libs/"
use lightbox true/false Set to "true" to replace the PopUp by a Lightbox-script
use rel attrib xxxxxxxxx The string of the "rel=..." attribute, according to your Lightbox-script
watermark color xxxxxx The hex-color of the watermark text without the leading '#'
watermark font size xx Font-Size of the watermark in px
watermark h align left/center/right The horizontal alignment of the watermark
watermark margin x The size of a margin around the watermark in px (0)
watermark text Your text Enter the text for your watermark here
watermark v align top/center/bottom The vertical alignment of the watermark


Changes to Svarrers latest v0.9 ...