A module for Zend Framework 2 that provides functionality to rate or like something.
PHP
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
config
data
src/WtRating
tests
.travis.yml
LICENSE
Module.php
README.md
autoload_classmap.php
autoload_function.php
autoload_register.php
composer.json

README.md

WtRating

Version 0.0.1

Build Status

Introduction

This is a Zend Framework 2 module that provides functionality to rate or like something.

Requirements

Installation

Add this repository as a submodule to your repository or install using Composer:

{
    "require": {
        "waltertamboer/wtrating": "*"
    }
}

Usage

Setup

Setup the mapper that you want to use. By default this module only comes with a Zend\Db mapper.

'service_manager' => array(
    'factories' => array(
        'wtrating.mapper' => function ($sm) {
            $dbAdapter = $sm->get('... db adapter ...');
            return new \WtRating\Mapper\ZendDbMapper($dbAdapter);
        }
    ),
)

Rate something

To add a rating you could do the following:

public function indexAction()
{
    // The id of the user that is currently logged in or null if there is no user:
    $userId = ...;

    // The type that identifies the rating:
    $typeId = 'my-article-163';

    // The rating to set, make something up:
    $rating = rand();

    $serviceLocator = $this->getServiceLocator();

    // Create a new rating:
    $rating = $serviceLocator->create('wtrating.rating');
    $rating->setTypeId($typeId);
    $rating->setUserId($userId);
    $rating->setRating($rating);

    // Save the rating to the storage device:
    $ratingService = $serviceLocator->get('wtrating.service');
    $ratingService->persist($rating);

    // Retrieve the rating set that contains information like avarage rating,
    // amount of rates, etc.
    return new ViewModel(array(
        'ratingSet' => $ratingService->getRatingSet($typeId)
    ));
}

Show ratings

There is a view helper that can be invoked:

$this->wtRating($ratingSet);

It's possible to add attributes as well:

$this->wtRating($this->ratingSet, array(
    'class' => 'rating'
));

If you want to change the HTML element you can use the third parameter:

$this->wtRating($this->ratingSet, array(), 'div');