EXT: Display Controller - SVN
Contents
1. lt LOOP be_users gt STT EAE if email B lt 1i gt FIELD realNamed G SFIELD emai dit lt li gt Title lt ENDLOOP gt er fy Types lt ul gt pe ra BE Users Type Email Description T oscript configuration Get list of all BE users a SELECT realName email FROM be_users J Validate Query Save field configuration General Data Objects Access Data Consumer setters SS AB z Tem plate based Display rimary Data Provider euse SSCS Data Queries Type of filter Advanced Data Filter primary If filter empty None eS m Display nothing X i t O Detail view Po TA E Display everything O List view Gp Data Filters Advanced filter choose Data Filter below LET Get Started About TYPO3 Features Customizing TYPO3 Resources Examples Feedback Web site administrators Home Feedback Web site administrators Your administrators admin Simple McEditor username example com Advanced McEditor username example com News McEditor username example com Questions If you have any questions about this extension you may want to refer to the Tesseract Project web site http www typo3 TYPO3 8 3 v TY PO 3 EXT Display Controller displaycontroller Introduction 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 extensio2. TY PO 3 Y EXT Display Controller displaycontroller Configuration url 4 parameter 15 In this example the redirection is first enabled Then the condition for the redirection to actually take place is set It will happen when the total number of records in the SDS is equals to 1 Finally the url for to redirect to is defined as a typolink to page 15 Don t forget that TypoScript is inherited along the page tree So a redirection configuration defined at some point may not be desirable at some other point down the page tree Either disable it plugin tx displaycontroller redirect enable 0 or cancel it altogether plugin tx displaycontroller redirect gt Hooks There s one hook defined in the Display Controller It is used to set extra data to pass to the Base Controller s parser if an advanced filter was selected for either primary or secondary Data Provider The hook must be registered that way SGLOBALS TYPO3 CONF VARS EXTCONF displaycontroller setExtraDataForParser myextension class tx myextension hook php amp tx myextension hook and a typical implementation might look like class tx cobwebcontig hook public function setExtraDataForParser S data SpObj Sdata coucou Sdata 15 return Sdata The method to implement is called setExtraDataForParser and it receives 2 arguments The first one is the array containing the existing extra data and the second o
3. v TY PO 3 EXT Display Controller displaycontroller Tutorial Tutorial This tutorial is designed not only to explain how the Display Controller itself works but more generally what the whole Tesseract Project is about and what advantages it brings compared to more usual ways of working with TYPO3 The whole point of the Tesseract Project is to provide a set of tools extensions that make it easy to retrieve data from a variety of sources but in particular the TYPO3 database and display them in the frontend without having to develop custom extensions every time In order to highlight the benefits of the Tesseract Project this tutorial was designed to show in the frontend a very unusual piece of information a list be BE users Scenario Here s what we want to achieve in this tutorial imagine a web site possibly an intranet where we want to have a list of BE users somewhere in the frontend so that visitors can easily contact the web site administrators This tutorial will show that this can be achieved with a minimum of efforts and a minimum of redundant components Future tutorials on the Tesseract web site http www tesseract typo3 com tutorials will take this example further e g showing how to search sort and filter this list Preparing for work Before starting the actual work create a new page somewhere in your page tree so that we can start with a blank slate Call it Web site administrators
4. y TY PO 3 EXT Display Controller displaycontroller EXT Display Controller EXT Display Controller Extension Key displaycontroller Language en Keywords forEditors forIntermediates Copyright 2000 2010 Francois Suter lt typo3 cobweb ch gt 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 TYPO3 1 TYPO3 Table of Contents EXT Display Controller 1 INEFOGUCUON siisii rakanira 3 What dges it OD rnganeierieena 3 Sereen NOLS issiria iina a 3 JU CSTIONS l vc scciiace hasan dsasicveavcasatdacindagecarsinietenntemcsaertes 3 Keeping the developer Nappy scsscssessrssresesereees 4 Installati n susrsinirinnnniorannnninnnnn nnna 5 Eoia i ge E EN E A E A T 5 Users MANU al siswaniiiwnuiinianriniaunninaninika nannamamma 6 The Display COMUONEL ckectinsscatwiiuctecsienereitienexeniens 6 Cached or not cached ssiissrrisriinererivnivinenrsinrninnnnrnns 7 Query parameterS s ssssssssnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnna 7 COMMQUIATIO Mossissa 8 PPO E E eee 8 Redirection mechaniSM ssssrirssisrinersrnnnnsnnnnnsnnnnaas 8 EXT Display Controller displaycontroller EXT Display Controller PIONS E AA E A 9 FS IN Fe E E E E E e 9 TUCO FAN ensisictctisanscescstuicctirwesceddatacbertstduistnnseanssstentes 11 CE es E E E 11 Preparing for
5. McEditor username example com News McEditor username examople com What s wrong with the first line That s quite simple this BE user has no real name and no e mail address defined This gives us a good opportunity to improve our example Improving the display A first approach could to just filter out users that have no real name or e mail address in the SQL query itself This is a bit rough We can do better with some more TypoScript in the display First of all let s edit the SQL query so that we have the username at disposal too Edit the Data Queries record and add the username field to the list of selected fields gt SQL Query username ealName email FROM be_users Validate Query TYPO3 Wis TY PO 3 vv EXT Display Controller displaycontroller Tutorial Now let s edit the Template based Display record again We want to achieve the following if the real name is not defined we want to display the username instead This will be possible only with TypoScript so we have to change the type of the realName field to text and then enter the following TypoScript ifEmpty field username Mappings Mapping HTML lt ul gt Fields lt LOOP be_users gt 9 sy om reainame W lt li WFTELD realName 9FIELD emai 1 lt 1i gt lt ENDLOOP gt lt ul gt Types Type Text H T poscript configuration Jif Empty field username Save field c
6. WOM ccisccessscenssavardcegessradetbeciecseinccers 1i Querying the database c cecsessesesesecseseensnesennens 11 Preparing a template for display cccsceseeeeeeeeees 12 Fitting it all together cesecinereonsinceantenitaduschinencttnetnes 13 Improving the display ssnsssssnssrennnnsennnrnnsnnnrenns 15 IO SOS EA AE T O E T 17 Known problems ussisssssisssnonnnssronnssnnni nnns 18 TO DO Wb vccissctisscnsnnsantvessdcasdicniesanencedassanceestctnacnans 19 CHANG CLO Give scttstitecinnsaccnstcewssdennassesaisansnensesassensaane 20 Appendix A Tutorial ANSWEFS 0 scseseseeeeseseeees 21 TYPO38 2 TY PO 3 vv EXT Display Controller displaycontroller Introduction Introduction What does it do This extension is a FE plugin for the Tesseract Project It connects a Data Consumer with one or more Data Providers and Data Filters in order to display data in the TYPO3 FE If this sounds like gibberish please go straight to the Tutorial chapter of this manual which explains all the basic concepts For an even quicker introduction you can refer to the tutorial screencast found on the Tesseract web site http Screenshots An example of the power of the Tesseract Project a SQL based query a HTML template with a point and click mapping interface the Display Controller to relate these two components together and a result in the frontend M General Advanced appings Mapping HTML Hide lt li gt Fields
7. Place yourself on this new page in Web gt List mode Querying the database As a first step we will use Data Query to get a list of all BE users We want to display their names and email addresses so that the web site users can contact them easily Create a new Data Queries record and type in the SQL query General Advanced Hide Title BE Users Description Get list of all BE users Validate Query SELECT realName email FROM be_users Data Query takes care of all special fields automatically so you don t need to care about them In this case it will transparently handle the disabled field meaning that disabled BE users will not be listed although we didn t specify this condition explicitly in the SQL query WARNING be sure to type the query as it appears in the above screenshots with the SQL keywords in uppercase Data Query requires SQL keywords to be in uppercase Let s not worry about the other properties for now Just save and close the Data Query record TYPO3W ou v TY PO 3 EXT Display Controller displaycontroller Tutorial Preparing a template for display The next step is to start preparing the display for the results of our query To achieve this create a new record of type Template based Display Just enter a title and save You should have a screen that looks like this General Debug Hide Title List of BE users Mappings Mapping HTML Change this content b
8. aycontroller issues TYPO3 Wis v TY PO 3 EXT Display Controller displaycontroller To Do list To Do list The roadmap for the evolution of this extension can be found on Forge http forge typo3 org projects roadmap extension displaycontroller For feature requests please open a report on Forge issue tracker http forge typo3 org projects extension displaycontroller issues TYPO3 Wi TYPO3 EXT Display Controller displaycontroller ChangeLog ChangeLog Version Changes 1 0 0 First public release TYPO3 20 v TY PO 3 EXT Display Controller displaycontroller Appendix A Tutorial answers Appendix A Tutorial answers Here are the steps that were needed to improve the display of the e mail address 1 2 3 edit the HTML so that the FIELD email marker is just next to the FIELD realName marker change the type of the field to Text enter the following TypoScript configuration typolink parameter field email required 1 noTrimWrap The mailto link is now built using the typolink property of the TEXT object We use the fact that the record s data is loaded into the content object to retrieve the e mail address using the field property We also make the field value required so that nothing gets displayed when it s empty The brackets are added using the noTrimWrap property in order to also include a blank space before
9. ble search criteria it is not desirable or even possible to store every combination of search values into cache Query parameters Since the Display Controller exists in two versions pil and pi2 it uses a common naming for its GET POST variables i e tx displaycontroller xxx so that both plug ins use the same syntax Any variable named according to that scheme will be available in the piVars of the Display Controller This also means that they will be available as vars in the datafilter extension since it relies on expressions Furthermore the Display Controller recognizes a number default GET POST variable names with which it builds the Detail view and List view described above tx displaycontroller table table used for the detail view tx displaycontroller showUid primary key of the record to display in the detail view Used in conjunction with the table parameter above this uniquely defines a given record tx displaycontroller max for the list view with page browsing how many records to display at a time tx displaycontroller page for the list view with page browsing number of the current page expected to start at 0 tx displaycontroller sort for the list view field on which to sort the records may use the syntax table field tx displaycontroller order order for sorting asc or desc defaults to asc Extension templatedisplay
10. cil changed after clicking on Save field configuration This is a quick visual clue as to the type of the field Let s move on to the next field where we will use some TypoScript Indeed we want the e mail address to be clickable So the steps to take are 1 click on the FIELD email marker 2 verify that the email field is indeed selected in the Fields selector 3 choose the type Email from the Types selector TYPO3 Wo TYPO 3 vv EXT Display Controller displaycontroller Tutorial 4 click on Save field configuration Your display should look like this Mappings Mapping HTML lt ul gt Fields a ae a ENDLOOP gt Types lt ul gt Type Email T oscript configuration Save field configuration The Email type field corresponds to a typolink function It expects that the field it is mapped to contains an e mail address otherwise it will just create a typolink to whatever else We are ready for the big jump Save and close the edit window and then view the page we have been working on You should see a list of BE users with a clickable e mail address the screenshot is based on the Introduction Package oC a Get Started About TYPO3 Features Customizing TYPO3 Resources Examples Feedback Web site administrators Home Feedback Web site administrators Your administrators Simple McEditor username example com Advanced
11. e defined earlier For the Data Consumer select Template based Display record that we just created For the Primary Data Provider select the Data Queries record created in the first step Click on the Save button Your screen should look like this General Data Objects Access Data Consumer List of BE users x B Ps 4y Tem plate based Display Primary Data Provider BE Users x 4 TAE Data Queries Type of filter Advanced Data Filter primary If filter empty ee ee ee eee re ee Te i ee a None l x cy wD Display nothing Detail view LJ Display everything List view T7 Data Filters Advanced filter choose Data Filter below Now the Template based Display record has been set in relation with the Data Queries record via the Display Controller It s time to edit the Template based Display record and define the relations between the database fields and the template markers Select the Template based Display record and click on the pencil icon Data Consumer i List of BE users ts Template based Display In the new window click on the FIELD realName marker Notice the drop down menu that has appeared on the right side Also note that the realName field is preselected in this drop down menu That s because the marker used the exact same name as the database field Below the fields drop down menu is another selector called Types This def
12. er will also be empty You must then choose whether you want to display everything or nothing in such a case TYPO3 8 V TY P0O3 EXT Display Controller displaycontroller Users manual Secondary Data Provider This is a reference to the Data Provider that feeds into the Primary Provider The field provides wizards for selecting a record edit the current record or create a new Data Provider one such wizard appears per compatible Data Provider type The Secondary Data Provider is meant to return lists of primary keys which will then restrict the list of records returned by the Primary Data Provider A Data Filter can be applied to the Secondary Data Provider too The same choice as described above must be made in case that filter ends up being empty If secondary provider returns nothing As with Data Filters it is necessary to define the behavior of the Display Controller should the Secondary Data Provider if defined return nothing Here again the choice is to display either everything or nothing Cached or not cached The Display Controller fronted plug in comes in two versions one cached and one not cached How to choose which one to use The general rule is that the cached version should be preferred whenever possible for obvious performance reasons However in some circumstances using the non cached version cannot be avoided A typical use of the non cached version is when performing searches if there are a lot of possi
13. has an object type that builds links to detail views using the variables names described above It also uses the proper variables names when creating a page browser Note that these variables names are not hard coded but are provided by the controllers themselves via an API TYPO3W 7 TYPO3 Configuration TypoScript EXT Display Controller displaycontroller Configuration Property Data type Description Default redirect gt redirectConfig Use this configuration to redirect the process to some other page based on a condition listView gt listViewConfig Configuration for the list view This is generally default values that may be superseded by GET POST parameters detailView gt detailViewConfig Configuration for the detail Currently this is just about setting a different keyword for the RealURL postVarSets see RealURL below context TypoScript This property is just a container for more TypoScript When parsed the resulting array will be loaded into the extra data of the Base Controller s parser and will thus be available to all expressions see Context below tsref plugin tx_displaycontroller gt redirectConfig Property Data type Description Default enable boolean stdWrap Enable the redirection mechanism at all redirection still depends on the condition below condition gt if Condition for the
14. ines how the field should be rendered You will notice that some items in this selector bear names that resemble TypoScript content objects This is no coincidence For example a field of type text will be rendered using a TEXT object The box below the selector allows you to enter TypoScript corresponding to the type that you selected The Template Display manual has a list of all types and their corresponding TypoScript objects or functions TYPO3 Wi v TY PO 3 EXT Display Controller displaycontroller Tutorial Mappings Mapping HTML lt ul gt Fields lt LOOP be_users gt realName E lt ENDLOOP gt Types lt ul gt of ai Type Text H T oscript configuration ah lt 1i FIELD realName FIELD emai l lt li gt In this case we don t want to do anything special with the administrator s name so we don t need any TypoScript rendering Hence we choose the Raw text no transformation type and click the Save field configuration button below the TypoScript configuration field Mappings Mapping HTML lt ul gt j Fields lt LOOP be_users gt pyr realName LT lt 1i gt FIELD realNamet HYFIELD emai 1 lt 1 gt lt ENDLOOP gt Types TEE Raw text no transforma lt u gt Typoscript configuration Pi m t 2 Save field configuration Notice how the little icon next to the pen
15. ler provides RealURL with a user object to transforms these parameters into a speaking URL In the above configuration the first parameter tx _ displaycontroller table is mapped to a list of tables The key used in the array will be the name of the table as a segment in the speaking URL The second parameter tx displaycontroller showUid refers to a user function for generating the alias with the proper field of the proper table since it will refer to tx displaycontroller table It is very important to keep these two configurations for table and for showUid exactly in that order because it is expected to be this way Setting a different order or using other indices in the configuration array will break the encoding decoding process If the alias_field property is missing the Display Controller will use the uid field as a fall back The alias_field property in the configuration can be more than a simple string It can contain expressions that will be interpreted by the expressions parser Example alias field gt header date y Another feature is to use a marker called LANG which contains the 2 letter ISO code associated with the language in which the URL is being generated The code is deducted from the language value map entered in the RealURL configuration Given the following configuration STYPO3 CONF VARS EXTCONF realurl DEFAULT preVars array array GETvar g
16. n 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 TYPO3W v TY PO 3 EXT Display Controller displaycontroller Installation Installation The Display Controller must be installed as part of the Tesseract suite of extensions It is useless outside of this scope The extension will add a number of fields to the tt_content table and creates a new table used to store the relations between the various Tesseract components After installation the static TypoScript template provided by the extension should be added to the site s template General Options Includes Resources Access Include static AFTER basedOn C Include static from extensions Selected Items CSS Styled Content css_styled_content CSS Styled Content TYPO3 v3 8 css_styl CSS Styled Content TYPO3 w3 9 css_styl CSS Styled Content TYPO3 v4 2 css_styl CSS Styled Content TYPO3 v4 3 css_styl Clickenlarge Rendering rtehtmlarea News settings tt_news News CSS styles tt_news News feeds RSS RDFATOM tt_news Generic display controller displaycontrolles Generic di
17. ne is a reference to the Display Controller The method must return the modified data array RealURL The Display Controller provides a user object for creating speaking URLs for any link to a single record in conjunction with RealURL A typical configuration will look like STYPO3 CONF VARS EXTCONF realurl DEFAULT postVarSets DEFAULT array item gt array array GETvar gt tx displaycontroller table valueMap gt array news gt Cr news y y array GEivar gt tx displaycontroller showJid userFunc gt EXT displaycontroller class tx displaycontroller realurl php amp tx displaycontroller realurl gt main userFunc gt array Et news gt array alias field gt title y E Note how the postVarSets configuration uses the item key in bold above This is the default key expected by the Display Controller s RealURL user function It s possible to use another key but it must be defined in the TypoScript configuration plugin tx displaycontroller detailView postVarsets foo When creating a link to a single record the Tesseract requires the link to be built using tx _ displaycontroller table and tx displaycontroller showUid query parameters the first one containing the table s name and the second the TYPO3 7 9 TY POQ3 vv EXT Display Controller displaycontroller Configuration primary key of the record The Display Control
18. onfiguration J NOTE don t forget to click the Save field configuration button every time you make a change either to the Fields selector the Types selector or the TypoScript configuration field Let s look at the result in the frontend a Get Started About TYPO3 Features Customizing TYPO3 Resources Examples Feedback Web site administrators F Home Feedback Web site administrators Your administrators admin Simple McEditor username example com Advanced McEditor username example com News McEditor username examople com The username has indeed replaced the real name for the first user How was that possible For each record handled inside the loop Template Display loads all fields from the record into the local content object used for rendering Thus every field is available in the field property of stdWrap This makes it very easy to use the data from the database to create sophisticated renderings It this case we are using this together with the ifEmpty property so that the username gets displayed when the real name is blank The second improvement would be to avoid displaying empty brackets when no e mail address is defined This is left as an exercise to the reader The answer can be found in Appendix A Tutorial answers Just a hint the Email type field corresponds to a typolink function This implies that we will not have the TypoScript available
19. redirection to take place Note that you have the following data available e the total count of records in the SDS in a register called sds totalCount e the count of records in the SDS in a register called sds count the data in the first record of the SDS loaded in the content object and thus available with the field syntax in the getText function url gt typolink URL to redirect to Note that data from the first record of the SDS is available here too as described above tsref plugin tx_displaycontroller redirectConfig gt listViewConfig Property Data type Description Default limit int Maximum number of records to display 10 sort string Field name for default sorting of results Syntax is similar to SQL i e tablename fieldname table name can be omitted order string Default ordering of records Acceptable values are asc or desc tsref plugin tx_displaycontroller listViewConfig gt detailViewConfig Property Data type Description Default postVarSets string Name of the key that defines the postVarSets configuration for RealURL item tsref plugin tx_displaycontroller listViewConfig Redirection mechanism The Display Controller comes with a flexible redirection mechanism whose properties described above Here is an example configuration plugin tx displaycontroller redirect enable 1 Condition value data equals 1 register sds totalCount TYPO3
20. splay controller displaycontrolle Configuration There s a single configuration option available after installing the extension debug check this box to enable some debug statements to be logged This relies on the Developer s Log so you need some extension that enables it like devlog for example TYPO3 5 X TY P0O3 EXT Display Controller displaycontroller Users manual Users manual If you have never used a Display Controller before please refer to the tutorial further down in this manual The Display Controller This section describes all the options available when creating a new Display Controller content element General Data Objects Access Data Consumer List of BE users x 4 Pt a Tem plate based Display Primary Data Provider BE Users x B Pe Data Queries Type of filter Advanced Data Filter primary If filter empty None eVOO x C fo Display nothing LJ Detail view l Display everything List view T Data Filters Advanced filter choose Data Filter below OO Secondary Data Provider Advanced Data Filter secondary If filter empty x G fo Display nothing Display everything Gr Data Filters If secondary provider returns nothing Display nothing Display everything Data Consumer This is a reference to a Data Consumer record The field provides wizards for selecting a record edit the current record or create a new Data Cons
21. t L valueMap gt array fr gt A l en gt it ge gt TAT tit gt 3 ly valueDefault gt fr noMatch gt bypass hy E the LANG marker will contain fr when language is 0 or undefined default en when language is 1 etc The alias_field configuration would then look like alias field gt header LANG Note that to make the language configuration more easily accessible for the Display Controller it is possible to use the lang key as index to the language configuration So the above configuration would be written as STYPO3 CONF VARS EXTCONF realurl DEFAULT preVars array lang gt array GETvar gt L valueMap gt array fr gt Or l en gt 1t de gt paT tit gt 3 ly valueDefault gt fr noMatch gt bypass hy 7 Note the part in bold Troubleshooting If anything seems wrong with the speaking URLs don t forget to check both ends of the process i e if the link is assembled with properly named variables i e tx displaycontroller table and tx displaycontroller showUid if the RealURL configuration is correct i e all tables are listed and an alias field is defined for each Activating the debug flag in the extension s configuration will log information to the Developer s Log which may help you track errors in the generation of speaking URLs TYPO3 Wi
22. ted the loop and the field markers Those markers are where the data from the database will come They currently have warning icons over them because they are not yet related to a database field even though the use the same name In the current situation the Data Queries record that we created in the previous step and the template are not related in any way TYPO3 BW 2 v TY PO 3 EXT Display Controller displaycontroller Tutorial In the next step we will define the actual content element and make the relation between the query and the template For now you can save and close the Template based Display record Fitting it all together It is finally time to use the Display Controller itself Move to the Web gt Page module and create a new Display Controller cached by choosing from the new content element wizard Plugins E O General Plugin Select this element type to insert a plugin O News Versatile news system for TYPOS O Display Controller cached Create a fully cached Display Controller h cannot be found amongst the options below O Display Controller not cached Create a non cached Display Controller This should be chosen only if needed for example in case of a search function See the User s manual chapter for a discussion on the difference between the cached and non cached versions Switch to the Data Objects tab to create the relations between the components w
23. the opening bracket TYPO3 BW 21
24. to avoid displaying empty brackets The type of the field will have to be changed and the mailto link built differently And the HTML template has to be changed too of course The result should be as follows TYPO3 Bic TYPO3 vv EXT Display Controller displaycontroller Tutorial Feedback Cc ia Get Started About TYPO3 Features Customizing TYPO3 Resources Examples Web site administrators F Home Feedback Web site administrators Your administrators admin Simple McEditor username example com Advanced McEditor username example com News McEditor Username examople com Next steps There are more tutorials on the Tesseract Project web site http www typo3 tesseract com The first tutorial is equivalent to the one above The second tutorial builds on it and introduces the use of the third type of components Data Filters On top of tutorials the web site offers a number of tips amp tricks highlighting some advanced features TYPO3 8 17 y TY PO 3 EXT Display Controller displaycontroller Known problems Known problems If you have any issues please refer to the Tesseract Project web site http www typo3 tesseract com You may also post your problems to the TYPO3 English mailing list typo3 english so that others may benefit from the answers too For bugs or feature requests please open an entry in the extension s bug tracker on Forge http forge typo3 org projects extension displ
25. umer one such wizard appears per available Data Consumer type This field is required as nothing will be display otherwise Primary Data Provider This is a reference to the Data Provider that will fetch the data to display The field provides wizards for selecting a record edit the current record or create a new Data Provider one such wizard appears per compatible Data Provider type This field is required as nothing will be display otherwise Type of filter Choose the type of filter to apply to the Data Provider The Detail view and List view options will tell the Display Controller to define a filter using the default GET POST variable names for both views Check the Advanced filter option if you want to apply a Data Filter record which has to be selected separately see below Advanced Data Filter primary This is a reference to a Data Filter record that will apply to the Primary Data Provider The field provides wizards for selecting a record edit the current record or create a new Data Filter one such wizard appears per available Data Filter type In order for this filter to be active it is also necessary to select Advanced filter from the Type of filter field see above If filter empty With this field you can choose the behavior of the Display Controller when the filter results in no conditions at all This may happen with a search field for example when the use submits an empty search the filt
26. y clicking on tab HTML Then You can 1nsert inline HTML load a file FILE fileadmin templates plugins tesseract news 1 ist_of_news htm Show JSON Description pe The main action happens in the mapping Fields At the moment there s nothing we can do in the Mapping tab but we can switch to the HTML tab and start defining a template for displaying the list of BE users Enter the following HTML Mappings Mapping HTML lt ul gt lt 1 LOOP be_users gt lt j gt 22FIELD realName t 4 FIELD email 2 lt li gt lt ENDLOOP gt lt ul gt The basic idea is to display the BE users as a bulleted list So the first step is to open and close a lt ul gt tag Inside that tag we define a loop on the be_users table using the syntax which is explained in more details in the manual of the Template Display extension Inside the loop we create a lt li gt tag for each user and decided to display the name and the email side by side the email being wrapped in brackets We can move back the the Mapping tab The HTML that we just entered is saved in the background You should now have the following view Mappings Mapping HTML lt i gt LOOP be_users gt T lt li gt FIELD realNamed FIELD emai l c li gt lt ENDLOOP gt lt ul gt Show JSON As you can see that HTML was parsed and some elements were recognized and highligh
Download Pdf Manuals
Related Search