.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ===================== EXT: gkh\_rss\_import ===================== :Author: Christopher :Created: 2010-12-18T19:57:23 :Changed: 2013-07-03T08:13:00.880000000 :Classification: gkh_rss_import :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) ---- :Keywords: RSS, FE, Show, Feeds :Author: Gert Kaae Hansen :Email: gertkh@gmail.com :Language: en .. _img-1-img-2-EXT-gkh-rss-import: |img-1| |img-2| EXT: gkh\_rss\_import ===================================== Extension Key: gkh\_rss\_import Language: en Version: x.y.z Keywords: RSS, FE, Show, Feeds Copyright 2006-2013, Gert Kaae Hansen, 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 ----------------- **`EXT: Name of your Extension 1 <#__RefHeading__5708_1738894311>`_** **`Introduction 3 <#__RefHeading__5710_1738894311>`_** `What does it do? 3 <#__RefHeading__463_413120346>`_ `Screenshots 3 <#__RefHeading__465_413120346>`_ **`Users manual 4 <#__RefHeading__467_413120346>`_** `Subheading 4 <#__RefHeading__31507_818911409>`_ `FAQ 4 <#__RefHeading__31509_818911409>`_ **`Administration 5 <#__RefHeading__31511_818911409>`_** `FAQ 5 <#__RefHeading__31513_818911409>`_ **`Configuration 6 <#__RefHeading__31515_818911409>`_** `FAQ 6 <#__RefHeading__31517_818911409>`_ `Reference 6 <#__RefHeading__31519_818911409>`_ **`Tutorial 8 <#__RefHeading__31523_818911409>`_** **`Known problems 9 <#__RefHeading__31525_818911409>`_** **`To-Do list 10 <#__RefHeading__477_413120346>`_** **`ChangeLog 11 <#__RefHeading__31623_818911409>`_** **`Important guidelines 12 <#__RefHeading__31625_818911409>`_** `Inserting images 12 <#__RefHeading__31656_818911409>`_ `Fonts 12 <#__RefHeading__712_1275600224>`_ `Paragraph styles 12 <#__RefHeading__31658_818911409>`_ `Character styles 13 <#__RefHeading__757_92746827>`_ `Linking 13 <#__RefHeading__31660_818911409>`_ `Meta data and updates 13 <#__RefHeading__31662_818911409>`_ `HowTo: Update a manual to the new layout 13 <#__RefHeading__62258_818911409>`_ `HowTo: Alternative updating possibility: Import the styles from another document 14 <#__RefHeading__62260_818911409>`_ `HowTo: Fix the Table Of Contents when it is empty 15 <#__RefHeading__62262_818911409>`_ `HowTo: Fix the Table Of Contents when a chapter is missing 15 <#__RefHeading__62264_818911409>`_ `Help from documentation.openoffice.org 15 <#__RefHeading__62266_818911409>`_ .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension inset a RSS feed on a FE page, and it gives you a high level of configuration options. Included is a function that trims the text to a specified length. Words are separated by space characters, and they are not chopped if possible. Logo from pages can be set to a maximum width. If the feed is in coded with a special language code this can be set also. Now with support for templates, you can easy select a new template in the flex form. The output i fully configurable via CSS. The extension uses the RSS parser from Last RSS http://lastrss.oslab.net/ witch is modifyed to work with Typo3 .. _Screenshots: Screenshots ^^^^^^^^^^^ Here you see what the extension does: |img-3| |img-4| |img-5| Users manual ------------ - Inset the plugin on a page. - Change the settings to your needs. RSS feed URL : The URL of the RSS feed that you want to show. Maximum feeds to show : The amount of items that you want to show. Length of item content : Defines how many characters you want to display for each item Length of header description : Defines how many characters you want to display in the description of the feed Target of URL : Select if all URL should open in a new window or on the same page. Width of LOGO : Defines the pixel width of the logo Error message : If a feed cant be reached this message will be shown Date format : Select the format you want for the publishing date. Please be aware of the date only is shown if it is a valid date format. Remove HTML from RSS feed : Select if you want HTML content in the feed to be shown. RSS Feed cache time : The amount of time the RSS feed will be stored locally. Can be adjusted from 1 to 24 hours. Template file : There are two template files located in /gkh\_rss\_import/template/. If no template file is selected it will use the template “tmpl\_rssimport.htm” Include rss\_feed (gkh\_rss\_import) to your static templates if you want to use all the standard settings. .. _Select-template-via-TS: Select template via TS ^^^^^^^^^^^^^^^^^^^^^^ You can now via Typoscript link to at template file plugin.tx\_gkhrssimport\_pi1.templateFile = fileadmin/templates/gkh\_rss\_import/tmpl\_rssimport-div.htm .. _Administration: Administration -------------- If you want to change the design of the output you can use the following CSS code: .tx-gkhrssimport-pi1-rss\_title, tx-gkhrssimport-pi1-rss\_title a { font-size: medium; font-family: Georgia, Times New Roman, Times, serif; font-weight: bold; color: #FF6100; width: 100px; padding-bottom: 1px; } .tx-gkhrssimport-pi1-description { font-weight: bold; padding-bottom: 10px; border-bottom-width: 0px; border-bottom-style: solid; border-bottom-color: #2763A5; margin-bottom: 15px; } .tx-gkhrssimport-pi1-header { font-weight: bold; } .tx-gkhrssimport-pi1-content, .tx-gkhrssimport-pi1-download { margin-bottom:10px; } .tx-gkhrssimport-pi1-pubbox, .tx-gkhrssimport-pi1-date, .tx- gkhrssimport-pi1-author, .tx-gkhrssimport-pi1-category { display: inline; } .tx-gkhrssimport-pi1-content p img { float: left; width: 150px; height: 100px; padding-right: 5px; padding-bottom: 5px; } .. _Configuration: Configuration ------------- .. _Reference: Reference ^^^^^^^^^ Possible subsections: Reference of TypoScript options. .. ### BEGIN~OF~TABLE ### .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type link Description Link to the template file plugin.tx\_gkhrssimport\_pi1.templateFile = fileadmin/templates/gkh\_rss\_import/tmpl\_rssimport-div.htm Default .. _item-stdWrap: item\_stdWrap """"""""""""" .. container:: table-row Property item\_stdWrap Data type wrap Description plugin.tx\_gkhrssimport\_pi1.item\_stdWrap { removeBadHTML = 1 HTMLparser = 1 HTMLparser.keepNonMatchedTags = 1 HTMLparser.tags.img.fixAttrib.src.userFunc = tx\_gkhrssimport\_pi1->fixRssURLs HTMLparser.tags.a.fixAttrib.href.userFunc = tx\_gkhrssimport\_pi1->fixRssURLs HTMLparser.tags.img.fixAttrib.style.unset = 1 } Default .. _itemSummary-stdWrap: itemSummary\_stdWrap """""""""""""""""""" .. container:: table-row Property itemSummary\_stdWrap Data type wrap Description plugin.tx\_gkhrssimport\_pi1.itemSummary\_stdWrap < plugin.tx\_gkhrssimport\_pi1.item\_stdWrap plugin.tx\_gkhrssimport\_pi1.itemSummary\_stdWrap.parseFunc.userFunc = tx\_gkhrssimport\_pi1->smart\_trim Default .. _CSS-DEFAULT-STYLE: \_CSS\_DEFAULT\_STYLE """"""""""""""""""""" .. container:: table-row Property \_CSS\_DEFAULT\_STYLE Data type string Description plugin.tx\_gkhrssimport\_pi1.\_CSS\_DEFAULT\_STYLE ( .tx-gkhrssimport-pi1-rss\_title, tx-gkhrssimport-pi1-rss\_title a { font-size: medium; font-family: Georgia, Times New Roman, Times, serif; font-weight: bold; color: #FF6100; width: 100px; padding-bottom: 1px; } .tx-gkhrssimport-pi1-description { font-weight: bold; padding-bottom: 10px; border-bottom-width: 0px; border-bottom-style: solid; border-bottom-color: #2763A5; margin-bottom: 15px; } .tx-gkhrssimport-pi1-header { font-weight: bold; } .tx-gkhrssimport-pi1-content, .tx-gkhrssimport-pi1-download { margin-bottom:10px; } .tx-gkhrssimport-pi1-pubbox, .tx-gkhrssimport-pi1-date, .tx- gkhrssimport-pi1-author, .tx-gkhrssimport-pi1-category { display: inline; } .tx-gkhrssimport-pi1-content p img { float: left; width: 150px; height: 100px; padding-right: 5px; padding-bottom: 5px; } Default .. ###### END~OF~TABLE ###### [tsref:cObject.TEST] .. _Example: Example """"""" Here you would show an example of the stuff from the reference or so: :: plugin.tx_gkhrssimport_pi1.item_stdWrap { removeBadHTML = 1 HTMLparser = 1 HTMLparser.keepNonMatchedTags = 1 HTMLparser.tags.img.fixAttrib.src.userFunc = tx_gkhrssimport_pi1->fixRssURLs HTMLparser.tags.a.fixAttrib.href.userFunc = tx_gkhrssimport_pi1->fixRssURLs HTMLparser.tags.img.fixAttrib.style.unset = 1 } .. _Tutorial: Tutorial -------- None .. _Known-problems: Known problems -------------- None .. _To-Do-list: To-Do list ---------- None .. _ChangeLog: ChangeLog --------- .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 44 .. :id: graphics5 .. :name: graphics5 .. :vspace: 57 .. :width: 161 .. |img-2| image:: img-2.png .. :align: left .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 199 .. :id: grafik1 .. :name: grafik1 .. :width: 450 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 111 .. :id: grafik2 .. :name: grafik2 .. :width: 450 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 247 .. :id: grafik3 .. :name: grafik3 .. :width: 444