slad/slad-booking-bundle

Adds some booking functionality to your Symfony 2 project

V2.0 2016-10-18 16:27 UTC

Requires

• php: >=5.3.2
• doctrine/doctrine-bundle: ~1.1
• doctrine/orm: >=2.3
• symfony/browser-kit: ~2.3
• symfony/filesystem: ~2.3
• symfony/finder: ~2.3
• symfony/framework-bundle: ~2.3
• symfony/options-resolver: ~2.3
• symfony/twig-bundle: ~2.3
• twig/extensions: ~1.0
• twig/twig: ~1.5

Requires (Dev)

• doctrine/doctrine-fixtures-bundle: dev-master
• phpunit/phpunit: ~3.7

Suggests

• doctrine/mongodb-odm: 1.0.*@dev

MIT

• Stéphane Lemoine

• calendar
• booking
• availability

README

this project is forked from melifaro/melifaro-booking-bundle Changes will be made to match with car rental business

Booking Bundle for Symfony 2 Applications. Bundle provides some useful functionality for handling bookings on your website.

Installation

1. Download

Prefered way to install this bundle is using composer

Download the bundle:

$ php composer.phar require "slad/slad-booking-bundle:dev-master"

2. Add it to your Kernel:

<?php

// app/AppKernel.php


public function registerBundles()
{
    $bundles = array(
        // ...

        new Slad\BookingBundle\SladBookingBundle(),
    );
}

3. Create your entity

Doctrine ORM

Bundle has all necessary mappings for your entity. Just create your entity class and extend it from Slad\BookingBundle\Entity\Booking, create your id field and setup proper relation for item you want to be booked.

<?php

namespace Vendor\Bundle\Entity;

use Slad\BookingBundle\Entity\Booking as BaseClass;

/**
 * Booking
 *
 * @ORM\Entity()
 * @ORM\Table(name="booking")
 */
class Booking extends BaseClass
{
    /**
         * @var integer
         *
         * @ORM\Column(name="id", type="integer")
         * @ORM\Id
         * @ORM\GeneratedValue(strategy="AUTO")
         */
        protected $id;

        /**
         * @var \Vendor\Bundle\Entity\BookableItem
         *
         * @ORM\ManyToOne(targetEntity="BookableItem", inversedBy="bookings")
         * @ORM\JoinColumn(name="property_id", referencedColumnName="id")
         */
        protected $item;

        // Don't forget about getters and setters
}

4. Configure the booking bundle in config.yml

# Booking
slad_booking:
    entity_class:   AppBundle\Entity\Booking

Now we are ready to rock!

Booker Service

Core component of this bundle is booker service. You can get it in your controller by using

<?php

public function bookingAction()
{
    $this->get('booker'); /** @var \Slad\BookingBundle\Helper\Booker */
}

Booker Service has following methods:

isAvailableForPeriod($item, \DateTime $start, \DateTime $end) Checks is your item available for period, returns boolean

isAvailableForDate($item, \DateTime $date) Checks is your item available for date, returns boolean

whereAvailableForPeriod(QueryBuilder $queryBuilder, $join, \DateTime $start, \DateTime $end) Updates your QueryBuilder and returns the same QueryBuilder object with added join and where clause.

Note: $join is array('field', 'alias')

whereAvailableForDate(QueryBuilder $queryBuilder, $join, \DateTime $date) Updates your QueryBuilder and returns the same QueryBuilder object with added join and where clause.

Note: $join is array('field', 'alias')

book($item, \DateTime $start, \DateTime $end) Books your item returns Entity | false (Entity on success, false on failure)

Calendar Twig Extension

Bundle also provides cool Twig extension. To use it in your template just try following:

{{ slad_booking_calendar(item, "now", 4) }}

Where

item - is object of your bookable item

now - is any date allowed for \DateTime::__construct()

4 - number of months to be rendered after desired date

Overriding template

Template can be overridden as usual in Symfony 2 application. Just create following directory structure:

app/Resources/views/SladBookingBundle/Calendar/month.html.twig