.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================================ EXT: Display Controller Advanced ================================ :Created: 2010-02-18T17:33:18 :Changed: 2012-06-26T11:57:56 :Classification: displaycontroller_advanced :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: forEditors, forIntermediates :Author: Fabien Udriot :Email: fabien.udriot@ecodev.ch :Info 4: :Language: en |img-1| |img-2| EXT: Display Controller Advanced - displaycontroller\_advanced .. _EXT-Display-Controller-Advanced: EXT: Display Controller Advanced ================================ Extension Key: displaycontroller\_advanced Language: en Keywords: forEditors, forIntermediates Copyright 2000-2012, Fabien Udriot, 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 ----------------- `EXT: Display Controller Advanced 1 <#__RefHeading__4324_929642545>`_ **`Introduction 3 <#__RefHeading__4326_929642545>`_** `What does it do? 3 <#__RefHeading__4328_929642545>`_ `Screenshots 3 <#__RefHeading__4330_929642545>`_ `Questions? 3 <#__RefHeading__4332_929642545>`_ `Keeping the developer happy 4 <#__RefHeading__12760_1738894311>`_ `Configuration 4 <#__RefHeading__766_66368504>`_ **`Users manual 5 <#__RefHeading__4334_929642545>`_** `Setting up a display controller advanced 5 <#__RefHeading__3699_1912311873>`_ `Multiple Data Structure 5 <#__RefHeading__3701_1912311873>`_ **`Configuration 7 <#__RefHeading__4342_929642545>`_** **`Bug reporting 8 <#__RefHeading__4364_929642545>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension is a FE plugin for the Tesseract Project. It connects a Data Consumer with **multiple** Data Providers and Data Filters in order to display data in the TYPO3 FE. Display Controller Advanced is well indicated when it is necessary to mix up different source of data coming from different Data Provider on the same Data Consumer. If this sounds like gibberish please go straight to the chapter "Tutorial" of extension "displaycontroller". For an even quicker introduction you can refer to the tutorial screencast found on the Tesseract web site (http://tesseract.cobweb.cb). .. _Screenshots: Screenshots ^^^^^^^^^^^ Here's a view of a Display Controller Advanced record. Data Providers are collapsed. |img-3| Here's a view of a Display Controller Advanced record. Data Providers are expanded. .. _img-4-Questions: |img-4| Questions? ^^^^^^^^^^^^^^^^^^ If you have any questions about this extension, you may want to refer to the Tesseract Project web site ( `http://www.typo3-tesseract.com/ `_ ) for support and tutorials. You may also ask questions in the TYPO3 English mailing list (typo3.english). .. _Keeping-the-developer-happy: Keeping the developer happy ^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you like this extension, do not hesitate to rate it. Go the Extension Repository, search for this extension, click on its title to go to the details view, then click on the “Ratings” tab and vote (you need to be logged in). Every new vote keeps the developer ticking. So just do it! You may also take a step back and reflect about the beauty of sharing. Think about how much you are benefiting and how much yourself is giving back to the community. .. _Configuration: Configuration ^^^^^^^^^^^^^ As of version 1.3.0, TYPO3 4.5 or more is required. .. _Users-manual: Users manual ------------ .. _Setting-up-a-display-controller-advanced: Setting up a display controller advanced ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Create a new record of type tt\_content and change the record type to "Display Controller Advanced (not cached)" or to "Display Controller Advanced (cached)" according to the case. "Cached" means the extension will be of type USER and will thusly use the caching mechanism of TYPO3. |img-5| In the second tab, define a Data Consumer. Either the Data Consumer already exists and can be picked within the page tree or it must be defined as a new record. Beware, the extension **"templatedisplay" is not compatible** with the advanced controller mainly for architecture reasons. |img-6| Lastly, defines groups of provider by clicking on "Create new". First Data Provider is mandatory while the filter is optional. Optionally, a second Data Provider can be defined. |img-7| .. _Multiple-Data-Structure: Multiple Data Structure ^^^^^^^^^^^^^^^^^^^^^^^ Display Controller Advanced will pass a multi-data structure to the Data Consumer. In other words data structure has an additional lever given by the main table name. Consider the following multi-data structure. .. ### BEGIN~OF~TABLE ### .. _pages: pages """"" .. container:: table-row a pages b .. ### BEGIN~OF~TABLE ### .. container:: table-row a name b pages .. container:: table-row a count b Number of records (for pages table) .. container:: table-row a uidList b Comma-separated list of uid's .. container:: table-row a records b .. ### BEGIN~OF~TABLE ### .. container:: table-row a 0 b .. ### BEGIN~OF~TABLE ### .. container:: table-row a uid b (value) .. container:: table-row a title b (value) .. container:: table-row a \_\_subtables b .. ### BEGIN~OF~TABLE ### .. container:: table-row a tt\_content b .. ### BEGIN~OF~TABLE ### .. container:: table-row a name b tt\_content .. container:: table-row a count b Number of records joined to pages table record 0 .. container:: table-row a uidList b Comma-separated list of uid's .. container:: table-row a records b .. ### BEGIN~OF~TABLE ### .. container:: table-row a 0 b .. ### BEGIN~OF~TABLE ### .. container:: table-row a uid b (value) .. container:: table-row a header b (value) .. ###### END~OF~TABLE ###### .. container:: table-row a 1 b ... .. container:: table-row a 2 b ... .. ###### END~OF~TABLE ###### .. ###### END~OF~TABLE ###### .. ###### END~OF~TABLE ###### .. ###### END~OF~TABLE ###### .. container:: table-row a 1 b ... .. ###### END~OF~TABLE ###### .. ###### END~OF~TABLE ###### .. _other-table: **other table** """"""""""""""" .. container:: table-row a **other table** b **other data structure** .. ###### END~OF~TABLE ###### .. _Configuration: Configuration ------------- Please, refer to the manual of the "displaycontroller" extension for this section. Display Controller Advanced was build up on the basis of Controller Display. As a result, they share a lot of code in common as well as configuration options. In the "displaycontroller" manual, more informations are to be found about: - TypoScript configuration options, - passing context information to an third extension, - available hooks, - RealURL configuration options. .. _Bug-reporting: Bug reporting ------------- Bug can be reported on Forge at `http://forge.typo3.org/projects /extension-displaycontroller\_advanced/issues `_ |img-2| 8 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 235 .. :id: graphics1 .. :name: graphics1 .. :width: 461 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 416 .. :id: graphics2 .. :name: graphics2 .. :width: 452 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 117 .. :id: graphics3 .. :name: graphics3 .. :width: 233 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 164 .. :id: graphics4 .. :name: graphics4 .. :width: 274 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 299 .. :id: graphics5 .. :name: graphics5 .. :width: 320