Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Sportacus Scheduler

System for scheduling referees for soccer games.

Our vision is for Sportacus to be an online sports resource scheduler. It will be designed to help our users schedule games, practices, field maintenance, volunteers, referees and more! Perhaps even automatically schedule resources and assign people as needed, if availability and conflict information is provided accurately.

Write now it is a referee schedule system.

  • It detects conflicts as schedules are imported or changed.
  • It sends reminder emails and texts to users for games.
  • It also sends alerts when a game is moved or changed.
  • It supports multiple region play.
  • It has somewhat configurable referee positions.
  • It automatically calculates referee points and allows referees to assign themselves to teams. is provided as a free service for AYSO Area 5C and surrounding areas. was originally written by John Price with ideas and contributions from Art Hundiak (author of zAYSO).

As of 2020, John was the Regional Commissioner of AYSO Region 894 (Harvest, Alabama USA), Area Referee Administrator and Area Scheduler for AYSO Area 5C. He has volunteered for AYSO since 2012.

As of 2020, Art is currently the Assistant Referee Administrator of AYSO Section 5 and volunteered in many areas for Area 5C and Region 894 since at least 2000.

Install for development

You will need to get apache2, php and mysql configured and running on your server. This is left as an exercise for the reader. :)

  1. Make sure you have git, apache2, mysql, PHP, and composer installed and the following PHP extensions: php-xml, php-mysql, php-dom, php-gd

  2. Setup git if you have never done so:

    # git config --global "Your Name"
    # git config --global
    # git config --global push.default simple
  3. Create directory for project and make it the current directory. It is assumed this directory is the current directory for the rest of these instructions.

    # mkdir sportacus
    # cd sportacus
  4. Run

    # git clone .
  5. Create a database and import data (change dbname, dbuser, dbpass to your own values):

    # sudo mysql -p
    mysql> create database db;
    mysql> grant all on dbname.* to 'dbuser'@'localhost' identified by 'dbpass';
  6. Run composer. If there are errors, address them (usually missing packages). You should be able to use the defaults for most of the parameters, but be sure to enter your own database info that you used when creating your database above. You should set "httpProtocol" to "http" if you don't have https setup.

    # composer install
  7. Make sure all files are readable by all (or at least your web server).

  8. create var/cache & var/logs and make them writeable and readable by your web server.

    # mkdir -p var/cache var/logs
    # chmod a+rw var/cache var/logs
  9. Run the following to build bootstrap.php.cache.

    # php ./vendor/sensio/distribution-bundle/Resources/bin/build_bootstrap.php
  10. Create a clean database

    # bin/console doctrine:schema:create

    or, import data from another working site (this command will prompt you for the dbpass)

    # mysql --user=dbuser --password dbname < database-backup.sql
  11. Copy and edit the remaining dist files to your own config files (composer should have already copied app/config/parameters.yml.dist to app/config/parameters.yml):

    # cp
    # cp src/Scheduler/SchBundle/Scripts/parameters.php.dist src/Scheduler/SchBundle/Scripts/parameters.php
  12. Point your browser at web/app_dev.php. For production environment, configure your server to map the root of the webpage to web/app.php.

  13. Register an admin user on the webpage and then promote that user to admin:

    # bin/console fos:user:promote admin ROLE_ADMIN

You should have a working copy by now. Look at var/log/[dev|prod].log to get hints when you have issues.

To push changes to the repo, fork the project, make your changes, then create a pull request.


AYSO Soccer Referee Scheduling System







No packages published