.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ======================================= Browser Tutorial CSV/RSS/vCard/XML (en) ======================================= :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: dirk :Changed: 2015-06-09T23:46:30 :Classification: browser_tut_rss_en :Description: Publish your data in CSV, RSS, vCard, VCF or XML! Tutorial for publishing data in a comma-separated-list, as RSS-Feed, as vCrad or in XML. Browser – TYPO3 without PHP. :Keywords: browser, typo3 without php, csv, feed, rss, vcard, vcf, xml :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 CSV/RSS/vCard/XML (en) (extkey: browser\_tut\_rss\_en) |img-3| .. _Browser-Tutorial-CSV-RSS-vCard-XML-en: Browser Tutorial CSV/RSS/vCard/XML (en) ======================================= **Browser - TYPO3 without PHP** Publish your data in CSV, RSS, vCard, VCF or XML! Tutorial for publishing data in a comma-separated-list, as RSS-Feed, as vCrad or in XML. Browser – TYPO3 without PHP. |img-4| Version: 7.2.0, 2015-06-01 Extension Key: browser\_tut\_rss\_en Language: en Keywords: browser, typo3 without php, csv, feed, rss, vcard, vcf, xml Copyright 2010-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 CSV/RSS/vCard/XML (en) 1 <#__RefHeading__24238_633547889>`_ `Screen Shots 3 <#__RefHeading__33763_510247921>`_ `CSV export 3 <#__RefHeading__19076_836230152>`_ `RSS/XML 4 <#__RefHeading__19078_836230152>`_ `vCard 5 <#__RefHeading__19080_836230152>`_ `Introduction 6 <#__RefHeading__1513_1172745218>`_ `What does it do? 6 <#__RefHeading__1169_1172745218>`_ `Further Information 6 <#__RefHeading__33765_510247921>`_ `CSV Sample 7 <#__RefHeading__2608_888143581>`_ `Precondition 7 <#__RefHeading__16322_633547889>`_ `Backend: one mouse click! 7 <#__RefHeading__3471_1423540087>`_ `Frontend: Export Button 8 <#__RefHeading__15382_633547889>`_ `CSV export in depth 9 <#__RefHeading__16324_633547889>`_ `Known bugs 10 <#__RefHeading__2610_888143581>`_ `RSS/XML Sample 11 <#__RefHeading__2867_277981672>`_ `Preconditions 11 <#__RefHeading__2869_277981672>`_ `Add a Page, a Plugin and the Extension Template 11 <#__RefHeading__2871_277981672>`_ `Configuring 12 <#__RefHeading__3718_277981672>`_ `Result in the Frontend 13 <#__RefHeading__3726_277981672>`_ `Adapt the Sample to your Needs 14 <#__RefHeading__6390_277981672>`_ `RSS Alternate Link 16 <#__RefHeading__14467_277981672>`_ `Template 16 <#__RefHeading__3730_277981672>`_ `vCard Sample 17 <#__RefHeading__59133_1116738509>`_ `Precondition 17 <#__RefHeading__17833_836230152>`_ `Page 17 <#__RefHeading__17835_836230152>`_ `Link 22 <#__RefHeading__17837_836230152>`_ `Constant Editor 24 <#__RefHeading__17839_836230152>`_ `[BROWSER – Navigation] 24 <#__RefHeading__15294_836230152>`_ `[BROWSER – PAGE OBJECTS] 24 <#__RefHeading__15296_836230152>`_ `[BROWSER – TEMPLATES – LIST – HEADER 0] 24 <#__RefHeading__15300_836230152>`_ `[BROWSER – TEMPLATES – LIST – URL 0] 24 <#__RefHeading__17422_836230152>`_ `[BROWSER – TEMPLATES – SINGLE – VCARD 0] 25 <#__RefHeading__17424_836230152>`_ `Reference 27 <#__RefHeading__17841_836230152>`_ `Completely Browser Reference 27 <#__RefHeading__44233_603351207>`_ `Export CSV and vCard 27 <#__RefHeading__18447_836230152>`_ `RSS 28 <#__RefHeading__59135_1116738509>`_ `FAQ 29 <#__RefHeading__11025_1112387226>`_ `Can I use this Feature for Products and Events too? 29 <#__RefHeading__6396_277981672>`_ `Can I publish Data from Foreign Tables? 29 <#__RefHeading__6885_277981672>`_ `Does this Feature supports RealURL? 29 <#__RefHeading__6398_277981672>`_ `Helpful suggestions 30 <#__RefHeading__33767_510247921>`_ `Change Log 31 <#__RefHeading__3727_2139160512>`_ `Illustration Index 32 <#__RefHeading__7879_1359502716>`_ `Alphabetical Index 33 <#__RefHeading__14691_1458450892>`_ .. _Screen-Shots: Screen Shots ------------ .. _CSV-export: CSV export ^^^^^^^^^^ |img-5| See details at the section "CSV Sample" on page 7 below. .. _RSS-XML: RSS/XML ^^^^^^^ |img-5| See details at the section "RSS/XML Sample" on page 11 below. .. _vCard: vCard ^^^^^ |img-5| See details at the section "vCard Sample" on page 17 below. .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This is a tutorial for the extension Browser (extkey: browser). It is a manual how to publish and save your data - in a CSV-file (comma-separated-list), - as a RSS feed - as a vCard file (vcf) or - in XML by the Browser – TYPO3 without PHP. .. _Further-Information: Further Information ^^^^^^^^^^^^^^^^^^^ .. _This-tutorial-in-PDF-format: This tutorial in PDF format """"""""""""""""""""""""""" You find this tutorial as a PDF file at - doc/manual.pdf - `http://typo3-browser.de/typo3conf/ext/browser\_tut\_rss\_en/doc/manua l.pdf `_ .. _Browser-Manual: Browser Manual """""""""""""" Manual: The Browser has it's own manual (with the reference of course). - HTML: `http://typo3.org/extensions/repository/view/browser\_manual\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_manual\_en/doc/ma nual.pdf `_ .. _CSV-Sample: CSV Sample ---------- .. _Precondition: Precondition ^^^^^^^^^^^^ You publish data with the Browser – TYPO3 without PHP. The sample from below is based on the tt\_news sample. See - HTML: `http://typo3.org/extensions/repository/view/browser\_tut\_tt\_n ews\_en/ `_ - PDF: `http://typo3-browser.de/typo3conf/ext/browser\_tut\_tt\_news\_en /doc/manual.pdf `_ .. _Backend-one-mouse-click: Backend: one mouse click! ^^^^^^^^^^^^^^^^^^^^^^^^^ |img-5| - Select the tab [List View] - Set the field "CSV export" to [enabled] (1) The button [Export] will displayed in the frontend. See "Frontend: Export Button" below. .. _Frontend-Export-Button: Frontend: Export Button ^^^^^^^^^^^^^^^^^^^^^^^ |img-5| |img-5| Click on the button [Export] A dialogue box will open and will propose a proper application for opening the CSV file. The proposed application depends on the properties of the client personal computer. Click [OK]! Open the CSV file with your CSV application (here: Libre Office). .. _CSV-export-in-depth: CSV export in depth ^^^^^^^^^^^^^^^^^^^ .. _TypoScript: TypoScript """""""""" The TYPO3 Browser controls the CSV export by TypoScript. The page object browser\_csv will be added to your TypoScript, if you have included the Browser static template. browser\_csv < plugin.tx\_browser\_pi1.export.csv.page The line above is done by the TYPO3 Browser. The browser\_csv page object has the type 29.370 by default. 29.370 is the number of the CSV export feature given by forge.typo3.org. If you need another type, please configure it with the TypoScript Constant Editor. You can control some properties and the behaviour of the CSV export by TypoScript. See the array of plugin.tx\_browser\_pi1.flexform.viewList.csvexport Investigate the properties - devider, - enclosure and - strip\_tag. .. _Subpartmarker: Subpartmarker """"""""""""" The export button is added while runtime to the frontend form. The TYPO3 Browser default templates use the subpart ###BUTTON\_CSV-EXPORT### If you are using your own template, please add the subpart to your HTML template. You find an example in the TYPO3 Browser default template at res/html/default.tmpl Look for ###BUTTON\_CSV-EXPORT###. If you are enabling the CSV export in the flexform of the plugin, but the HTML template doesn't contain any subpart marker for the export button, you should get a warning in the frontend. .. _HTML-template: HTML-template """"""""""""" The CSV export is based on a very short and simple HTML template. There shouldn't be any need to change the template. But if there is a need anyway, you can use your own template. See plugin.tx\_browser\_pi1.flexform.viewList.csvexport.template If there isn't any template or the template will deliver an empty content, you should get an error message in the frontend. .. _Localisation: Localisation """""""""""" You don't need to configure anything, if you are using the CSV export on localised pages. It should work reday-to-use. .. _Access-rights-and-security: Access rights and security """""""""""""""""""""""""" Your data can be downloaded in a CSV file only, if you allow the CSV export by the flexform of the plugin in the TYPO3 backend. You can limit the CSV export for a defined group (like members only). The easiest way should be, to use the Browser flexform on a page with access rights. .. _Known-bugs: Known bugs ^^^^^^^^^^ .. _AJAX: AJAX """" If you are update a part of the Browser output with AJAX, some parameters won't be added to the hidden fields of the export form in some cases. In these cases an exported CSV file will contain other data than displayed. .. _Workaround: Workaround ~~~~~~~~~~ The workaround is to disable AJAX. .. _Several-plugins: Several plugins """"""""""""""" If you are using several plugins on the same page, you can get unwanted effects. Please refer to the tutorial "Several Plugins" and look for "unwanted effects". See - HTML: `http://typo3.org/extensions/repository/view/browser\_tut\_sever alplugins\_en/ `_ - PDF `http://typo3-browser.de/typo3conf/ext/browser\_tut\_severalplugin s\_en/doc/manual.pdf `_ .. _RSS-XML-Sample: RSS/XML Sample -------------- .. _Preconditions: Preconditions ^^^^^^^^^^^^^ You need the extension tt\_news. You have to add some news in your news folder. .. _Add-a-Page-a-Plugin-and-the-Extension-Template: Add a Page, a Plugin and the Extension Template ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Modul: Web > List Add a page to your page tree.Call it "Browser Sample III". Add the Browser plugin to the page.Call it "[Browser Sample III]".Set the header type to: [hidden].Configure the other properties later (see below). Add an extension template to your page.Call it in the format "type \_name-of-your-page\_uid-of-yourTypoScript-template".Here: "+page\_browsersampple3\_1176" |img-5| .. _Configuring: Configuring ^^^^^^^^^^^ .. _Template: Template """""""" Configure the extension template. .. _General: [General] ~~~~~~~~~ Add in the tab [General] into the field "constnts" the code from below, where 3596 is the id of the page with the single view. // page with the single view plugin.tx\_browser\_pi1.templates.listview.url.0.singlePid = 3596 .. _Includes: [Includes] ~~~~~~~~~~ Add in the tab [Includes] into the field "Include static (from extensions):" both templates: - Browser [1] Basis (browser) - Browser [3] + Sample for tt\_news (RSS feed) (browser) .. _Browser-Plugin-Flexform: Browser Plugin / Flexform """"""""""""""""""""""""" .. _Behaviour: [Behaviour] ~~~~~~~~~~~ Browser plugin tab [Behaviour] Field "Record Storage Page": the folder wirh your news. Here: "News (tt\_news)" Recursive: [Infinite] |img-5| .. _Plugin-Templating: [Plugin] > [Templating] ~~~~~~~~~~~~~~~~~~~~~~~ HTML: [tt\_news: RSS (tt\_news)] |img-5| .. _Result-in-the-Frontend: Result in the Frontend ^^^^^^^^^^^^^^^^^^^^^^ The RSS feed. |img-5| .. _Adapt-the-Sample-to-your-Needs: Adapt the Sample to your Needs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You can adapt the tt\_news sample from above to your needs quickly. .. _XML-Template: XML Template """""""""""" Copy the XML template into any other directory - i.e.: fileadmin. Adapt the XML code to your needs. You find the path to the XML template here: plugin.tx\_browser\_pi1.template.extensions.tt\_news.rss.file .. _File-sample: File sample ~~~~~~~~~~~ Resources/Public/Sample/tt\_news/rss.tmpl ###RSS\_TITLE### ###RSS\_DESCRIPTION### ###RSS\_LANG### ###RSS\_URL### <![CDATA[###TT\_NEWS.TITLE###]]>

