.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =============== tt\_news Marker =============== :Created: 2010-10-13T21:40:33 :Changed by: dirk :Changed: 2014-10-31T16:25:07 :Classification: ttnews_marker :Description: Unlimited marker for tt_news: Use any marker in tt_news! Don\'t display news lists, if they are emptyAny Marker has the std_wrap property. There are special markers for a link and for counting. :Keywords: tt_news, marker, stdwrap, counting :Author: Dirk Wildt - Die Netzmacher :Email: http://wildt.at.die-netzmacher.de :Website: http://die-netzmacher.de :Language: en |img-1| |img-2| tt\_news Marker|img-3| .. _tt-news-Marker: tt\_news Marker =============== Unlimited marker for tt\_news: Use any marker in tt\_news! Don\'t display news lists, if they are emptyAny Marker has the std\_wrap property. There are special markers for a link and for counting. |img-4| Version: 3.6.0, 2014-10-31 Extension Key: ttnews\_marker Language: en Keywords: tt\_news, marker, stdwrap, counting Copyright 2009-2014, Dirk Wildt - Die Netzmacher, 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.org `_ .. _Table-of-Contents: Table of Contents ----------------- `tt\_news Marker 1 <#__RefHeading__1165_1172745218>`_ `Introduction 3 <#__RefHeading__2270_1366623199>`_ `What does it do? 3 <#__RefHeading__2136_1967628842>`_ `What do you need? 3 <#__RefHeading__2138_1967628842>`_ `Installation 4 <#__RefHeading__2140_1967628842>`_ `Extension Manager 4 <#__RefHeading__2142_1967628842>`_ `Include Static Template 4 <#__RefHeading__2144_1967628842>`_ `Markers 5 <#__RefHeading__2146_1967628842>`_ `System Defined Markers 5 <#__RefHeading__2148_1967628842>`_ `Registers 6 <#__RefHeading__2160_1967628842>`_ `User Defined Markers 7 <#__RefHeading__2164_1967628842>`_ `Tutorial 8 <#__RefHeading__2168_1967628842>`_ `HTML Template and TypoScript 8 <#__RefHeading__2170_1967628842>`_ `HTML Output and Generated Code 8 <#__RefHeading__2172_1967628842>`_ `Output only if there is an item at least 8 <#__RefHeading__2174_1967628842>`_ `Reference 9 <#__RefHeading__2176_1967628842>`_ `System Markers 9 <#__RefHeading__2178_1967628842>`_ `User Defined Markers 10 <#__RefHeading__2180_1967628842>`_ `Code 10 <#__RefHeading__2182_1967628842>`_ `FAQ 11 <#__RefHeading__2190_1967628842>`_ `SimulateStaticDocuments and RealURL 11 <#__RefHeading__2192_1967628842>`_ `Changelog 12 <#__RefHeading__2204_1967628842>`_ `Further Information 13 <#__RefHeading__5023_1340805417>`_ `Feature Requests and Suggestions 13 <#__RefHeading__5025_1340805417>`_ `Professional Support 13 <#__RefHeading__4076_1304872024>`_ `Other extensions published by Die Netzmacher 14 <#__RefHeading__11111_182679940>`_ `Illustration Index 15 <#__RefHeading__5651_1106668378>`_ `Change log 16 <#__RefHeading__6733_1266816573>`_ .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ - The extension tt\_news Marker extends tt\_news for using - user defined markers and - system defined markers like for a news URL or item counters and - the new codes LIST\_ONLY\_WITH\_ITEMS and LATEST\_ONLY\_WITH\_ITEMS - Every self defined marker has the std\_wrap property. - If you use the extension tt\_news select configuration (extkey: ttnews\_selectconf) too, you can filter your news items by fe\_users for example. .. _What-do-you-need: What do you need? ^^^^^^^^^^^^^^^^^ - The extension tt\_news. - The extension ttnews\_selectconf, if you want to filter news items by SQL properties. - A little bit experience with TypoScript. .. _Installation: Installation ------------ .. _Extension-Manager: Extension Manager ^^^^^^^^^^^^^^^^^ Open the extension manager, download the extension tt\_news Marker (extkey: ttnews\_marker) and install it. |img-5| .. _Include-Static-Template: Include Static Template ^^^^^^^^^^^^^^^^^^^^^^^ |img-5| Include the static template from the extension in the template of that page where you are using tt\_news plugins. This is the root page probably. .. _Markers: Markers ------- The tt\_news plugin has the new array "extensions" after installation of the extension tt\_news Marker. You can configure extensions for tt\_news here. .. _System-Defined-Markers: System Defined Markers ^^^^^^^^^^^^^^^^^^^^^^ |img-5| There are some so called system defined markers in the default mode. They have the following meaning: .. _href: href """" - Is a link to a news item in the single view.Examples for values are: - index.php?id=87&tt\_news[tt\_news]=1234&... - festival/datum/2009/03/26/titel/internationale-figurentheaternaechte- reutlingen/ - If you like to use the value in your tt\_news template use the marker ###HREF### - tt\_news has the ###LINK\_ITEM### for this case. ###HREF### has only a sense, if you want to edit the link. I.e. you need an absolute URL with a foreign host. - href has the typolink property only. .. _num-plugin: num\_plugin """"""""""" - Is a counter for the used tt\_news plugins in the current page. - If you like to use the value in your tt\_news template use the marker ###NUM\_PLUGIN### - num\_plugin has the std\_wrap property. .. _num-items-cur-plugin: num\_items\_cur\_plugin """"""""""""""""""""""" - Is a counter for the displayed tt\_news items in the current plugin. - If you use more than one tt\_news plugin on the current page, the counter will begin in every next plugin with 1 again. - If you like to use the value in your tt\_news template use the marker ###NUM\_ITEMS\_CUR\_PLUGIN### - num\_items\_cur\_plugin has the std\_wrap property. .. _num-items-cur-page: num\_items\_cur\_page """"""""""""""""""""" - Is a counter for the displayed tt\_news items in the current page. - If you use more than one tt\_news plugin on the current page, the counter will count ahead. - If you like to use the value in your tt\_news template use the marker ###NUM\_ITEMS\_CUR\_PAGE### - num\_items\_cur\_page has the std\_wrap property. .. _std-wrap-Property: std\_wrap Property """""""""""""""""" Every marker item has the std\_wrap property but href. href has the typolink property only. If you want wrap the number of the item as a header use this code f.e: plugin.tt\_news { extensions { ttnews\_marker { marker { num\_items\_cur\_page { wrap =

