xima-media/ical-bundle

There is no license information available for the latest version (0.2.3) of this package.

The XIMA iCal Bundle

0.2.3 2023-12-19 15:46 UTC

Requires

• php: ^8.0
• eluceo/ical: ^0.13.0
• sabre/vobject: >=3.4
• stof/doctrine-extensions-bundle: ^1.5.0
• timdev/doctrine-date-interval: 0.1.2

Unknown License

• Wolfram Eberius
• Konrad Michalik
• Sebastian Gierth
• Tobias Gaertner

README

Wraps the eluceo/ical package to a Symfony Bundle with Doctrine Association Mappings and includes Sonata Admin classes.

Installation

composer require xima-media/ical-bundle

Notes:

• The dependency to the eluceo/ical fork depends on markuspoerschke/iCal#50 and will be removed as soon as the pull request is accepeted.
• The dependency to the dev version of herrera-io/doctrine-dateinterval depends on kherge-archive/php-doctrine-dateinterval#3 and will be removed as soon as a new release is out.

Load the bundle in app/AppKernel.php:

public function registerBundles()
{
    $bundles = array(
    ...
    new Xima\ICalBundle\XimaICalBundle()
}

Configuration

Your projects needs to support the dbal types json and dateinterval, configured in your app/config/config.yml, e.g.:

doctrine:
    dbal:
      ...
      types:
            json: Sonata\Doctrine\Types\JsonType
            dateinterval:  Herrera\Doctrine\DBAL\Types\DateIntervalType

Integration

1. Create en event entity

You need to create a custom Event class that inherits from ICalBundle's Event class, e.g.:

<?php
use Doctrine\ORM\Mapping as ORM;

/**
 * ICalEvent.
 *
 * @ORM\Entity
 */
class ICalEvent extends \Xima\ICalBundle\Entity\Component\Event
{

}

Note: ORM auto_mapping should be enabled or configure XimaICalBundle manually in app/config/config.yml.

2. Update your database schema

Use your the method of choice to update your database schema, e.g. doctrine migrations.

Sonata Admin classes

Documentation to be done. Take a look, use or inherit from the admin classes in xima-media\ical-bundle\Admin\EventAdmin.php and xima-media\ical-bundle\Admin\RecurrenceRuleAdmin.php.

Usage

Get all events in cal format

/**
 * @Route("/ical")
 * Render all events as iCalendar
 */
protected function iCalAction(Array $events)
{
    $vCalendar = new \Eluceo\iCal\Component\Calendar('myCalendar');

    foreach ($events as $event) {
        $vCalendar->addComponent($event);
    }
    
    $response = new Response();
    $response->headers->set('Content-Type', 'text/calendar; charset=utf-8');
    $response->headers->set('Content-Disposition', 'inline; filename="cal.ics"');
    $response->setContent($vCalendar->render());

    return $response;
}