.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============================= Browser Tutorial RealUrl (en) ============================= :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: dirk :Changed: 2015-05-28T17:05:20 :Classification: browser_tut_realurl_en :Description: Configure RealURL. Tutorial for the Browser – TYPO3 without PHP. :Keywords: browser, typo3 without php, realurl :Author: Dirk Wildt, Die Netzmacher :Email: http://wildt.at.die-netzmacher.de :Website: http://die-netzmacher.de :Language: en |img-1| |img-2| Browser Tutorial RealUrl (en) (extkey: browser\_tut\_realurl\_en) |img-3| .. _Browser-Tutorial-RealUrl-en: Browser Tutorial RealUrl (en) ============================= **Browser – TYPO3 without PHP** Configure RealURL. Tutorial for the Browser – TYPO3 without PHP. |img-4| Version: 7.1.3, 2015-05-28 Extension Key: browser\_tut\_realurl\_en Language: en Keywords: browser, typo3 without php, realurl Copyright 2009-2015, 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 RealUrl (en) 1 <#__RefHeading__24238_633547889>`_ `Screen Shots 3 <#__RefHeading__4079_122014903>`_ `Introduction 4 <#__RefHeading__4081_122014903>`_ `What does the Tutorial do? 4 <#__RefHeading__4083_122014903>`_ `What does the Browser do with Real URL? 4 <#__RefHeading__4085_122014903>`_ `Further Information 4 <#__RefHeading__4087_122014903>`_ `Beforehand 5 <#__RefHeading__4089_122014903>`_ `Configuring Real URL in general 5 <#__RefHeading__4091_122014903>`_ `Real URL Manual 5 <#__RefHeading__4093_122014903>`_ `Tutorial 6 <#__RefHeading__4095_122014903>`_ `Configuration for all pages in general 6 <#__RefHeading__4097_122014903>`_ `Configure pages differently 8 <#__RefHeading__4099_122014903>`_ `Recover piVars for Links to the Single View 9 <#__RefHeading__4101_122014903>`_ `Reference 10 <#__RefHeading__4103_122014903>`_ `Helpful suggestions 11 <#__RefHeading__4152_122014903>`_ `Change Log 12 <#__RefHeading__4109_122014903>`_ `Illustration Index 13 <#__RefHeading__7879_1359502716>`_ `Alphabetical Index 14 <#__RefHeading__14691_1458450892>`_ .. _Screen-Shots: Screen Shots ------------ |img-5| A URL looks like this without Real URL: http://die-netzmacher.de/index.php?id=2926&tx\_browser\_pi1[showUid]=1 4319&cHash=a81cae5084 |img-5| A URL looks like this with Real URL: http://die-netzmacher.de/nachrichten/title/ab-heute-die-netzmacher/ .. _Introduction: Introduction ------------ .. _What-does-the-Tutorial-do: What does the Tutorial do? ^^^^^^^^^^^^^^^^^^^^^^^^^^ This is a tutorial for the extension Browser (extkey: browser). It is a step-by-step introduction for the configuration of the Real URL functionality only. If you are interested in other issues, please note the section "Further Informations" below. .. _What-does-the-Browser-do-with-Real-URL: What does the Browser do with Real URL? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - Searching in displayed and in non displayed columns. - Searching for words and phrases. Example: - Sword: "My Phrase" Word another word - Will search for "My Phrase" or "Word" or "another" or "word". - |img-6| Illustration 3: Tutorial in PDF format The search is case insensitive. - The search is configurable: - You can search in every column of every table. It doesn't matter, if table or filed are displayed in the current view. - You can configure the search form. - You can configure the colors of the result items. .. _Further-Information: Further Information ^^^^^^^^^^^^^^^^^^^ .. _This-tutorial-in-PDF-format: This tutorial in PDF format """"""""""""""""""""""""""" You find this manual as PDF file at - doc/manual.pdf - `http://typo3.org/extensions/repository/view/browser\_tut\_realurl\_en /current/info/?tx\_terfe\_pi1%5BdownloadFile%5D=doc%252Fmanual.pdf `_ .. _Browser-Manual-and-Browser-Tutorial-Basics: Browser Manual and Browser Tutorial Basics """""""""""""""""""""""""""""""""""""""""" Manual: The Browser has it's own manual (with the reference of course). - HTML `http://typo3.org/documentation/document-library/extension- manuals/browser/current/ `_ - PDF: `http://typo3.org/extensions/repository/view/browser/current/info /?tx\_terfe\_pi1%5BdownloadFile%5D=doc%252Fmanual.pdf `_ Tutorial Basics: A lot of step-by-step introductions. - HTML: `http://typo3.org/documentation/document-library/extension- manuals/browser\_tut\_basics\_en/current/ `_ - PDF: `http://typo3.org/extensions/repository/view/browser\_tut\_basics \_en/current/info/?tx\_terfe\_pi1%5BdownloadFile%5D=doc%252Fmanual.pdf `_ .. _Beforehand: Beforehand ---------- .. _Configuring-Real-URL-in-general: Configuring Real URL in general ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You can configure the Browser for Real URL with the common Real URL configuration. .. _Real-URL-Manual: Real URL Manual ^^^^^^^^^^^^^^^ You find the whole documentation for Real URL on `http://typo3.org/extensions/repository/view/realurl/current/ `_ .. _Tutorial: Tutorial -------- .. _Configuration-for-all-pages-in-general: Configuration for all pages in general ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you have a small website with a small RealUrl configuration, you should take the easy way: Configuring RealURL for all pages of your site. .. _Browser-Sample: Browser Sample """""""""""""" You find a Browser sample at: typo3conf/ext/browser/Resources/Private/Extensions/RealURL/realurl\_co nf.php .. _realurl-conf-php: realurl\_conf.php """"""""""""""""" You find the TypoScript code in res/01\_realurl\_conf.php. array( // 'table' => 'tx\_mytable', // ... $TYPO3\_CONF\_VARS['EXTCONF']['realurl'] = array( '\_DEFAULT' => array( 'postVarSets' => array( '\_DEFAULT' => array( 'title' => array( array( 'GETvar' => 'tx\_browser\_pi1[showUid]' , 'lookUpTable' => array( 'table' => 'tt\_news', // <- Your table 'id\_field' => 'uid', 'alias\_field' => 'title', 'addWhereClause' => ' AND NOT deleted AND NOT hidden', 'useUniqueCache' => 1, 'useUniqueCache\_conf' => array( 'strtolower' => 1, 'spaceCharacter' => '-', ), ), ), ), 'az' => array( array( 'GETvar' => 'tx\_browser\_pi1[azTab]' , ), ), 'mode' => array( array( 'GETvar' => 'tx\_browser\_pi1[mode]' , ), array( 'GETvar' => 'tx\_browser\_pi1[pointer]' , ), ), 'sort' => array( array( 'GETvar' => 'tx\_browser\_pi1[sort]' , ), ), 'sword' => array( array( 'GETvar' => 'tx\_browser\_pi1[sword]' , ), ), ), ), ), ) ?> Please copy the code in you localconf.php or in your realurl\_conf.php. .. _Comment: Comment """"""" Every parameter of the Browser Tutorial RealUrl (en) will be renamed as a word of your choice. Example with the the code above: ' **az** ' => array( array( 'GETvar' => ' **tx\_browser\_pi1[azTab]** ' , ), The parameter "tx\_browser\_pi1[azTab]" (line 37) will be renamed as brwAZ (line 35). If you like another name i.e. "myAz", please change the value in line 35 to "myAz". The uid of the record will be renamed as the title of the record. Example with the code above: ' **title** ' => array( array( 'GETvar' => ' **tx\_browser\_pi1[showUid]** ' , 'lookUpTable' => array( 'table' => 'tt\_news', // <- Your table 'id\_field' => 'uid', 'alias\_field' => 'title', 'addWhereClause' => ' AND NOT deleted AND NOT hidden', 'useUniqueCache' => 1, 'useUniqueCache\_conf' => array( 'strtolower' => 1, 'spaceCharacter' => '-', ), ), ), ), The code should be easy to understand. We have an array lookUpTable in line 22. This effects that the extension Real URL will look up in the defined table a value for the given uid. In the case above, Real URL will search the record by its "uid" (line 24) in the table "tt\_news" (line 23) and will renamed the uid as the value from the "title" (line 25). If you want to know more about configuration possibilities, please take a look in the manual of the extension Real URL. .. _Configure-pages-differently: Configure pages differently ^^^^^^^^^^^^^^^^^^^^^^^^^^^ We had a contract to develop the Browser for displaying records from the database Virtual Civil Services (extkey: civserv). It is a database especially for public services. It displays services, agencies and forms among other things. If you have a detail view of a service like a dog license fee there is a link to the appropriate agency like the city finance department. Real URL generates a proper link to that agency if you are using the fixedPostVars array. The fixedPostVars array enables a real URL configuration depending on the current page. .. _realurl-conf-php: realurl\_conf.php """"""""""""""""" You find the TypoScript code in res/02\_realurl\_conf.php. In line 46 is a page id. Please replace it with your page id. array ( array ( 'GETvar' => 'tx\_browser\_pi1[azTab]', 'valueDefault' => 'A-Z', ), array ( 'GETvar' => 'tx\_browser\_pi1[showUid]', 'lookUpTable' => array ( 'table' => 'tx\_civserv\_service', 'id\_field' => 'uid', 'alias\_field' => 'sv\_name', 'addWhereClause' => ' AND NOT deleted AND NOT hidden', 'useUniqueCache' => 1, 'useUniqueCache\_conf' => array ( 'strtolower' => 1, 'spaceCharacter' => '-', ), ) ), array ( 'GETvar' => 'tx\_browser\_pi1[pointer]', ), ), ' **1512** ' => 'tx\_civserv\_service', ); ... $TYPO3\_CONF\_VARS['EXTCONF']['realurl']['\_DEFAULT']['postVarSets'] = array ( ... ); ?> .. _Comment: Comment """"""" You see the completely code in res/02\_realurl\_conf.php The code has three parts: Default real URL configuration Real URL configuration for civserv depending on the current page Real URL configuration for all pages Default real URL configuration Here you configure the general real URL configuration Real URL configuration for civserv depending on the current page Here you configure the real URL configuration only for the configured page (see line 46) .. _Further-Information: Further Information """"""""""""""""""" See the Tutorial "Page Browser and A-Z-Browser". The A-Z-Browser has a paragraph with real URL. You find it in the Tutorial Basics. .. _Recover-piVars-for-Links-to-the-Single-View: Recover piVars for Links to the Single View ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The Browser remove some piVars from the list in the default mode to get short URL. There should be only one piVar available in links to a single view - the sword. If you have your own requirements, you can recover every piVar. Please configure the following TypoScript: plugin.tx\_browser\_pi1 { advanced { realUrl { linkToSingle { // [boolean] If it's true, the array dont\_display\_piVars will be processed dont\_display\_piVars = 1 dont\_display\_piVars { // [boolean] If it's true, piVars[azTab] won't used in a link to a single view azTab = 1 // [boolean] If it's true, piVars[sort] won't used in a link to a single view mode = 1 // [boolean] If it's true, piVars[mode] won't used in a link to a single view pointer = 1 // [boolean] If it's true, piVars[pointer] won't used in a link to a single view plugin = 1 // [boolean] If it's true, piVars[sort] won't used in a link to a single view sort = 1 // [boolean] If it's true, piVars[sword] won't used in a link to a single view sword = 0 } } } } } .. _Reference: Reference --------- See the section Reference in the Browsers manual in - HTML `http://typo3.org/documentation/document-library/extension- manuals/browser/current/ `_ - PDF: `http://typo3.org/extensions/repository/view/browser/current/info /?tx\_terfe\_pi1%5BdownloadFile%5D=doc%252Fmanual.pdf `_ .. _Helpful-suggestions: Helpful suggestions ------------------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _Forum: Forum """"" If you have helpful suggestions, feel free to publish any question, bug or code snippet on `http://typo3-browser-forum.de/ `_ Posts are welcome in English and German. .. _New-Features-and-Bug-Reports: New Features and Bug Reports """""""""""""""""""""""""""" You are welcome to post any question, bug or code snippet on TYPO3 forge.Here you find feature announcements and bug reports.See `http://forge.typo3.org/projects/show/extension-browser `_ .. _Change-Log: Change Log ---------- 7.1.3 **Feature** \* #i0176: RealURL sample. See: typo3conf/ext/brows er/Resources/Private/Extensions/RealURL/realurl\_conf.php **Update** \* #i0002: For Browser 7.1.2 3.0.1 **Initial release** .. _Illustration-Index: Illustration Index ------------------ Illustration 1: URL without Real URL 3 Illustration 2: URL without Real URL 3 Illustration 3: Tutorial in PDF format 4 .. _Alphabetical-Index: Alphabetical Index ------------------ 14 .. ######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: 16 .. :id: graphics1 .. :name: graphics1 .. :width: 18 .. |img-4| image:: img-4.png .. :align: bottom .. :border: 0 .. :height: 268 .. :id: graphics6 .. :name: graphics6 .. :width: 302 .. |img-5| image:: data: :alt: Frame4 .. :align: bottom .. :id: Frame4 .. :name: Frame4 .. |img-6| image:: img-6.jpeg .. :align: left .. :border: 0 .. :height: 205 .. :id: Grafik3 .. :name: Grafik3 .. :width: 227