Poll bundle

Installs: 9

Dependents: 0

Suggesters: 0

Security: 0


1.0.2 2023-12-19 14:33 UTC

This package is auto-updated.

Last update: 2024-02-19 14:52:07 UTC


Install through composer:

php -d memory_limit=-1 composer.phar require atm/pollbundle

In your AppKernel

public function registerbundles()
    return [
    	new ATM\PollBundle\ATMPollBundle(),

Configuration sample

# app/config/config.yml
    media_folder: path to media folder


Append to the main routing file:

# app/config/routing.yml

    resource: "@ATMPollBundle/Controller/PollController.php"
    type:     annotation
    prefix:   /members


There is only 1 service that search votes and retrieve the items in a poll sorted by it's votes. These are the functions:

    public function search($options){
            $defaultOptions = array(
                'poll_id' => null,
                'user_id' => null,
                'item_id' => null,
                'creation_date' => null,
                'ids' => null,
                'sorting_field' => null,
                'date_limit' => array(
                    'min' => null,
                    'max' => null
                'limit' => null,
                'hydrate' => true,
                'page' => 1,
                'max_results' => null,
                'pagination' => null,
                'count' => null

If count is true it will return an array with the following structure:

        'count' => $totalVotes
     public function getItemsByVotes($pollId){}

Show a poll

You can show the poll in you site by using the following call in you twig template:

    {{ render(controller('ATMPollBundle:Poll:showPoll',{
        'pollId' :  pollId
    })) }}

You can also use the following route to show the poll in its own page:

    {{ path('atm_poll_show',{ 'pollId':pollId }) }}

The view that returns it's in this path:


And the variables that are passed to that view are the following:

- poll -> poll object
- items -> items in that poll sorted by number of votes
- totalPollVotes -> total amount of votes of this poll

There is an extra feature to show confetti every time that a user votes successfully, these are the steps to use it:

- Include this script in your page:
    <script src="{{ asset('bundles/atmpoll/plugins/confetti/confetti.js') }}"></script>
- Create a <canvas id="canvas"></canvas> somewhere in you page with these styles:
    canvas {display: block;position: fixed;z-index: 1;pointer-events: none;top:0;left:0}
- Create these 2 buttons:
    <button id="confetti_start" style="display: none"></button>
    <button id="confetti_stop" style="display: none"></button>
- Show and hide the confetti with this code:
    }, 2000);