MBKD :: Image Lightbox - Image Galleriy - Differen
Copyright © by Markus Brunner, Katja Deutschmann <mail@markusbrunner-design.de, mail@katjadeutschmann.de>Published under the Open Content License available from http://www.opencontent.org/opl.shtml
Table Of Contents
- 1. EXT: Image Lightbox - Image Gallery
- 1.1. Extension Key: mbkdimagelightbox
- 1.2. Language: en
- 1.3. Keywords: image, lightbox, gallery, smoothgallery, imagepreview, popeye, contentflow, jqueryzoom, galleriffic
- 1.4. Copyright 2000-2008, Markus Brunner, Katja Deutschmann, <mail@markusbrunner-design.de, katja.deutschmann@gmx.de>
- 1.5. Read online
- 1.6. This document is published under the Open Content License
- 1.7. available from http://www.opencontent.org/opl.shtml
- 1.8. Read online
- 1.9. The content of this document is related to TYPO3
- 1.10. - a GNU/GPL CMS/Framework available from www.typo3.org
- 1.11. Read online
- 1.12. Introduction
- 1.13. Users manual
- 1.14. Administration
- 1.15. Read online
- 1.16. Configuration
- At first include the static TypoScript-File “MBKD :: ImageLightbox STD Values” into your Main Template, or alternatively add all TypoScript-Setup of this file (EXT:mbkdimagelightbox/static/MBKD____Image_Lightbox_standard_values/setup.txt) directly into your TS-Setup:
- Read online
- Read online
- Specific Wrappers for Imagesets and Images
- This extension inserts two database-tables “tx_mbkdimagelightbox_imagesetwrap” for Image-Set-Wraps and “tx_mbkdimagelightbox_imagewrap” for Image-Wraps. You can define those wrappers within any folder in your TYPO3-Backend. Just select the List-Module and insert a new record for Imagesets or Images (there are also some default wrappers you can find in the file EXT:mbkdimagelightbox/ext_tables_static+adt.sql for SQL-Insert via a SQL-Tool, if automatic insert did not succeed):
- Read online
- Read online
- TypoScript
- Read online
- CSS
- Just overwrite existing CSS with your own one in your CSS. If you do not like the standard-CSS of the extensionparts you can also deactivate them via TypoScript (lightbox.usedefaultcss, lightbox.pagebrowser.usedefaultcss, smoothgallery.usedefaultcss, thumbzoomer.usedefaultcss).
- Extensionaccess
- If you want to include this extension as a developer directly into your own extension, you can do this via some specific TypoScript-Setup, PHP and Flexform-XML only used for this purpose (see mbprojects for an integration-example).
- Flexform: you can copy the flexform of mbkdimagelightbox, to get all input possibilities of the extension → EXT:mbkdimagelightbox/flexform.xml – for getting the flexform initialized, you have to add some lines to your extension's ext_tables.php:
- Read online
- /*
- * Flexform integration
- */
- $TCA['tt_content']['types']['list']['subtypes_addlist'][$_EXTKEY.'_pi1'] ='pi_flexform';
- t3lib_extMgm::addPiFlexFormValue($_EXTKEY.'_pi1', 'FILE:EXT:'.$_EXTKEY . '/flexform.xml');
- Read online
- PHP: her is a method out of mbprojects you can use 1:1 for integration in your own extension; fill the method with infos out of flexform:
- Read online
- /**
- * @param $extKeyextKey of your extension
- * @param $imgPathpath to your images – needed for next variable $imagefiles
- * @param $imagefilescomma separated string of image files e.g. “file1.jpg,file2.gif,file3.png”
- * @param $imagefolderfolder to read all images
- * @param $startingpointdam
- * @param $startingpointdamcat
- * @param $imagetitlesimagetitles for all images, new line for next image
- * @param $imagesubtitleslike $imagetitles, but subtitles
- */
- private function _getExternalMBKDImageLighbox($extKey, $imgPath = '', $imagefiles = '', $imagefolder = '', $startingpointdam = '', $startingpointdamcat = '', $imagetitles = '', $imagesubtitles = '', $showLightbox = true) {
- Read online
- $content = '';
- Read online
- // include mbkdimagelightbox Extension
- if(t3lib_extMgm::isLoaded('mbkdimagelightbox') && $showLightbox) {
- // get imagelightbox-object
- include_once(t3lib_extMgm::extPath('mbkdimagelightbox').'pi1/class.tx_mbkdimagelightbox_pi1.php');
- $gallery = t3lib_div::makeInstance('tx_mbkdimagelightbox_pi1');
- $gallery->cObj = t3lib_div::makeInstance('tslib_cObj');
- // get TypoScript of extension
- $gallerySetup = $GLOBALS['TSFE']->tmpl->setup['plugin.']['tx_mbkdimagelightbox_pi1.'];
- // overwrite extension-TypoScript with external extension vars
- $gallerySetup['extensionaccess'] = 1;
- foreach($this->conf['mbkdimagelightbox.'] AS $key => $value) {
- $gallerySetup['extensionaccess.'][$key] = $value;
- }
- // fill extension vars
- $gallerySetup['extensionaccess.']['extKey'] = $extKey;
- $gallerySetup['extensionaccess.']['imgPath'] = $imgPath;
- // fill images
- $gallerySetup['extensionaccess.']['imagefiles'] = $imagefiles;
- $gallerySetup['extensionaccess.']['imagefolder'] = $imagefolder;
- $gallerySetup['extensionaccess.']['startingpointdam'] = $startingpointdam;
- $gallerySetup['extensionaccess.']['startingpointdamcat'] = $startingpointdamcat;
- // fill titles and subtitles
- $gallerySetup['extensionaccess.']['imagetitles'] = $imagetitles;
- $gallerySetup['extensionaccess.']['imagesubtitles'] = $imagesubtitles;
- // get ImageLightbox
- $content = $gallery->main("", $gallerySetup);
- }
- Read online
- return $content;
- }
- Read online
- Read online
- TypoScript-Setup you need to specify for your extension:
- Read online
- plugin.tx_MYPLUGINNAME_pi1 {
- mbkdimagelightbox {
- extKey = MYPLUGINEXTKEY e.g. mbprojects
- imgPath = uploads/tx_MYPLUGINEXTKEY/
- selectmode = 2
- imagesetname = MYIMAGESETNAME e.g. mbproject
- imagetitles_in_lightbox = 1
- hidepagebrowser = 1
- imagewrapperhtmlwrap = |
- imagesetwrapperhtmlwrap = |
- }
- }
- Include the extension-TypoScript-Setup directly into your TypoScript-Setup (alternative to static TypoScript-Setup-File)
- 1.17. Known problems
- 1.18. Read online
- 1.19. ChangeLog
- 1.20. Read online
This document is related to version 2.3.0 of the extension mbkdimagelightbox.