.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =========== linkhandler =========== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Michael Klapper :Changed: 2009-04-17T18:36:27.650000000 :Author: Daniel Pötzinger :Email: nospam@nospam.de :Info 3: :Info 4: .. _linkhandler: linkhandler =========== Extension Key: **linkhandler** Copyright 2000-2002, Daniel Pötzinger, 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 ----------------- **linkhandler 1** **Introduction 1** What does it do? 1 Screenshots 2 **Users manual 2** FAQ 2 **Adminstration 2** **Configuration 2** Reference Tsconfig 3 Reference Typoscript 3 **Tutorial 4** **Known problems 4** **To-Do list 4** **Changelog 4** **Important guidelines 5** **Issues with Open Office documentation for TYPO3 5** Inserting images 5 Paragraph styles 5 Linking 6 Meta data and updates 6 .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ - This extension enables you to link to any record you want. For that reasons it does two things: - 1.) Possibility to add as many additional TABS to the linkbrowser in the BE - 2.) Possibility to configure typolink setting to any records. This extension is optimized for TYPO3 4.2.\* But it includes a patch to work also for 4.1.x ! .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-1| .. _Users-manual: Users manual ------------ \- For editors the use is straightforward: They just need to make a link with the linkwizard (linkbrowser). Then they can click on a Tab like “News” and select the news they want to link to ... .. _FAQ: FAQ ^^^ .. _Adminstration: Adminstration ------------- To use the extension you have to do this steps: - be sure to have **PHP5** and at least **TYPO3 4.1.x** - Install the extension. **If you use TYPO3 < 4.2 set the checkbox in the extension manager to activate the patch** . - Add static template if you want (has tt\_news linkhandler setting) - Then you need to configure the tabs: - Available Tabs in BE: use (page)-TSConfig - Linkgeneration for the FE: Use typoscript. .. _Configuration: Configuration ------------- .. _Reference-Tsconfig: Reference Tsconfig ^^^^^^^^^^^^^^^^^^ You can configure as many tabs as you want. See example above. TSConfig Configuration path: :: mod.tx_linkhandler is used for normal linkbrowser RTE.default.tx_linkhandler is used for RTE linkbrowser .. ### BEGIN~OF~TABLE ### .. _: \* "" .. container:: table-row Property \* Data type linkhandler-tabconfig Description Set as many tab configurations you want Default .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Property Data type Description Default .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Property Data type Description Default .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Property Data type Description Default .. ###### END~OF~TABLE ###### [linkhandler tsconfig] .. ### BEGIN~OF~TABLE ### .. _label: label """"" .. container:: table-row Property label Data type String Description Speaking name for the tab (displayed in linkbrowser) Default .. _listTables: listTables """""""""" .. container:: table-row Property listTables Data type List Description \* or comma list of tables which should be listed for that tab Default .. _: :: "" .. container:: table-row Property :: onlyPids Data type List Description List of integers. If set only the rootlines to this pids are shown in the tree for the tab. Default .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Property Data type Description Default .. ###### END~OF~TABLE ###### [linkhandler tabconfig] .. _generated: ((generated)) """"""""""""" .. _Example-Default-TSConfig: Example / Default TSConfig: ~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: RTE.default.tx_linkhandler { record { label=Records listTables=* } tt_news { label=News listTables=tt_news onlyPids= } } mod.tx_linkhandler { record { label=Records listTables=* } tt_news { label=News listTables=tt_news onlyPids= } } .. _Reference-Typoscript: Reference Typoscript ^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _: \* "" .. container:: table-row Property \* Data type Typolink for record “\*” Description For each table you can and have to configure a typolink. The trick is that the tsobject is loaded with the data row of the linked record. So you can access uid and any field. :: plugin.tx_linkhandler { tt_news { parameter={$linkhandler.newsSinglePid} additionalParams=&tx_ttnews[tt_news]={field:uid} additionalParams.insertData=1 useCacheHash=1 } } Default .. _forceLink: forceLink """"""""" .. container:: table-row Property forceLink Data type Integer Description Force the creation of an typolink to a page also when the linked record are not available for the current fe\_user. Default 0 .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Property Data type Description Default .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Property Data type Description Default .. ###### END~OF~TABLE ###### [plugin.tx\_linkhandler] .. _generated: ((generated)) """"""""""""" .. _Example-Default-Typoscript: Example/Default Typoscript: ~~~~~~~~~~~~~~~~~~~~~~~~~~~ :: plugin.tx_linkhandler { tt_news { # force link generation also when the tt_news record are hidden or deleted forceLink = 0 # typolink settings parameter = {$linkhandler.newsSinglePid} additionalParams = &tx_ttnews[tt_news]={field:uid} additionalParams.insertData = 1 useCacheHash = 1 } } .. _Tutorial: Tutorial -------- This is possible: - use typoscript for different pages to link to different single pids - use the title of the record as alt text for the link - use typoscript conditions to build the link different depending on certain conditions... - use complex CASE objects to build fancy links... .. _Known-problems: Known problems -------------- - In 4.1 it works with a patch - PHP 5 is required .. _To-Do-list: To-Do list ---------- .. _Changelog: Changelog --------- \- 17-04-2009 Michael Klapper \* Update Documentation \- 08-04-2009 Michael Klapper \* fix Bug #2626, #3057, #3058, #1488, #1244, #2675 \* Add some PHPDoc \* Code indention \- 23-01-2009 Stefano Cecere \* fix Bug #1342 (rtehtmlarea hook name has changed)- 07-09-17 Daniel Pötzinger \* Initial release |img-2| linkhandler - 4 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 381 .. :id: Grafik1 .. :name: Grafik1 .. :width: 558 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102