Download the PHP package georgringer/news-importicsxml without Composer
On this page you can find all versions of the php package georgringer/news-importicsxml. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download georgringer/news-importicsxml
More information about georgringer/news-importicsxml
Files in georgringer/news-importicsxml
Package news-importicsxml
Short Description Versatile news import from ICS + XML (local files or remote URLs) including images and category mapping
License GPL-2.0-or-later
Homepage http://ringer.it
Informations about the package news-importicsxml
TYPO3 CMS Extension news_importicsxml
This extension provides an import interface for xml and ics files which can either be located on the same server or reached via URL.
The import is done by the scheduler.
Requirements
- TYPO3 CMS 13.4 LTS or 14 LTS
- EXT:news 13 / 14
Sponsors
- Webconsulting https://webconsulting.at/
- TUM (Technical University of Munich) https://www.tum.de/
- Hochschule Darmstadt - University of Applied Sciences https://www.h-da.de/
Screenshots
Screenshot #1: Creation of an import task
Screenshot #2: Metadata of an imported ICS item
Installation
Installation using Composer
The recommended way to install the extension is by using composer. In your composer based TYPO3 project root, just do composer require georgringer/news-importicsxml.
Installation as extension from TYPO3 Extension Repository (TER)
Download and install the extension with the extension manager module.
Configuration
After installing the extension, switch to the module scheduler and create a new task Execute console commands.
Select the command news:importicsxml and fill the arguments:
path: Define a local path likefileadmin/data.xmlor any URL likehttps://typo3.org/xml-feeds/rss.xml.pid: Define a page id where the new records will be saved.format: Eitherxmlorics.slug,cleanBeforeImport,persistAsExternalUrl,email,mapping: Optional, see below.
The same import can be started on the command line: vendor/bin/typo3 news:importicsxml fileadmin/data.xml 42 xml.
Category mapping
A category mapping can be used to add categories to the news records based on categories found in the feed.
A typical feed item can look like this:
An ICS entry with a category can look like this:
A possible category mapping would look like this:
As a result, the imported news record will belong to the categories of the IDs 5 & 17.
Email notification
Add an email address which will get notified after each run.
Important: This feature is not yet implemented!
Persist article with type external page
If set, the news article is saved with the type "External Url".
Further information
Clear the cache after an import
The import writes the records without the DataHandler, therefore TCEMAIN.clearCacheCmd is not evaluated.
EXT:news dispatches the event GeorgRinger\News\Event\NewsPostImportEvent once an import has been done.
Use it to flush the caches of the pages which show the news, the cache tags of EXT:news are tx_news_pid_<pid> and tx_news_uid_<uid>:
Proxy
XML feeds, ICS files and enclosures are fetched with the HTTP client of TYPO3. All settings of $GLOBALS['TYPO3_CONF_VARS']['HTTP'], like proxy (including no), are respected.
Debugging
This extension uses the logging API of TYPO3 CMS. You can find some basic information in the log files (default typo3temp/var/logs/typo3_****.log).
Extending the import
If you need to import additional data from a feed or ics item or you need to modify the data, use the Event Dispatching of the extension news. Most likely, you will need the NewsImportPostHydrateEvent EventListener.
- Check the documentation of the news extension for a full list of available events:
https://docs.typo3.org/p/georgringer/news/main/en-us/Reference/Events/Index.html - An example on how to use the NewsImportPostHydrateEvent EventListener is available in
ext:eventnews
All versions of news-importicsxml with dependencies
typo3/cms-scheduler Version ^8.7 || ^9.2
typo3/cms-core Version ^8.7 || ^9.2