.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =========== wt\_gallery =========== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2010-04-30T22:10:48 :Classification: TYPO3 Extension: Galerie :Author: Alex Kellner :Email: Alexander.Kellner@einpraegsam.net :Info 3: :Info 4: .. _wt-gallery: wt\_gallery =========== Extension Key: **wt\_gallery** Copyright 2005-2010, Alex Kellner, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **wt\_gallery 1** **Introduction 2** What does it do? 2 What's new in version 3.0? 2 **Screenshots 3** Einpraegsam Portfolio: 3 IRONMAN Malaysia Photo gallery: 5 Art gallery: 6 **Users manual – step by step 7** **Example Setup 8** Plugin configuration via Flexform 8 Example TypoScript: 12 **Features 21** Cooliris (PicLens) use 21 Lightbox use 23 TXT and EXIF information for any view: 26 Different menus for list- or categoryview 29 Using dynamic typoscript or locallang marker in any html template: 31 Realurl example: 32 **FAQ 34** Main 34 Errormessages 35 **Changelog 36** Version 3.1.x beta 36 Version 3.0.x alpha 36 Version 2.x stable 37 **Todo 40** Main features: 40 If you found/need a: 40 **Additional links 41** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ It is a easy to install Photo gallery extension with separate category-, list- and single view – just insert a folder (like fileadmin/pictures) to show all pictures and folders of this folder. The good old wt\_gallery don't need values from database – just pictures on the server - Easy Installation with Flexform or TypoScript - List view without table (only DIV) - Manipulation via html templates of all views possible - TXT Files or EXIF can explain the listed picture (pic.jpg -> pic.jpg.txt in the same folder) - Subgallery mode possible (shows different categories) .. _What-s-new-in-version-3-0: **What's new in version 3.0?** ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ wt\_gallery 3.0 is complete new extension! That's why wt\_gallery goes back to alpha status for now. **You can't update wt\_gallery from version 2.x to 3.x!** - 3.0 is COMPLETELY NEW PHP CODE - Configuration complete via typoscript - Definition of images via typoscript or flexform - No limit of categories (folders to show) - Category pictures could be listed in rows and columns (like list view) - Image Magick is used (no more gdlib) - TYPO3 caching will be used - Pagebrowser for listview AND for categorie view possible - Pagebrowser will be filled with a HMENU – so manipulate it as you want - Dynamic typoscript possible (as known from powermail or wt\_directory) - Dynamic locallang marker possible (as known from powermail or wt\_directory) - No more german manual (sorry – too much work on an upgrade) - Describe picture via text files (now with more parts – title, subject, commentary, brand, etc...) - Localized picture description via different text files - **NEW:** Cooliris (Piclens) RSS included - **NEW:** Cooliris (Piclens) Frontend Plugin .. _Screenshots: Screenshots ----------- .. _Einpraegsam-Portfolio: Einpraegsam Portfolio: ^^^^^^^^^^^^^^^^^^^^^^ .. _Category-choose: Category choose """"""""""""""" |img-1| .. _Gallery-list-and-singleview: Gallery list- and singleview """""""""""""""""""""""""""" |img-2| `http://www.einpraegsam.net/fotogalerie.html `_ .. _Cooliris-listview-integration-in-Frontend: Cooliris listview integration in Frontend """"""""""""""""""""""""""""""""""""""""" |img-3| `http://www.einpraegsam.net/fachgebiete/typo3-extensions/wt- gallery.html `_ .. _IRONMAN-Malaysia-Photo-gallery: IRONMAN Malaysia Photo gallery: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Gallery-for-tough-guys: Gallery for tough guys """""""""""""""""""""" .. _img-4: |img-4| """"""" .. _Art-gallery: Art gallery: ^^^^^^^^^^^^ .. _Really-small-thumbnails-at-the-bottom: **Really small thumbnails at the bottom** """"""""""""""""""""""""""""""""""""""""" |img-5| .. _Users-manual-step-by-step: Users manual – step by step --------------------------- - Import wt\_doorman (min. 0.2.1) from TER - Import wt\_gallery from online repository - Use Flexform or TypoScript for configuration (see below) - 2 configuration values are NEEDED:- Mode: single- or list- or categoryview- Picturepath: start point for picture path - Many configuration possibilities via TypoScript available (see below) .. _Example-Setup: Example Setup ------------- .. _Plugin-configuration-via-Flexform: Plugin configuration via Flexform ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Main-configuration: Main configuration """""""""""""""""" .. _Screenshot: Screenshot ~~~~~~~~~~ |img-6| .. _Explanation: Explanation ~~~~~~~~~~~ **Show:** This is the gallery mode – what should the plugin do (Show a single picture, show list of pictures of a folder, show folder list) **Pic Folder:** Please select the path to the picture folder like fileadmin/path/. **NOTE:** If the field Pic Folder is not shown on your sytem, you can enable the old style field in the extension manager (if you click on wt\_gallery) **NOTE:** All configuration could be also done via typoscript .. _Single-configuration: Single configuration """""""""""""""""""" .. _Screenshot: Screenshot ~~~~~~~~~~ |img-7| .. _Explanation: Explanation ~~~~~~~~~~~ **Picture width:** Define single picture width (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Picture height:** Define single picture height (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Page with single view:** If you are using the Single view on another PID, you can choose this page (empty if single and list in the same page) **NOTE:** All configuration could be also done via typoscript **NOTE2:** Do you like quadratical images? Example use: width 100c / height 100c .. _List-Configuration: List Configuration """""""""""""""""" .. _Screenshot: Screenshot ~~~~~~~~~~ |img-8| .. _Explanation: Explanation ~~~~~~~~~~~ **Picture width:** Define list picture width (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Picture height:** Define list picture height (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Page with list view:** If you are using the List view on another PID, you can choose this page (empty if single and list in the same page) **Number of columns:** Define the number of columns for the list view (1 for all pictures in one line, etc...) **Number of rows:** Define the number of rows for the list view **NOTE:** All configuration could be also done via typoscript **NOTE2:** Do you like quadratical images? Example use: width 100c / height 100c **NOTE3:** [Number of columns] x [Number of rows] are the allowed number of pictures on one page – if overall is greater than this allowed number a page browser will be shown .. _Category-Configuration: Category Configuration """""""""""""""""""""" .. _Screenshot: Screenshot ~~~~~~~~~~ |img-9| .. _Explanation: Explanation ~~~~~~~~~~~ **Picture width:** Define list picture width (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Picture height:** Define list picture height (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Number of columns:** Define the number of columns for the list view (1 for all pictures in one line, etc...) **Number of rows:** Define the number of rows for the list view **NOTE:** All configuration could be also done via typoscript **NOTE2:** Do you like quadratical images? Example use: width 100c / height 100c **NOTE3:** [Number of columns] x [Number of rows] are the allowed number of pictures on one page – if overall is greater than this allowed number a page browser will be shown .. _Cooliris-Configuration: Cooliris Configuration """""""""""""""""""""" .. _Screenshot: Screenshot ~~~~~~~~~~ |img-10| .. _Explanation: Explanation ~~~~~~~~~~~ **Picture width:** Define cooliris picture width (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Picture height:** Define cooliris picture height (200 for 200 pixel, 200m for maximum width of 200 pixel, 200c for a crop after 200 pixel) **Width of cooliris window (px):** Define the width of the flash plugin in the frontend **Height of cooliris window (px):** Define the height of the flash plugin in the frontend **NOTE:** All configuration could be also done via typoscript **NOTE2:** Do you like quadratical images? Example use: width 100c / height 100c **NOTE3:** See details below to cooliris .. _Example-TypoScript: Example TypoScript: ^^^^^^^^^^^^^^^^^^^ You can use TypoScript instead of Flexform – Note: If there are configurations in Flexform and in TypoScript, Flexform configuration has the priority. Setup and Constants are saved in the files ext\_typoscript\_setup.txt and ext\_typoscript\_constants.txt in the Extension folder. .. _Setup: Setup: """""" :: # WT_GALLERY PLUGIN # includeLibs.user_wtgallery_pagebrowser = EXT:wt_gallery/lib/user_wtgallery_pagebrowser.php # main settings plugin.tx_wtgallery_pi1 { # Constants template.single = {$plugin.wtgallery.template.single} template.category = {$plugin.wtgallery.template.category} template.list = {$plugin.wtgallery.template.list} template.cooliris = {$plugin.wtgallery.template.cooliris} main.mode = {$plugin.wtgallery.main.mode} main.path = {$plugin.wtgallery.main.path} main.file_extensions = {$plugin.wtgallery.main.file_extensions} main.DIVforRows = {$plugin.wtgallery.main.DIVforRows} # Single view settings single { # Constants pid_single = {$plugin.wtgallery.single.pid_single} width = {$plugin.wtgallery.single.width} height = {$plugin.wtgallery.single.height} order = {$plugin.wtgallery.single.order} metainformation = {$plugin.wtgallery.single.metainformation} # Single image image = IMAGE image { # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension # Information from txt/EXIF: comments, title, subject, author, recordtime, cam_brand, cam_model wrap =
|
file.import.field = picture file.width = {$plugin.wtgallery.single.width} file.height = {$plugin.wtgallery.single.height} altText.field = basename titleText.field = filename params = class="wtgallery wtgallery_single" if.isTrue.field = picture # popup definition imageLinkWrap = 1 imageLinkWrap.enable = 1 imageLinkWrap { bodyTag = wrap = | JSwindow = 1 JSwindow.newWindow = 1 } } # Text from txt file or EXIF information to single image text = COA text { # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension # Information from txt/EXIF: comments, title, subject, author, recordtime, cam_brand, cam_model wrap =
|
if.isTrue.field = title 10 = TEXT 10.field = title 10.wrap =
|
10.if.isTrue.field = title 20 = TEXT 20.field = comments 20.wrap =
|
20.if.isTrue.field = comments } # Link to the listview below picture (only if listview and singleview are not on the same page) # available variables for .field are: listview_link listviewlink = TEXT listviewlink { wrap =

