.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ====================== EXT: News RSS Importer ====================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Xavier Perseguers :Changed: 2013-06-21T13:34:43 :Classification: ttnews_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) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: tt_news, rss, feed, import :Author: Steffen Kamper :Email: info@sk-typo3.de :Info 4: :Language: en |img-1| |img-2| EXT: News RSS Importer - ttnews\_rss\_import .. _EXT-News-RSS-Importer: EXT: News RSS Importer ====================== Extension Key: ttnews\_rss\_import Language: en Keywords: tt\_news, rss, feed, import Copyright 2000-2012, Steffen Kamper, Copyright 2013, Xavier Perseguers 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: News RSS Importer 1 <#__RefHeading__29220_394025407>`_ **`Introduction 3 <#__RefHeading__29222_394025407>`_** `What does it do? 3 <#__RefHeading__29224_394025407>`_ `Screenshots 3 <#__RefHeading__29226_394025407>`_ **`Users manual 7 <#__RefHeading__29228_394025407>`_** **`Administration 8 <#__RefHeading__29230_394025407>`_** `Wizard 8 <#__RefHeading__29232_394025407>`_ `Scheduler 9 <#__RefHeading__29234_394025407>`_ **`Configuration 10 <#__RefHeading__29236_394025407>`_** **`Known problems 11 <#__RefHeading__29238_394025407>`_** `Getting an error while retreiving and RSS feed 11 <#__RefHeading__29240_394025407>`_ `Logfile is not created / updated 11 <#__RefHeading__29242_394025407>`_ `tt\_news record creation fails when executed from scheduler 11 <#__RefHeading__29244_394025407>`_ **`To-Do list 12 <#__RefHeading__29246_394025407>`_** **`ChangeLog 13 <#__RefHeading__29248_394025407>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The extension imports any RSS feed to tt\_news records. Assigned categories will be created automatically. .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-3| |img-4| |img-5| |img-6| |img-7| |img-8| |img-7| |img-9| .. _Users-manual: Users manual ------------ Install the extension. Create a new record for the import, all configuration can be done in the record form. .. _Administration: Administration -------------- .. _Wizard: Wizard ^^^^^^ As your feed records may reside in different sysfolders, there is a wizard to see all records. You find it under web > functions: |img-10| Make sure you click on first page of your page tree (best choice) You can edit, simulate import or import from here manually. You will see all output, with protocol you see complete arrays like in the wizard of the records. .. _Scheduler: Scheduler ^^^^^^^^^ If you want to run a cronjob for updating your feeds you cam do this with scheduler. Make sure to read the manual of scheduler how to setup a cronjob for automatic execution. Now you can create a task for scheduler: |img-11| Also make sure sure the \_cli\_scheduler user is located in a group that has rights to create tt\_news and tt\_news\_cat record and make sure the group has access to the folders it should be writing into. See `tt\_news records creation fails when executed from scheduler <#1. 6.3.tt_news%20record%20creation%20fails%20when%20executed%20from%20sch eduler|outline>`_ in section Know Problems of this document for more details. You can specify the uid's of the records by using comma list (eg 1,4,5,6) or simply leave it empty (\*) for updating all feed records. All actions will be written to log which is by default fileadmin/rssimport.log. For viewing the log I recommend extension reports\_logview: |img-12| .. _Configuration: Configuration ------------- You can configure defaults in pageTS or userTS with the key “mod.ttnew\_rss\_import” .. ### BEGIN~OF~TABLE ### .. _newCategoryParentId: newCategoryParentId ^^^^^^^^^^^^^^^^^^^ .. container:: table-row Property newCategoryParentId Data type int Description Define the parent category for new created categories from feed Default .. _storagePid: storagePid ^^^^^^^^^^ .. container:: table-row Property storagePid Data type int Description Define the storage Pid for new created news records Default .. _categoryStoragePid: categoryStoragePid ^^^^^^^^^^^^^^^^^^ .. container:: table-row Property categoryStoragePid Data type int Description Define the storage Pid for new created news categories Default .. _defaultCategories: defaultCategories ^^^^^^^^^^^^^^^^^ .. container:: table-row Property defaultCategories Data type String Description Comma-seperated list of default categories which will be assigned to new created news records Default .. _mapping: mapping ^^^^^^^ .. container:: table-row Property mapping Data type Array Description Array of tt\_news record fields and feed item fields. Syntax is tt\_news-field = rss-field There is the possibility to map more than one field to a tt\_news field with “\|”. Example: the author can be rss-field “dc:creator” or “author”. Mapping is done by author = dc:creator\|author In addition, you may specify a string to be used as this: author = dc:creator\|author\|”Some name” Default :: mapping { title = title links = link datetime = pubDate author = dc:creator|author bodytext = content:encoded ext_url = guid|link } .. _default-tt-news: default.tt\_news ^^^^^^^^^^^^^^^^ .. container:: table-row Property default.tt\_news default.tt\_news\_cat Data type Array Description Default values for new created news / news category items Example: :: mod.ttnew_rss_import { default.tt_news { type = 2 } default.tt_news_cat { description = Imported from RSS feed } } Default .. ###### END~OF~TABLE ###### [mod.ttnew\_rss\_import] All of these settings can be done in the record form as well except the default.tt\_news / default.tt\_news\_cat . .. _Known-problems: Known problems -------------- .. _Getting-an-error-while-retreiving-and-RSS-feed: Getting an error while retreiving and RSS feed ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ While trying to fetch an RSS file using the “Test XML feed” button, the following error shows up in the Source textarea of my ttnews\_rss\_import record: ERROR: The input content failed XML parsing: Line 1: Invalid document end Solution : set $TYPO3\_CONF\_VARS['SYS']['curlUse']=0 in typo3 configuration or try to tweak your CURL settings if you have to keep CURL enabled. .. _Logfile-is-not-created-updated: Logfile is not created / updated ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The extension does not create the logfile automatically. If you want to make use of the logfile for verifying scheduler task is running ok, you will have to create the log file manually (default location is fileadmin/rssimport.log and can be adjusted in extension options) and you must make sure the file is writable by user apache. .. _tt-news-record-creation-fails-when-executed-from-scheduler: tt\_news record creation fails when executed from scheduler ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This is a configuration issue with your installation : Here is the solution :- create a usergroup with access rights and mountpoints you need- give access to pages with module 'access' to this user group as you would for any 'normal' backend usergroup using the access permissions module --> VERY IMPORTANT- add user \_cli\_scheduler to this usergroup A good way to test your setup is to use the User Admin module to switch to the \_cli\_scheduler user. This way you will be able to see:- whether you have access to the storage of your records at all- whether you can edit or create the expected records in this storage. .. _To-Do-list: To-Do list ---------- No To-Dos now. .. _ChangeLog: ChangeLog --------- - Fixed : user defined mapping in ttnews\_rssimport record was ignored - Added RSS encoding autodetection in a reliable way : the encoding is extracted from the tag from the RSS file 13 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 262 .. :id: Grafik4 .. :name: Grafik4 .. :width: 669 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 531 .. :id: Grafik5 .. :name: Grafik5 .. :width: 669 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 429 .. :id: Grafik6 .. :name: Grafik6 .. :width: 669 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 289 .. :id: Grafik7 .. :name: Grafik7 .. :width: 669 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 509 .. :id: Grafik11 .. :name: Grafik11 .. :width: 669 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 624 .. :id: Grafik8 .. :name: Grafik8 .. :width: 669 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 587 .. :id: Grafik10 .. :name: Grafik10 .. :width: 669 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 393 .. :id: Grafik1 .. :name: Grafik1 .. :width: 669 .. |img-11| image:: img-11.png .. :align: left .. :border: 0 .. :height: 446 .. :id: Grafik3 .. :name: Grafik3 .. :width: 666 .. |img-12| image:: img-12.png .. :align: left .. :border: 0 .. :height: 183 .. :id: Grafik12 .. :name: Grafik12 .. :width: 669