DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

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

Extension Key: displaycontroller_advanced

Language: en

Keywords: forEditors, forIntermediates

Copyright 2000-2012, Fabien Udriot, <fabien.udriot@ecodev.ch>

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

EXT: Display Controller Advanced 1

`Introduction 3 <#__RefHeading__4326_929642545>`_

What does it do? 3

Screenshots 3

Questions? 3

Keeping the developer happy 4

Configuration 4

`Users manual 5 <#__RefHeading__4334_929642545>`_

Setting up a display controller advanced 5

Multiple Data Structure 5

`Configuration 7 <#__RefHeading__4342_929642545>`_

`Bug reporting 8 <#__RefHeading__4364_929642545>`_

Introduction

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

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?

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

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

As of version 1.3.0, TYPO3 4.5 or more is required.

Users manual

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

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.

pages

a

pages

b

a

name

b

pages

a

count

b

Number of records (for pages table)

a

uidList

b

Comma-separated list of uid's

a

records

b

a

0

b

a

uid

b

(value)

a

title

b

(value)

a

__subtables

b

a

tt_content

b

a

name

b

tt_content

a

count

b

Number of records joined to pages table record 0

a

uidList

b

Comma-separated list of uid's

a

records

b

a

0

b

a

uid

b

(value)

a

header

b

(value)

a

1

b

...

a

2

b

...

a

1

b

...

other table

a

other table

b

other data structure

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.