\|

} } } } } .. _Registers: Registers ^^^^^^^^^ The values of the system defined markers are stored in registers. The name of the register is the name of the system defined marker in upper case. You can use the value of every system defined marker in your TypoScript after ttnews\_marker is used. Thanks to Krystian Szymukowicz for the code snippet. .. _Example: Example """"""" .. _Code-snippet: Code snippet ~~~~~~~~~~~~ page.10.subparts.news.40 = TEXT page.10.subparts.news.40 { .. _value-ERROR-There-isn-t-any-register-called-NUM-ITEMS-CUR-PAGE: value = ERROR: There isn't any register called NUM\_ITEMS\_CUR\_PAGE. ?? override { data = register:NUM\_ITEMS\_CUR\_PAGE } noTrimWrap = \|\| news are on this page\| } |img-5| |img-5| The TypoScript code generates a line like in the illustration above on the left hand: 22 news are on this page In case of an error it will generates ERROR: There isn't any register called NUM\_ITEMS\_CUR\_PAGE. ?? news are on this page See the illustration on the right hand. Error means: Your TypoScript code will be rendered before any tt\_news plugin is handled. .. _User-Defined-Markers: User Defined Markers ^^^^^^^^^^^^^^^^^^^^ If you need any marker - add the name in uppercase to the HTML template - add the name in lowercase to the typscript .. _Example-for-a-self-defined-marker-a-href: Example for a self defined marker a\_href """"""""""""""""""""""""""""""""""""""""" Use ###A\_HREF### in the tt\_news HTML template like ion the example below:

|: } } **HTML template example:** :: ###NUM_PLUGIN### ###NEWS_TITLE### Default .. _num-items-cur-plugin: num\_items\_cur\_plugin """"""""""""""""""""""" .. container:: table-row Property num\_items\_cur\_plugin Data type std\_wrap Description This marker displays the number of the used tt\_news item in the current plugin. If you use two plugins f.e, all tt\_news items in the first plugin will counted from one to the last number of the news in this plugin, and all news items in the second plugin will be counted from one to the last number of the last news item of the second plugin. See the example below. **Typoscript example:** :: plugin.tt_news.extensions.ttnews_marker.marker { num_items_cur_plugin { wrap = |: } } **HTML template example:** :: ###NUM_ITEMS_CUR_PLUGIN### ###NEWS_TITLE### Default .. _num-items-cur-page: num\_items\_cur\_page """"""""""""""""""""" .. container:: table-row Property num\_items\_cur\_page Data type std\_wrap Description This marker displays the number of all used tt\_news in a page. **Typoscript example:** :: plugin.tt_news.extensions.ttnews_marker.marker { num_items_cur_page { wrap = |: } } **HTML template example:** :: ###NUM_ITEMS_CUR_PAGE### ###NEWS_TITLE### Default .. ###### END~OF~TABLE ###### .. _User-Defined-Markers: User Defined Markers ^^^^^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _marker: *marker* """""""" .. container:: table-row Property *marker* Data type std\_wrap Description *marker* is a self defined element in the array marker. It has the std\_wrap property. See the examples below with the self defined marker "my\_marker" **HTML marker:** :: ###MY_MARKER### **Typoscript example I:** :: plugin.tt_news.extensions.ttnews_marker.marker { my_marker { value = My Title wrap =