|

data = LLL:EXT:wt_gallery/pi1/locallang.xml:wtgallery_ll_listviewlink typolink.parameter.field = listview_link if.isTrue.field = listview_link } ######################################### # Example for your marker ###ANYMARKER### ######################################### # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension # Information from txt/EXIF: comments, title, subject, author, recordtime, cam_brand, cam_model anymarker = TEXT anymarker { field = picture wrap = | } } # List view settings list { # Constants pid_list = {$plugin.wtgallery.single.pid_list} order = {$plugin.wtgallery.list.order} limit = {$plugin.wtgallery.list.limit} width = {$plugin.wtgallery.list.width} height = {$plugin.wtgallery.list.height} rows = {$plugin.wtgallery.list.rows} columns = {$plugin.wtgallery.list.columns} metainformation = {$plugin.wtgallery.list.metainformation} # List preview image image = IMAGE image { # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension, currentfolder, picturehash, pid_single, link_single # Information from txt/EXIF: comments, title, subject, author, recordtime, cam_brand, cam_model file.import.field = picture file.width = {$plugin.wtgallery.list.width} file.height = {$plugin.wtgallery.list.height} altText.field = basename titleText.field = filename params = class="wtgallery wtgallery_list" if.isTrue.field = picture # link to singleview imageLinkWrap = 1 imageLinkWrap.enable = 1 imageLinkWrap.typolink.parameter.field = link_single } # Text from txt file or EXIF information to current list image text = COA text { # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension, currentfolder, picturehash, pid_single, link_single # Information from txt/EXIF: comments, title, subject, author, recordtime, cam_brand, cam_model wrap =
|
if.isTrue.field = title 10 = TEXT 10.field = title 10.wrap =
|
10.if.isTrue.field = title 20 = TEXT 20.field = comments 20.wrap =
|
20.if.isTrue.field = comments } # Pagebrowser for listview pagebrowser = HMENU pagebrowser { special = userfunction # Available functions are: "pagemenu" and "clickmenu" special.userFunc = user_wtgallery_pagebrowser->pagemenu special.userFunc { # clickmenu settings clickmenu.previous = TEXT clickmenu.previous.data = LLL:EXT:wt_gallery/pi1/locallang.xml:wtgallery_ll_pagebrowser_previous clickmenu.next = TEXT clickmenu.next.data = LLL:EXT:wt_gallery/pi1/locallang.xml:wtgallery_ll_pagebrowser_next } 1 = TMENU 1 { wrap =
    |
