ZeeJong is an online betting system for football matches.
Switch branches/tags
Nothing to show
Clone or download
Latest commit d98bee1 Jan 28, 2016

readme.md

ZeeJong - Soccer Betting System

ZeeJong Logo

About

ZeeJong is an online betting system for football matches.
The web app is designed to collect and display all relevant information about any match in the world of soccer and lets users place bets on upcoming events.

Unregistered visitors have access to a large archive of competitions, seasons, matches, players, coaches and referees.
On the match page, an overview of the match is given. Visitors can see the date, final score, referees and players. Both goals and cards are also shown on the match page.
Players, referees, coaches and teams are displayed with their information. Visitors can also view graphs containing the stats of them.

Registered users have the ability to place bets on upcoming events. Those bets can be done individually, but can also be done in groups.
Users who created groups can invite other users in them, bet against each other, and use the online chatbox on the group page.

Installation

###Requirements###

  • PHP 5.5 or newer
  • PDO for mysqli
  • Apache mod_rewrite support
  • (Depending on the size of the import data, your server may need a lot of RAM)

###Uploading### In order to have a website you must upload the zeejong folder to your webserver. But the file/folder permissions on your server are more important!

  • First of all, your webserver must have the permission to access the files.
  • In order to store the chatbox content, Apache must have write access to the core/php-chatbox/ directory
  • When running the parser, the user running the parser must have write (and of course read) access to the core/cache/ and images/ directories.
  • With an automatic installation, ZeeJong must have write access to the root folder, for creating the config file.
  • To avoid people taking down your server with DDOS attacks, you shouldn't make your webserver able to run the core/parser.php and core/mailer.php.

###Installer### In order to install ZeeJong you must navigate to the installation directory with your browser.
Navigate to http://yourdomain.com/install/ and fill in all fields. The script will create the database tables and will generate a config file.
The installer must be ran on an empty database, otherwise errors will occur.

You can also install preloaded data. We provide a JSON file containing an archive of competitions.
The preloaded data is provided in a JSON file, but you can also retrieve the archive yourself, by running the ZeeJong Parser tool.

ZeeJong Parser is a tool, written in GO, which collects and builds a database containing an archive of soccer information.

In order to install this, you must run http://yourdomain.com/core/importer.php. This may take some time.
Do this after the installation. You need empty tables in your database.

###Maintenance### To find and update new matches, you have to run the parser, located at /core/parser.php. This script isn't meant for running in the browser, but directly through the command line (or even better, with a cronjob). Doing this with a cron job every night ensures that your data stays up to date and that bets are processed fully automatically on a daily basis.

Another script that needs to be ran, is the core/mailer.php script. This will keep users informed about upcoming events.

Authors

  • Mathias Beke
  • Timo Truyts
  • Alexander Vanhulle
  • Bruno Van de Velde
  • Elias Van Langenhove

Acknowledgements


This project was a university assignment for the course Programming Project Database. We are not actively developing this anymore and it will be, without doubt, full of bugs.
Feel free to take inspiration for this project, and even use this. But don't expect this to work flawlessly for professional use. (You may always send pull request when you fix something, but we won't fix things for you.)

Also note that crawling data from the sites, using our parser, is stealing the hard work of the organizations that filled those databases.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.