.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt .. role:: underline ============== EXT: rgnewsimg ============== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2008-04-13T12:52:18 :Author: Georg Ringer (just2b) :Email: http://www.ringer.it :Info 3: :Info 4: .. _EXT-rgnewsimg: EXT: rgnewsimg ============== Extension Key: **rgnewsimg** Copyright 2000-2002, Georg Ringer (just2b), 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 ----------------- **EXT: rgnewsimg 1** **Introduction 1** What does it do? 1 Demo 1 Screenshots 2 **Users manual 5** Install the Extension 5 Use the Extension 5 **Administration 5** Modify the selection 5 **Configuration 5** Templates 5 TypoScript 6 Reference 6 **You like the extension? 7** **Known problems 7** **To-Do list 7** **Changelog 7** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension allows to apply different design sets to the images of a single tt\_news record. So you can split the images in 1 big image, 3 smaller images and display the remaining images as very small thumbnails. Furthermore It is possible to switch the whole template including the whole TS you can apply to tt\_news. Please take a look at the demo & screenshots to get an impression of the extension! .. _Demo: Demo ^^^^ Please take a look at the online demo at my website to get the best impression of this extension! - in English: `http://www.rggooglemap.com/en/dev/rgnewsimg.html `_ - in German: `http://www.rggooglemap.com/dev/rgnewsimg.html `_ .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-1| **Image 1:** A big headerimage and the usual small images |img-2| **Image 2:** A larger headerimage and 2 images at the right side and the rest at the left side. |img-3| **Image 3:** 2 header images followed by 3 images in a row and the rest is at the left side next to the text |img-4| **Image 4:** Backend to choose the layout .. _Users-manual: Users manual ------------ .. _Install-the-Extension: Install the Extension ^^^^^^^^^^^^^^^^^^^^^ Install the extension with the Extension Manager Include the static TS (from extension) in the template record (your root TS or make an ext. template just for the page where you want the extension be displayed). :underline:`**The steps for the real beginners are**` : Select your root/first page. Click in the menu on the left side “Template” and choose “Edit whole record”. Scroll down until you see the the same thing as in the screenshot shown. Search for the “tt\_news Image-Designsets” entry on the right side, click on it to get it on the left side. Press “Save” and you are done. |img-5| Modify your news-templates. Basically you need new markers like ###NEWS\_IMAGE\_1###, ###NEWS\_IMAGE\_2###. For further information take a look at the chapter Configuration. .. _Use-the-Extension: Use the Extension ^^^^^^^^^^^^^^^^^ After the installation you can just switch the Designsets in the news record and enjoy the results. .. _Administration: Administration -------------- .. _Modify-the-selection: Modify the selection ^^^^^^^^^^^^^^^^^^^^ It is very easy to modify the selection inside a tt\_news record using the Page TsConfig! **Add a new item** The ID in this example is 10 and the text would be “New Designset”. If you want to add an image too, you need to create the entry in an ext\_tables.php file because it is not possible with TsConfig. :: TCEFORM.tt_news.tx_rgnewsimg_design.addItems.10 = New Designset **Remove an existimg item** This would remove the designsets 2 & 3 :: TCEFORM.tt_news.tx_rgnewsimg_design.removeItems = 2,3 .. _Configuration: Configuration ------------- .. _Templates: Templates ^^^^^^^^^ If you want to use this extension you need to set some additional markers in the single view subpart of tt\_news. The markers are called ###NEWS\_IMAGE\_1###, ###NEWS\_IMAGE\_2###, ###NEWS\_IMAGE\_3### and so on. You need one marker for every image set. Non-used markers won't be displayed in the frontend (just up to ###NEWS\_IMAGE\_10###). .. _TypoScript: TypoScript ^^^^^^^^^^ There are already 3 demo design sets included with the extension. You can see all 3 at my website `http://www.rggooglemap.com/dev/rgnewsimg.html `_ **Get the design sets in TS** Do get the chosen design set with TS you need to use the included condition which needs to be included first (which is already done in the static TS. :: # TS Code includeLibs.rgnewsimg = EXT:rgnewsimg/condition.php [userFunc = user_rgnewsimg(1)] ... [global] The '1' stands for the selected design set with the key 1. You can also set one condition for more designsets by using this syntax: :: # TS Code [userFunc = user_rgnewsimg(4,5,6)] **Override the TS of a design set** To override the settings of the given sets you just need to use a code like this (which would override the settings of the design set #2. :: # TS Code [userFunc = user_rgnewsimg(2)] plugin.tt_news { rgnewsimg = 1 rgnewsimg { split = 1,2,4 image1 { file { width = 200c height = 200c } } image3WithCaption.wrap =
|
image3AllWrap.wrap =
|
} } [global] Styling with CSS **For more information** Please take a look at the ext/rgnewsimg/static/setup.txt if you want to know what all is set by default. .. _Reference: Reference ^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _rgnewsimg: rgnewsimg """"""""" .. container:: table-row Property rgnewsimg Data type boolean Description De-/Activate rgnewsimg Default .. _rgnewsimg-split: rgnewsimg.split """"""""""""""" .. container:: table-row Property rgnewsimg.split Data type string Description According to this property the images will be splitted. **Examples:** :: # 1 image followed by 10 split = 1,10 # 2 images followed by 3 followed by 4 split = 2,3,4 Default .. _rgnewsimg-imageXAllWrap: rgnewsimg.imageXAllWrap """"""""""""""""""""""" .. container:: table-row Property rgnewsimg.imageXAllWrap Data type stdWrap Description StdWrap for the complete image set. The X stands for the number of the imageset, e.g. image2AllWrap will be a stdWrap for the 2 :sup:`nd` image set. Default wrap =
\|
.. _rgnewsimg-imageXWithCaption: rgnewsimg.imageXWithCaption """"""""""""""""""""""""""" .. container:: table-row Property rgnewsimg.imageXWithCaption Data type stdWrap Description StdWrap for a single image including its caption. Default wrap =
\|
.. _rgnewsimg-imageX: rgnewsimg.imageX """""""""""""""" .. container:: table-row Property rgnewsimg.imageX Data type imgResource Description Modify all images of the image set X by using this property. Take a look at the TsRef how to do it. **Examples:** :: image2 { file { width = 100 height = 100 } imageLinkWrap = 1 imageLinkWrap { enable = 1 bodyTag = wrap = | width = 500m height = 500 JSwindow = 1 JSwindow.newWindow = 1 JSwindow.expand = 17,20 } } Default .. ###### END~OF~TABLE ###### [tsref:plugin.tt\_news] .. _You-like-the-extension: **You like the extension?** --------------------------- **I really had much work with this extension so if you like this extension, you can do one or more of the following things:** - Write me a mail or create a posting at `http://www.rggooglemap.com/en//dev/rgnewsimg.html `_ . - Please rate the extension in the Repository: `http://typo3.org/extensions/ `_ search for rgnewsimg, click on the title and then at “Ratings” (You need to be registered and logged in at typo3.org) - Donate something, so that I can write those kind of extensions for you. More information is here: German: `http://www.rggooglemap.com/menu/spende.html `_ and English: `http://www.rggooglemap.com/en/2/donate.html `_ . Thanks! **One of those things is the least you can do for getting all those great extensions completely for free!** .. _Known-problems: Known problems -------------- - Cropping can produce images with a bad quality. Check therefor this patch, it works e.g. on my website! `http://bugs.typo3.org/view.php?id=4186 `_ - Nothing that I know. Did I miss something? .. _To-Do-list: To-Do list ---------- Nothing planned. Did I miss something? .. _Changelog: Changelog --------- 1.0.0 Initial upload |img-6| EXT: rgnewsimg - 7 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.jpeg .. :align: left .. :border: 0 .. :height: 565 .. :id: Grafik1 .. :name: Grafik1 .. :width: 581 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 609 .. :id: Grafik2 .. :name: Grafik2 .. :width: 581 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 600 .. :id: Grafik3 .. :name: Grafik3 .. :width: 434 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 286 .. :id: Grafik4 .. :name: Grafik4 .. :width: 669 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 191 .. :id: Grafik5 .. :name: Grafik5 .. :width: 547 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102