carlescliment/calendar-bundle

A bundle for handling events in calendar

Friday, October 14, 2016
by carlescliment
Repository
7 Watchers
44 Stars
15,376 Installations

PHP
0 Dependents
0 Suggesters
16 Forks
9 Open issues
15 Versions
1 % Grown

The README.md

CalendarBundle

, _(*1)

The CalendarBundle gives you a built-in calendar for managing events without relying on third-parties like Google. It comes with four different default views; agenda, by day, by week and by month. If you need greater customizations, you can use the bundle as a simple calendar API and build your own logic on it., _(*2)

Installation

1. Update your vendors

Add this line to your composer.json, _(*3)

"require": {
    "carlescliment/calendar-bundle": "dev-master"
}

Execute php composer.phar update carlescliment/calendar-bundle, _(*4)

2. Load the bundle in `app/AppKernel.php`

$bundles = array(
    // ...
    new BladeTester\CalendarBundle\BladeTesterCalendarBundle(),
);

3. Update your routing:

// ...

BladeTesterCalendarBundle:
    resource: "@BladeTesterCalendarBundle/Resources/config/routing.yml"
    prefix:   /

4. Create your calendar bundle

Create a new bundle extending BladeTesterCalendarBundle, _(*5)

namespace Your\OwnCalendarBundle;

use Symfony\Component\HttpKernel\Bundle\Bundle;

class YourOwnCalendarBundle extends Bundle
{

   public function getParent()
    {
        return 'BladeTesterCalendarBundle';
    }
}

WARNING: If your bundle includes its own routing file, remember to delete it or completely override the parent bundle paths., _(*6)

Add it to AppKernel., _(*7)

    $bundles = array(
        // ...
        new Your\OwnCalendarBundle\YourOwnCalendarBundle(),
    );

5. Update the schema

php app/console doctrine:schema:update --force

6. Install the assets

php app/console assets:install

Using the calendar

Go to http://www.example.com/calendar and enjoy :), _(*8)

Customizing the bundle

If you want to override the bundle default views to use your design and markup, please follow the next steps., _(*9)

1. Override the default base template

Copy the template in Resources/views/Base/base.html.twig into your own bundle and modify it to extend your base template., _(*10)

2. Add the assets to your base template

<script type="text/javascript" src="{{ asset('bundles/bladetestercalendar/js/jquery-1.9.1.min.js') }}"></script>
<link rel="stylesheet" href="{{ asset('bundles/bladetestercalendar/css/calendar.css') }}" />
<script type="text/javascript" src="{{ asset('bundles/bladetestercalendar/js/calendar.js') }}"></script>

Note: remove the line including jquery if your template already includes it., _(*11)

How to override the default entities

You can define your own entities. First, create your custom entity:, _(*12)

namespace Your\OwnCalendarBundle\Entity;

use Doctrine\ORM\Mapping as ORM;
use BladeTester\CalendarBundle\Entity\Event as BaseEvent;


/**
 * @ORM\Entity(repositoryClass="BladeTester\CalendarBundle\Repository\EventRepository")
 * @ORM\Table(name="events")
 */
class Event extends BaseEvent
{
  // ... your implementation goes here
}

Then modify your app/config/config.yml, _(*13)

    blade_tester_calendar:
        driver: doctrine/orm
        engine: twig
        classes:
            event:
                entity: Your\OwnBundle\Entity\Event
            category:
                entity: Your\OwnBundle\Entity\EventCategory

Extending the behaviour

It is easy to extend the behaviour of this bundle by using inheritance in your models and entities. If it is not enough, you can register listeners to the calendar events., _(*14)

Pre-persist event

Dispatched whenever an item is about to be created in the database., _(*15)

    your_own_calendar_listener:
        class: Your\OwnCalendarBundle\Event\CalendarListener
        tags:
          - { name: kernel.event_listener, event: calendar.pre-persist, method: onPrePersist }


namespace Your\OwnCalendarBundle\Event;

use BladeTester\CalendarBundle\Event\CalendarEvent;

class CalendarListener {

    public function onPrePersist(CalendarEvent $event) {
        $event_model = $event->getEvent();
        // do whatever with the object before persisting it.
    }
}

Post-add event

Dispatched after an item is added to the database., _(*16)

    your_own_calendar_listener:
        class: Your\OwnCalendarBundle\Event\CalendarListener
        tags:
          - { name: kernel.event_listener, event: calendar.post-add, method: onPostAdd }

Post-update event

Dispatched after an item is updated., _(*17)

    your_own_calendar_listener:
        class: Your\OwnCalendarBundle\Event\CalendarListener
        tags:
          - { name: kernel.event_listener, event: calendar.post-update, method: onPostUpdate }

Testing

CalendarBundle contains unitary and functional tests. Download the bundle, create the database according to the travis.yml file and configure the access settings in src/BladeTester/CalendarBundle/Tests/App/parameters.ini. Run the following command:, _(*18)

cd /path/to/calendar-bundle
composer update
php vendor/bin/phpunit

Credits

Author: Carles Climent (programming)
Author: [Marcos Calatayud][marcosc] (markup and design)
Contributor: Doug Hayward (french translations, fixes)
Contributor: Rubén Egiguren (basque translations)
Contributor: Andrzej Jarzebowski (polish translations)

Contribute and feedback

Any feedback and contribution will be very appreciated., _(*19)

The Versions

14/10 2016

dev-master

9999999-dev https://github.com/carlescliment/calendar-bundle

A bundle for handling events in calendar

symfony-bundle calendar-bundle

A bundle for handling events in calendar

carlescliment/calendar-bundle

The README.md

CalendarBundle

Installation

1. Update your vendors

2. Load the bundle in app/AppKernel.php

3. Update your routing:

4. Create your calendar bundle

5. Update the schema

6. Install the assets

Using the calendar

Customizing the bundle

1. Override the default base template

2. Add the assets to your base template

How to override the default entities

Extending the behaviour

Pre-persist event

Post-add event

Post-update event

Testing

Credits

Contribute and feedback

The Versions

dev-master

The Requires

The Development Requires

by Carles Climent Granell

dev-dev-symfony3

The Requires

The Development Requires

by Carles Climent Granell

2.5.3

The Requires

The Development Requires

by Carles Climent Granell

2.5.2

The Requires

The Development Requires

by Carles Climent Granell

dev-fix/travis-build

The Requires

The Development Requires

by Carles Climent Granell

2.5.1

The Requires

The Development Requires

by Carles Climent Granell

dev-more_events

The Requires

The Development Requires

by Carles Climent Granell

2.5.0

The Requires

The Development Requires

by Carles Climent Granell

2.4.0

The Requires

The Development Requires

by Carles Climent Granell

dev-bump_2_4

The Requires

The Development Requires

by Carles Climent Granell

dev-refactorings

The Requires

The Development Requires

by Carles Climent Granell

2.3.0

The Requires

by Carles Climent Granell

2.1.0

The Requires

by Carles Climent Granell

2.1.x-dev

The Requires

by Carles Climent Granell

v2.1.x-dev

The Requires

2. Load the bundle in `app/AppKernel.php`