Modification de Outils/Numerique/Nuitdebout.fr(site officiel)/Documentation Technique

Le site web nuitdebout.fr est propulsé par Wordpress. 

Il est configuré en mode multi-sites afin de fournir de l'infrastructure à ceux qui en ont besoin. 

== Introduction ==

Le code source du site est hébergé sur Github. 

Deux machines virtuelles (Vagrant et Docker) sont fournies avec le projet afin de permettre aux développeurs de travailler sur leur propre machine. 

Le thème du site utilise le framework de thème Roots/Sage. 

== Page d'accueil ==

Le thème étant partagé entre le site principal et les multi-sites, l'affichage est quelque peu différent selon le contexte (site principal ou multi-site). 

Sur le '''site principal''', la page d'accueil est configurée pour afficher une page statique, mais l'affichage est de toutes façons "hardcodé" 

Sur un '''multi-site''', le choix est laissé libre à l'administrateur d'afficher [https://codex.wordpress.org/Creating_a_Static_Front_Page une page statique] ou les derniers articles ajoutés.

=== Affichage des actions en page d'accueil ===

La page d'accueil permet d'afficher et de mettre en avant des actions de l'agenda. Techniquement, les actions tagguées ''featured events'' par un modérateur sur Open Aganda s'affichent dans ce bandeau.

[[Fichier:Nuitdebout.fr accueil bandeau actions.png|640px]]

=== Affichage des articles en page d'accueil ===

La page d'accueil permet d'afficher et de mettre en avant des articles. 

Pour plus de détails, voir l'implémentation dans le fichier [https://github.com/nuitdebout/wordpress/blob/master/theme/templates/module-news.php theme/templates/module-news.php]

[[Fichier:Nuitdebout.fr accueil a la une.png|640px]]

==== Affichage des articles "À la une" et "Important" ====

Les '''deux premiers articles''' mis en avant sont gérés via des categories : 
* le dernier article placé dans la catégorie "À la une" apparaîtra en première position
* le dernier article placé dans la catégorie "Important" apparaîtra en seconde position 

Pour un affichage optimal, ils doivent forcément avoir une [https://codex.wordpress.org/Post_Thumbnails image à la une]. 

==== Affichage des articles mis en avant sur la page d'accueil ====

Tous les autres articles avec l'option "Mettre cet article en avant sur la page d’accueil" activée seront affichés à la suite, par ordre décroissant de publication. (https://codex.wordpress.org/Sticky_Posts)

[[Fichier:Nuitdebout.fr mettre a la une.png]]

=== Curation de contenus via PressForward ===

Le plugin Wordpress [http://pressforward.org/ PressForward] est installé afin de simplifier la sélection des articles à relayer via les multiples sources d'information en ligne (presse traditionnelle, presse alternative, agenda miliatant, etc...)

Ce plugin permet simplement d'agréger les dernières parutions via les flux RSS, et de les sélectionner de manières collaborative : chaque administrateur/contributeur du site ayant accès au plugin PressForward peut "voter" pour qu'un lien soit nominé pour être relayé. 

==== Ajouter un flux RSS comme source de contenu ====

[https://github.com/PressForward/pressforward/wiki/User-Manual#subscribe-to-rssatom-feeds Documentation sur le Wiki de PressForward]

Dans la section '''PressForward > Subscribed feeds''' sont listés tous les flux RSS actuellement utilisés, c'est ici que vous pouvez ajouter, supprimer ou modifier un flux RSS. 

Lorsque vous ajoutez un flux, n'oubliez pas de l'éditer afin de le ranger dans une catégorie. 

==== Nominer un article à relayer ====

[https://github.com/PressForward/pressforward/wiki/User-Manual#using-the-all-content-page-how-to-read-nominate-and-add-comments-to-items Documentation sur le Wiki de PressForward]

Dans la section '''PressForward > All content''' apparaissent les derniers articles récupérés depuis les flux RSS. 

Si vous jugez qu'un article est intéressant à relayer, il suffit d'appuyer sur le signe "Play", qui va se colorer en vert. 

Ci-dessous l'article "Le capitalisme, marqueur géologique ?" du Monde Diplomatique est "nominé". 

[[Fichier:Nuitdebout.fr PressForward AllContent.png|796px]]

Attention, à ce stade l'article n'a pas encore été relayé, il passe seulement dans la zone des articles "nominés" : il faut encore aspirer le contenu de l'article et le publier. 

==== Publier un article nominé ====

[https://github.com/PressForward/pressforward/wiki/User-Manual#using-the-nominated-page-how-to-review-select-and-publish-nominations Documentation sur le Wiki de PressForward]

Dans la section '''PressForward > Nominated''' apparaissent tous les articles qui ont été nominés par les administrateurs. 
Le nombre de "votes" apparait à côté du signe "Play" et permet de voir les articles faisant le plus consensus. 

Lorsqu'il est décidé qu'un article doit être relayé, il suffit d'appuyer sur le bouton "Avance rapide" : cela a pour effet d'aspirer le contenu de l'article depuis le site original et de '''créer un article en mode brouillon'''. 
L'article n'est pas publié immédiatement, ce qui permet de le mettre en forme (parfois l'aspiration de l'article n'est pas optimale), d'ajuster le titre, l'URL de l'article, d'ajouter une image à la une, etc...

Une fois que l'article est satisfaisant, il est prêt à être publié.

== Gestion des villes ==

Un peu d'historique : la version précédente du site étant statique (pas de base de données), il fallait trouver un système pour alimenter le site. 

Dans la première version, les pages pour chaque ville ont donc été générées à partir des données du Wiki : un robot aspirait les pages du Wiki de chaque ville et créait des pages HTML avec les informations. 

Lors du passage au site dynamique, les pages ville ont été conservées. 

=== Stockage des métadonnées pour chaque ville ===

Chaque ville est stockée dans une page Wordpress ayant un modèle de page dédié, page-ville.php. 

Grâce au métadonnées de posts (augmentées via ACF), chaque page ville permet de spécifier les champs suivants : 
* Nom de la ville
* Lieu et heure de rassemblement
* Site web officiel
* Page Facebook officielle
* Compte Twitter officiel
* Position géographique
@@ Ligne 9 : / Ligne 9 : @@
 Deux machines virtuelles (Vagrant et Docker) sont fournies avec le projet afin de permettre aux développeurs de travailler sur leur propre machine.
 Le thème du site utilise le framework de thème Roots/Sage.
-Le site est en ''cours de construction''. Pour le moment, seulement une V0 de la page d'accueil est en ligne. D'autres pages doivent voir le jour (regroupées en 3 rubriques [https://github.com/nuitdebout/wordpress/issues/156 Découvrir / Participer / S'informer])
 == Page d'accueil ==
@@ Ligne 24 : / Ligne 21 : @@
 === Affichage des actions en page d'accueil ===
-La page d'accueil permet d'afficher et de mettre en avant des actions de l'agenda.
+La page d'accueil permet d'afficher et de mettre en avant des actions de l'agenda. Techniquement, les actions tagguées ''featured events'' par un modérateur sur Open Aganda s'affichent dans ce bandeau.
-Techniquement, les actions tagguées ''featured events'' par un modérateur sur [//openagenda.com/nuitdebout Open Agenda] s'affichent dans ce bandeau.
 [[Fichier:Nuitdebout.fr accueil bandeau actions.png|640px]]
@@ Ligne 44 : / Ligne 39 : @@
 * le dernier article placé dans la catégorie "Important" apparaîtra en seconde position
 Pour un affichage optimal, ils doivent forcément avoir une [https://codex.wordpress.org/Post_Thumbnails image à la une].
-Afin qu'ils n'apparaissent pas en double sur la page d'accueil, n'ajoutez pas les catégories suivantes : Actions, Nuit debout en France, Analyses.
 ==== Affichage des articles mis en avant sur la page d'accueil ====
 Tous les autres articles avec l'option "Mettre cet article en avant sur la page d’accueil" activée seront affichés à la suite, par ordre décroissant de publication. (https://codex.wordpress.org/Sticky_Posts)
-Les illustrations doivent être au format 4x3.
-Afin qu'ils n'apparaissent pas en double sur la page d'accueil, n'ajoutez pas les catégories suivantes : Actions, Nuit debout en France, Analyses.
 [[Fichier:Nuitdebout.fr mettre a la une.png]]
-==== Affichage des articles dans 3 catégories ====
-Les articles des catégories suivantes (Actions, Nuit debout en France, Analyses) sont mis en avant en étant listés automatiquement en page d'accueil.
-[[Fichier:Nuitdebout.fr 3 catégories.jpg|640px]]
 === Curation de contenus via PressForward ===
@@ Ligne 103 : / Ligne 86 : @@
 Une fois que l'article est satisfaisant, il est prêt à être publié.
-=== Contact ===
-Venez discuter du contenu éditorial de la page d'accueil sur le tchat.
-<div style="background-color:#f6f6f6; padding:10px 30px 30px 30px;">
-<br/>
-<div class="plainlinks" style="text-align:center;">[https://chat.nuitdebout.fr/channel/edito-nuitdebout.fr {{Bouton cliquable|Contactez-nous sur le tchat chat.nuitdebout.fr}}]</div>
-</div>
 == Gestion des villes ==
@@ Ligne 134 : / Ligne 106 : @@
 * Compte Twitter officiel
 * Position géographique
-== Astuces ==
-=== Centrer un tweet ===
-<pre>
-<blockquote class="twitter-tweet tw-align-center">
-</pre>
-=== Centrer une vidéo Youtube ===
-<pre>
-<div style="text-align:center">
-...
-</div>
-</pre>