Merge pull request #8 from ancarebeca/develop

Develop

.gitignore

@@ -1,2 +1,4 @@
 .idea/
 /vendor/
+composer.lock
+gi

Controller/CalendarController.php

@@ -2,7 +2,6 @@
 
 namespace AncaRebeca\FullCalendarBundle\Controller;
 
-use AncaRebeca\FullCalendarBundle\Event\CalendarEvent;
 use Symfony\Bundle\FrameworkBundle\Controller\Controller;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;

README.md

@@ -8,10 +8,292 @@ This bundle allow you to integrate [FullCalendar.js](http://fullcalendar.io/) li
 * FullCalendar.js v2.3.2
 * Symfony v2.3+
 * PHP v5.3+
-* PHPSpec
+* PHPSpec 
 
 Installation
 ------------
 Installation process:
 
-WIP
+1. [Download FullCalendarBundle using composer](#download-fullcalendarbundle)
+2. [Enable bundle](#enable-bundle)
+3. [Create your Event class](#create-event)
+4. [Create and Configure your own event adapter](#config-adapter)
+5. [Add styles and scripts in your template](#styles-scripts)
+6. [Add Routing](#routing)
+
+### 1. Download FullCalendarBundle using composer <a id="download-fullcalendarbundle"></a>
+
+```bash
+$> composer require ancarebeca/full-calendar-bundle
+```
+
+### 2. Enable bundle <a id="download-fullcalendarbundle"></a>
+
+```php
+// app/AppKernel.php
+
+public function registerBundles()
+{
+    return array(
+        // ...
+        new AncaRebeca\FullCalendarBundle\FullCalendarBundle(),
+    );
+}
+```
+### 3. Create your Calendar Event class <a id="create-event"></a>
+
+```php
+// src/AppBundle/Entity/EventCustom.php
+
+<?php
+
+namespace AppBundle\Entity;
+
+use AncaRebeca\FullCalendarBundle\Model\Event as BaseEvent;
+
+class CalendarEvent extends BaseEvent
+{
+	// Your fields 
+}
+```
+
+### 4. Create and Configure your own event adapter <a id="config-adapter"></a>
+
+```php
+// src/AppBundle/Adapter/CustomAdapter.php
+
+<?php
+
+namespace AppBundle\Adapter;
+
+use AncaRebeca\FullCalendarBundle\Adapter\CalendarAdapterInterface;
+use AncaRebeca\FullCalendarBundle\Model\EventInterface;
+use AppBundle\Entity\CustomAdapter;
+
+class CustomAdapter implements CalendarAdapterInterface
+{
+    /**
+     * @param \Datetime $startDate
+     * @param \Datetime $endDate
+     * @param \array $filters
+     *
+     * @return EventInterface[]
+     */
+    public function getData(\Datetime $startCalendarDate, \Datetime $endCalendarDate, array $filters = [])
+    {
+    	 // You may want do a custom query to populate the events	
+        return [
+            new CalendarEvent('Event Title 1', new \DateTime()),
+            new CalendarEvent('Event Title 2', new \DateTime())
+        ];
+    }
+}
+```
+
+Adding bundle config:
+
+```yml
+// app/config/config.yml
+
+full_calendar:
+    adapter_class: AppBundle\Adapter\CustomAdapter
+    serializer_class: # by default AncaRebeca\FullCalendarBundle\Service\Serializer
+```
+
+### 5. Add styles and scripts in your template <a id="styles-scripts"></a>
+
+Add html template to display the calendar:
+
+```twig
+{% block body %}
+    {% include '@FullCalendar/Calendar/calendar.html.twig' %}
+{% endblock %}
+```
+
+Add styles:
+
+```twig
+{% block stylesheets %}
+    <link rel="stylesheet" href="{{ asset('bundles/fullcalendar/css/fullcalendar/fullcalendar.min.css') }}" />
+{% endblock %}
+```
+
+Add javascript:
+
+```twig
+{% block javascripts %}
+    <script type="text/javascript" src="{{ asset('bundles/fullcalendar/js/fullcalendar/lib/jquery.min.js') }}"></script>
+    <script type="text/javascript" src="{{ asset('bundles/fullcalendar/js/fullcalendar/lib/moment.min.js') }}"></script>
+    <script type="text/javascript" src="{{ asset('bundles/fullcalendar/js/fullcalendar/fullcalendar.min.js') }}"></script>
+    <script type="text/javascript" src="{{ asset('bundles/fullcalendar/js/fullcalendar/fullcalendar.default-settings.js') }}"></script>
+{% endblock %}
+```
+
+Install assets
+
+```bash
+$> php app/console assets:install web
+```
+
+### 6. Define routes by default <a id="routing"></a>
+
+```yml
+# app/config/config.yml
+
+ancarebeca_fullcalendar:
+    resource: "@FullCalendarBundle/Resources/config/routing.yml"
+```
+
+# Extending Basic functionalities
+
+## Extending the Calendar Javascript
+If you want to customize the FullCalendar javascript you can copy the fullcalendar.default-settings.js in Resources/public/js, and add your own logic:
+
+```javascript
+$(function () {
+	$('#calendar-holder').fullCalendar({
+		header: {
+		    left: 'prev, next',
+		    center: 'title',
+		    right: 'month, agendaWeek, agendaDay'
+		},
+		timezone: ('Europe/London'),
+		businessHours: {
+		    start: '09:00',
+		    end: '17:30',
+		    dow: [1, 2, 3, 4, 5]
+		},
+		allDaySlot: false,
+		defaultView: 'agendaWeek',
+		lazyFetching: true,
+		firstDay: 1,
+		selectable: true,
+		timeFormat: {
+		    agenda: 'h:mmt',
+		    '': 'h:mmt'
+		},
+		columnFormat:{
+		    month: 'ddd',
+		    week: 'ddd D/M',
+		    day: 'dddd'
+		},
+		editable: true,
+		eventDurationEditable: true,
+		eventSources: [
+		{
+			url: /your/custom/route,
+			type: 'POST',
+			data: {
+			
+			}
+			error: function() {
+			   //alert()
+			}
+		}
+]
+```
+
+## Define your own Controller
+You may want to define your own controller. This is specially usefull when you want to use some filters in the calendar:
+
+```javascript
+// custom-settings.js 
+// ...
+		eventSources: [
+		{
+			url: /your/custom/route,
+			type: 'POST',
+			data: {
+			   userName: 'fulanito'
+			}
+			error: function() {
+			   //alert()
+			}
+		}
+// ....
+```
+
+```php
+<?php
+
+namespace Acme\AppBundle\Controller;
+
+use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class CalendarCustomController extends Controller
+{
+    /**
+     * @param Request $request
+     *
+     * @return Response
+     */
+    public function loadAction(Request $request)
+    {
+        $startDate = new \DateTime($request->get('start'));
+        $endDate = new \DateTime($request->get('end'));
+        $filter = [
+           'userName' => $request->get('userName', 'default')
+        ];
+
+        $response = new Response();
+        $response->headers->set('Content-Type', 'application/json');
+
+        try {
+            $content = $this->get('anca_rebeca_full_calendar.service.calendar')->getData($startDate, $endDate, $filters);
+            $response->setContent($content);
+            $response->setStatusCode(Response::HTTP_OK);
+        } catch (\Exception $exception) {
+            $response->setContent([]);
+            $response->setStatusCode(Response::HTTP_INTERNAL_SERVER_ERROR);
+        }
+
+        return $response;
+    }
+}
+``` 
+
+## Define your own serializer
+You may want to define your own serializer. You only need to:
+
+Create your serializer implementing the serializer class:
+
+```php
+// src/AppBundle/Serializer/CustomSerializer.php
+
+<?php
+
+namespace AppBundle\Serializer;
+
+use AncaRebeca\FullCalendarBundle\Model\EventInterface;
+
+class CustomSerializer implements SerializerInterface
+{
+    /**
+     * @param array $data
+     *
+     * @return string json
+     */
+    public function serialize(array $data)
+    {
+		 // your code
+
+        return $json;
+    }
+}
+```
+Adding config:
+
+```yml
+// app/config/config.yml
+
+full_calendar:
+    adapter_class: AppBundle\Adapter\CustomAdapter
+    serializer_class: AppBundle\Serializer\CustomSerializer
+```
+
+Contribute and feedback
+-------------------------
+
+Any feedback and contribution will be very appreciated.