This page is still a beta!

1.4. Reference

This is the TS reference of the extension. It is divided into the sections General, Category, Gallery & Single.

Take a look at the file ext_typoscript_setup inside the extension directory to see the default configuration.

General

General settings which are needed for any view.

Property:

Data type:

Description:

Default:

_DEFAULT_PI_VARS

Use _DEFAULT_PI_VARS to set default piVars. _DEFAULT_PI_VARS.single = 1 is set to show the first image by default in the single view.

_DEFAULT_PI_VARS.single = 1

mode

String, stdWrap

Possible: LIST to show the list view or GALLERY to show a single gallery

templateFile

string, stdWrap

Path to the template

EXT:chgallery/res/template.html

pathToCSS

string, stdWrap

Path to the CSS file. Leave this empty to include no CSS file.

EXT:chgallery/res/gallery.css

pagebrowser

int, stdWrap

How many images should be displayed in one page.

9

fileTypes

string, stdWrap

All allowed filetypes which are displayed inside the gallery

jpg,gif,png

path

string, stdWrap

The path to the files. This needs to be something like fileadmin/gallery/example/

useAnchor

boolean, stdWrap

Use Anchors in the links to avoid scrolling to the gallery element. The anchors are set by TYPO3 and not by the extension.

1

single

Boolean

Use this to let the plugin know that a single view is used.

categoryOrder

String

Sort the categories by using either path, size, title, description, name or date.

path

categoryOrderAscDesc

String

Sorting direction. Possible values are asc and desc.

asc

link

string, stdWrap

Link all images to a specific url/page/...

link.

typolink

Specify the “link all images” and use all options from the usual typolink

ajaxScript

string, stdWrap

Path to the js file

EXT:chgallery/res/js/ajax.js

pathToMootools

string, stdWrap

Path to the Mootools lib if t3mootools is not used

EXT:chgallery/res/js/mootools.js

ajax

boolean, stdWrap

Enable ajax

0

ratings

boolean, stdWrap

Enable ratings of each image. Requirements: Set this to 1 and install the extension ratings.

1

ratings.

Configuration of ratings

exif

boolean

Enable exif functions

1

cooliris

boolean

Enable cooliris

0

cooliris.link

typolink

Configuration of the link to the RSS feed with the images

Default configuration:

link {

useCacheHash = 1

returnLast = url

additionalParams = &type=9713

}

cooliris.showAllGalleriesInCategory

boolean

If set and category view is used and you are inside a gallery, Cooliris  will still show all images and not just of this category.

0

cooliris.logo

String

Set a url to the logo which should be displayed in Cooliris,

cooliris.prefixUrl

boolean

If set, the images will be prefixed with the current domain

[tsref:plugin.tx_chgallery_pi1 ]

CATEGORY view

This part of the reference is for the LIST view. Use plugin.tx_chgallery_pi1.category.XXX

Property:

Data type:

Description:

Default:

image

IMAGE

Configure the preview image

file.maxW = 100

link

TYPOLINK

Configure the link to the gallery view

useCacheHash = 1

date

stdWrap

Creation time of the directory

strftime.%d.%m.%Y  %H:%m

size

stdWrap

StdWrap for the size of a category

description

stdWrap

StdWrap for the description of a category

path

stdWrap

StdWrap for the path of a category

title

stdWrap

StdWrap for the title of a category

[tsref:plugin.tx_chgallery_pi1.list ]

GALLERY view

This part of the reference is for the GALLERY view. This part is also used if no categories are used. Use  plugin.tx_chgallery_pi1.gallery.XXX

Property:

Data type:

Description:

Default:

excludeFirstImage

boolean

Exclude the 1st image from this view. Can be used to use this image as preview image.

0

image

IMAGE

Configuration of the image

Default configuration:

file {

maxW = 139

maxH = 110

}

description

stdWrap

Configuration of the description of each image

Default configuration:

ifEmpty =  

dir_title

stdWrap

StdWrap for the title of the category, if categories are used

Default configuration:

required = 1

stdWrap.wrap = <strong>|</strong>

dir_description

stdWrap

StdWrap for the description of the category, if categories are used

Default configuration:

required = 1

stdWrap.wrap = <br />|<br />

download

filelink

Take a look at the SINGLE view reference

exif_size

stdWrap

Take a look at the SINGLE view reference

exif_time

stdWrap

Take a look at the SINGLE view reference

renderAllLinks

boolean

If enabled, links to all images are rendered. If you are on page 2 of 3 and you are using any lightbox, you will get all images in the lightbox presented.

Default configuration:

renderAllLinks = 1

renderAllLinks {

title.field= tx_chgalleryTitle

parameter.override.cObject = IMG_RESOURCE

parameter.override.cObject {

file.import.field = tx_chgalleryImageLong

file.maxW = 800

file.maxH = 600

}

ATagParams = rel="lightbox"

ATagParams.override = rel="lightbox[presentlb{field:uid}]"

ATagParams.insertData = 1

}

0

[tsref:plugin.tx_chgallery_pi1.gallery ]

SINGLE view

This part of the reference is for the SINGLE view. Use  plugin.tx_chgallery_pi1.single.XXX

Property:

Data type:

Description:

Default:

image

IMAGE

Configuration of the single image

Default configuration:

file {

maxW = 554

}

pass

boolean

If set the current single view image is still shown if the page browser in the gallery view is used.

1

download

filelink

Download link to the image using the TS function filelink.

Default configuration:

download {

labelStdWrap.field= tx_chgalleryTitle // tx_chgalleryFilename

icon = 1

icon_link = 1

icon {

noTrimWrap = | | |

}

size = 0

size {

noTrimWrap = | (| Bytes) |

bytes = 1

bytes.labels =  | Kb| Mb| Gb

}

jumpurl = 1

jumpurl.secure = 1

}

exif_size

stdWrap

Size of the image using exif

Default configuration:

exif_size {

bytes = 1

bytes.labels =  | Kb| Mb| Gb

}

exif_time

stdWrap

Date of the image using exif

strftime= %d.%m.%Y  %H:%m

[tsref:plugin.tx_chgallery_pi1.single ]

Available markers

If you want to know which markers are available take a look at the default template template.html. All markers are listed in the top of the document!