NO.allWrap =
  • |
    • ACT = 1 ACT.allWrap =
  • |
    • ACT.ATagParams = class="act" } } ######################################### # Example for your marker ###ANYMARKER### ######################################### # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension, currentfolder, picturehash, pid_single, link_single # Information from txt/EXIF: comments, title, subject, author, recordtime, cam_brand, cam_model anymarker = TEXT anymarker { field = picture wrap = | } } # Category view settings category { # Constants order = {$plugin.wtgallery.category.order} limit = {$plugin.wtgallery.category.limit} width = {$plugin.wtgallery.category.width} height = {$plugin.wtgallery.category.height} previewpicture_order = {$plugin.wtgallery.category.previewpicture_order} rows = {$plugin.wtgallery.category.rows} columns = {$plugin.wtgallery.category.columns} metainformation = {$plugin.wtgallery.category.metainformation} forceFolder = {$plugin.wtgallery.category.forceFolder} # Category preview image image = IMAGE image { # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension, currentfolder, link_list # Information from txt/EXIF: comments, title, subject, author, recordtime, cam_brand, cam_model wrap =
    |
    file.import.field = picture file.width = {$plugin.wtgallery.category.width} file.height = {$plugin.wtgallery.category.height} altText.field = basename titleText.field = filename params = class="wtgallery wtgallery_category" if.isTrue.field = picture # link to categoryview imageLinkWrap = 1 imageLinkWrap.enable = 1 imageLinkWrap.typolink.parameter.field = link_list } # Text from txt file or EXIF information to current category image text = COA text { # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension, currentfolder, link_list # Information from folder txt file: cat_comments, cat_title, cat_subject, cat_author, cat_recordtime, cat_cam_brand, cat_cam_model # Information from txt/EXIF of currently shown picture: comments, title, subject, author, recordtime, cam_brand, cam_model wrap =
    |
    if.isTrue.field = cat_comments 10 = TEXT 10.field = cat_title 10.wrap =
    |
    10.if.isTrue.field = cat_title 20 = TEXT 20.field = cat_comments 20.wrap =
    |
    20.if.isTrue.field = cat_comments } # Link to the startcategory below category # available variables for .field are: startcategory_link startcategorylink = TEXT startcategorylink { wrap =

    |

    data = LLL:EXT:wt_gallery/pi1/locallang.xml:wtgallery_ll_startcategorylink typolink.parameter.field = startcategory_link if.isTrue.field = startcategory_link } # Pagebrowser for categoryview pagebrowser = HMENU pagebrowser { special = userfunction # Available functions are: "pagemenu" and "clickmenu" special.userFunc = user_wtgallery_pagebrowser->pagemenu special.userFunc { # clickmenu settings clickmenu.previous = TEXT clickmenu.previous.data = LLL:EXT:wt_gallery/pi1/locallang.xml:wtgallery_ll_pagebrowser_previous clickmenu.next = TEXT clickmenu.next.data = LLL:EXT:wt_gallery/pi1/locallang.xml:wtgallery_ll_pagebrowser_next } 1 = TMENU 1 { wrap =
      |
    NO.allWrap =
  • |
    • ACT = 1 ACT.allWrap =
  • |
    • ACT.ATagParams = class="act" } } ######################################### # Example for your marker ###ANYMARKER### ######################################### # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension, currentfolder, link_list # Information from folder txt file: cat_comments, cat_title, cat_subject, cat_author, cat_recordtime, cat_cam_brand, cat_cam_model # Information from txt/EXIF of currently shown picture: comments, title, subject, author, recordtime, cam_brand, cam_model anymarker = TEXT anymarker { field = picture wrap = | } } # Cooliris view settings cooliris { # Constants title = {$plugin.wtgallery.cooliris.title} url = {$plugin.wtgallery.cooliris.url} description = {$plugin.wtgallery.cooliris.description} width = {$plugin.wtgallery.cooliris.width} height = {$plugin.wtgallery.cooliris.height} order = {$plugin.wtgallery.cooliris.order} limit = {$plugin.wtgallery.cooliris.limit} swf = {$plugin.wtgallery.cooliris.swf} window_width = {$plugin.wtgallery.cooliris.window_width} window_height = {$plugin.wtgallery.cooliris.window_height} allow_fullscreen = {$plugin.wtgallery.cooliris.allow_fullscreen} allow_scriptaccess = {$plugin.wtgallery.cooliris.allow_scriptaccess} noflash_message = {$plugin.wtgallery.cooliris.noflash_message} flashvars = {$plugin.wtgallery.cooliris.flashvars} metainformation = {$plugin.wtgallery.cooliris.metainformation} # path for cooliris image image = COA image { # available variables for .field are: # Information from the pic: picture, tstamp, filename, dirname, basename, extension, currentfolder, picturehash # Information from txt/EXIF of currently shown picture: comments, title, subject, author, recordtime, cam_brand, cam_model 10 = TEXT 10 { data = getIndpEnv:TYPO3_SITE_URL } 20 = IMG_RESOURCE 20 { file.import.field = picture file.width = {$plugin.wtgallery.cooliris.width} file.height = {$plugin.wtgallery.cooliris.height} if.isTrue.field = picture } } } } # Add css file for "table style" of list and categoryview page.includeCSS.file3135 = EXT:wt_gallery/files/css/wtgallery_main.css seite.includeCSS.file3135 < page.includeCSS.file3135# COOLIRIS part for wt_gallery # add rss feed to header lib.wt_gallery_coolirisRSS = TEXT lib.wt_gallery_coolirisRSS { wrap = typolink.parameter.dataWrap = {TSFE:id},3135 typolink.returnLast = url } [userFunc = user_wtgallery_oncurrentpage] page.headerData.3135 < lib.wt_gallery_coolirisRSS seite.headerData.3135 < lib.wt_gallery_coolirisRSS [end] # TypeNum 3135 offers a dynamic rss feed (listview) for cooliris (piclens) - more infos at www.cooliris.com wtgallery_cooliris_rss = PAGE wtgallery_cooliris_rss { typeNum = 3135 10 < plugin.tx_wtgallery_pi1 config { disableAllHeaderCode = 1 disablePrefixComment = 1 xhtml_cleaning = 0 admPanel = 0 } } .. _Constants: Constants: """""""""" :: ### # This are the default TS-constants for wt_gallery ## plugin.wtgallery { # cat=plugin.wtgallery//0010; type=file[html,htm,tmpl,txt]; label= Template File single: HTML-template file for single view (see EXT:wt_gallery/templates/single.html for an example) template.single = EXT:wt_gallery/templates/single.html # cat=plugin.wtgallery//0020; type=file[html,htm,tmpl,txt]; label= Template File list: HTML-template file for list view (see EXT:wt_gallery/templates/list.html for an example) template.list = EXT:wt_gallery/templates/list.html # cat=plugin.wtgallery//0030; type=file[html,htm,tmpl,txt]; label= Template File category: HTML-template file for category view (see EXT:wt_gallery/templates/category.html for an example) template.category = EXT:wt_gallery/templates/category.html # cat=plugin.wtgallery//0040; type=file[html,htm,tmpl,txt]; label= Template File cooliris: HTML-template file for cooliris view (see EXT:wt_gallery/templates/cooliris.html for an example) template.cooliris = EXT:wt_gallery/templates/cooliris.html # cat=plugin.wtgallery//1000; type=options[,single,list,latest]; label= Main Gallery mode: Define what the gallery should do - normally set via flexform in the plugin (e.g. single) main.mode = # cat=plugin.wtgallery//1010; type=text; label= Main Picture path: Relative path to the pictures (e.g. fileadmin/pictures/) main.path = # cat=plugin.wtgallery//1020; type=text; label= Main Allowed file extensions: Define all allowed file extensions of the picture path (not allowed files will be ignored) (default jpg,jpeg,gif,png) main.file_extensions = jpg,jpeg,gif,png # cat=plugin.wtgallery//1030; type=boolean; label= Main Parent DIV for rows: De/Activate a parent DIV container for every row of the list or category view (default 1) main.DIVforRows = 1 # cat=plugin.wtgallery//2000; type=text; label= Single view PID: Set PID of single page (e.g. 5) (Note: Flexform value overwrite this setting!) single.pid_single = # cat=plugin.wtgallery//2010; type=text; label= Single picture width: Default width of singlepicture (e.g. 500) (Note: Flexform value overwrite this setting!) single.width = 500 # cat=plugin.wtgallery//2020; type=text; label= Single picture height: Default height of singlepicture (e.g. 500) (Note: Flexform value overwrite this setting!) single.height = # cat=plugin.wtgallery//2030; type=options[ASC,DESC,newest,oldest,random]; label= Single picture sorting: If no picture is chosen, the first picture is selected by one of the methods (ASC,DESC,newest,oldest,random) single.order = ASC # cat=plugin.wtgallery//2040; type=options[TXT/EXIF,EXIF/TXT,TXT,EXIF,]; label= Single metainformation: Show meta information of a single picture from textfile or from EXIF information (possibilities: TXT/EXIF,EXIF/TXT,TXT,EXIF or empty) (TXT/EXIF means - search for a txt file and if no info from txt than take EXIF information of picture) single.metainformation = TXT/EXIF # cat=plugin.wtgallery//3000; type=text; label= List view PID: Set PID of list page (e.g. 6) (Note: Flexform value overwrite this setting!) list.pid_list = # cat=plugin.wtgallery//3010; type=text; label= List picture width: Default width of listpictures (e.g. 100) (Note: Flexform value overwrite this setting!) list.width = 100 # cat=plugin.wtgallery//3020; type=text; label= List picture height: Default height of listpictures (e.g. 500) (Note: Flexform value overwrite this setting!) list.height = # cat=plugin.wtgallery//3030; type=text; label= List number of rows: Set the number of rows for listview (e.g. 3) (Note: Flexform value overwrite this setting!) list.rows = # cat=plugin.wtgallery//3040; type=text; label= List number of columns: Set the number of columns for listview (e.g. 6) (Note: Flexform value overwrite this setting!) list.columns = # cat=plugin.wtgallery//3050; type=options[ASC,DESC,newest,oldest,random]; label= List sorting: Define the sorting of the listview images (ASC,DESC,newest,oldest,random) list.order = ASC # cat=plugin.wtgallery//3060; type=text; label= Listview limit: Define a maximum limit of the listview images (e.g. 100) (empty for no limit) list.limit = # cat=plugin.wtgallery//3070; type=options[TXT/EXIF,EXIF/TXT,TXT,EXIF,]; label= List metainformation: Show meta information of a list picture from textfile or from EXIF information (possibilities: TXT/EXIF,EXIF/TXT,TXT,EXIF or empty) (TXT/EXIF means - search for a txt file and if no info from txt than take EXIF information of picture) list.metainformation = TXT/EXIF # cat=plugin.wtgallery//4000; type=text; label= Category picture width: Default width of categorypictures (e.g. 80) (Note: Flexform value overwrite this setting!) category.width = 80 # cat=plugin.wtgallery//4010; type=text; label= Category picture height: Default height of categorypictures (e.g. 500) (Note: Flexform value overwrite this setting!) category.height = # cat=plugin.wtgallery//4020; type=text; label= Category number of rows: Set the number of rows for categoryview (e.g. 3) (Note: Flexform value overwrite this setting!) category.rows = # cat=plugin.wtgallery//4030; type=text; label= Category number of columns: Set the number of columns for categoryview (e.g. 6) (Note: Flexform value overwrite this setting!) category.columns = # cat=plugin.wtgallery//4040; type=options[ASC,DESC,random]; label= Category sorting: Define the sorting of the categories itselve (ASC,DESC,random) category.order = ASC # cat=plugin.wtgallery//4050; type=text; label= Category limit: Define a maximum limit of the category images (e.g. 100) (empty for no limit) category.limit = # cat=plugin.wtgallery//4060; type=options[ASC,DESC,newest,oldest,random]; label= Category image sorting: If no special picture is chosen, any picture of the folder will be chosen (ASC,DESC,newest,oldest,random) category.previewpicture_order = random # cat=plugin.wtgallery//4070; type=options[TXT/EXIF,EXIF/TXT,TXT,EXIF,]; label= Category metainformation: Show meta information of a category picture from textfile or from EXIF information (possibilities: TXT/EXIF,EXIF/TXT,TXT,EXIF or empty) (TXT/EXIF means - search for a txt file and if no info from txt than take EXIF information of picture) category.metainformation = TXT/EXIF # cat=plugin.wtgallery//4080; type=text; label= Category force folder: If you want to force a folder for your categories, you can enter a folder (e.g. fileadmin/pics/). This could be useful, if you want to always show your categories - even on list- and singleview! category.forceFolder = # cat=plugin.wtgallery//5000; type=text; label= Cooliris title: Define a title for the cooliris view (e.g. This is the title) cooliris.title = wt_gallery for cooliris # cat=plugin.wtgallery//5010; type=text; label= Cooliris url: Define an URL for the cooliris view (e.g. http://www.domain.org/) cooliris.url = http://www.cooliris.com/ # cat=plugin.wtgallery//5020; type=text; label= Cooliris description: Define a description for the cooliris view (e.g. This is the description) cooliris.description = This is the wt_gallery cooliris description... # cat=plugin.wtgallery//5030; type=text; label= Cooliris picture width: Default width of coolirispictures (e.g. 500) cooliris.width = 500 # cat=plugin.wtgallery//5040; type=text; label= Cooliris picture height: Default height of coolirispictures (e.g. 500) cooliris.height = # cat=plugin.wtgallery//5050; type=options[ASC,DESC,newest,oldest,random]; label= Cooliris sorting: Define the sorting of the coolirisview images (ASC,DESC,newest,oldest,random) cooliris.order = ASC # cat=plugin.wtgallery//5060; type=text; label= Cooliris limit: Define a maximum limit of the coolirisview images (e.g. 100) (empty for no limit) cooliris.limit = # cat=plugin.wtgallery//5070; type=text; label= Cooliris SWF path: Define a path for cooliris SWF file (e.g. EXT:wt_gallery/files/swf/cooliris.swf) cooliris.swf = EXT:wt_gallery/files/swf/cooliris.swf # cat=plugin.wtgallery//5080; type=int; label= Cooliris window width: Define width of the flash window in Frontend (e.g. 800) (Note: Flexform value overwrite this setting!) cooliris.window_width = 800 # cat=plugin.wtgallery//5090; type=int; label= Cooliris window height: Define height of the flash window in Frontend (e.g. 600) (Note: Flexform value overwrite this setting!) cooliris.window_height = 600 # cat=plugin.wtgallery//5100; type=boolean; label= Cooliris fullscreen button: Enable fullscreen button in cooliris flash window cooliris.allow_fullscreen = 1 # cat=plugin.wtgallery//5110; type=boolean; label= Cooliris scriptaccess button: Enable scriptaccess button in cooliris flash window cooliris.allow_scriptaccess = 0 # cat=plugin.wtgallery//5120; type=text; label= Cooliris flashvars: Add some cooliris flashvars if you want (e.g. &numRows=5&style=light) - see whole list at http://developer.cooliris.com/?p=embed/flash cooliris.flashvars = # cat=plugin.wtgallery//5130; type=text; label= Cooliris No-Flash message: Define a message if no flash was found in the browser cooliris.noflash_message = Get Adobe Flash # cat=plugin.wtgallery//5140; type=options[TXT/EXIF,EXIF/TXT,TXT,EXIF,]; label= Cooliris metainformation: Show meta information of the listed picture from textfile or from EXIF information (possibilities: TXT/EXIF,EXIF/TXT,TXT,EXIF or empty) (TXT/EXIF means - search for a txt file and if no info from txt than take EXIF information of picture) (You have to make some changes in the cooliris.html as you want) cooliris.metainformation = TXT/EXIF } .. _Constants-explanation: Constants explanation """"""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _Name: **Name** ~~~~~~~~ .. container:: table-row a **Name** b **Description** c **Default value** d **Additional information** .. _template-single: template.single ~~~~~~~~~~~~~~~ .. container:: table-row a template.single b Template File single: HTML-template file for single view (see EXT:wt\_gallery/templates/single.html for an example) c EXT:wt\_gallery/templates/single.html d .. _template-list: template.list ~~~~~~~~~~~~~ .. container:: table-row a template.list b Template File list: HTML-template file for list view (see EXT:wt\_gallery/templates/list.html for an example) c EXT:wt\_gallery/templates/list.html d .. _template-category: template.category ~~~~~~~~~~~~~~~~~ .. container:: table-row a template.category b Template File category: HTML-template file for category view (see EXT:wt\_gallery/templates/category.html for an example) c EXT:wt\_gallery/templates/category.html d .. _template-cooliris: template.cooliris ~~~~~~~~~~~~~~~~~ .. container:: table-row a template.cooliris b Template File cooliris: HTML-template file for cooliris view (see EXT:wt\_gallery/templates/cooliris.html for an example) c EXT:wt\_gallery/templates/cooliris.html d This template is only for the cooliris RSS feed .. _main-mode: main.mode ~~~~~~~~~ .. container:: table-row a main.mode b Gallery mode: Define what the gallery should do - normally set via flexform in the plugin (e.g. single) (could contains commaseparated list) c d Normally set via flexform .. _main-path: main.path ~~~~~~~~~ .. container:: table-row a main.path b Picture path: Relative path to the pictures (e.g. fileadmin/pictures/) c d Normally set via flexform .. _main-file-extensions: main.file\_extensions ~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a main.file\_extensions b Allowed file extensions: Define all allowed file extensions of the picture path (not allowed files will be ignored) (default jpg,jpeg,gif,png) c jpg,jpeg,gif,png d .. _main-DIVforRows: main.DIVforRows ~~~~~~~~~~~~~~~ .. container:: table-row a main.DIVforRows b Parent DIV for rows: De/Activate a parent DIV container for every row of the list or category view (default 1) c 1 d .. _single-pid-single: single.pid\_single ~~~~~~~~~~~~~~~~~~ .. container:: table-row a single.pid\_single b PID of single view: Set PID of single page (e.g. 5) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _single-width: single.width ~~~~~~~~~~~~ .. container:: table-row a single.width b Width of single picture: Default width of singlepicture (e.g. 500) (Note: Flexform value overwrite this setting!) c 500 d Normally set via flexform .. _single-height: single.height ~~~~~~~~~~~~~ .. container:: table-row a single.height b Height of single picture: Default height of singlepicture (e.g. 500) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _single-order: single.order ~~~~~~~~~~~~ .. container:: table-row a single.order b Sorting for singleview: If no picture is chosen, the first picture is selected by one of the methods (ASC,DESC,newest,oldest,random) c ASC d .. _single-metainformation: single.metainformation ~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a single.metainformation b Show metainformation single: Show meta information of a single picture from textfile or from EXIF information (possibilities: TXT/EXIF,EXIF/TXT,TXT,EXIF or empty) (TXT/EXIF means - search for a txt file and if no info from txt than take EXIF information of picture) c TXT/EXIF d .. _list-pid-list: list.pid\_list ~~~~~~~~~~~~~~ .. container:: table-row a list.pid\_list b PID of list view: Set PID of list page (e.g. 6) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _list-width: list.width ~~~~~~~~~~ .. container:: table-row a list.width b Width of list pictures: Default width of listpictures (e.g. 100) (Note: Flexform value overwrite this setting!) c 100 d Normally set via flexform .. _list-height: list.height ~~~~~~~~~~~ .. container:: table-row a list.height b Height of list pictures: Default height of listpictures (e.g. 500) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _list-rows: list.rows ~~~~~~~~~ .. container:: table-row a list.rows b Number of rows: Set the number of rows for listview (e.g. 3) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _list-columns: list.columns ~~~~~~~~~~~~ .. container:: table-row a list.columns b Number of columns: Set the number of columns for listview (e.g. 6) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _list-order: list.order ~~~~~~~~~~ .. container:: table-row a list.order b Sorting for listview: Define the sorting of the listview images (ASC,DESC,newest,oldest,random) c ASC d .. _list-limit: list.limit ~~~~~~~~~~ .. container:: table-row a list.limit b Limit for listview: Define a maximum limit of the listview images (e.g. 100) (empty for no limit) c d .. _list-metainformation: list.metainformation ~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a list.metainformation b Show metainformation list: Show meta information of a list picture from textfile or from EXIF information (possibilities: TXT/EXIF,EXIF/TXT,TXT,EXIF or empty) (TXT/EXIF means - search for a txt file and if no info from txt than take EXIF information of picture) c TXT/EXIF d .. _category-width: category.width ~~~~~~~~~~~~~~ .. container:: table-row a category.width b Default width of categorypictures (e.g. 80) (Note: Flexform value overwrite this setting!) c 80 d Normally set via flexform .. _category-height: category.height ~~~~~~~~~~~~~~~ .. container:: table-row a category.height b Height of category pictures: Default height of categorypictures (e.g. 500) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _category-rows: category.rows ~~~~~~~~~~~~~ .. container:: table-row a category.rows b Number of rows: Set the number of rows for categoryview (e.g. 3) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _category-columns: category.columns ~~~~~~~~~~~~~~~~ .. container:: table-row a category.columns b Number of columns: Set the number of columns for categoryview (e.g. 6) (Note: Flexform value overwrite this setting!) c d Normally set via flexform .. _category-order: category.order ~~~~~~~~~~~~~~ .. container:: table-row a category.order b Category sorting: Define the sorting of the categories itselve (ASC,DESC,random) c ASC d .. _category-limit: category.limit ~~~~~~~~~~~~~~ .. container:: table-row a category.limit b Category limit: Define a maximum limit of the category images (e.g. 100) (empty for no limit) c d .. _category-previewpicture-order: category.previewpicture\_order ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a category.previewpicture\_order b Sorting for category image: If no special picture is chosen, any picture of the folder will be chosen (ASC,DESC,newest,oldest,random) c random d .. _category-metainformation: category.metainformation ~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a category.metainformation b Show metainformation category: Show meta information of a category picture from textfile or from EXIF information (possibilities: TXT/EXIF,EXIF/TXT,TXT,EXIF or empty) (TXT/EXIF means - search for a txt file and if no info from txt than take EXIF information of picture) c TXT/EXIF d .. _cooliris-title: cooliris.title ~~~~~~~~~~~~~~ .. container:: table-row a cooliris.title b Cooliris title: Define a title for the cooliris view (e.g. This is the title) c wt\_gallery for cooliris d .. _cooliris-url: cooliris.url ~~~~~~~~~~~~ .. container:: table-row a cooliris.url b Cooliris url: Define an URL for the cooliris view (e.g. http://www.domain.org/) c http://www.cooliris.com/ d .. _cooliris-description: cooliris.description ~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a cooliris.description b Cooliris description: Define a description for the cooliris view (e.g. This is the description) c This is the wt\_gallery cooliris description... d .. _cooliris-width: cooliris.width ~~~~~~~~~~~~~~ .. container:: table-row a cooliris.width b Width of cooliris pictures: Default width of coolirispictures (e.g. 500) c 500 d .. _cooliris-height: cooliris.height ~~~~~~~~~~~~~~~ .. container:: table-row a cooliris.height b Height of cooliris pictures: Default height of coolirispictures (e.g. 500) c d .. _cooliris-order: cooliris.order ~~~~~~~~~~~~~~ .. container:: table-row a cooliris.order b Sorting for coolirisview: Define the sorting of the coolirisview images (ASC,DESC,newest,oldest,random) c ASC d .. _cooliris-limit: cooliris.limit ~~~~~~~~~~~~~~ .. container:: table-row a cooliris.limit b Limit for coolirisview: Define a maximum limit of the coolirisview images (e.g. 100) (empty for no limit) c d .. _cooliris-swf: cooliris.swf ~~~~~~~~~~~~ .. container:: table-row a cooliris.swf b Cooliris SWF path: Define a path for cooliris SWF file (e.g. EXT:wt\_gallery/files/swf/cooliris.swf) c EXT:wt\_gallery/files/swf/cooliris.swf d .. _cooliris-window-width: cooliris.window\_width ~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a cooliris.window\_width b Width of cooliris window: Define width of the flash window in Frontend (e.g. 800) (Note: Flexform value overwrite this setting!) c 800 d .. _cooliris-window-height: cooliris.window\_height ~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a cooliris.window\_height b Height of cooliris window: Define height of the flash window in Frontend (e.g. 600) (Note: Flexform value overwrite this setting!) c 600 d .. _cooliris-allow-fullscreen: cooliris.allow\_fullscreen ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a cooliris.allow\_fullscreen b Allow fullscreen button: Enable fullscreen button in cooliris flash window c 1 d .. _cooliris-allow-scriptaccess: cooliris.allow\_scriptaccess ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a cooliris.allow\_scriptaccess b Allow scriptaccess button: Enable scriptaccess button in cooliris flash window c 0 d .. _cooliris-noflash-message: cooliris.noflash\_message ~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a cooliris.noflash\_message b No-Flash message: Define a message if no flash was found in the browser c Get Adobe Flash d This HTML code is wrapped by a DIV container .. ###### END~OF~TABLE ###### .. _Features: Features -------- .. _Cooliris-PicLens-use: Cooliris (PicLens) use ^^^^^^^^^^^^^^^^^^^^^^ .. _Passive-use-of-cooliris: Passive use of cooliris """"""""""""""""""""""" .. _Screenshot: Screenshot ~~~~~~~~~~ |img-11| .. _Description-and-configuration: Description and configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will be enabled automaticly if you enter a list view on a homepage. **Function:** A dynamic RSS feed will be integrated to your page (via typoscript page.headerData ...) which enables this feature. So if you have trouble – check the dynamic RSS feed at first! **Configuration:** You can define some settings in the constants (picture with and height, Title, URL, etc...) **NOTE:** The RSS will only work, if you have entered a main picture path in the constants (path in flexform wont work!!!) .. _Active-use-of-cooliris-in-Frontendplugin: Active use of cooliris in Frontendplugin """""""""""""""""""""""""""""""""""""""" .. _Screenshot: Screenshot ~~~~~~~~~~ |img-3| .. _Description-and-configuration: Description and configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is an alternative listview – choose this mode in the plugin for showing the flash plugin. Basic feature is the rss feed (see above). So if you have trouble – check the dynamic RSS feed at first! **NOTE:** The RSS will only work, if you have entered a main picture path in the constants (path in flexform wont work!!!) **NOTE2:** The cooliris flash don't wan to open an URL like /index.php?id=2&type=3135 – please rewrite this RSS URL with realurl like /cooliris/wt\_gallery.html (see realurl part of this manual for details) .. _Lightbox-use: Lightbox use ^^^^^^^^^^^^ |img-12| .. _With-perfectlightbox: With perfectlightbox """""""""""""""""""" .. _Open-pictures-from-the-listview: Open pictures from the listview ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: #setup plugin.tx_wtgallery_pi1 { list { image = IMAGE image { imageLinkWrap.typolink { parameter.cObject = IMG_RESOURCE parameter.cObject.file.import.field = picture parameter.cObject.file.maxW = 600 parameter.cObject.file.maxH = 600 ATagParams = rel="lightbox[galerie]" } } } } .. _Open-pictures-from-the-singleview: Open pictures from the singleview ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: #setup plugin.tx_wtgallery_pi1 { single { image = IMAGE image { imageLinkWrap.typolink { parameter.cObject = IMG_RESOURCE parameter.cObject.file.import.field = picture parameter.cObject.file.maxW = 600 parameter.cObject.file.maxH = 600 ATagParams = rel="lightbox[galerie]" } } } } .. _With-rzcolorbox: With rzcolorbox """"""""""""""" .. _Open-pictures-from-the-listview: Open pictures from the listview ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: #setup plugin.tx_wtgallery_pi1 { list { image = IMAGE image { imageLinkWrap.typolink { parameter.cObject = IMG_RESOURCE parameter.cObject.file.import.field = picture parameter.cObject.file.maxW = 600 parameter.cObject.file.maxH = 600 ATagParams = rel="lightbox" ATagParams.override = class="{$plugin.rzcolorbox.rel}" rel="{$plugin.rzcolorbox.rel}" } } } } .. _Open-pictures-from-the-singleview: Open pictures from the singleview ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: #setup plugin.tx_wtgallery_pi1 { single { image = IMAGE image { imageLinkWrap = 0 imageLinkWrap.enable = 0 imageLinkWrap.typolink { parameter.cObject = IMG_RESOURCE parameter.cObject.file.import.field = picture parameter.cObject.file.maxW = 600 parameter.cObject.file.maxH = 600 ATagParams = rel="lightbox" ATagParams.override = class="{$plugin.rzcolorbox.rel}" rel="{$plugin.rzcolorbox.rel}" } } } } .. _With-kj-imagelightbox2-version-2-0-0: With kj\_imagelightbox2 < version 2.0.0 """"""""""""""""""""""""""""""""""""""" .. _Open-pictures-from-the-listview: Open pictures from the listview ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: #setup plugin.tx_wtgallery_pi1 { list { image = IMAGE image { # ImageLightboxv2 imageLightbox2 = 1 imageLightbox2 { imageset = myImgSet caption= saveImageShow = 0 printImageShow = 0 presentMode = 0 imageset = 1 } } } } .. _Open-pictures-from-the-singleview: Open pictures from the singleview ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: #setup plugin.tx_wtgallery_pi1 { single { image = IMAGE image { imageLinkWrap = 0 imageLinkWrap.enable = 0 # ImageLightboxv2 imageLightbox2 = 1 imageLightbox2 { imageset = myImgSet caption= saveImageShow = 0 printImageShow = 0 presentMode = 0 imageset = 1 } } } } .. _TXT-and-EXIF-information-for-any-view: TXT and EXIF information for any view: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Description: Description: """""""""""" Of course I've added this feature again, just configure via constants (EXIF/TXT or TXT/EXIF or only TXT or only EXIF or turn of this feature) .. _How-to-use-EXIF: How to use EXIF: """""""""""""""" Before you upload your pictures to your webserver, you can enter EXIF informations for every picture. Just open your Windows Explorer and write. After that you can upload your picture folder. Thats all... .. _Windows-Vista-example: Windows Vista example: ~~~~~~~~~~~~~~~~~~~~~~ |img-13| .. _Windows-XP-example: Windows XP example: ~~~~~~~~~~~~~~~~~~~ .. _img-14-img-15: |img-14| |img-15| ~~~~~~~~~~~~~~~~~ .. _TXT-using-txt-files-to-describe-a-picture: TXT – using .txt files to describe a picture: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can upload TXT files in addition to your picture folder to describe your pictures. The TXT files should have the same name like the picture but with the extension .txt: For picture.jpg use picture.jpg.txt.With a pipe sign (\|) you can split Title from Subject and so on (see picture for details). Localisation mode: pic.txt for default language, pic.de.txt for german language, pic.it.txt for italian language and so on... For security reasons - HTML is not allowed in the txt files! |img-16| |img-17| .. _TXT-using-txt-files-to-describe-a-folder-in-category-view: TXT – using .txt files to describe a folder in category view: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can upload TXT files in addition to your picture folder to describe the folder. The TXT files should have the same name as the folder but with the extension .txt: For fileadmin/pictures use fileadmin/pictures.txt.With a pipe sign (\|) you can split Title from Subject and so on (see picture for details). Localisation mode: folder.txt for default language, folder.de.txt for german language, folder.it.txt for italian language and so on... For security reasons - HTML is not allowed in the txt files! |img-18| |img-17| .. _Different-menus-for-list-or-categoryview: Different menus for list- or categoryview ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Pagemenu: Pagemenu """""""" .. _Example-Screenshot: Example Screenshot ~~~~~~~~~~~~~~~~~~ |img-19| .. _Example-Typoscript: Example Typoscript ~~~~~~~~~~~~~~~~~~ :: # Category view (pagemenu is default) plugin.tx_wtgallery_pi1.category.pagebrowser.special.userFunc = user_wtgallery_pagebrowser->pagemenu # List view (pagemenu is default) plugin.tx_wtgallery_pi1.list.pagebrowser.special.userFunc = user_wtgallery_pagebrowser->pagemenu .. _Clickmenu: Clickmenu """"""""" .. _Example-Screenshot: Example Screenshot ~~~~~~~~~~~~~~~~~~ |img-20| .. _Example-Typoscript: Example Typoscript ~~~~~~~~~~~~~~~~~~ :: # Category view plugin.tx_wtgallery_pi1.category.pagebrowser.special.userFunc = user_wtgallery_pagebrowser->clickmenu # List view plugin.tx_wtgallery_pi1.list.pagebrowser.special.userFunc = user_wtgallery_pagebrowser->clickmenu .. _Using-images-instead-of-text-for-next-previous: Using images instead of text for next/previous ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: # Category view plugin.tx_wtgallery_pi1.category.pagebrowser.special.userFunc { clickmenu.previous = IMAGE clickmenu.previous.file = fileadmin/prev.gif clickmenu.next = IMAGE clickmenu.next.file = fileadmin/next.gif } # List view plugin.tx_wtgallery_pi1.list.pagebrowser.special.userFunc { clickmenu.previous = IMAGE clickmenu.previous.file = fileadmin/prev.gif clickmenu.next = IMAGE clickmenu.next.file = fileadmin/next.gif } .. _Note: Note ~~~~ Check the typoscript setup of wt\_gallery and you'll see the default settings – which could be changed from anybody .. _Using-dynamic-typoscript-or-locallang-marker-in-any-html-template: Using dynamic typoscript or locallang marker in any html template: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Explanation: Explanation """"""""""" .. _What-is-a-dynamic-typoscript-marker: What is a dynamic typoscript marker? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The idea is very simple: Using any typoscript object in a HTML Output! So if you add a special marker in any HTML Template, a similar typoscript object will be called for an output (could be e.g. a HMENU, a TEXT, an IMAGE, or anything else). Of course stdWrap could be used to have the full flexibility. .. _What-is-a-dynamic-locallang-marker: What is a dynamic locallang marker? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This idea is also simple: Using a defined marker in any HTML template will call a value from the locallang.xml and can be overwritten by typoscript .. _Where-can-a-use-this-markers: Where can a use this markers? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In every HTML Template .. _Example-HTML-Markers: Example HTML Markers """""""""""""""""""" ::
    Typoscript Label: ###WTGALLERY_TS_ANYOBJECT###
    Locallang Label: ###WTGALLERY_LL_ANYLABEL###
    .. _Example-Typoscript: Example Typoscript """""""""""""""""" :: # dynamic Typoscriptmarker lib.object = TEXT lib.object.value = This is the value lib.object.wrap = | plugin.tx_wtgallery_pi1.dynamicTyposcript.anyobject < lib.object # dynamic Locallangmarker plugin.tx_wtgallery_pi1._LOCAL_LANG.default { wtgallery_ll_anylabel = This is the label } plugin.tx_wtgallery_pi1._LOCAL_LANG.de { wtgallery_ll_anylabel = Das ist die Beschriftung } .. _Realurl-example: Realurl example: ^^^^^^^^^^^^^^^^ .. _Explanation: Explanation """"""""""" If you want to use the cooliris view it's important to rewrite the RSS URL! .. _Example-for-realurlconf-php: Example for realurlconf.php """"""""""""""""""""""""""" :: $TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT'] = array( 'init' => array( 'enableCHashCache' => 1 ), 'preVars' => array( array( 'GETvar' => 'no_cache', 'valueMap' => array( 'no_cache' => 1, ), 'noMatch' => 'bypass', ), array( 'GETvar' => 'L', 'valueMap' => array( 'en' => '1', ), 'noMatch' => 'bypass', ), array( 'GETvar' => 'type', 'valueMap' => array( 'cooliris' => '3135' ), 'noMatch' => 'bypass', ), ), 'fileName' => array ( 'defaultToHTMLsuffixOnPrev' => 1, ), 'postVarSets' => array( '_DEFAULT' => array ( 'index' => array( array( 'GETvar' => '', ), ), 'gallery' => array( array( 'GETvar' => 'tx_wtgallery_pi1[category]', ), array( 'GETvar' => 'tx_wtgallery_pi1[show]', ), array( 'GETvar' => 'tx_wtgallery_pi1[listpointer]', ), array( 'GETvar' => 'tx_wtgallery_pi1[categorypointer]', ), ), ), ), 'pagePath' => array( 'type' => 'user', 'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main', 'spaceCharacter' => '-', 'languageGetVar' => 'L', 'expireDays' => 0, 'rootpage_id' => '1', ), ); .. _Readable-category-and-filenames: Readable category- and filenames """""""""""""""""""""""""""""""" If you use a realurl configuration like shown above, you will get URL like: |img-21| But the category and the image is written as integer (for security reasons) If you want to get URL like: |img-22| For this, you have to enable the option in the extension manager: |img-23| **Note:** Readable URL works only with realurl and only if you have rewritten the postVarSets of wt\_gallery (see realurlconf above) .. _FAQ: FAQ --- .. _Main: Main ^^^^ .. _Cooliris-PicLens-is-not-shown: Cooliris (PicLens) is not shown """"""""""""""""""""""""""""""" Check if the dynamic RSS is correctly integrated to you page (see page header) If you use realurl – enable type 3135 in your realurl configuration for this RSS file If you open the rss file manually (look into the html header and copy the rss url to your browser), a XML should be shown with all listed images The cooliris flash file don't want to open a RSS URL like /index.php?id=3&type=3135 so it could be necessary to change the url via realurl like /cooliris/wt\_gallery.html (see realurl part in this manual) You have to enter a main picture path via constants (not only via flexform – cooliris rss need this!) If you forgot this – the message “Please set the startpath via typoscript and not only in the plugin - this is needed for cooliris!” will be shown in the dynamic RSS file and the cooliris FE plugin stays only black .. _Cooliris-PicLens-is-only-black-and-there-no-images-in-the-window: Cooliris (PicLens) is only black and there no images in the window """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Go through the checklist above .. _I-want-to-use-a-lightbox-plugin-withwt-gallery: I want to use a lightbox plugin withwt\_gallery """"""""""""""""""""""""""""""""""""""""""""""" Single- and listview enabled with lightbox (see above) .. _Using-RealURL-or-SimulateStaticDocument: Using RealURL or SimulateStaticDocument """"""""""""""""""""""""""""""""""""""" This Gallery Extension of course support both methods. RealURL example: |img-22| For more informations read the manual to realurl or simulatestaticdocuments (TYPO3) .. _How-does-the-category-view-work: How does the category view work: """""""""""""""""""""""""""""""" - If there are folders in the main path, the category view will show them - Note: category- and listview has to be in the same page! .. _Image-generating-takes-a-long-time: Image generating takes a long time """""""""""""""""""""""""""""""""" The first time you enter the Frontend the pictures will be generated by TYPO3, but they are cached from this moment – so a second visit will be much more faster .. _No-images-will-be-shown-and-no-errormessage-apears: No images will be shown and no errormessage apears """""""""""""""""""""""""""""""""""""""""""""""""" - Check if you have selected min. one mode in the flexform (e.g. listview) - Check image processing in the install tool (check if image magick works well) .. _Errormessages: Errormessages ^^^^^^^^^^^^^ .. _wt-gallery-Error-Picture-path-not-set-set-in-flexform-or-in-constants: wt\_gallery Error: Picture path not set - set in flexform or in constants! """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Select a path in the flexform .. _wt-gallery-Error-Mode-not-set-set-mode-in-flexform-or-in-constants: wt\_gallery Error: Mode not set - set mode in flexform or in constants """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Select a mode in the flexform (e.g. listview) .. _wt-gallery-Error-No-valid-picture-path: wt\_gallery Error: No valid picture path! """"""""""""""""""""""""""""""""""""""""" - Check if there are any special signs in the picture folder or in the webpage folder and remove them (~, $, % and so on...) - Don't use more than only one wt\_gallery plugin with different picture paths on the same page .. _wt-gallery-Picture-path-not-valid-please-correct-it: wt\_gallery: Picture path not valid - please correct it! """""""""""""""""""""""""""""""""""""""""""""""""""""""" There is a illegal picture path in use (like ../othertypo3/fileadmin/) - please correct it! .. _wt-gallery-Extension-wt-doorman-not-found-please-install-first: wt\_gallery: Extension wt\_doorman not found, please install first! """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Please install extension wt\_doorman and try again (wt\_doorman cleans the piVars against bad influence and keeps your server secure) .. _Changelog: Changelog --------- .. _Version-3-1-x-beta: Version 3.1.x **beta** ^^^^^^^^^^^^^^^^^^^^^^ .. _Update-30-04-2010-version-3-1-7: Update 30.04.2010 version 3.1.7: """""""""""""""""""""""""""""""" - Feature #7554: Readable picture and category names in URL (together with realurl) - Feature #7375: Manual changes for another lightbox example - Bugfix #4774: Enable old style text field for pathinfo in plugin - Bugfix #5620: Deprecated functions removed - Bugfix #6296: Category Text not shown .. _Update-07-01-2010-version-3-1-6: Update 07.01.2010 version 3.1.6: """""""""""""""""""""""""""""""" - Bugfix #5620: Deprecated function fix - Bugfix #5625: Typo in hook\_inner in category class - Small change in TXT/EXIF Hook .. _Update-21-09-2009-version-3-1-5: Update 21.09.2009 version 3.1.5: """""""""""""""""""""""""""""""" Bugfix #4714: “No valid picture path” if typo3 works in a subfolder .. _Update-28-07-2009-version-3-1-4: Update 28.07.2009 version 3.1.4: """""""""""""""""""""""""""""""" More flexibility: Use your own markers now! .. _Update-15-07-2009-version-3-1-3: Update 15.07.2009 version 3.1.3: """""""""""""""""""""""""""""""" Improved clickmenu .. _Update-13-07-2009-version-3-1-2: Update 13.07.2009 version 3.1.2: """""""""""""""""""""""""""""""" - Add clickmenu to wt\_gallery - Selecting folders instead of writing there name in flexform - Limit for categories could be set - Changes in manual .. _Update-24-06-2009-version-3-1-1: Update 24.06.2009 version 3.1.1: """""""""""""""""""""""""""""""" - Bugfix #3748: Backlink in Listview was not viewable - Bugfix #3393: RSS including improved - Bugfix #3170: Wrong setting of css class in category pagebrowser - Feature #3752: Using TXT/EXIF info as titletag or alttag and so on... - Feature #3751: Add some hooks - Feature #3042: Italian translation for next and previous buttons - Feature: TXT files to describe the folders .. _Update-21-04-2009-version-3-1-0: Update 21.04.2009 version 3.1.0: """""""""""""""""""""""""""""""" - Changing status to beta - Small changes in the manual .. _Version-3-0-x-alpha: Version 3.0.x **alpha** ^^^^^^^^^^^^^^^^^^^^^^^ .. _Update-05-04-2009-version-3-0-6: Update 05.04.2009 version 3.0.6: """""""""""""""""""""""""""""""" - Added next and previous links to single view - Added current class for current picture in listview - Bugfix in EXIF function .. _Update-14-01-2009-version-3-0-5: Update 14.01.2009 version 3.0.5: """""""""""""""""""""""""""""""" - Enabled category view and cooliris - Folders will be shown as hash code if you want to use realurl - Sorting of categories possible - New cooliris flash file .. _Update-09-11-2008-version-3-0-4: Update 09.11.2008 version 3.0.4: """""""""""""""""""""""""""""""" - Offering cooliris.swf in wt\_gallery (no more crossdomain errors in cooliris) - Change in manual: How to include imagelightbox .. _Update-29-10-2008-version-3-0-3: Update 29.10.2008 version 3.0.3: """""""""""""""""""""""""""""""" Small bugfix: Error in setting DIV containers for every row in list- and category- view .. _Update-28-10-2008-version-3-0-2: Update 28.10.2008 version 3.0.2: """""""""""""""""""""""""""""""" Small bugfix (Detaillink in Single view) .. _Update-26-10-2008-version-3-0-1: Update 26.10.2008 version 3.0.1: """""""""""""""""""""""""""""""" - Cooliris (Piclens) RSS included - Cooliris (Piclens) Frontend Flash integration - Bugfix in Listlinks - Bugfix in class output - Some further small bugfixes - Changing local stylesheet to extern stylesheet .. _Relaunch-22-10-2008-version-3-0-0: Relaunch 22.10.2008 version 3.0.0: """""""""""""""""""""""""""""""""" - 3.0 is COMPLETELY NEW PHP CODE - Configuration complete via typoscript - Definition of images via typoscript or flexform - No limit of categories (folders to show) - Category pictures could be listed in rows and columns (like list view) - Image Magick is used (no more gdlib) - TYPO3 caching will be used - Pagebrowser for listview AND for categorie view possible - Pagebrowser will be filled with a HMENU – so manipulate it as you want - Dynamic typoscript possible (as known from powermail or wt\_directory) - Dynamic locallang marker possible (as known from powermail or wt\_directory) - No more german manual (sorry – too much work on an upgrade) - Describe picture via text files (now with more parts – title, subject, commentary, brand, etc...) Localized picture description via different text files .. _Version-2-x-stable: **Version 2.x stable** ^^^^^^^^^^^^^^^^^^^^^^ .. _Update-Sunday-03-02-2008-version-2-6-1: Update Sunday 03.02.2008 version 2.6.1: """"""""""""""""""""""""""""""""""""""" - Bugfix with perfectlightbox - Bugfix with wallpaper function - Small change in flexform .. _Update-Friday-07-01-2007-version-2-6-0: Update Friday 07.01.2007 version 2.6.0: """"""""""""""""""""""""""""""""""""""" - You can use the constant editor now (ATTENTION: Maybe new TS setup and constants) - Italien translation .. _Update-Friday-16-12-2007-version-2-5-1: Update Friday 16.12.2007 version 2.5.1: """"""""""""""""""""""""""""""""""""""" - Max. width bugfix - Security patch .. _Update-Friday-12-10-2007-version-2-5-0: Update Friday 12.10.2007 version 2.5.0: """"""""""""""""""""""""""""""""""""""" - Max. width is possible now - Small security patch .. _Update-Monday-01-10-2007-version-2-4-3: Update Monday 01.10.2007 version 2.4.3: """"""""""""""""""""""""""""""""""""""" You can use perfectlightbox with wt\_gallery .. _Update-Friday-14-09-2007-version-2-4-2: Update Friday 14.09.2007 version 2.4.2: """"""""""""""""""""""""""""""""""""""" Single pictures can be shown in original size .. _Update-Thursday-13-09-2007-version-2-4-1: Update Thursday 13.09.2007 version 2.4.1: """"""""""""""""""""""""""""""""""""""""" - Generated image file gets file permissions from TYPO3 - Small bugfix when used with imagelightbox2 .. _Update-Wednesday-23-05-2007-version-2-4-0: Update Wednesday 23.05.2007 version 2.4.0: """""""""""""""""""""""""""""""""""""""""" - Plugin don't disables cache any more! Indexed\_search and caching now possible. - Bugfixes for RealUrl and for some links .. _Update-Tuesday-22-05-2007-version-2-3-3: Update Tuesday 22.05.2007 version 2.3.3: """""""""""""""""""""""""""""""""""""""" Small bug in locallang.xml: “back” was used twice .. _Update-Monday-21-05-2007-version-2-3-2: Update Monday 21.05.2007 version 2.3.2: """"""""""""""""""""""""""""""""""""""" Enabling kj\_imagelightbox2 to work with wt\_gallery .. _Update-Tuesday-15-05-2007-version-2-3-1: Update Tuesday 15.05.2007 version 2.3.1: """""""""""""""""""""""""""""""""""""""" - Old GET variables from already delted pics (maybe indexed by google.de) lead to the first picture (no more error) - Other invalid GET variables leads to an errormessage - Barrier-free Improvement SingleView: Small bugfix in “Show category” link .. _Update-Monday-14-05-2007-version-2-3-0: Update Monday 14.05.2007 version 2.3.0: """"""""""""""""""""""""""""""""""""""" - Gallery can generate JPG or PNG (transparency in rounded corners possible) - First and last of the of each row in list view gets another class - Rounded Corners: Choose inner radius if border is set - HTML Template changes: Using Subparts for Links to be more flexible - PHP Code cleaned, some further intern functions Cache optimized: cache improve, each cache folder content could be deleted, check if cache folder existing, etc.. .. _Update-Monday-30-04-2007-version-2-2-1: Update Monday 30.04.2007 version 2.2.1: """"""""""""""""""""""""""""""""""""""" - Bugfixing PHP4 Errorwarning (should only happens if filter activated) - Changes in the manual Some more small changes... .. _Update-Sonday-29-04-2007-version-2-2-0: Update Sonday 29.04.2007 version 2.2.0: """"""""""""""""""""""""""""""""""""""" - Special effects like rounded corners now possible - Use links forward and backward below the single picture - HTML Template Change (different parts for EXIF and TXT comments) - Bugfix in showing EXIF informations - All pictures can be delete by using a especially GET Variable (see Additional informations) Clean Flexform .. _Update-Tuesday-17-04-2007-version-2-0-5: Update Tuesday 17.04.2007 version 2.0.5: """""""""""""""""""""""""""""""""""""""" New Feature in ListView: The current picture gets a different stylesheet class .. _Update-Monday-09-04-2007-version-2-0-4: Update Monday 09.04.2007 version 2.0.4: """"""""""""""""""""""""""""""""""""""" New Feature: If **wallpaper** function active, a link on the single picture will forward you to the original picture .. _Update-Tuesday-03-04-2007-version-2-0-3-Thanx-to-Sathya-Laufer: Update Tuesday 03.04.2007 version 2.0.3 (Thanx to Sathya Laufer): """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Small bugfix: Pictures in landscape format will be cutted right (not to much) .. _Update-Thursday-22-03-2007-version-2-0-2: Update Thursday 22.03.2007 version 2.0.2: """"""""""""""""""""""""""""""""""""""""" New Feature: Sorting of categories now possible (with TypoScript) .. _Update-Saturday-17-03-2007-version-2-0-1: Update Saturday 17.03.2007 version 2.0.1: """"""""""""""""""""""""""""""""""""""""" Bugfixing comment function (show content of picture.txt to picture.jpg) .. _Relaunch-Thursday-08-03-2007-version-2-0-0: Relaunch Thursday 08.03.2007 version 2.0.0: """"""""""""""""""""""""""""""""""""""""""" - Subgalleries are supported - Cached files could be deleted, if they are too old - All configurations can be set by TypoScript - New caching system - New ERROR management and ERROR displays on the frontend to find the mistake - PHP Code cleaned .. _Todo: Todo ---- .. _Main-features: Main features: ^^^^^^^^^^^^^^ - Commenting function for editors in the backend (maybe an additional extension – hook exists already!) - Adding latest view - Adding rounded corner feature - Adding watermark feature .. _If-you-found-need-a: If you found/need a: ^^^^^^^^^^^^^^^^^^^^ - Bug: Write in forge at: `http://forge.typo3.org/projects/extension- wt\_gallery/issues `_ - Feature Request: Write me an Email on `www.einpraegsam.net `_ .. _Additional-links: Additional links ---------------- **You can use one of the following links, to get more informations about this plugin:** - Authors (Alex Kellner) homepage: `http://www.einpraegsam.net `_ - Free help form the community: `http://www.typo3.net/ `_ - Don't miss the best TYPO3 blogging page: `http://www.typo3blogger.de/ `_ Real estate software for projects: `http://www.conject.com/ `_ |img-24| wt\_gallery - 41 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.jpeg .. :align: left .. :border: 0 .. :height: 299 .. :id: Grafik7 .. :name: Grafik7 .. :width: 447 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 298 .. :id: Grafik1 .. :name: Grafik1 .. :width: 445 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 392 .. :id: Grafik3 .. :name: Grafik3 .. :width: 451 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 284 .. :id: Grafik25 .. :name: Grafik25 .. :width: 454 .. |img-5| image:: img-5.jpeg .. :align: left .. :border: 0 .. :height: 209 .. :id: Grafik27 .. :name: Grafik27 .. :width: 458 .. |img-6| image:: img-6.jpeg .. :align: left .. :border: 0 .. :height: 196 .. :id: Grafik2 .. :name: Grafik2 .. :width: 564 .. |img-7| image:: img-7.jpeg .. :align: left .. :border: 0 .. :height: 192 .. :id: Grafik4 .. :name: Grafik4 .. :width: 480 .. |img-8| image:: img-8.jpeg .. :align: left .. :border: 0 .. :height: 264 .. :id: Grafik5 .. :name: Grafik5 .. :width: 484 .. |img-9| image:: img-9.jpeg .. :align: left .. :border: 0 .. :height: 207 .. :id: Grafik9 .. :name: Grafik9 .. :width: 484 .. |img-10| image:: img-10.jpeg .. :align: left .. :border: 0 .. :height: 208 .. :id: Grafik10 .. :name: Grafik10 .. :width: 486 .. |img-11| image:: img-11.jpeg .. :align: left .. :border: 0 .. :height: 371 .. :id: Grafik11 .. :name: Grafik11 .. :width: 669 .. |img-12| image:: img-12.jpeg .. :align: left .. :border: 0 .. :height: 302 .. :id: Grafik15 .. :name: Grafik15 .. :width: 473 .. |img-13| image:: img-13.jpeg .. :align: left .. :border: 0 .. :height: 378 .. :id: Grafik22 .. :name: Grafik22 .. :width: 559 .. |img-14| image:: img-14.png .. :align: left .. :border: 0 .. :height: 324 .. :id: Grafik6 .. :name: Grafik6 .. :width: 245 .. |img-15| image:: img-15.png .. :align: left .. :border: 0 .. :height: 383 .. :id: Grafik8 .. :name: Grafik8 .. :width: 276 .. |img-16| image:: img-16.jpeg .. :align: left .. :border: 0 .. :height: 231 .. :id: Grafik13 .. :name: Grafik13 .. :width: 142 .. |img-17| image:: img-17.jpeg .. :align: left .. :border: 0 .. :height: 120 .. :id: Grafik14 .. :name: Grafik14 .. :width: 500 .. |img-18| image:: img-18.jpeg .. :align: left .. :border: 0 .. :height: 163 .. :id: Grafik16 .. :name: Grafik16 .. :width: 148 .. |img-19| image:: img-19.jpeg .. :align: left .. :border: 0 .. :height: 342 .. :id: Grafik19 .. :name: Grafik19 .. :width: 306 .. |img-20| image:: img-20.jpeg .. :align: left .. :border: 0 .. :height: 326 .. :id: Grafik18 .. :name: Grafik18 .. :width: 308 .. |img-21| image:: img-21.png .. :align: left .. :border: 0 .. :height: 36 .. :id: Grafik21 .. :name: Grafik21 .. :width: 520 .. |img-22| image:: img-22.png .. :align: left .. :border: 0 .. :height: 36 .. :id: Grafik24 .. :name: Grafik24 .. :width: 521 .. |img-23| image:: img-23.png .. :align: left .. :border: 0 .. :height: 101 .. :id: Grafik23 .. :name: Grafik23 .. :width: 599 .. |img-24| image:: img-24.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102