.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============================ Browser Tutorial Basics (en) ============================ :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Dirk Wildt :Changed: 2013-09-19T21:38:18 :Classification: browser_tut_basics_en :Description: This is the Tutorial with the Basics for the Extension Browser - TYPO3 without PHP. :Keywords: forAdmins, forDevelopers, forBeginners, forIntermediates, forAdvanced, browser, tutorial, basics :Author: Dirk Wildt, Die Netzmacher :Email: http://wildt.at.die-netzmacher.de :Website: http://die-netzmacher.de :Language: en |img-1| |img-2| extKey: browser\_tut\_basics\_en |img-3| .. _Browser-Tutorial-Basics-en: Browser Tutorial Basics (en) ============================ This is the Tutorial with the Basics for the Extension Browser - TYPO3 without PHP. |img-4| Version: 4.6.2, 2013-09-19 - Version is corresponding with the version of the Browser. Extension Key: browser\_tut\_basics\_en - Tutorial for the extension Browser (extkey: browser) Language: en Keywords: forAdmins, forDevelopers, forBeginners, forIntermediates, forAdvanced, browser, tutorial, basics Copyright 2009-2013, 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 ----------------- `Browser Tutorial Basics (en) 1 <#__RefHeading__12229_1904948122>`_ `Beforehand 3 <#__RefHeading__50612_1960331820>`_ `Tutorial in PDF 3 <#__RefHeading__2576_182679940>`_ `Manual of the Browser 3 <#__RefHeading__2578_182679940>`_ `Tutorials Overview 3 <#__RefHeading__2580_182679940>`_ `Demo Websites Overview 6 <#__RefHeading__59838_1960331820>`_ `Installation 7 <#__RefHeading__50614_1960331820>`_ `Extension Manager 7 <#__RefHeading__2584_182679940>`_ `Constant Editor 7 <#__RefHeading__2586_182679940>`_ `Include Static Template 7 <#__RefHeading__2588_182679940>`_ `Tutorial Requirements 8 <#__RefHeading__2590_182679940>`_ `Where are the TypoScript snippets? 8 <#__RefHeading__2592_182679940>`_ `Why do we use tt\_news? 8 <#__RefHeading__2594_182679940>`_ `Convention 8 <#__RefHeading__2596_182679940>`_ `Tutorial I: Quickstart 9 <#__RefHeading__2598_182679940>`_ `One Table with one Relation 9 <#__RefHeading__2600_182679940>`_ `Tutorial II: The Local Table 10 <#__RefHeading__2602_182679940>`_ `Intention 10 <#__RefHeading__2604_182679940>`_ `Step 1: We change the order of the fields 10 <#__RefHeading__2606_182679940>`_ `Step 2: Configuring the local table 12 <#__RefHeading__2608_182679940>`_ `Step 3: Configuring the local table only for one view (local) 13 <#__RefHeading__2610_182679940>`_ `Tutorial III: Labeling and Field Properties 15 <#__RefHeading__2612_182679940>`_ `Labeling 15 <#__RefHeading__2614_182679940>`_ `Marker 15 <#__RefHeading__2616_182679940>`_ `Tutorial IV: Configuring Images 16 <#__RefHeading__2618_182679940>`_ `Tutorial V: Wrapping Fields 17 <#__RefHeading__2620_182679940>`_ `Example with wrap, crop and strftime 17 <#__RefHeading__2622_182679940>`_ `###MARKERS### in TypoScript 17 <#__RefHeading__2624_182679940>`_ `piVars in TypoScript 18 <#__RefHeading__2626_182679940>`_ `general\_stdWrap and the Rich Text Editor 18 <#__RefHeading__2628_182679940>`_ `Tutorial VI: 1:N Relations 20 <#__RefHeading__2630_182679940>`_ `Single View 20 <#__RefHeading__2632_182679940>`_ `Tutorial VII: SEO - Search Engine Optimization 22 <#__RefHeading__2634_182679940>`_ `Please take a look at 22 <#__RefHeading__59840_1960331820>`_ `Tutorial VIII: Page Browser and Index-Browser 23 <#__RefHeading__2638_182679940>`_ `Tutorial IX: Search and Filter 24 <#__RefHeading__2640_182679940>`_ `Search and Filter 24 <#__RefHeading__2642_182679940>`_ `Select Box for Ordering 24 <#__RefHeading__2644_182679940>`_ `Tutorial X: SQL Relation Building 25 <#__RefHeading__2646_182679940>`_ `Tutorial XI: SQL Functions 26 <#__RefHeading__2648_182679940>`_ `Tutorial XII: HTML Templating 27 <#__RefHeading__2650_182679940>`_ `Tutorial 27 <#__RefHeading__50616_1960331820>`_ `Tutorial XIII: Constant Markers 28 <#__RefHeading__2666_182679940>`_ `Marker 28 <#__RefHeading__2668_182679940>`_ `Tutorial XIV: Real URL 29 <#__RefHeading__2670_182679940>`_ `Tutorial XV: Localization 30 <#__RefHeading__2672_182679940>`_ `Tutorial XVI: Data query 31 <#__RefHeading__2674_182679940>`_ `Enable Editors to select defined filters 31 <#__RefHeading__50618_1960331820>`_ `Tutorial 31 <#__RefHeading__50620_1960331820>`_ `TT\_CONTAINER 32 <#__RefHeading__2678_182679940>`_ `Reference 33 <#__RefHeading__2680_182679940>`_ `Helpful suggestions 34 <#__RefHeading__2682_182679940>`_ `To-Do List 35 <#__RefHeading__2684_182679940>`_ `Change Log 36 <#__RefHeading__2686_182679940>`_ `Illustration Index 37 <#__RefHeading__3367_450683128>`_ .. _Beforehand: Beforehand ---------- |img-5| Illustration 1: Tutorial in PDF format This is the basic tutorial for the extension Browser (extkey: browser). Tutorial in PDF ^^^^^^^^^^^^^^^ You find this tutorial as PDF file at - doc/manual.pdf - `http://typo3-browser.de/typo3conf/ext/browser\_tut\_basics\_en/doc/ma nual.pdf `_ .. _Manual-of-the-Browser: Manual of the Browser ^^^^^^^^^^^^^^^^^^^^^ If you are interested in the manual and the reference respectively, please take a look in the manual of the Browser. - HTTP: `http://typo3.org/extension-manuals/browser/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_manual\_en/doc/ma nual.pdf `_ .. _Tutorials-Overview: Tutorials Overview ^^^^^^^^^^^^^^^^^^ This tutorial isn't the only one. There are more tutorials. Link to the tutorials overview: `http://typo3-browser.de/browser-tutorials/ `_ Or visit - `http://typo3.org/extensions/repository/ `_ - and look for "browser\_tut" .. _Backend-Filter: Backend-Filter """""""""""""" Extend the TYPO3 backend list view with filters. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_befilter\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_befilter\_en /doc/manual.pdf `_ .. _BrowserMaps: BrowserMaps """"""""""" Publish your data with Google Maps or OpenStreetMap. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_map\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_map\_en/doc/ manual.pdf `_ .. _Calendar: Calendar """""""" Extend the TYPO3 backend list view with filters. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_cal\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_cal\_en/doc/ manual.pdf `_ .. _CSV-file-RSS-feed-and-XML: CSV file, RSS feed and XML """""""""""""""""""""""""" Export and publish your data independent of any format - like a CSV file or RSS feed. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_rss\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_rss\_en/doc/ manual.pdf `_ .. _Database: Database """""""" Configuring relations between tables. Build your own relation. Using functions, which are provided by the Browser. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_database\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_database\_en /doc/manual.pdf `_ .. _Development: Development """"""""""" Develop the Browser! Use the SVN repository on forge.typo3.org. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_dev\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_dev\_en/doc/ manual.pdf `_ .. _Downloads: Downloads """"""""" Manage your downloads with the Browser! The Browser takes care of user access rights. It is counting hits and visits for downloaded files. See Tutorial Statistics below. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_downloads\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_downloads\_e n/doc/manual.pdf `_ .. _Hooks: Hooks """"" Use hooks for your data. Handle data of any extension in your extension. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_hooks\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_hooks\_en/do c/manual.pdf `_ .. _Images: Images """""" Configuring images and galeries. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_images\_en/ `_ - PDF: http://typo3-browser.de/typo3conf/ext/browser\_tut\_images\_en/do c/manual.pdf .. _Javascript-and-AJAX: Javascript and AJAX """"""""""""""""""" The Browser - TYPO3 without PHP - supports the using of ready JSS scripts and the integration of JavaScript frameworks like jquery. This tutorials has some examples for AJAX, own Designs with jQuery and t3jquery in principle. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_jss\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_jss\_en/doc/ manual.pdf `_ .. _Labeling: Labeling """""""" Labeling and field properties. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_labeling\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_labeling\_en /doc/manual.pdf `_ .. _Localization: Localization """""""""""" Proper localisation design for your database. - HTTP: `http://typo3.org/extension- manuals/browser\_tut\_localization\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_localization \_en/doc/manual.pdf `_ .. _Marker: Marker """""" Database marker, constant marker, browser system marker, piVars marker, TYPO3 GLOBALS Marker. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_marker\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_marker\_en/d oc/manual.pdf `_ .. _Navigation: Navigation """""""""" Tutorial how to use and configure navigation objects like the record browser, index browswer and the page browser, - HTTP: `http://typo3.org/extension- manuals/browser\_tut\_navigation\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_navigation\_ en/doc/manual.pdf `_ .. _RealURL: RealURL """"""" Configuring RealURL - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_realurl\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_realurl\_en/ doc/manual.pdf `_ .. _Search-and-Filter: Search and Filter """"""""""""""""" Configuring the search and the filter - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_search\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_search\_en/d oc/manual.pdf `_ .. _SEO-Search-Engine-Optimization: SEO – Search Engine Optimization """""""""""""""""""""""""""""""" SEO – Search Engine Optimization – for the Browser - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_seo\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_seo\_en/doc/ manual.pdf `_ .. _Several-Plugins: Several Plugins """"""""""""""" Use the Browser plugin several times on the same page. - HTTP: `http://typo3.org/extension- manuals/browser\_tut\_severalplugins\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_severalplugi ns\_en/doc/manual.pdf `_ .. _Social-Media: Social Media """""""""""" Use social bookmarks. Publish your data on facebook.com. - Http: `http://typo3.org/extension- manuals/browser\_tut\_socialmedia\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_socialmedia\ _en/doc/manual.pdf `_ .. _Statistics: Statistics """""""""" Manage your statistics data with the Browser! The Browser collects hits and vistis for records and files. The statistics data is the basis for displaying the most frequented records or files. A good example are top 10 lists for news, products and records of your own database. - Http: `http://typo3.org/extension- manuals/browser\_tut\_statistics\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_statistics\_ en/doc/manual.pdf `_ .. _TCA: TCA """ Configure the TCA Browser properties. Use ready methods for TCA backend form (itemsProcFunc) - Http: `http://typo3.org/extension-manuals/browser\_tut\_tca\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_tca\_en/doc/ manual.pdf `_ .. _Templating: Templating """""""""" Create your own template and your own view. - Http: `http://typo3.org/extension- manuals/browser\_tut\_templating\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_templating\_ en/doc/manual.pdf `_ .. _tt-news-Sample: tt\_news Sample """"""""""""""" Test the Browser out of the box with tt\_news and than with your own data. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_tt\_news\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_tt\_news\_en /doc/manual.pdf `_ .. _Userfunc: Userfunc """""""" The Browser provides some user defined functions (userFunc). The tutorial is a overwiew with the reference. - Http: `http://typo3.org/extension-manuals/browser\_tut\_userfunc\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_userfunc\_en /doc/manual.pdf `_ .. _Demo-Websites-Overview: Demo Websites Overview ^^^^^^^^^^^^^^^^^^^^^^ .. _grne-autos-org: grüne-autos.org """"""""""""""" Database with the browser extension in three hours? The case story demonstrates the work flow. `http://grüne-autos.org/ `_ .. _Job-Market: Job Market """""""""" Offer jobs online with less effort. `http://typo3-job-market.de/ `_ .. _Organiser: Organiser """"""""" TYPO3 for the lobby and organisers. Install it with one click! `http://typo3-organiser.de/ `_ .. _Quick-Shop: Quick Shop """""""""" Quick Shop - the fastest shop in the history of TYPO3. Install the shop with one mouse click! `http://typo3-quick-shop.de/ `_ .. _Route: Route """"" Publish your routes with Google Maps or OpenStreetMap `http://typo3-route.de/ `_ |img-6| Illustration 2: Extension Manager Installation This section is from the section "Installation" from the Browser manual. .. _Extension-Manager: Extension Manager ^^^^^^^^^^^^^^^^^ Open the extension manager, download the extension Browser (extkey: browser) and install it. .. _Constant-Editor: Constant Editor ^^^^^^^^^^^^^^^ You can control some TypoScript properties with the Constant Editor. Modul Web > Template > Your Page > Constant Editor |img-7| .. _Include-Static-Template: Include Static Template ^^^^^^^^^^^^^^^^^^^^^^^ Include the static template in the pages, in which you want to use the Browser . |img-7| .. _Tutorial-Requirements: Tutorial Requirements --------------------- .. _Where-are-the-TypoScript-snippets: Where are the TypoScript snippets? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You find the snippets in the path res/tutorial of this extension. - Module Tools > Extension Manager - Extension: Browser Tutorial Basics (en). Click on the name of the extension. - Option: Edit Files - Click on the Link [Edit file] of the file, you want to use. |img-7| .. _Why-do-we-use-tt-news: Why do we use tt\_news? ^^^^^^^^^^^^^^^^^^^^^^^ We use fields from the extension News (extkey: tt\_news), because - this extension is very popular and a part of your TYPO3 installation probably, - the tables tt\_news and tt\_news\_cat are connected by a M-M relation. In principal the tutorial has to work with every other extension, if tables are connected with a M-M relation. .. _Convention: Convention ^^^^^^^^^^ .. _TypoScript: TypoScript """""""""" If we have lines, that haven't enough space in one line in this manual, we marked it up with a backslash '\'. Example: plugin.tx\_browser\_pi1.views.single.3.select = tt\_news.title, tt\_news.bodytext, tt\_news.image, **\** tt\_news.imagecaption, tt\_news.imagealttext, **\** tt\_news.imagetitletext If you copy this code in your TypoScript, please delete the backslash '\' and put all lines in one line. plugin.tx\_browser\_pi1.views.single.3.select = tt\_news.title, tt\_news.bodytext, tt\_news.image, ... .. _Tutorial-I-Quickstart: Tutorial I: Quickstart ---------------------- .. _One-Table-with-one-Relation: One Table with one Relation ^^^^^^^^^^^^^^^^^^^^^^^^^^^ Please see the section "Tutorial: Quickstart" in the Browser manual. - HTTP: `http://typo3.org/extension-manuals/browser\_manual\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_manual\_en/doc/ma nual.pdf `_ .. _Tutorial-II-The-Local-Table: Tutorial II: The Local Table ---------------------------- .. _Intention: Intention ^^^^^^^^^ The tutorial describes the context between local and foreign tables. It is important to understand it, especially in case of strange results in the frontend. .. _TypoScript: TypoScript """""""""" You find the whole TypoScript code for this tutorial in the folder res/tutorial\_01. .. _Step-1-We-change-the-order-of-the-fields: Step 1: We change the order of the fields ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Exercise: Exercise """""""" We change the order of the both fields in the view list 1: tt\_news\_cat.title is the first field now tt\_news.title is the second field now .. _TypoScript: TypoScript """""""""" You find the TypoScript code for this step in res/tutorial\_01/step\_01.txt. Insert these lines in your TypoScript: plugin.tx\_browser\_pi1 { views { list { 1 { select = **tt\_news\_cat.title, tt\_news.title** } } } } .. _Result: Result """""" The result is an error. Why? |img-7| |img-7| The reason should be easy to understand: - The Browser Tutorial Basics (en) takes the table of the first field as the local table. - tt\_news\_cat hasn't any connection back to the table tt\_news (it would be useless): tt\_news\_cat > tt\_news\_cat\_mm > tt\_news - The Browser Tutorial Basics (en) can't built a relation If you want to investigate what's happen, take a look in the devlog: |img-7| The Browser Tutorial Basics (en) builts a wrong query because of a missing relation: table tt\_news isn't known. .. _Result-in-case-of-a-FULL-JOIN: Result in case of a FULL JOIN """"""""""""""""""""""""""""" You can use the Browser Tutorial Basics (en) in a FULL JOIN mode. The Browser Tutorial Basics (en) builds in this mode FULL JOINS instead of LEFT JOINS. |img-7| You will get another result but it is wrong too: You see a lot of records (in this example 318 instead of 41) |img-7| |img-7| .. _Solution: Solution """""""" If you need your own field ordering independent of the automatic SQL relation building it doesn't any matter. You have to tell the Browser Tutorial Basics (en) only, which is the local table (see next step). .. _Step-2-Configuring-the-local-table: Step 2: Configuring the local table ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _TypoScript: TypoScript """""""""" The TypoScript coded based on the code from the last step. You find the TypoScript code for this step inres/tutorial\_01/step\_02.txt. .. _Exercise: Exercise """""""" We configure the local table. - We inspect the TypoScript code with the TypoScript Object Browser - We add the name of the local table. |img-7| |img-7| Edit the property "localTable", click on it. Module Web >Template , Page "tutorial", TypoScript Object Browser, plugin.tx\_browser\_pi1.localTable Set the value to your local table: tt\_news Press the button [Update] .. _TypoScript: TypoScript """""""""" The TypoScript Object Browser wrote the following code in the last line of our TypoScript Setup: plugin.tx\_browser\_pi1.localTable = **tt\_news** .. _Result: Result """""" |img-7| We have a proper result. .. _Step-3-Configuring-the-local-table-only-for-one-view-local: Step 3: Configuring the local table only for one view (local) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The Browser Tutorial Basics (en) has a lot of properties, which can be used "local". Local means: You can copy the global property to every view. This enables the differently configuration for every view. We edit the TypoScript code. - We copy the global array to the view. Then the view has a local array . - We configure the property localTable in the local array. .. _TypoScript: TypoScript """""""""" You find the TypoScript code for this step in res/tutorial\_01/step\_03.txt. plugin.tx\_browser\_pi1 { views { list { 1 { select = **tt\_news\_cat.title, tt\_news.title** } } } } plugin.tx\_browser\_pi1.views.list.1 { localTable < **plugin.tx\_browser\_pi1.localTable** localTable = **tt\_news** } .. _TypoScript-Object-Browser: TypoScript Object Browser """"""""""""""""""""""""" |img-7| .. _Tutorial-III-Labeling-and-Field-Properties: Tutorial III: Labeling and Field Properties ------------------------------------------- .. _Labeling: Labeling ^^^^^^^^ Please take a look in the Browser Tutorial Labeling. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_labeling\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_labeling\_en /doc/manual.pdf `_ .. _Marker: Marker ^^^^^^ Design your own layout. Have access to hundreds of TYPO3 values at runtime. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_marker\_en `_ / - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_marker\_en/d oc/manual.pdf `_ .. _Tutorial-IV-Configuring-Images: Tutorial IV: Configuring Images ------------------------------- Please take a look in the Browser Tutorial Images. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_images\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_images\_en/d oc/manual.pdf `_ .. _Tutorial-V-Wrapping-Fields: Tutorial V: Wrapping Fields --------------------------- The tutorial describes, how to wrap any table field. .. _Example-with-wrap-crop-and-strftime: Example with wrap, crop and strftime ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Every table in TYPO3 has the field tstamp. But tstamp isn't configured in the TCA. Because of this, the Browser Tutorial Basics (en) hasn't any chance to detect this field as a time stamp and can't format it in a human readable format. .. _Exercise: Exercise """""""" - We add to the list view the tstamp field. - We wrap it as a date. - We wrap it as a header. - We want to truncate it after 14 characters. .. _TypoScript: TypoScript """""""""" You find the TypoScript code for this step in res/tutorial\_05/step\_01.txt. plugin.tx\_browser\_pi1 { views { list { 1 { select = **tt\_news.title, tt\_news.tstamp, tt\_news.image** tt\_news.tstamp { strftime = **%c** wrap = **