|

} } **HTML result:** ::

My Title

Use the field property, if you need a value from the current news record. We take the title field of a tt\_news and crop in the example below: **Typoscript example II:** :: plugin.tt_news.extensions.ttnews_marker.marker { my_marker { field = title wrap =

|

crop = 20|...|1 } } **HTML result:** ::

The Title of the ...

Use the field property, if you need a value from the current news record. We take the title field of a tt\_news and crop in the example below: **Typoscript example III:** :: plugin.tt_news.extensions.ttnews_marker.marker { my_marker { typolink { parameter = 67 returnLast = url } } } **HTML result:** :: index.php?id=67 // Without Real-URL my_path1/my_path2/my_page // With Real-URL Default .. ###### END~OF~TABLE ###### .. _Code: Code ^^^^ .. ### BEGIN~OF~TABLE ### .. _code: code """" .. container:: table-row Property code Data type tt\_news.code Description Set the tt\_news property code like in the example below, if you don't want any HTML in LIST view if there isn't any tt\_news item. **Typoscript example:** :: plugin.tt_news { code = LIST_ONLY_WITH_ITEMS } plugin.tt_news { code = LATEST_ONLY_WITH_ITEMS } Default .. ###### END~OF~TABLE ###### .. _FAQ: FAQ --- .. _SimulateStaticDocuments-and-RealURL: SimulateStaticDocuments and RealURL ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ There isn't any known problem with SimulateStaticDocuments or RealURL. .. _Changelog: Changelog --------- 3.6.0 **Major Feature** \* #i0001: Upgrade TYPO3 6.2 1.0.1 **New features** \* Handling for internal and external links was addedThanks to Stefan Kroecher for the code snippet\* Values of system markers are stored in TypoScript registersThanks to Krystian Szymukowicz for the code snippet 1.0.0 **New Main Version** \* Changed status to stable 0.1.1 **New Feature** \* Code LATEST\_ONLY\_WITH\_ITEMS 0.0.6 **Maintenance** \* Update the manual 0.0.5 **Maintenance** \* Update the manual 0.0.3 **Changed extKey** \* Initial release of ttnews\_href\_marker is obsolete now 0.0.2 **Publishing** 0.0.1 **Initial release** \* As ttnews href marker (extkey: ttnews\_href\_marker) .. _Further-Information: Further Information ------------------- .. _Feature-Requests-and-Suggestions: Feature Requests and Suggestions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you have helpful suggestions please send an e-mail to `http://wildt.at.die-netzmacher.de `_ .. _Professional-Support: Professional Support ^^^^^^^^^^^^^^^^^^^^ If you need professional support, please refer to - Call me: `http://wildt.at.die-netzmacher.de `_ - Send a request form: `http://die-netzmacher.de/kontakt `_ .. _Other-extensions-published-by-Die-Netzmacher: Other extensions published by Die Netzmacher ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - |img-9| +AOE Linkhandler Configurator: Configure the AOE linkhandler supported by userinterfaces. Out-of-the-box templates for cal, org, tt\_news and tt\_products. Don't edit page TSconfig any longer. `http://typo3.org/extensions/repository/view/linkhandlerconf/ `_ - |img-10| autositemap: A smart site-map optimised for the footer. It groups menus in columns. Great menus will get two columns. Configuration is based on TypoScript HMENU. `http://typo3.org/extensions/repository/view/autositemap/ `_ - |img-11| Browser – TYPO3 without PHP. Develop your TYPO3 extension 8 times faster! You need one line TypoScript for a result list with a search form, a record browser and an index browser. Images are wrapped self-acting. SEO, Search Engine Optimization, is integrated. `http://typo3.org/extensions/repository/view/browser/ `_ - |img-12| Caddy – the TYPO3 shopping cart. You can use it for your own needs. You need a database with products or any other items only. You can install Caddy out of the box with one mouse click – see Quick Shop below. `http://typo3.org/extensions/repository/view/caddy/ `_ - |img-12| Deal! – TYPO3 Quick Shop interface for the marketplace ebay. Manage all items with TYPO3 and publish it on ebay. Amazon is under construction. `http://typo3.org/extensions/repository/view/deal/ `_ - |img-13| Duty – collection of helpful scheduler tasks. Here: remove deprecated files from directories. `http://typo3.org/extensions/repository/view/duty/ `_ - |img-14| Flip it! offers lovely and smooth page flip transitions. It enables you to run over pages in PDF documents like in a real magazine. It is based on flash. Flipt it! can convert PDF documents to swf files automatically. `http://typo3.org/extensions/repository/view/flipit/ `_ - |img-15| Jobmarket is a catalogue with job offers. Views, the a-z-browser, the page-browser, the search, social bookmarks and a lot of other stuff can configured by the Browser plugin with the mouse. Job Market hasn't any PHP code, it should be easy to adapt it to your needs. `http://typo3.org/extensions/repository/view/job\_market/ `_ - |img-16| Organiser – TYPO3 for the lobby and the organisers. Handle news, events, staff, headquarters, locations, workshops and a calendar with one extension. Sell online tickets! Install the Organiser with one mouse click! `http://typo3-organiser.de/ `_ - |img-12| Quick Shop – the fastest shop in the history of TYPO3. Install it with one mouse click! Quick Shop is based on the browser (see above) and powermail. `http://typo3-quick-shop.de/ `_ - |img-17| PDF Controller: Easy to install. Add to your HTML page the PDF-controller-button. Link from the button to the controller. Adjust the controller by mouseclicks. The PDF Controller supports CSS 3. `http://typo3-pdfcontroller.de/ `_ - |img-18| Radial Search (Umkreissuche) – Enable the browsing through your data by geo location. 'Your data must have a latitude and a longitude. Address data can geocoded automatically by the Browser - TYPO3 without PHP. `http://typo3.org/extensions/repository/view/radialsearch/ `_ - |img-18| Route – Publish your routes with GoogleMaps or OpenStreetMap. Routes have points of interest (POI). You can categorise and filter both: routes and POI. Address data can geocoded automatically. `http://typo3.org/extensions/repository/view/route/ `_ - |img-19| seo\_dynamic\_tag: Search Engine Optimization for the title tag, the canonical tag and the meta tags author, description and keywords. Configuration by a user interface. `http://typo3.org/extensions/repository/view/seo\_dynamic\_tag/ `_ - |img-20| Slick - jQuery Carousel: Fully responsive. Scales with its container. Separate settings per breakpoint. Uses CSS3 when available. Swipe enabled. Desktop mouse dragging. Infinite looping. Fully accessible. `http://typo3.org/extensions/repository/view/slick/ `_ - |img-21| TSconfig Pages and Users by extManager (extkey: tsconf): Configure the the eight most commonly used TSconfig porperties with the mouse - like page tree uids, activated extended view, activated clipboard, ... `http://typo3.org/extensions/repository/view/tsconf/ `_ .. _Illustration-Index: Illustration Index ------------------ Illustration 1: Loaded extension tt\_news Marker 4 Illustration 2: Include the static template tt\_news Marker 4 Illustration 3: The extensions array with so called system defined markers 5 Illustration 4: In case of success 6 Illustration 5: In case of an error 6 Illustration 6: HTML template with self defined markers 7 Illustration 7: Our marker a\_href 7 Illustration 8: The HTML output 7 .. _Illustration-9-TypoScript-and-HTML-template-with-user-defined-markers: Illustration 9: TypoScript and HTML template with user defined markers 8 Illustration 10: tt\_news code LIST\_ONLY\_WITH\_ITEMS 8 .. _Change-log: Change log ---------- 3.6.0 **Major Feature** \* #i0001: Upgrade TYPO3 6.2 1.0.1 **New features** \* Handling for internal and external links was addedThanks to Stefan Kroecher for the code snippet\* Values of system markers are stored in TypoScript registersThanks to Krystian Szymukowicz for the code snippet 1.0.0 **New Main Version** \* Changed status to stable 0.1.1 **New Feature** \* Code LATEST\_ONLY\_WITH\_ITEMS 0.0.6 **Maintenance** \* Update the manual 0.0.5 **Maintenance** \* Update the manual 0.0.3 **Changed extKey** \* Initial release of ttnews\_href\_marker is obsolete now 0.0.2 **Publishing** 0.0.1 **Initial release** \* As ttnews href marker (extkey: ttnews\_href\_marker) 16 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.jpeg .. :align: middle .. :border: 0 .. :height: 20 .. :id: Grafik1 .. :name: Grafik1 .. :width: 69 .. |img-3| image:: img-3.png .. :align: middle .. :border: 0 .. :height: 16 .. :id: graphics1 .. :name: graphics1 .. :width: 18 .. |img-4| image:: img-4.png .. :align: bottom .. :border: 0 .. :height: 335 .. :id: graphics3 .. :name: graphics3 .. :width: 378 .. |img-5| image:: data: :alt: Frame2 .. :align: bottom .. :id: Frame2 .. :name: Frame2 .. |img-6| image:: img-6.jpeg .. :align: left .. :border: 0 .. :height: 239 .. :id: graphics30 .. :name: graphics30 .. :width: 227 .. |img-7| image:: img-7.jpeg .. :align: bottom .. :border: 0 .. :height: 199 .. :id: graphics22 .. :name: graphics22 .. :width: 669 .. |img-8| image:: img-8.jpeg .. :align: left .. :border: 0 .. :id: graphics31 .. :name: graphics31 .. :width: 100% .. |img-9| image:: img-9.png .. :border: 0 .. :height: 16 .. :id: graphics8 .. :name: graphics8 .. :width: 18 .. |img-10| image:: img-10.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics37 .. :name: graphics37 .. :width: 18 .. |img-11| image:: img-11.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics9 .. :name: graphics9 .. :width: 18 .. |img-12| image:: img-12.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics15 .. :name: graphics15 .. :width: 16 .. |img-13| image:: img-13.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics12 .. :name: graphics12 .. :width: 16 .. |img-14| image:: img-14.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics48 .. :name: graphics48 .. :width: 18 .. |img-15| image:: img-15.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: Grafik5 .. :name: Grafik5 .. :width: 18 .. |img-16| image:: img-16.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics10 .. :name: graphics10 .. :width: 16 .. |img-17| image:: img-17.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics55 .. :name: graphics55 .. :width: 18 .. |img-18| image:: img-18.png .. :align: bottom .. :border: 0 .. :height: 18 .. :id: graphics16 .. :name: graphics16 .. :width: 18 .. |img-19| image:: img-19.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics21 .. :name: graphics21 .. :width: 16 .. |img-20| image:: img-20.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics11 .. :name: graphics11 .. :width: 16 .. |img-21| image:: img-21.png .. :align: bottom .. :border: 0 .. :height: 16 .. :id: graphics18 .. :name: graphics18 .. :width: 16