Le thème doculab est une boite à outil à destination de tout lieu contributif à la recherche d'une solution de documentation relativement accessible à tous.
##Démarche initiale
Pour commencer quelques éléments de contexte concernant le développement de cet outil. Il a été mis en place au FacLab en remplacement du wiki. L'idée était de permettre une prise en main plus simple de la plateforme de contribution avec une plus grande place offerte aux images et à a mise en page.
Il est important de noter que la version proposée ici est loin d'être optimale, mais dans l'idée, il s'agit surtout de partager la solution mise en place.
##Prérequis ###Installer Wordpress Ce thème est associé à une installation wordpress. Il est conseillé de partir sur une installation propre (je n'ai pas testé à partir d'un installation pré-existante). Pour installer Wordpress merci de se référer à la documentation officielle : https://fr.wordpress.org/txt-install
###Installer le thème "Gridz"
Le thème "Doculab" est un thème enfant du thème "Gridz", il ne vous sera pas possible de l'installer sans que ce thème ne soit présent sur le système. Installer des thèmes avec Wordpress : https://www.codeur.com/cms/aide/installer-theme-wordpress/ Télécharger le thème "gridz" : https://wordpress.org/themes/gridz/ A noter que le thème est pre-packagé dans le thème doculab :
/dependencies/gridz.1.0.5.zip
##Installation du thème "Doculab"
###Télécharger & activer le thème : Récupérer le thème : https://github.com/cloeduc/doculab Vous pouvez au choix récupérer l'archive du thème ou, pour faciliter la mise à jour, configurer directement le dépot git dans le dossier :
wp-content/themes/
Qui doit, à priori, déjà contenir les thèmes suivants :
wp-content/themes/twentyfifteen
wp-content/themes/twentyfourteen
wp-content/themes/twentythirteen
wp-content/themes/gridz
Se rendre dans l'interface de gestion wordpress pour activer le thème
Apparences > Thèmes > Doculab
Voila, le thème est activé : nous verrons par la suite comment configurer le thème.
Un certain nombre de plugins "requis" pour que le thème fonctionne au mieu. Pour les activer, suivre la procédure suivante :
Se rendre sur l'inspecteur de dépendance qui a été activé en même temps que le plugin (vous devez avoir une belle notice en haut de votre espace d'administration qui vous indique que plein de choses sont en attente d'être installé) :
This theme requires the following plugins[...] Sizes, Sweet Custom Dashboard, WP User Avatar and iThemes Security.
This theme recommends the following plugins: Advanced Custom Fields: Date and Time Picker, Confirm User Registration, Random Post Widget, Simple Custom Post Types, TinyMCE Advanced, User Role Editor, WP Password Generator, WP-DBManager and Wp Lightbox Bank Standard Edition.
Ces plugins sont soient requis, soit très conseillés pour que le système fonctionne de façon optimal :
Apparence > Installer les plugins
Installer ensuite chaque plugin souhaité en cliquant sur "Install" (au survol du plugin). Penser à activer les plugins une fois ceux ci installés.
Les plugins CD-tools sont des petites compositions thématiques composées de divers "hacks" connus de Wordpress.
Créer une formulaire de connexion, d'inscription et de récupération de mots de passe, puis l'affiche dans le menu principal du site.
Permet de gérer des petites astuces pour cachers certaines partie de l'administration aux utilisateurs (ce qui facilite la lecture de l'interface de contribution)
Bon format des permaliens, création du role "Fabuser", autorisation des inscriptions... etc.
Le choix a été fait d'utiliser le plugin "pro" qui nécessite l'achat d'une licence et étends les fonctionnalités du plugin gratuit. Ce plugin premium est indispensable au bon fonctionnement du système. http://www.advancedcustomfields.com/
Syncronisation d'ACF Pro : ACF rajoute des champs supplémentaires très variés à l'interface wordpress basique. Cette configuration est inclue dans les dépendances du thème "doculab" mais doit passer par une option de synchronisation pour être éditable sur une nouvelle instance. Pour cela se rendre sur la gestion du plugin ACF. Un onglet "Sync Available" est disponible dans l'interface. Il suffit de synchroniser chaque configuration souhaitée. http://www.advancedcustomfields.com/blog/acf-pro-v5-1-5-update/ A noter que le fait de ne pas effectuer cette synchronisation n'empêchera pas l'interface de s'ajuster.
Ce plugin indispensable permet de sécuriser son installation Wordpress à l'aide de trucs et astuces plus ou moins poussés. Il dispose d'un outil d'analyse de sécurité de l'installation poussé. Lors de la première visite sur le plugin activé, il vous est proposé un certain nombre d'actions. Il est plus que conseillé d'effectuer un "One-Click Secure"
##Configuration du thème Une fois chaque plugins installés, il faut ensuite passer par la configuration de la plateforme.
Le thème est configuré pour fonctionner au mieux en mode "sidebar-right". Pour configurer le thème :
Apparence > Theme Option
Vous pouvez ici choisir les couleurs et logos qui s'afficheront en en-tête du site. Mais il est aussi possible de changer le mode d'affichage du site, et c'est ce qui va nous intéresser. Le thème "DocuLab" n'a été conçu (mal codé, plus exactement) que pour ne fonctionner sous une seule configuration d'affichage de son thème parent. C'est un point à améliorer, bien évidement.
Doculab Theme Option :
Fonts & Colors : A votre convenance
Logo et favicon : A votre convenance
Homepage
Number of grid columns : 3
Show sidebar along with masonry : check
Post Settings
Sidebar Layout : right (première miniature)
Show Categories : check
Show Tags : uncheck
Show Post Navigation : check
De base le thème créer un "main-menu" qui va afficher le bouton de connexion (ne pas y toucher) et le lien vers la page "comment contribuer". Vous pouvez éditer et améliorer ce menu dans :
Apparence > Theme Menus
Il est également conseillé de créer de nouveaux menus qui permettrons de configurer la navigation de la plateforme via les sidebars (voir le point suivant)
Pour plus d'information sur les menus : http://codex.wordpress.org/WordPress_Menu_User_Guide
La seule sidebar utilisée à bon escient dans le thème doculab (en développement, encore une fois) est la "Primary SideBar". C'est avec elle que l'on va venir configurer la navigation interne de la plateforme.
Plus d'information se les sidebars : http://codex.wordpress.org/Appearance_Widgets_Screen
En l'occurence, sur le site doc.faclab.org, nous avons ajouté :
La barre de recherche (widget "Chercher") Deux menus personnalisés (Widget "Menu personnalisé" associé à deux menus (cf ci dessus)) Le widget "Random Post" qui permet de remonter automatiquement certaines ressources au hasard de la plateforme.
C'est à vous de configurer et de décider de la façon dont vous souhaitez configurer ces menus.