Error

This template should not used for a single view.

Please configure in the Browser plugin/flexform [General] > views [configured] > Views: Page with Single View

Fehler

Dieses Template soll gar keine Detailansicht zeigen.

Bitte konfiguriere im Browser Plugin/Flexform [Allgemein] > views [Konfiguriert] > Views: Seite mit Detailansicht

.. _TypoScript: TypoScript """""""""" If you have moved the RSS/XML file and if you have adapted it, please add the TypoScript snippet from below in the extension template of your RSS page into the field setup. plugin.tx\_browser\_pi1 { template { extensions { // Remove the tt\_news template tt\_news > my\_extension { rss { // [String] Name of the template. It will displayed in the plugin/flexform name = My RSS // [String] Path to your RSS/XML template file = fileadmin/... // [String] Path to a icon. It will displayed in the flexform of the plugin. image = EXT:browser/Resources/Public/Images/BackendLayouts/browser- rss.gif // [csv] Comma seperated list with the number of the correspondening views csvViews = 1010 } } } } } Inspect the array with the configuration for the RSS view. Please take the TypoScript Object Browser and adapt properties to your needs. This is the array: plugin.tx\_browser\_pi1.views.list.1010 .. _File-structure: File structure ~~~~~~~~~~~~~~ You can copy a TypoScript draft to your extension. Copy the directory tt\_news\_rss from blow.You have to adapt it to your needs. See Configuration/TypoScript/samples/tt\_news\_rss/ tt\_news\_rss/ ├── constants.txt ├── page │ └── setup.ts ├── plugin │ ├── \_setup.ts │ └── tx\_browser\_pi1 │ ├── list │ │ ├── marker.ts │ │ ├── setup.ts │ │ ├── sql.ts │ │ └── tableFields.ts │ ├── locallang.ts │ ├── \_setup.ts │ ├── single │ │ └── setup.ts │ └── template.ts ├── setup.txt └── tt\_content └── setup.ts .. _RSS-Alternate-Link: RSS Alternate Link ------------------ You can set a so called alternate link in the HTML head section of your root page. Then browsers will detect automatically, that you provide an RSS feed. Some browsers will activate an RSS icon! If you like this nice feature, please configure the template of your root page like in the code snippet below. .. _Template: Template ^^^^^^^^ .. _General: [General] """"""""" Add in the tab [General] into the field "setup" the code from below. //////////////////////////////////////////////////////// // // RSS alternate link in the HTML head section page { headerData { 99 = COA 99 { 10 = TEXT 10 { value = } } } } // RSS alternate link in the HTML head section You have to allocate the uid of the page of your RSS feed. See property: page.headerData.99.20.stdWrap.typoLink.parameter = .. _vCard-Sample: vCard Sample ------------ .. _Precondition: Precondition ^^^^^^^^^^^^ You publish your data with the Browser – TYPO3 without PHP. .. _Page: Page ^^^^ .. _Sample: Sample """""" The Organiser – TYPO3 for the lobby and the organisers – is using the vCard feature. See `http://typo3-organiser.de `_ - Please look for the menu [people] `:sup:`0` <#sdfootnote1sym>`_ . - Click the link to the detail view. - Click the vCard-link `:sup:`0` <#sdfootnote2sym>`_ in the right margin column. The whole TypoScript for the vCard, generated by the Organiser – TYPO3 for the lobby and the organisers: `https://forge.typo3.org/projects/extension- org/repository/show/trunk/Configuration/TypoScript/staff/vCard/120 `_ .. _TypoScript: TypoScript """""""""" .. _Constants: Constants ~~~~~~~~~ You have to edit the properties with the Constant Editor. See: - [BROWSER – Navigation] on page 24 below - [BROWSER – TEMPLATES – LIST – URL 0] on page 24 below - [BROWSER – TEMPLATES – SINGLE – VCARD 0] on page 25 below Result in case of the configuration for the Organiser – TYPO3 for the lobby and the organisers – is: plugin.tx\_browser\_pi1 { navigation { showUid = staffUid } templates { listview { url { 0 { record = tx\_org\_staff.uid showUid = staffUid } } } singleview { vCard { 0 { field { adr { 1 = tx\_org\_headquarters.postbox\_postbox 2 = tx\_org\_headquarters.mail\_address 3 = tx\_org\_headquarters.mail\_street 4 = tx\_org\_headquarters.mail\_city 5 = 6 = tx\_org\_headquarters.mail\_postcode 7 = tx\_org\_headquarters.mail\_country } email { work = tx\_org\_staff.contact\_email } fn = tx\_org\_staff.title impp { skype = tx\_org\_staff.contact\_skype } geo { lat = tx\_org\_headquarters.mail\_lat lon = tx\_org\_headquarters.mail\_lon } n { 1 = tx\_org\_staff.name\_last 2 = tx\_org\_staff.name\_first } org = tx\_org\_headquarters.title tel { work { fax = tx\_org\_staff.contact\_fax voice = tx\_org\_staff.contact\_phone } } title = } } } } } } .. _Setup: Setup ~~~~~ List plugin.tx\_browser\_pi1 { views { list { 120 = +Org: People vCard 120 { name = +Org: People vCard showUid = {$plugin.tx\_browser\_pi1.navigation.showUid} select ( tx\_org\_staff.uid ) tx\_org\_staff { uid = TEXT uid { value (

