Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source Magazine

1.5. Advanced configuration

External Thumbnails

It is very easy to show the thumbnails of rgsmoothgallery in an external place. An example is here: http://www.rggooglemap.com/dev/rgsmoothgallery/smoothgallery-mit-externen-thumbnails.html (English http://www.rggooglemap.com/en/dev/rgsmoothgallery/smoothgallery-with-external-thumbnails.html )

All you need is to insert in the field “External Thumbs DIV ID“ the id of a div element or to add the id with TS

plugin.tx_rgsmoothgallery_pi1.externalthumbs = ext-thumbnails 

and an html-element with this content

<div id=”ext-thumbnails”></div>

To get the output as in the example, you need to include the sample CSS like in this way:

page.includeCSS.file21 = EXT:rgsmoothgallery/res/css/externalThumbs.css 

Important: This feature changed in version 1.0.7 but it still possible to use it like in version 1.0.6!

Cropped images

Sometimes it is useful to crop images instead of using the proportions of an image. An example is here: http://www.rggooglemap.com/dev/rgsmoothgallery/smoothgallery-mit-beschnittenen-bildern.html (English: http://www.rggooglemap.com/en/dev/rgsmoothgallery/smoothgallery-with-cropped-images.html )

The configuration for the samples is

SmoothGallery I

Width of image: 330c+30
Height of image: 330c-25
Width of gallery: 330
Height of gallery: 330

SmoothGallery II

Width of image: 420c
Height of image: 160c
Width of gallery: 420
Height of gallery: 160

SmoothGallery III

Width of image: 420c
Height of image: 160c
Width of gallery: 420
Height of gallery: 190 

More information about cropping can be found in the TsRef: http://typo3.org/documentation/document-library/references/doc_core_tsref/4.1.0/view/5/2/

Watermarks

If you want to use watermarks on your images you need to activate this feature inside the flexforms or with Typoscript. An example is located here: http://www.rggooglemap.com/dev/rgsmoothgallery/smoothgallery-mit-wasserzeichen.html (English: http://www.rggooglemap.com/en/dev/rgsmoothgallery/smoothgallery-with-watermarks.html)

To configure it, take a look at the static TS (located at ext/rgsmoothgallery/pi1/static/setup.txt):

TS-CODE

plugin.tx_rgsmoothgallery_pi1 {
  big2 = IMG_RESOURCE
  big2 {
    file = GIFBUILDER 
    file { 
      XY = [10.w],[10.h] 
      10=IMAGE 
      10 {           
        file.maxW=460
        file.maxH=345
      }
      20=TEXT 
      20 {
        text.data = date:Y 
        text.noTrimWrap = |(c) | by somebody | 
        align=right 
        offset=0,[10.h]-45 
        fontSize=10 
        fontColor=#ffffff 
        #niceText=1 
      } 
    } 
  }    
}

So this code changes the text of the copyright only:

plugin.tx_rgsmoothgallery_pi1.big2.file.20.text.noTrimWrap = |(c) | by Georg Ringer | 

To change the lightbox image, you need to do the same thing with lightbox2 instead of lightbox.

Please be aware: Using this features influences the quality of the image in a bad way. You can see the differences on the example page. You can make the output better with changing jpg_quality in the install tool (Section “All configuration) to 100

[GFX][jpg_quality] = 100 

Alternative Layout & Design

It is quite boring to see the same layout over and over and it is very easy to change the layout yourself. The following code and link should serve as an example:

DE: http://www.rggooglemap.com/dev/rgsmoothgallery/smoothgallery-mit-erweiterten-einstellungen.html

EN: http://www.rggooglemap.com/en/dev/rgsmoothgallery/smoothgallery-with-advanced-settings.html

You just need to change the path to 2 CSS files which come with the latest version of rgsmoothgallery.

TS-CODE

plugin.tx_rgsmoothgallery_pi1 { pathToJdgalleryCSS = EXT:rgsmoothgallery/res/css/jd.galleryColor.css pathToSlightboxCSS = EXT:rgsmoothgallery/res/css/slightboxColor.css} 

Include a gallery with TS only

To include the rgSmoothgallery just with TS you need to look up the section “Reference”. 2 simple examples are shown here

1st example: A gallery with images out of a directory, changing every 5 seconds, lightbox,arrwos and thums available and limited to 10 images

TS-CODE

lib.randomImage < plugin.tx_rgsmoothgallery_pi1
lib.randomImage {
  mode = DIRECTORY
  duration = 5000
  startingpoint = fileadmin/here_are_my_images/
  lightbox = 1
  showThumbs = 1
  arrows = 1
  limitImagesDisplayed = 10
}

2nd example: A gallery displaying images out of records with just arrows to switch to the previous & next image.

TS-CODE

lib.randomImage2 < plugin.tx_rgsmoothgallery_pi1
lib.randomImage2 {
  mode = DIRECTORY
  # 63 = uid of the page where the records are saved
  startingpointrecords = 63
  arrows = 1
}

!! Be aware: If you insert more than one rgsmoothgallery with TS, you need to add an extra command to differ the 2 galleries. It is not important what you insert as id but it need to be unique – it can be a number or just a single character.

TS-CODE

lib.randomImage < plugin.tx_rgsmoothgallery_pi1
lib.randomImage {
  ...
}
lib.randomImage < plugin.tx_rgsmoothgallery_pi1
lib.randomImage {
  ...
  id = something
}