Dans tout projet, et en particulier la v5, il faut configurer :
- l'environnement système (base de donnée, serveur web)
- l'environnement applicatif (ressources utilisées, liste des objets par défaut)
Le master script permet de faciliter la configuration du deuxième point, l'environnement applicatif. En particulier, il est capable de :
- créer l'arborescence du forum
- créer les trophées et titres
- créer les utilisateurs par défaut
- ajouter un utilisateur à un groupe
- etc.
L'utilisation du master script ne peut se faire qu'après avoir configuré l'environnement système. Cf 01 Installation de environnement nonginx ou 02 Installation de environnement nginx.
À la racine du projet se trouve un fichier appelé master.py. Vous pouvez le rendre exécutable, ou bien le lancer via
$ python master.py
This is the Planète Casio master shell. Type 'exit' or C-D to leave.
Type 'help' to print this message.
Listing commands:
members Show registered community members
groups Show privilege groups
forums Show forum tree
trophies Show trophies
Install and update commands:
update-groups Create or update groups from app/data/
update-forums Create or update the forum tree from app/data/
update-trophies Create or update trophies
generate-trophy-icons Regenerate all trophy icons
create-common-accounts Remove and recreate 'Planète Casio' and 'GLaDOS'
add-group <member> #<id> Add <member> to group #<id> (presumably admins)
enable-user <member> Manually confirm member's email address
@>
Les actions disponibles sont listées dans l'aide d'accueil.
Pour initialiser la v5 la première fois, il vous faudra exécuter ces commandes :
@> update-groups
@> update-forums
@> update-trophies
@> generate-trophy-icons
@> create-common-accounts
Vous pouvez alors créer un compte (nommé ici Démo, mais tout pseudo fera l'affaire) via l'interface web de la v5, puis, grâce au master script, l'ajouter au groupe administrateur. Si vous n'avez pas désactivé l'envoi des mails dans la configuration, vous pouvez aussi activer le compte manuellement.
@> add-group Démo #1
@> enable-user Démo
La v5 est maintenant prête à être utilisée 😉