_   _         _  _    ______       _                    _
| \ | |       (_)| |   |  _  \     | |                  | |
|  \| | _   _  _ | |_  | | | | ___ | |__    ___   _   _ | |_
| . ` || | | || || __| | | | |/ _ \| '_ \  / _ \ | | | || __|
| |\  || |_| || || |_  | |/ /|  __/| |_) || (_) || |_| || |_
\_| \_/ \__,_||_| \__| |___/  \___||_.__/  \___/  \__,_| \__|

Ce dépôt contient le code source du site nuitdebout.fr, propulsé par Wordpress.

Contribuer

La plupart de choses à faire sur le site sont listées dans l'onglet Issues, nous nous efforçons de le tenir à jour.

Vous pouvez en rajouter si vous remarquez un bug, ou si vous avez une suggestion. Vous pouvez bien entendu soumettre directement une Pull Request

Afin de simplifier l'usage des Issues, nous nous appuyons sur ZenHub, une extension Chrome/Firefox qui ajoute des fonctionnalités à l'interface de Github, dont notamment un Kanban.

Description rapide du workflow :

• Les tâches dans la liste Backlog sont en cours de discussion
• Les tâches dans la liste Todo sont prêtes à être traitées
• Si vous commencez une tâche, assignez-vous la tâche, et déplacez-la dans la liste In Progress
• Lorsque vous estimez que la tâche est terminée, créez une Pull Request : une fois la Pull Request validée, la tâche est déplacée dans la liste Done

Si vous ne disposez pas des droits nécessaire pour déplacer les issues, mentionnez simplement l'un des développeurs, ou venez sur le chat.

Environnement de développement

Le projet est fourni avec une machine virtuelle afin de pouvoir faire tourner le site sur sa machine.

Compte administrateur

Identifiant ou adresse de messagerie : admin Mot de passe : urWnshZ)f0xYJCbPJ9

Avec Vagrant

• Installer VirtualBox & Vagrant
• Installer Ansible via les Instruction d'installation.
• Installer le plugin vagrant-hosts

Ensuite il n'y a plus qu'a lancer la machine. Elle devrait installer wordpress et importer les données.

    vagrant up

• Ajouter la ligne suivante au fichier /etc/hosts

    192.168.31.3 nuitdebout.dev

• Aller sur http://nuitdebout.dev.

Utilisateur Windows

Sur windows, le nfs n'est pas supporté. Pour corriger le problème, ajoutez la variable d'Environnement

VM_NFS="false"

Vous aurait peut-être besoin d'installer un plugin pour vagrant

vagrant plugin install vagrant-vbguest

Installation sans machine virtuelle.

Si vous preferez faire tourner le site directement sur votre machine locale, vous allez devoir télécharger wordpress. Utilisez le fichier de configuration wp-config.php.

Vous pouvez vous aidez de wordpress cli.

cd /var/www
wp core download --locale=fr_FR
cp PATH_TO_THE_REPO/wp-config.php wp-config.php

Ensuite vous devez créer une base de donnée nuidebout et importer le fichier sql.

cd -
mysql --user={{database.user}} --password={{database.password}} nuidebout < sql/nuitdebout.sql

Pour ajouter le theme, vous pouvez faire un lien symbolique vers le dossier ./theme.

ln -s theme/ /var/www/wp-content/themes/nuidebout
cd /var/www
wp theme enable nuitdebout --network --activate

Il faut ensuite installer les différents plugins. La liste est dans ansible/site.yml.

Enfin vous devez configurer votre serveur web. Si vous avez apache, vous pouvez récupérer un .htaccess ici. Si vous avez nginx, vous pouvez vous inspirer de ceux dans ./ansible/roles/nginx/templates.

Développement

Compilation du thème

Le thème est installé dans ./theme. Il utilise Sass, Gulp, Bower et Composer.

cd theme
npm install -g gulp bower
npm install
bower install
composer install

Les fichiers source se trouvent dans theme/assets Les fichiers compilés se trouvent dans theme/dist Pour recompiler les assets à chaque modification de fichier, lancer la tâche watch :

gulp watch

Ajout d'un plugin

Pour ajouter un plugin, il faut le mettre à la fin de la liste située dans ./ansible/site.yml.

Pour lancer l'installation, le plus safe est reprovisionner la machine :

vagrant provision

Si vous aimez vivre dangereusement, vous pouvez lancer

vagrant ssh -c "wp plugin install nom_du_plugin --activate-network --activate --path=/var/www"