Fatal Error

Sorry, but page isn't configured for list views.

) } } } htmlSnippets { subparts { listview = TEXT listview { value (
###TX\_ORG\_STAFF.UID###
) } } } } } } } Single plugin.tx\_browser\_pi1 { views { single { 120 = +Org: People vCard 120 { select ( tx\_org\_staff.title, tx\_org\_staff.contact\_email, tx\_org\_staff.contact\_fax, tx\_org\_staff.contact\_phone, tx\_org\_staff.contact\_skype, tx\_org\_staff.contact\_url, tx\_org\_staff.department, tx\_org\_staff.name\_first, tx\_org\_staff.name\_last, tx\_org\_staff.uid, tx\_org\_headquarters.title, tx\_org\_headquarters.mail\_address, tx\_org\_headquarters.mail\_city, tx\_org\_headquarters.mail\_country, tx\_org\_headquarters.mail\_lat, tx\_org\_headquarters.mail\_lon, tx\_org\_headquarters.mail\_street, tx\_org\_headquarters.mail\_postcode, tx\_org\_headquarters.postbox\_city, tx\_org\_headquarters.postbox\_postbox, tx\_org\_headquarters.postbox\_postcode, tx\_org\_headquarters.uid ) orderBy ( tx\_org\_staff.title DESC ) tx\_org\_staff { // vCard uid < plugin.tx\_browser\_pi1.displaySingle.master\_templates.tableFie lds.vCard.0 } htmlSnippets { subparts { singleview = TEXT singleview { value ( ###TX\_ORG\_STAFF.UID### ) } } } } } } } .. _Plugin: Plugin """""" Add a Browser plugin to the page. Configure it like: - [Behaviour] - Record Storgae Page: [Your folder with the staff records] - Recursive: [Infinite] - [Plugin] - [General] - Views [Configured] - Views: Filter: [Your template for the vCard. In the sample above is it the view 120.] - [List View] - Limit: records per page: 1 - Display: Navigation [ ] Index Browser, [ ] Page Browser - Search: [Configured] - Search: Form - [ ] Display the form - [Templating] HTML: [Browser: Main (browser)] .. _Link: Link ^^^^ .. _Sample: Sample """""" The Organiser – TYPO3 for the lobby and the organisers – is using the vCard feature. See `http://typo3-organiser.de `_ - Please look for the menu [people] `:sup:`0` <#sdfootnote3sym>`_ . - Click the link to the detail view. - Click the vCard-link `:sup:`0` <#sdfootnote4sym>`_ in the right margin column. The whole TypoScript for a link to the vCard, generated by the Organiser – TYPO3 for the lobby and the organisers: `https://forge.typo3.org/projects/extension-org/repository/show/trunk/ Configuration/TypoScript/staff/101/tx\_browser\_pi1/single/tableFields /tx\_org\_staff.ts `_ .. _TypoScript: TypoScript """""""""" .. _Constants: Constants ~~~~~~~~~ You have to edit the properties with the Constant Editor. See: - [BROWSER – Navigation] on page 24 below - [BROWSER – TEMPLATES – LIST – HEADER 0] on page 24 below - [BROWSER – TEMPLATES – LIST – URL 0] on page 24 below Result in case of the configuration for the Organiser – TYPO3 for the lobby and the organisers – is: tmp.vCard = COA tmp.vCard { 10 = COA 10 { 10 = TEXT 10 { prepend = TEXT prepend { value = noTrimWrap = \|\| \| } value = vCard lang { de = Visitenkarte en = vCard } } stdWrap { typolink { parameter { cObject = COA cObject { // url 10 = TEXT 10 { value = {$plugin.org.pages.vCard} } // target 20 = TEXT 20 { value = - noTrimWrap = \| "\|"\| } // class 30 = TEXT 30 { value = download noTrimWrap = \| "\|"\| } // title 40 = COA 40 { 10 = TEXT 10 { value = vCard for lang { de = vCard von en = vCard for } noTrimWrap = \|\| \| } 20 = TEXT 20 { field = {$plugin.tx\_browser\_pi1.templates.listview.header.0.field} } stdWrap { stripHtml = 1 htmlSpecialChars = 1 crop = {$plugin.tx\_browser\_pi1.templates.listview.header.0.title.crop} noTrimWrap = \| "\|"\| } } } } additionalParams { wrap = &tx\_browser\_pi1[{$plugin.tx\_browser\_pi1.navigation.showUid} ]=\|&type={$plugin.tx\_browser\_pi1.typeNum.vCardPageObj} field = {$plugin.tx\_browser\_pi1.templates.listview.url.0.record} } } } } wrap =
  • \|
    • } .. _Constant-Editor: Constant Editor --------------- .. _BROWSER-Navigation: [BROWSER – Navigation] ^^^^^^^^^^^^^^^^^^^^^^ Prefix: plugin.tx\_browser\_pi1.navigation .. ### BEGIN~OF~TABLE ### .. _showUid: showUid """"""" .. container:: table-row Property showUid Data type string Description showUid: Alias for the parameter showUid. WARNING: Set this property for main plugins only, don't set it for plugins in the marginal column. The alias simplifies the configuration of realUrl. Default showUid .. ###### END~OF~TABLE ###### .. _BROWSER-PAGE-OBJECTS: [BROWSER – PAGE OBJECTS] ^^^^^^^^^^^^^^^^^^^^^^^^ Prefix: plugin.tx\_browser\_pi1.typeNum .. ### BEGIN~OF~TABLE ### .. _csvPageObj: csvPageObj """""""""" .. container:: table-row Property csvPageObj Data type integer Description **CSV page object:** Type number (typenum) of the CSV page object Default 29370 .. _csvPageObj-additionalHeaders: csvPageObj.additionalHeaders """""""""""""""""""""""""""" .. container:: table-row Property csvPageObj.additionalHeaders Data type string Description **CSV additionalHeaders:** additionalHeaders for the CSV page object. Default: Content-Type: text/csv \| Content-Disposition: attachment; filename="export.csv" Default See description .. _vCardPageObj: vCardPageObj """""""""""" .. container:: table-row Property vCardPageObj Data type integer Description **vCard page object:** Type number (typenum) of the vCard page object. Default 67208 .. _vCardPageObj-additionalHeaders: vCardPageObj.additionalHeaders """""""""""""""""""""""""""""" .. container:: table-row Property vCardPageObj.additionalHeaders Data type string Description **vCard additionalHeaders:** additionalHeaders for the vCard page object. Default: Content-Type: text/vcard \| Content-Disposition: attachment; filename="vcard.vcf" Default See description .. ###### END~OF~TABLE ###### .. _BROWSER-TEMPLATES-LIST-HEADER-0: [BROWSER – TEMPLATES – LIST – HEADER 0] ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefix: plugin.tx\_browser\_pi1.templates.listview.header.0 .. ### BEGIN~OF~TABLE ### .. _field: field """"" .. container:: table-row Property field Data type string Description **Header:** Field with the header for the list view.I.e: tx\_org\_service.teaser\_title // tx\_org\_service.title Default .. ###### END~OF~TABLE ###### .. _BROWSER-TEMPLATES-LIST-URL-0: [BROWSER – TEMPLATES – LIST – URL 0] ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefix: plugin.tx\_browser\_pi1.templates.listview.url.0 .. ### BEGIN~OF~TABLE ### .. _record: record """""" .. container:: table-row Property record Data type string Description **Uid\*:** (Obligate!) Field with the uid of the current record. I.e: tx\_org\_service.uid Default .. ###### END~OF~TABLE ###### .. _BROWSER-TEMPLATES-SINGLE-VCARD-0: [BROWSER – TEMPLATES – SINGLE – VCARD 0] ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefix: plugin.tx\_browser\_pi1.templates.single.vCard.0 .. ### BEGIN~OF~TABLE ### .. _version: version """"""" .. container:: table-row Property version Data type string Description **Version:** 2.1, 4.0 Default 4.0 .. _charset: charset """"""" .. container:: table-row Property charset Data type string Description **Charset:** Has an effect in version 2.1 only! Default UTF-8 .. _fn: fn "" .. container:: table-row Property fn Data type string Description **FN:** Field for the FN (fullname) property. Example: tx\_org\_staff.title.Details at `http://tools.ietf.org/html/rfc6350#section-6.2.1 `_ Default .. _n-1: n.1 """ .. container:: table-row Property n.1 Data type string Description **N last name:** Field for the N (name) last name property.Example: tx\_org\_staff.name\_last. Details at `http://tools.ietf.org/html/rfc6350#section-6.2.2 `_ Default .. _n-2: n.2 """ .. container:: table-row Property n.2 Data type string Description **N first name:** Field for the N (name) first name property.Example: tx\_org\_staff.name\_first. Details at `http://tools.ietf.org/html/rfc6350#section-6.2.2 `_ Default .. _n-3: n.3 """ .. container:: table-row Property n.3 Data type string Description **N third property:** Field for the N (name) third property. Example: tx\_org\_staff.xyz. Details at `http://tools.ietf.org/html/rfc6350#section-6.2.2 `_ Default .. _n-4: n.4 """ .. container:: table-row Property n.4 Data type string Description **N title:** Field for the N (name) title. Example: tx\_org\_staff.xyz. Details at `http://tools.ietf.org/html/rfc6350#section-6.2.2 `_ Default .. _adr-1: adr.1 """"" .. container:: table-row Property adr.1 Data type string Description **ADR post box:** Field for the ADR (address) post box property. Example: tx\_org\_headquarters.postbox\_postbox. Details at `http://tools.ietf.org/html/rfc6350#section-6.3.1 `_ Default .. _adr-2: adr.2 """"" .. container:: table-row Property adr.2 Data type string Description **ADR extended address:** Field for the ADR (address) extended address (e.g., apartment or suite number) porperty. Example: tx\_org\_headquarters.mail\_address. Details at `http://tools.ietf.org/html/rfc6350#section-6.3.1 `_ Default .. _adr-3: adr.3 """"" .. container:: table-row Property adr.3 Data type string Description **ADR street address:** Field for the ADR (address) street address property. Example: tx\_org\_headquarters.mail\_street. Details at `http://tools.ietf.org/html/rfc6350#section-6.3.1 `_ Default .. _adr-4: adr.4 """"" .. container:: table-row Property adr.4 Data type string Description **ADR locality:** Field for the ADR (address) locality (e.g., city) property. Example: tx\_org\_headquarters.mail\_city. Details at `http://tools.ietf.org/html/rfc6350#section-6.3.1 `_ Default .. _adr-5: adr.5 """"" .. container:: table-row Property adr.5 Data type string Description **ADR region:** Field for the ADR (address) region (e.g., state or province) property. Example: tx\_org\_headquarters.mail\_region. Details at `http://tools.ietf.org/html/rfc6350#section-6.3.1 `_ Default .. _adr-6: adr.6 """"" .. container:: table-row Property adr.6 Data type string Description **ADR postal code:** Field for the ADR (address) postal code property. Example: tx\_org\_headquarters.mail\_postcode. Details at `http://tools.ietf.org/html/rfc6350#section-6.3.1 `_ Default .. _adr-7: adr.7 """"" .. container:: table-row Property adr.7 Data type string Description **ADR country:** Field for the ADR (address) country name property. Example: tx\_org\_headquarters.mail\_country. Details at `http://tools.ietf.org/html/rfc6350#section-6.3.1 `_ Default .. _geo-lat: geo.lat """"""" .. container:: table-row Property geo.lat Data type string Description **GEO lat:** Field for the GEO latitude property. Example: tx\_org\_headquarters.mail\_lat. Details at `http://tools.ietf.org/html/rfc6350#section-6.5.2 `_ Default .. _geo-lon: geo.lon """"""" .. container:: table-row Property geo.lon Data type string Description **GEO lon:** Field for the GEO longitude property. Example: tx\_org\_headquarters.mail\_lon. Details at `http://tools.ietf.org/html/rfc6350#section-6.5.2 `_ Default .. _org: org """ .. container:: table-row Property org Data type string Description **ORG:** Field for the ORG (organisation name) property. Example: tx\_org\_headquarters.title. Details at `http://tools.ietf.org/html/rfc6350#section-6.6.4 `_ Default .. _title: title """"" .. container:: table-row Property title Data type string Description **TITLE:** Field for the TITLE (position or job of the object the vCard) property.Example: tx\_org\_staff.position. Details at `http://tools.ietf.org/html/rfc6350#section-6.6.1 `_ Default .. _email-work: email.work """""""""" .. container:: table-row Property email.work Data type string Description **EMAIL work:** Field for the EMAIL work property. Example: tx\_org\_staff.contact\_email. Details at `http://tools.ietf.org/html/rfc6350#section-6.4.2 `_ Default .. _impp-skype: impp.skype """""""""" .. container:: table-row Property impp.skype Data type string Description **IMPP skype:** Field for the IMPP skype property. Example: tx\_org\_staff.contact\_skype. Details at `http://tools.ietf.org/html/rfc6350#section-6.4.3 `_ Default .. _tel-work-voice: tel.work.voice """""""""""""" .. container:: table-row Property tel.work.voice Data type string Description **TEL work voice:** Field for the TEL work voice property. Example: tx\_org\_staff.contact\_phone. Details at `http://tools.ietf.org/html/rfc6350#section-6.4.1 `_ Default .. _tel-work-fax: tel.work.fax """""""""""" .. container:: table-row Property tel.work.fax Data type string Description **TEL work fax:** Field for the TEL work fax property. Example: tx\_org\_staff.contact\_fax. Details at `http://tools.ietf.org/html/rfc6350#section-6.4.1 `_ Default .. _source: source """""" .. container:: table-row Property source Data type boolean Description **Source:** Enable the SOURCE property. This is the URL of vCard. Default 1 .. _url-uid: url.uid """"""" .. container:: table-row Property url.uid Data type integer Description **URL:** Page id for the URL. Leave it empty, if you don't want an URL in your vCard. Default .. ###### END~OF~TABLE ###### .. _Reference: Reference --------- .. _Completely-Browser-Reference: Completely Browser Reference ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - 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 `_ .. _Export-CSV-and-vCard: Export CSV and vCard ^^^^^^^^^^^^^^^^^^^^ .. _csv: csv """ Prefix: plugin.tx\_browser\_pi1.export .. ### BEGIN~OF~TABLE ### .. _csv: csv ~~~ .. container:: table-row Property csv Data type array Description The rss page object. plugin.tx\_browser\_pi1.export.csv { page = PAGE page { typeNum = {$plugin.tx\_browser\_pi1.typeNum.csvPageObj} config { // Get rid of the parsetime comment debug = 0 disableAllHeaderCode = 1 disablePrefixComment = 1 // CSV has a one byte charset! metaCharset = iso-8859-15 xhtml\_cleaning = 0 admPanel = 0 additionalHeaders = {$plugin.tx\_browser\_pi1.typeNum.csvPageObj.additionalHeaders} } 10 = CONTENT 10 { table=tt\_content select{ // use current language languageField = sys\_language\_uid andWhere { cObject = COA cObject { // choose all Browser plugins... 10 = TEXT 10 { value = list\_type = 'browser\_pi1' } } } } } } } .. ###### END~OF~TABLE ###### .. _vCard: vCard """"" Prefix: plugin.tx\_browser\_pi1.export .. ### BEGIN~OF~TABLE ### .. _vCard: vCard ~~~~~ .. container:: table-row Property vCard Data type array Description The rss page object. plugin.tx\_browser\_pi1.export.vCard < plugin.tx\_browser\_pi1.export.csv plugin.tx\_browser\_pi1.export.vCard { page { typeNum = {$plugin.tx\_browser\_pi1.typeNum.vCardPageObj} config { // Get rid of the parsetime comment metaCharset = UTF-8 additionalHeaders = {$plugin.tx\_browser\_pi1.typeNum.vCardPageObj.additionalHeaders} } } } .. ###### END~OF~TABLE ###### .. _RSS: RSS ^^^ .. ### BEGIN~OF~TABLE ### .. _rss-page: rss.page """""""" .. container:: table-row Property rss.page Data type array Description The rss page object. plugin.tx\_browser\_pi1 { rss { page = PAGE page { typeNum = 0 config { disableAllHeaderCode = 1 disablePrefixComment = 1 xhtml\_cleaning = 0 admPanel = 0 additionalHeaders = Content-type:text/xml } 10 = CONTENT 10 { table=tt\_content select{ // use current language languageField = sys\_language\_uid andWhere { cObject = COA cObject { // choose all Browser plugins... 10 = TEXT 10 { value = list\_type = 'browser\_pi1' } } } } } } } } Default .. ###### END~OF~TABLE ###### .. _FAQ: FAQ --- .. _Can-I-use-this-Feature-for-Products-and-Events-too: Can I use this Feature for Products and Events too? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ It doesn't matter, if you want to publish news or any other data in RSS/XML format. Other data can be products or events for example. .. _Can-I-publish-Data-from-Foreign-Tables: Can I publish Data from Foreign Tables? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Yes! I.e.: You have a foreign table with categories for the records in the local table. You can publish both in your RSS/XML feed: data from local table and foreign table. .. _Does-this-Feature-supports-RealURL: Does this Feature supports RealURL? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Yes. You have to do noting but enabling RealURL. .. _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.2.2 **Feature** \* #i0183: vCard. version 2.1 is added.\* Can enabled by Constant Editor 7.2.1 **Feature** \* #i0181: vCard\* SOURCE: can enabled and disabled by Constant Editor\* URL: page uid by Constant Editor **Improvement** \* #i0182: Browser foundation icons 7.2.0 **Update** \* #67208: vCard 7.0.6 **Update** \* #i0001: Foer Browser 6.x/7.x, TYPO3 6.x 4.2.0 **Workaround** \* #43852: CSV-Export: Is ignored, if you are using several plugins 3.9.14 **Update** \* for Browser 3.9.14 3.9.3 **New Features** \* #29370: CSV export 3.5.1 **Maintenance** Adding the Reference 3.5.0 **Initial Release** .. _Illustration-Index: Illustration Index ------------------ Illustration 1: CSV export: The Browser – TYPO3 without PHP – adds the [Export] Button (1). 3 Illustration 2: RSS feed: subscription of a RSS feed (1) (Firefox) and the news item (2) 4 Illustration 3: Get the vCard of Barack Obama 5 Illustration 4: Enable the CSV export in the flexform of the Browser plugin 7 Illustration 5: Click on the button [Export] (1). Select in the dialogue box, what should happen (2). 8 Illustration 6: Dialogue box of your CSV application. Here: Libre Office. 8 Illustration 7: RSS page with the browser plugin and the TypoScript template 11 Illustration 8: Set the Record Storage Page 12 Illustration 9: Browser plugin tab [Templating]. Select the tt\_news RSS Feed 13 Illustration 10: RSS feed subscription in the Forefox browser (1) and the news (2) 13 .. _Alphabetical-Index: Alphabetical Index ------------------ CSV Sample 7 Screenshot 3 TypoScript 27 RSS Sample 11 Screenshot 4 vCard Property ADR 25 EMAIL 25 FN 25 GEO 25 IMPP 25 N 25 ORG 25 skype 25 TEL 25 TITLE 25 Sample 17 Screenshot 5 TypoScript 18, 22, 28 Version 25 XML Sample 11 Screenshot 4 `0 <#sdfootnote1anc>`_ [Personen] in German language. `0 <#sdfootnote2anc>`_ [Visitenkarte] in German language. `0 <#sdfootnote3anc>`_ [Personen] in German language. `0 <#sdfootnote4anc>`_ [Visitenkarte] in German language. 33 .. ######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: Frame3 .. :align: bottom .. :id: Frame3 .. :name: Frame3