PHPackages                             bobalazek/contest-o-mat - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. bobalazek/contest-o-mat

AbandonedArchivedProject[Utility &amp; Helpers](/categories/utility)

bobalazek/contest-o-mat
=======================

An simple starter kit for contest applications.

1.0.1(8y ago)7162MITPHPPHP ^7.0

Since Sep 15Pushed 8y ago1 watchersCompare

[ Source](https://github.com/bobalazek/contest-o-mat)[ Packagist](https://packagist.org/packages/bobalazek/contest-o-mat)[ RSS](/packages/bobalazek-contest-o-mat/feed)WikiDiscussions develop Synced today

READMEChangelog (10)Dependencies (28)Versions (31)Used By (0)

README
======

[](#readme)

**Contest-O-Mat**

An simple contest / prize game application starter kit.

Features
--------

[](#features)

- **Users System**: You and your client (owner of the prizegame) can create unlimited users and each user can have separate permissions for each functionality (to view, create or edit users, roles, participants, entries, votes, winners and statistics). Each user can also register by themselves (if enabled). The system has also already integrated the reset password functionality for users.
- **Participants**: Each visitor that participates in your prize game / sweepstakes.
- **Entries**: If the participant can participate multiple times in the prize game / contest then the participant is entered only once and for each participation an "entry" is created (because it does not make sense to always create a new participant for each time the visitor participates).
- **Votes**: In case you want the visitors to enable voting on the entries.
- **Winners**: You can hand pick the winning participants and entries which will then be shown on a separate page.
- **Statistics**: To have the complete overview of your application. You are able to see the participants, entries, votes and visits (if Piwik is enabled) by:
    - last 48 hours,
    - last 30 days,
    - browsers,
    - operating systems,
    - device types,
    - devices,
    - cities and
    - countries.
- **Settings**: Most of the settings can be edited via the administration.

Build status
------------

[](#build-status)

[![Build Status](https://camo.githubusercontent.com/16a2685570bfd30720ceef1128b311fe10591e1775ee8f28628858a7d19deac5/68747470733a2f2f7472617669732d63692e6f72672f626f62616c617a656b2f636f6e746573742d6f2d6d61742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/bobalazek/contest-o-mat)

Requirements &amp; Tools &amp; Helpers
--------------------------------------

[](#requirements--tools--helpers)

- PHP &gt; 5.4
- [Composer](https://getcomposer.org/)
- [Bower](http://bower.io/)
- [PHP Coding Standards Fixer](http://cs.sensiolabs.org/) (optional)

Setup / Installation
--------------------

[](#setup--installation)

- Navigate yor your web directory: `cd /var/www`
- Create a new project: `composer create-project bobalazek/contest-o-mat --no-scripts`
- Configure database (and maybe other stuff if you want): [app/configs/global.php](https://github.com/bobalazek/contest-o-mat/blob/master/app/configs/global.php#L47) or [app/configs/global-local.php.dist](https://github.com/bobalazek/contest-o-mat/blob/master/app/configs/global-local.php.dist) (in case you will deploy it and need a different local configuration. Just rename the global-local.php.dist to global-local.php and set your own configuration)
- After that, run the following commands:
    - `bin/console orm:schema-tool:update --force` (to install the database schema)
    - `bower update` (to install the front-end dependencies - you will need to install [Bower](http://bower.io/) first - if you haven't already)
    - `bin/console application:database:hydrate-data` (to hydrate some data, if you want)
- You are done! Start developing!

Database
--------

[](#database)

- We use the Doctrine database
- Navigate to your project directory: `cd /var/www/my-app`
- Check the entities: `bin/console orm:info` (optional)
- Update the schema: `bin/console orm:schema-tool:update --force`
- Database updated!

Development
-----------

[](#development)

Important files / directory you may want / need to edit when developing your application:

- Config: `app/configs/global.php` (just open the file and view it yourself. There are MANY settings you may want to tweak)
- Middlewares: `app/core/middlewares.php` (you may want to take a deeper look into the "User UID" part - line 115. and below)
- HTML Templates: `app/templates/contents/application/`
- Javascripts: `web/assets/javascripts/contest.js`
- Stylesheets: `web/assets/stylesheets/contest.css`
- Participate Form Type: `src/Application/Form/Type/Participate/DefaultType.php` (the form, which shows up at the participation)
- Application Controller: `src/Application/Controller/ApplicationController.php` (all the contest logic, handling and persistence goes here)
- Application Controller Provider: `src/Application/ControllerProvider/ApplicationControllerProvider.php` (the contest routes are here)

Application name
----------------

[](#application-name)

You should replace the name for your actual application inside the following files:

- `README.md`
- `bower.json`
- `composer.json`
- `phpunit.xml`
- `app/configs/global.php`

Administrator login
-------------------

[](#administrator-login)

With the `bin/console application:database:hydrate-data` command, you will, per default hydrate 2 users (which you can change inside the `app/fixtures/users.php` file):

- Admin User (with admin permissions)
    - Username: `admin` or `admin@myapp.com`
    - Password: `test`
- Test User (with the default user permissions)
    - Username: `test` or `test@myapp.com`
    - Password: `test`

Commands
--------

[](#commands)

- `bin/console application:environment:prepare` - Will create the global-local.php and development-local.php files (if they do not exist)
- `bin/console application:database:hydrate-data [-r|--remove-existing-data]` - Will hydrate the tables with some basic data, like: 2 users and 6 roles (the `--remove-existing-data` flag will truncate all tables before re-hydrating them)
- `bin/console application:storage:prepare` - Will prepare all the storage (var/) folders, like: cache, logs, sessions, etc.
- `bin/console application:translations:prepare` - Prepares all the untranslated string into a separate (app/locales/{locale}\_untranslated.yml) file. Accepts an locale argument (defaults to 'en\_US' - usage: `bin/console application:translations:prepare --locale de_DE` or `bin/console application:translations:prepare -l de_DE` )

Other commands
--------------

[](#other-commands)

- `sudo php-cs-fixer fix .` - if you want your code fixed before each commit. You will need to install [PHP Coding Standards Fixer](http://cs.sensiolabs.org/)

Preview
-------

[](#preview)

### Application - Index

[](#application---index)

[![Application - Index](doc/images/application-index.png)](doc/images/application-index.png)

### Application - Participate

[](#application---participate)

[![Application - Participate](doc/images/application-participate.png)](doc/images/application-participate.png)

### Members Area - Users

[](#members-area---users)

[![Members Area - Users](doc/images/members-area-users.png)](doc/images/members-area-users.png)

### Members Area - Entries

[](#members-area---entries)

[![Members Area - Entries](doc/images/members-area-entries.png)](doc/images/members-area-entries.png)

### Members Area - Participants

[](#members-area---participants)

[![Members Area - Participants](doc/images/members-area-participants.png)](doc/images/members-area-participants.png)

### Members Area - Participants - Metas Modal

[](#members-area---participants---metas-modal)

[![Members Area - Participants](doc/images/members-area-participants-metas-modal.png)](doc/images/members-area-participants-metas-modal.png)

### Members Area - Participants - Edit

[](#members-area---participants---edit)

[![Members Area - Participants - Edit](doc/images/members-area-participants-edit.png)](doc/images/members-area-participants-edit.png)

### Members Area - Votes

[](#members-area---votes)

[![Members Area - Votes](doc/images/members-area-votes.png)](doc/images/members-area-votes.png)

### Members Area - Winners

[](#members-area---winners)

[![Members Area - Winners](doc/images/members-area-winners.png)](doc/images/members-area-winners.png)

### Members Area - Statistics

[](#members-area---statistics)

[![Members Area - Statistics](doc/images/members-area-statistics.png)](doc/images/members-area-statistics.png)

### Members Area - Statistics (more)

[](#members-area---statistics-more)

[![Members Area - Statistics (more)](doc/images/members-area-statistics-2.png)](doc/images/members-area-statistics-2.png)

### Members Area - Statistics (more)

[](#members-area---statistics-more-1)

[![Members Area - Statistics (more)](doc/images/members-area-statistics-3.png)](doc/images/members-area-statistics-3.png)

### Members Area - Statistics - Visits

[](#members-area---statistics---visits)

[![Members Area - Statistics - Visits](doc/images/members-area-statistics-visits.png)](doc/images/members-area-statistics-visits.png)

### Members Area - Settings

[](#members-area---settings)

[![Members Area - Settings](doc/images/members-area-settings.png)](doc/images/members-area-settings.png)

### Contact

[](#contact)

[![Contact](doc/images/contact.png)](doc/images/contact.png)

Changelog
---------

[](#changelog)

### 1.0.0

[](#100)

- Complete refactor - the app is now based upon silex2
- Fixes big selects (entry &amp; participant data) - now loads the data asynchronously

License
-------

[](#license)

Contest-O-Mat is licensed under the MIT license.

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~26 days

Recently: every ~171 days

Total

29

Last Release

3210d ago

Major Versions

0.11.0 → 1.0.12017-09-19

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1904053?v=4)[Borut Balazek](/maintainers/bobalazek)[@bobalazek](https://github.com/bobalazek)

---

Top Contributors

[![bobalazek](https://avatars.githubusercontent.com/u/1904053?v=4)](https://github.com/bobalazek "bobalazek (213 commits)")

---

Tags

boilerplateboilerplate-templatecontestfacebookfacebook-api

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bobalazek-contest-o-mat/health.svg)

```
[![Health](https://phpackages.com/badges/bobalazek-contest-o-mat/health.svg)](https://phpackages.com/packages/bobalazek-contest-o-mat)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[contao/core-bundle

Contao Open Source CMS

1231.6M2.8k](/packages/contao-core-bundle)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k17.8k](/packages/prestashop-prestashop)[chameleon-system/chameleon-base

The Chameleon System core.

1028.6k5](/packages/chameleon-system-chameleon-base)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
