RatingBundle ⭐

Requirements

• PHP 7.1+
• MySQL 5.7.20+
• Symfony 3.4+

📦 Installation

Install bundle with Composer dependency manager first by running the command:

$ composer require oachoor/rating-bundle

Register the bundle

Enable the bundle in app\AppKernel.php file.

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = [
        // ...
        new RatingBundle\RatingBundle(),
    );
}

Add routes

rating:
    resource: '@RatingBundle/Controller'
    type: annotation

(Optional) Create your own Entities

Entities doens't fully meet your requirements?, then you can create yours based on Rating and Vote.

Resolve abstract Entities with RatingBundle or AcmeRatingBundle

doctrine:
    orm:
        resolve_target_entities:
            RatingBundle\Model\AbstractVote: RatingBundle\Entity\Vote or AcmeRatingBundle\Entity\Vote
            RatingBundle\Model\AbstractRating: RatingBundle\Entity\Rating or AcmeRatingBundle\Entity\Rating
            Symfony\Component\Security\Core\User\UserInterface: FOS\UserBundle\Model\User # Voter (Optional)

Define mapping Bundle

Make sure you have registred the Bundle that holds the Entities as following:

doctrine:
    orm:
        entity_managers:
            default:
                mappings:
                    RatingBundle: ~ or AcmeRatingBundle: ~

Update database schema

$ bin/console doctrine:schema:update --force

Using voting strategy

There are two strategies for rating, based on IP addresses or cookies. (both? feel free to contribute)

oa_rating:
    strategy: cookie (defaul "ip")
    cookie_name: your_custom_name
    cookie_lifetime: '+1 year'

Usage

To see rating result for a Content (read-only mode), use the following twig code:

{{ render( controller( 'RatingBundle:Rating:result', {'contentId' : YOUR_CONTENT_ID} ) ) }}

Rating is based on Content, to enable voting for a Content use the following twig code:

{{ render( controller( 'RatingBundle:Rating:vote', {'contentId' : YOUR_CONTENT_ID} ) ) }}

Voting is based on IP address, meaning that each computer or device can only vote once.

Bonus

A minimal Template that contains rating-call, javascripts and stylesheets.