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