\|

** crop = **14 \| ...** } } } } } .. _Result: Result """""" |img-7| |img-7| The time stamp values are formatted as a human readable date, wrapped with an HTML

-tag and are truncated. .. _MARKERS-in-TypoScript: ###MARKERS### in TypoScript ^^^^^^^^^^^^^^^^^^^^^^^^^^^ Please take a look in the Browser Tutorial Marker. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_marker\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_marker\_en/d oc/manual.pdf `_ .. _piVars-in-TypoScript: piVars in TypoScript ^^^^^^^^^^^^^^^^^^^^ Please take a look in the Browser Tutorial Marker. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_marker\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_marker\_en/d oc/manual.pdf `_ .. _general-stdWrap-and-the-Rich-Text-Editor: general\_stdWrap and the Rich Text Editor ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Every field will be wrapped with the properties of the general\_stdWrap array. The general\_stdWrap has the properties of lib.parseFunc\_RTE by default but without wrapping non wrapped lines with the

-Tag. .. _Global-Configuration: Global Configuration """""""""""""""""""" If you want to change the wrapping please configure plugin.tx\_browser\_pi1 { general\_stdWrap { parseFunc < **lib.parseFunc\_RTE** parseFunc { nonTypoTagStdWrap { encapsLines { nonWrappedTag > } } } } .. _Local-Configuration: Local Configuration """"""""""""""""""" If you want to use the RTE functionality only for one field only, add the parseFunc propertiy to this fieldchange the wrapping please configure plugin.tx\_browser\_pi1 { views { ... single { 1 { ... tx\_bzdstaffdirectory\_persons { opinion { parseFunc **< lib.parseFunc\_RTE** } } } } } } You will have a full qualified parseFunc\_RTE array and you can edit it in the TypoScript Object Browser (see the illustration below) fot the used field especially. |img-7| |img-7| |img-7| .. _Handle-as-Text: Handle as Text """""""""""""" Fields, which should handled as Text like in this TypoScript plugin.tx\_browser\_pi1 { views { single { 1 { select = tx\_juridat\_pi1.issue, tx\_juridat\_pi1.headnote handleAs { text = **tx\_juridat\_pi1.headnote** } } } } } will be wrapped with the displayList.content\_stdWrap or displaySingle.content\_stdWrap properties. content\_stdWrap will wrap lines without tags with a

\|

by default. If there isn't any local nor global displayList.content\_stdWrap or displaySingle.content\_stdWrap array, the Browser will wrap the field with the general\_stdWrap property. .. _Tutorial-VI-1-N-Relations: Tutorial VI: 1:N Relations -------------------------- The Browser process 1:n relations as 1:n relations automatically. There is only one requirement: You have to select the uid of the children records in your SELECT statement. The Browser extends the TypoScript stdWrap property for this cae with a special array: - You can wrap all items - You can prepend a header - If there isn't any child, you can configure, that nothing will displayed. .. _Single-View: Single View ^^^^^^^^^^^ .. _Example: Example """"""" - We have a main table tx\_bzdstaffdirectory\_persons (local table). - There is a relation to a table tx\_bzdstaffdirectory\_functions (foreign table). |img-7| |img-7| .. _HTML-Template: HTML-Template """"""""""""" There is nothing to do but to replace your table.field as a marker at your position of your HTML template.Code (cutout): ...
...

\| if { **isTrue** = ###TX\_BZDSTAFFDIRECTORY\_FUNCTIONS.TITLE### } extensions { browser { wrapAll { **header** { value = Domains: lang { de = Arbeitsbereiche: } wrap =

\|

} **stdWrap** { wrap =
    \|
} } } } } } ... } } } } .. _Tutorial-VII-SEO-Search-Engine-Optimization: Tutorial VII: SEO - Search Engine Optimization ---------------------------------------------- Please take a look at - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_seo\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_seo\_en/doc/ manual.pdf `_ .. _Tutorial-VIII-Page-Browser-and-Index-Browser: Tutorial VIII: Page Browser and Index-Browser --------------------------------------------- Please take a look in the Browser Tutorial Navigation. - HTTP: `http://typo3.org/extension- manuals/browser\_tut\_navigation\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_navigation\_ en/doc/manual.pdf `_ .. _Tutorial-IX-Search-and-Filter: Tutorial IX: Search and Filter ------------------------------ .. _Search-and-Filter: Search and Filter ^^^^^^^^^^^^^^^^^ |img-7| |img-7| |img-7| Please take a look in the Browser Tutorial Search. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_search\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_search\_en/d oc/manual.pdf `_ .. _Select-Box-for-Ordering: Select Box for Ordering ^^^^^^^^^^^^^^^^^^^^^^^ See the Tutorial Marker: .. _Marker: Marker """""" Design your own layout. Have access to hundreds of TYPO3 values at runtime. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_marker\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_marker\_en/d oc/manual.pdf `_ .. _Tutorial-X-SQL-Relation-Building: Tutorial X: SQL Relation Building --------------------------------- Please take a look in the Browser Tutorial Database. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_database\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_database\_en /doc/manual.pdf `_ .. _Tutorial-XI-SQL-Functions: Tutorial XI: SQL Functions -------------------------- Please take a look in the Browser Tutorial Database. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_database\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_database\_en /doc/manual.pdf `_ .. _Tutorial-XII-HTML-Templating: Tutorial XII: HTML Templating ----------------------------- .. _Tutorial: Tutorial ^^^^^^^^ See Tutorial Templating: - HTTP: `http://typo3.org/extension- manuals/browser\_tut\_templating\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_templating\_ en/doc/manual.pdf `_ .. _Tutorial-XIII-Constant-Markers: Tutorial XIII: Constant Markers ------------------------------- .. _Marker: Marker ^^^^^^ Marker enables to design individual designs. Please take a look in the Browser Tutorial Marker. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_marker\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_marker\_en/d oc/manual.pdf `_ .. _Tutorial-XIV-Real-URL: Tutorial XIV: Real URL ---------------------- Please take a look in the Browser Tutorial RealURL. - HTTP: `http://typo3.org/extension-manuals/browser\_tut\_realurl\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_realurl\_en/ doc/manual.pdf `_ .. _Tutorial-XV-Localization: Tutorial XV: Localization ------------------------- Please take a look in the Browser Tutorial Localization. - HTTP: `http://typo3.org/extension- manuals/browser\_tut\_localization\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_localization \_en/doc/manual.pdf `_ .. _Tutorial-XVI-Data-query: Tutorial XVI: Data query ------------------------ .. _Enable-Editors-to-select-defined-filters: Enable Editors to select defined filters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You can enable editors to select filters by the plugin/flexform. Example: - An editor select a template with news, which is displaying all news. - If it is configured, an editor can select a data query like "Politician" or "Society".The view will display news with the category politician or society in the frontend. .. _Tutorial: Tutorial ^^^^^^^^ Please take a look in the Browser Tutorial Templating. - HTTP: `http://typo3.org/extension- manuals/browser\_tut\_templating\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_templating\_ en/doc/manual.pdf `_ .. _TT-CONTAINER: TT\_CONTAINER ------------- Sorry, but TT\_CONTAINER is deprecated. .. _Reference: Reference --------- See the section Reference in the Browsers manual. - HTML `http://typo3.org/extension-manuals/browser\_manual\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_manual\_en/doc/ma nual.pdf `_ .. _Helpful-suggestions: Helpful suggestions ------------------- If you have helpful suggestions, feel free to contact me: `http://wildt.at.die-netzmacher.de `_ . .. _To-Do-List: To-Do List ---------- Nothing to do. .. _Change-Log: Change Log ---------- 4.6.2 **New Features** - Update the manual 4 3.0.5 **New Feature** - Browser Tutorial Marker (en) 3.0.1 **Initial release** .. _Illustration-Index: Illustration Index ------------------ Illustration 1: Tutorial in PDF format 3 Illustration 2: Extension Manager 7 Illustration 3: Constant Editor 7 Illustration 4: Include static template from extension 7 .. _Illustration-5-Get-the-TypoScript-snippet-Click-the-link-Edit-file: Illustration 5: Get the TypoScript snippet? Click the link [Edit file] 8 Illustration 6: Without the DRS - Development Reporting System 10 Illustration 7: With the DRS10 Illustration 8: Entries in the logging report 11 Illustration 9: The Browser Tutorial Basics (en) in FULL JOIN mode - relations.left\_join is 0 (FALSE) 11 Illustration 10: Result with a wrong relation in a FULL JOIN mode. 12 Illustration 11: For comparison the proper result. 12 Illustration 12: The global localTable array 12 Illustration 13: Allocating localTable with your own local table 13 Illustration 14: Proper result with a manually configured local table. 13 Illustration 15: Configuration in the TypoScript Object Browser 14 Illustration 16: The time stamp isn't wrapped 17 Illustration 17: The wrapped time stamp. 17 Illustration 18: parseFunc in the Typoscript Object Browser 19 Illustration 19: RTE field in the backend 19 Illustration 20: RTE field in the frontend 19 Illustration 21: 1:n relation in the frontend 20 Illustration 22: 1:n relation in the backend 20 Illustration 23: List view 24 Illustration 24: Result with six search words 24 Illustration 25: Searchform with three filters 24 37 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.jpeg .. :border: 0 .. :height: 20 .. :id: Grafik2 .. :name: Grafik2 .. :width: 69 .. |img-3| image:: img-3.png .. :align: bottom .. :border: 0 .. :height: 27 .. :id: graphics25 .. :name: graphics25 .. :width: 30 .. |img-4| image:: img-4.png .. :align: bottom .. :border: 0 .. :height: 268 .. :id: graphics5 .. :name: graphics5 .. :width: 302 .. |img-5| image:: img-5.jpeg .. :align: left .. :border: 0 .. :height: 225 .. :id: graphics47 .. :name: graphics47 .. :width: 227 .. |img-6| image:: img-6.jpeg .. :align: left .. :border: 0 .. :height: 94 .. :id: Grafik12 .. :name: Grafik12 .. :width: 227 .. |img-7| image:: data: :alt: Frame2 .. :align: bottom .. :id: Frame2 .. :name: Frame2