PHPackages                             georgringer/news-importicsxml - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing & Serialization](/categories/parsing)
4. /
5. georgringer/news-importicsxml

ActiveTypo3-cms-extension[Parsing & Serialization](/categories/parsing)

georgringer/news-importicsxml
=============================

Versatile news import from ICS + XML (local files or remote URLs) including images and category mapping

3.0.0(8y ago)329.7k↑54.9%23[15 issues](https://github.com/georgringer/news_importicsxml/issues)[2 PRs](https://github.com/georgringer/news_importicsxml/pulls)GPL-2.0-or-laterPHP

Since Jul 10Pushed 7mo ago5 watchersCompare

[ Source](https://github.com/georgringer/news_importicsxml)[ Packagist](https://packagist.org/packages/georgringer/news-importicsxml)[ Docs](http://ringer.it)[ RSS](/packages/georgringer-news-importicsxml/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (1)Dependencies (3)Versions (12)Used By (0)

TYPO3 CMS Extension "news\_importicsxml"
========================================

[](#typo3-cms-extension-news_importicsxml)

This extensions 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 10.4 LTS or 11.5 LTS
- EXT:news 8.0.0+

**Sponsors**

- Webconsulting
- TUM (Technical University of Munich)
- Hochschule Darmstadt - University of Applied Sciences

Screenshots
-----------

[](#screenshots)

**Screenshot #1:** Creation of an import task

[![Creation of an import task](Resources/Public/Documentation/screenshot-task.png)](Resources/Public/Documentation/screenshot-task.png)

**Screenshot #2:** Metadata of an imported ICS item

[![Metadata of an imported ics item](Resources/Public/Documentation/screenshot-import-ics.png)](Resources/Public/Documentation/screenshot-import-ics.png)

Important information for Upgrade from 6.0 to 7.0
-------------------------------------------------

[](#important-information-for-upgrade-from-60-to-70)

The auto-generated ID for identifying an imported source has been changed for ICS files. If you import existing items again, those will be duplicated one time.

### Installation

[](#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

[](#configuration)

After installing the extension, switch to the module **scheduler** and create a new task **Import news**. These additional fields are available:

#### Format

[](#format)

Select either *XML* or *ICS* to import an ICS file or an XML file.

#### Path

[](#path)

Define a local path like fileadmin/data.xml or any URL like .

#### Page ID

[](#page-id)

Define a page id where the new records will be saved.

#### Category mapping

[](#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:

```

        A possible title
        http://www.examle.com/feed.xml
        Lorem ipsum

        Sports
        Tech
        Information
        Tue, 02 Jun 2015 16:54:00 +0200

```

An ICS entry with a category can look like this:

```
BEGIN:VCALENDAR
PRODID:QIS-LSF HIS eG
VERSION:2.0
BEGIN:VTIMEZONE
TZID:Europe/Berlin
X-LIC-LOCATION:Europe/Berlin
BEGIN:DAYLIGHT
TZOFFSETFROM:+0100
TZOFFSETTO:+0200
TZNAME:CEST
DTSTART:19700329T020000
RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=3
END:DAYLIGHT
BEGIN:STANDARD
TZOFFSETFROM:+0200
TZOFFSETTO:+0100
TZNAME:CET
DTSTART:19701025T030000
RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10
END:STANDARD
END:VTIMEZONE
METHOD:PUBLISH
BEGIN:VEVENT
DTSTART;TZID=Europe/Berlin:20171016T141500
DTEND;TZID=Europe/Berlin:20171016T154500
RRULE:FREQ=WEEKLY;UNTIL=20171211T235900Z;INTERVAL=2;BYDAY=MO
EXDATE;TZID=Europe/Berlin:
LOCATION:C12 - C12 / 024
DTSTAMP:20180216T113640Z
UID:52965155936
DESCRIPTION:
SUMMARY:MK.1890a - Finite Berechnungsverfahren  Praktikum (A-Zug) (Eufinger)
CATEGORIES:Praktikum
END:VEVENT
END:VCALENDAR
```

A possible category mapping would look like this:

```
5:Sports
17:Tech
17:Information
```

As a result, the imported news record will belong to the categories of the IDs *5 & 17*.

#### Email notification

[](#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

[](#persist-article-with-type-external-page)

If set, the news article is saved with the type "External Url".

Further information
-------------------

[](#further-information)

### Debugging

[](#debugging)

This extensions used 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

[](#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.

Tip

Check the documentation of the news extension for a full list of available events:

Tip

Since TYPO3 v10, event dispatching is based on PSR-14 standard. See the core API docs to learn more details:

Tip

An example on how to use the NewsImportPostHydrateEvent EventListener is available in ext:eventnews

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance25

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 81.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~475 days

Recently: every ~775 days

Total

9

Last Release

212d ago

Major Versions

1.0.1 → 2.0.02017-06-07

2.1.1 → 3.0.02018-06-09

3.0.0 → v14.x-dev2025-12-03

### Community

Maintainers

![](https://www.gravatar.com/avatar/1d08c176686c8914d32c70d4af388887d738930fdfdf07c7ca9c841ad10ed683?d=identicon)[georgringer](/maintainers/georgringer)

---

Top Contributors

[![georgringer](https://avatars.githubusercontent.com/u/1905663?v=4)](https://github.com/georgringer "georgringer (92 commits)")[![tkowtsch](https://avatars.githubusercontent.com/u/172428229?v=4)](https://github.com/tkowtsch "tkowtsch (8 commits)")[![cdaecke](https://avatars.githubusercontent.com/u/2102444?v=4)](https://github.com/cdaecke "cdaecke (4 commits)")[![sascha-schieferdecker](https://avatars.githubusercontent.com/u/8793359?v=4)](https://github.com/sascha-schieferdecker "sascha-schieferdecker (2 commits)")[![thomasruta](https://avatars.githubusercontent.com/u/177512?v=4)](https://github.com/thomasruta "thomasruta (1 commits)")[![vnc-kber](https://avatars.githubusercontent.com/u/83655246?v=4)](https://github.com/vnc-kber "vnc-kber (1 commits)")[![areimund](https://avatars.githubusercontent.com/u/22156820?v=4)](https://github.com/areimund "areimund (1 commits)")[![ykahveci](https://avatars.githubusercontent.com/u/33582550?v=4)](https://github.com/ykahveci "ykahveci (1 commits)")[![flolanger](https://avatars.githubusercontent.com/u/21835310?v=4)](https://github.com/flolanger "flolanger (1 commits)")[![NarkNiro](https://avatars.githubusercontent.com/u/6518044?v=4)](https://github.com/NarkNiro "NarkNiro (1 commits)")[![rengaw83](https://avatars.githubusercontent.com/u/5131653?v=4)](https://github.com/rengaw83 "rengaw83 (1 commits)")

---

Tags

icstypo3-cms-extensiontypo3-extensionxmlxmlimportextensionics newstypo3

### Embed Badge

![Health badge](/badges/georgringer-news-importicsxml/health.svg)

```
[![Health](https://phpackages.com/badges/georgringer-news-importicsxml/health.svg)](https://phpackages.com/packages/georgringer-news-importicsxml)
```

###  Alternatives

[friendsoftypo3/headless_news

This extension provides integration with news to output content from TYPO3 in JSON format.

1158.4k](/packages/friendsoftypo3-headless-news)[markussom/sitemap-generator

Easy to use sitemap generator for pages and records.

1164.9k](/packages/markussom-sitemap-generator)[t3brightside/pagelist

TYPO3 CMS extension to create news, events, vacancies and products or just page lists. Demo: microtemplate.t3brightside.com

1121.5k1](/packages/t3brightside-pagelist)[georgringer/redirect-generator

Generate redirect entries from a given set of URLs and export all to CSV

1647.2k](/packages/georgringer-redirect-generator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)