PHPackages                             portrino/px\_ical - 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. [Utility & Helpers](/categories/utility)
4. /
5. portrino/px\_ical

AbandonedArchivedTypo3-cms-extension[Utility & Helpers](/categories/utility)

portrino/px\_ical
=================

Provides classes to render ical via eluceo iCal lib (https://github.com/markuspoerschke/iCal)

0.2.1(4y ago)161GPL-2.0+PHP

Since May 10Pushed 4y ago6 watchersCompare

[ Source](https://github.com/portrino/px_ical)[ Packagist](https://packagist.org/packages/portrino/px_ical)[ Docs](http://typo3.org)[ RSS](/packages/portrino-px-ical/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (5)Versions (10)Used By (0)

px\_ical - 0.2.0
================

[](#px_ical---020)

[![Build Status](https://camo.githubusercontent.com/7a8c1b76b11b1d156cd31794a4ed054f5f5ddc9822771588eac9a27abe5c8760/68747470733a2f2f7472617669732d63692e6f72672f706f727472696e6f2f70785f6963616c2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/portrino/px_ical) [![Maintainability](https://camo.githubusercontent.com/6da552c2817c1c54b2845d2f21da59e7755fc0709cd345ff26876c46b48b8fb8/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f37643364363230396562333666373333616565632f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/portrino/px_ical/maintainability) [![Test Coverage](https://camo.githubusercontent.com/b275ec79e33ef59264654d9af80d3112eb2c84d2df39147631da7949c473781d/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f37643364363230396562333666373333616565632f746573745f636f766572616765)](https://codeclimate.com/github/portrino/px_ical/test_coverage)[![Test Coverage](https://camo.githubusercontent.com/1e203d523e2956427a845283b351a95c71342ac7705ccb18688758d77c6858d5/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f706f727472696e6f2f70785f6963616c2f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/portrino/px_ical/coverage)[![Issue Count](https://camo.githubusercontent.com/c800ab1f103b3d1a404bfdf4f942cf15d06a4464bcca0bedd103cb2abbd5e8e6/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f706f727472696e6f2f70785f6963616c2f6261646765732f69737375655f636f756e742e737667)](https://codeclimate.com/github/portrino/px_ical)[![Latest Stable Version](https://camo.githubusercontent.com/4aff354c81beb0488e87350bba3a10e8227d6f86ebbeb3adce3113034d535d95/68747470733a2f2f706f7365722e707567782e6f72672f706f727472696e6f2f70785f6963616c2f762f737461626c65)](https://packagist.org/packages/portrino/px_ical)[![Total Downloads](https://camo.githubusercontent.com/46f59fd3c382bf90fd437a27dffcb4bb000f22d3744beee4c2d6af6e524e501f/68747470733a2f2f706f7365722e707567782e6f72672f706f727472696e6f2f70785f6963616c2f646f776e6c6f616473)](https://packagist.org/packages/portrino/px_ical)

Provides TYPO3 classes to render \*.ics files via [eluceo — iCal](https://github.com/markuspoerschke/iCal) library.

Installation
------------

[](#installation)

```
composer require portrino/px_ical
```

Usage
-----

[](#usage)

### Extbase view

[](#extbase-view)

You can prepend `?tx_par_pi1[format]=ical` to your action controller request and extbase renders the corresponding view for you. By putting the ICalView class into the `$viewFormatToObjectNameMap`extbase is able to get the correct view class for your request. When you following the Domain Driven Design you have a domain model which is assigned to the view and get rendered by the different view classes.

By implementing the `ICalEventInterface` the ICalView class calls the `__toICalEvent()` method which have to be implemented by yourself. You have to return an `Eluceo\iCal\Component\Event` object here.

```
use Portrino\PxICal\Mvc\View\ICalView;
use TYPO3\CMS\Extbase\Mvc\View\JsonView;

class BookingController extends RestController
{
    /**
     * @var array
     */
    protected $viewFormatToObjectNameMap = [
        'json' => JsonView::class,
        'ical' => ICalView::class
    ];

    /**
     * Action Show
     *
     * @param \Foo\Bar\Domain\Model\Booking $booking
     *
     * @return void
     */
    public function showAction($booking)
    {
        /**
         * $booking should implement the ICalEventInterface
         */
        $this->view->assign('booking', $booking);
    }

}

...

class Booking extends AbstractEntity implements ICalEventInterface
{

    /**
     * @return Event
     */
    public function __toICalEvent()
    {
        $event = new Event();

        $event
            ->setUniqueId('foo_bar_' . (string)$this->getUid())
            ->setDtStart($this->getStart())
            ->setDtEnd($this->getEnd());

        ...

        return $event;
    }
}
```

If you do not have a domain model or the `__toICalEvent()` does not fit your needs, you can also assign the `Eluceo\iCal\Component\Event` object directly to the ICal view with the variable name **vEvent**

```
use Eluceo\iCal\Component\Event;

/**
 * Action Show
 *
 * @return void
 */
public function showAction()
{
    $vEvent = new Event();

    $vEvent
        ->setUniqueId('foo_bar_' . (string)$this->getUid())
        ->setDtStart($this->getStart())
        ->setDtEnd($this->getEnd());

    ...

    $this->view->assign('vEvent', $vEvent);
}
```

Service
-------

[](#service)

This extensions provides a service class which creates an iCal file for you and put this file into: `/typo3temp/px_ical` folder. You just have to inject the class into your controller, ... and then you can call these methods to generates / remove the ical file.

*Dependecy Injection:*

```
/**
 * @var \Portrino\PxICal\Service\ICalFileServiceInterface
 * @inject
 */
protected $iCalFileService;
```

*from domain object:*

```
$file = $this->iCalFileService->createFromDomainObject($booking);
```

*from event object:*

```
$file = $this->iCalFileService->create($vEvent);
```

To remove created files you just have to call the inverse method which does the job for you:

*by domain object:*

```
$file = $this->iCalFileService->removeByDomainObject($booking);
```

*by event object:*

```
$file = $this->iCalFileService->remove($vEvent);
```

Authors
-------

[](#authors)

[![](https://avatars0.githubusercontent.com/u/726519?s=40&v=4)](https://avatars0.githubusercontent.com/u/726519?s=40&v=4)

- **André Wuttig** - *Initial work, Unit Tests* - [aWuttig](https://github.com/aWuttig)
- **Leopold Engst** - *Unit Tests* - [leen2104](https://github.com/leen2104)

See also the list of [contributors](https://github.com/portrino/px_ical/graphs/contributors) who participated in this project.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.8% 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 ~245 days

Recently: every ~429 days

Total

8

Last Release

1572d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/03867e1d2497d7cb7feb932fb301387e143503bfd17c584ef90347b3d7942cf1?d=identicon)[portrino-dev](/maintainers/portrino-dev)

---

Top Contributors

[![aWuttig](https://avatars.githubusercontent.com/u/726519?v=4)](https://github.com/aWuttig "aWuttig (15 commits)")[![tgriessbach](https://avatars.githubusercontent.com/u/11647324?v=4)](https://github.com/tgriessbach "tgriessbach (1 commits)")

---

Tags

cmsicsicaltypo3portrino

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/portrino-px-ical/health.svg)

```
[![Health](https://phpackages.com/badges/portrino-px-ical/health.svg)](https://phpackages.com/packages/portrino-px-ical)
```

###  Alternatives

[spatie/icalendar-generator

Build calendars in the iCalendar format

6787.4M9](/packages/spatie-icalendar-generator)[typo3/cms-composer-installers

TYPO3 CMS Installers

6113.7M52](/packages/typo3-cms-composer-installers)[koninklijke-collective/my-redirects

TYPO3 Extension: Redirects management

17152.4k](/packages/koninklijke-collective-my-redirects)[jsvrcek/ics-bundle

This bundle provides a dependency injection wrapper for the JsvrcekICS iCal library

11150.6k](/packages/jsvrcek-ics-bundle)[welp/ical-bundle

Symfony Bundle to manage .ics iCal file (creating and eventually reading)

10114.3k](/packages/welp-ical-bundle)[codingfreaks/cf-cookiemanager

Manage cookies, scripts, and GDPR compliance on your Typo3 website with CodingFreaks Typo3 Cookie Manager. Customize cookie banners, streamline workflow, and enhance user experience. Ensure GDPR compliance and take control of cookie management with our Typo3 cookie management extension. Visit the official Typo3 Documentation page to learn more.

1625.8k](/packages/codingfreaks-cf-cookiemanager)

PHPackages © 2026

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