/netrunnerdb

A Deckbuilder for Android:Netrunner LCG

Primary LanguagePHPMIT LicenseMIT

This repository holds the source code of NetrunnerDB.

This is not where the cards data is

The data used by NetrunnerDB is at https://github.com/NetrunnerDB/netrunner-cards-json. If you want to fix a mistake in some card data, or add the data of a new card, you can submit a PR there. Also, that's where the localized data is.

Installing a local copy of NetrunnerDB

Prerequisite

  • you need a recent apache/php/mysql stack
  • your php module must be configured with mbstring.internal_encoding = UTF-8

How to install

  • Go into the directory where your server will reside
  • Clone the repository (or your own fork)
  • This creates a directory named netrunnerdb
  • Also, clone the data repository (or your own fork) at https://github.com/NetrunnerDB/netrunner-cards-json
  • Go into it the directory netrunnerdb
  • Install Composer (see https://getcomposer.org/download/)
  • Install the vendor libs: composer install. You'll be asked to input your database connection parameter.
  • Create the database: php bin/console doctrine:database:create
  • If the above command fails, edit app/config/parameters.yml and try again
  • Create the tables: php bin/console doctrine:schema:update --force
  • Import all the data from the data repository: php bin/console app:import:std -f path_to_json_repository
  • Configure your web server with the correct DocumentRoot. Alternatively, use PHP's built-in Web Server. Set your DocumentRoot to netrunnerdb/web
  • Point your browser to /app_dev.php

How to add card images

  • Put the card images in web/card_image/ (web/card_image/01001.png, etc.)

How to update

When you update your repository (git pull), run the following commands:

  • composer self-update
  • composer install (do not run composer update)
  • php bin/console doctrine:schema:update --force
  • php bin/console app:import:std path_to_json_repository

Deck of the Week

To update the deck of the week on the front page:

  • php bin/console app:highlight decklist_id

where decklist_id is the numeric id of the deck you want to highlight.

Update log

If you want to show site updates on the home page, copy web/update_log.example.txt to web/update_log.txt and copy the format with your own data. The update log shows dates, each with a list of updates. The update log should be kept fairly concise, with only information that is relevant to users of the website, not developers.

Setup an admin account

  • register
  • make sure your account is enabled (or run php bin/console fos:user:activate <username>)
  • run php bin/console fos:user:promote --super <username>

Add or edit cards

  • update the json data
  • run php bin/console app:import:json path_to_json_repository