Cette page permet de recenser tous les paramétrages et développements spécifiques réalisés sur le Wiki.

L'objectif est de pouvoir accélérer ou reproduire les paramétrages (par exemple à l'issu d'une migration ou lors de la création d'un nouveau Wiki qui devrait reprendre les mêmes paramétrages).

Voir ce qu'il reste à faire.

Personnaliser la traduction

• Accès à la page custom contenant les traductions personnalisées.  Il faut modifier la page en mode Source et non WYSIWIG. Note : cette page était initialement stockée dans Main pour éviter les problèmes de caractère "espace" dans le nom de l'espace / de la page, finalement elle a été déplacée dans un espace dédié aux personnalisations de XWiki, espace qui respecte ces contraintes de nommage.
• Cette page doit être déclarée dans l'admin du Wiki (= nom de page personnalisable) : Contenu > Localisation, zone en bas. Saisir le page sous la forme ESPACE.PAGE
• La dernière version "officielle" des fichiers de traduction de XWiki est ici (utiliser le fichier _fr pour retrouver le nom des clefs de trad à partir des libellés affichés dans XWiki) : https://github.com/xwiki/xwiki-platform/tree/master/xwiki-platform-core/xwiki-platform-oldcore/src/main/resources
• Aide officielle : https://network.xwiki.com/xwiki/bin/view/DocXE41Fr/EditerPreferencesLocalisation#HC9criredesapplicationsXWikiinternationalisE9es

Configurer le Wiki

Se connecter en admin (xrichard) puis :

Paramétrer le format date - heure

• Dans le Configuration du Wiki > Localisation > FORMAT DES DATES indiquer :
  dd/MM/yyyy HH:mm

Désactiver les suggestions de recherche

• Modifier l'option dans http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=searchSuggest

Désactiver les Annotations

• Editer la section "Annotation" dans la configuration du Wiki http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Annotations

Personnaliser le texte de la barre titre du navigateur Web

• http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Elements&space=XWiki
• dans la zone "Titre", indiquer le code :
  $tdoc.getRenderedTitle("plain/1.0") - Les tutos de Toto - XWiki

Personnaliser le pied de page

• Objectifs : logo "Powered By XWiki" + indication de la version XWiki utilisée (présente en standard) + lien d'envoi d'un mail + licence Creative Common pour ré-utiliser le contenu XRI ; le tout en limitant la hauteur / place occupée
• Allez sur la page d'admin http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Presentation&space=XWiki puis dans la section "Pied de page"
  • /!\ Attention : la taille (nombre de caractères) de ces champ est réduit en BDD
  • dans la zone 1 "Copyright", indiquez le code :
    <a title="xwiki.org" target="_blank" href="http://www.xwiki.org"><img src="http://www.ip-m.com/skins/toucanet/xwiki-powered.png"></a> <b>version $xwiki.getVersion()</b> - <a href="mailto:<ldmpub@gmail.com>?subject=Les Tutos de Toto">Contactez-moi</a>
  • dans la zone 2 "Version", indiquez le code :
    Vous pouvez ré-utiliser le contenu de ce site : <a title="Creative Commons BY-NC" target="_blank" href="https://creativecommons.org/licenses/by-nc/4.0/deed.fr"><img src="https://i.creativecommons.org/l/by-nc/4.0/80x15.png"></a>

Ajouter un Favicon

• Suivre pas à pas le paragraphe "For the Flamingo skin"de l'article de la FAQ sur le sujet. En bref :
  • Allez sur la page skin du Wiki http://tutos.myxwiki.org/xwiki/bin/view/XWiki/DefaultSkin#Attachments
  • et ajoutez en pièce jointe les 4 images qui sont regroupées dans le fichier zip joint (en fait il s'agit de 4 fois la même image favicon mais avec les noms et extensions précisés dans l'article de FAQ => un renommage du même fichier fait parfaitement illusion  ).

Filtrer la panneau / panel "Recently Modified" / "Dernières modifications"

Ajouter une condition supplémentaire dans le code (syntaxe velocity) pour n'afficher que les "vrais" articles de contenu c'est-à-dire ceux de l'espace "Tutos" (et ignorer l'affichage dans ce panneau,  par exemple, des dernières pages d'admin modifiées) :
#if ( $rdoc.getSpace().contains("tutos") )

Configurer la barre d'outils de l'éditeur WYSIWYG

Dans l'éditeur WYSIWYG : ajouter les options d'alignement d'un paragraphe (à gauche, centré, à droite), les mises en formes utiles (style TT, couleur du texte, effacer la mise en forme), supprimer les éléments inutiles (indice, exposant...).

Cette personnalisation est possible dans l'administration du Wiki (les options complètes figurent sur cette page) :

• Aller dans l'Administration du Wiki, partie Editeur WYSIWYG
• Ajouter les plugins color et justify
• Puis ajouter les éléments à la barre d'outils pour obtenir le résultat ci-dessous :
  
• Tester l'éditeur WYSIWYG en modifiant une page du Wiki, vous devez obtenir le résultat suivant :
  

Modifier le profil de l'administrateur

Connectez vous en tant qu'admin, allez dans Profil > Preferences puis

• activer Display hidden documents = Yes
• définir User type = Advanced

Créer l'utilisateur "principal" Toto

Créer un utilisateur "Toto" qui sera l'auteur de tous les articles  et lui donner les droits pour qu'il puisse faire l'import du XAR venant de l'ancien Wiki (ie articles importés sous son nom).

Autoriser les utilisateurs Anonymes à poster des commentaires

Afin d'autoriser les utilisateurs Anonymes (non enregistrés) à poster des commentaires avec Captcha, il faut réaliser 2 opérations dans l'administration du Wiki > Droits d'accès :

• Basculez en mode d'affichage "Utilisateurs" puis sur la ligne "Utilisateurs non enregistrés" cochez (c'est-à-dire mettre une coche verte) la colonne "Commenter"
• Enfin sous cette grille, cochez l'option "Force un utilisateur non enregistré à renseigner un captcha lors de l'ajout d'un commentaire sur une page".

Illustration des opérations à réaliser :

Personnalisation des écrans

Mettre en place une redirection sur la page d'accueil (pour anonyme)

Voir l'article dédié.

Définir la page d'accueil du Wiki

Afin que lors d'un clic sur l'icône présent en haut à gauche du header, l'utilisateur arrive sur la page d'accueil public du Wiki :

• créer une page Redirect contenant un code velocity de redirection, type :
  $response.sendRedirect("http://xxx")
• puis dans Administration > Wikis > Description > Page d'accueil, indiquer cette page par : Les_tutos_de_Toto.Redirect

Simplifier les résultats de recherche

Pour la recherche Solr

Modifiez la page http://tutos.myxwiki.org/xwiki/bin/edit/Main/SolrSearchMacros?editor=wiki. L'idée est de simplifier les pages des résultats de recherche soit en commentant soit en supprimant les éléments pour obtenir les éléments suivants :

Auteur et Date de dernière modification

• rechercher les lignes qui affichent l'auteur et la date de modification de chaque résultat (info n'ayant aucune valeur ajoutée), au 28/10/2018, les lignes supprimées sont :

Lister tous les résultats (sans pagination)

• pour avoir tous les résultats sur la même page passez la valeur à 200 (chiffre supérieur au nombre de pages du Wiki) :

    #set ($rows = 200)
 

Supprimer le lien avec le flux RSS

• pour supprimer le flux RSS en bas de la page des résultats (lien inutile, qui utilise encore le RSS ?), recherchez et supprimez la ligne contenant :

Pour la recherche de type "base de donnée"

• Éditez la page http://tutos.myxwiki.org/xwiki/bin/edit/Main/DatabaseSearch afin de retirer la partie RSS en bas de page ou la ligne avec la date et l'auteur de la modification de chaque résultat.

Anciennes modifications (avant Solr)

• Éditez le code de la page http://tutos.myxwiki.org/xwiki/bin/view/XWiki/Results, en commentant ou supprimant les lignes qui affichent l'auteur et la date de modification de chaque résultat (info n'ayant aucune valeur ajoutée).

Ajouter un logo personnel

1. Aller sur la page : http://tutos.myxwiki.org/xwiki/bin/view/ColorThemes/Mint
2. Ajouter le logo en pièce jointe à ce document
3. Passer en mode modification sur le document puis cliquer sur l'emplacement du logo
4. Enfin dans la boite de propriétés qui apparaît : indiquer le nom du fichier logo ajouté à l'étape 2 (par exemple : "Final.png").

Modifier la couleur des liens hypertextes

• Dans l'Administration > Apparence > Présentation en bas Thème de couleur, cliquez sur le bouton Personnaliser à côté du thème (le thème Mint est utilisé actuellement). Puis modifiez la couleur pour les liens hypertextes comme dans la copie écran ci-dessous, en indiquant une couleur bleue (standard du web) :

Numéroter automatiquement les titres en fonction de leur niveau

Pour avoir une numérotation automatique des niveaux de titre, j'ai installé l'extension Numbered Headings . Cette extension ajoute une macro qu'on peut mettre sur chaque page où l'on souhaite avoir la numérotation automatique des titres ...

Procédure "pas à pas" :

• Installation
  • Ajouter l'extension via Administration > Extension Manager
  • (optionnel) Modifier la Portée de la macro en définissant "Current Wiki" au lieu de "Global" par défaut, ça se passe ici.
• Utilisation
  • pour bénéficier de cette numérotation, ajoutez la macro suivante en début de page :
    {{numberedheadings/}}

Déclarer le Wiki au moteur de recherche Google

• Pour que le Wiki apparaisse dans les résultats du moteur de recherche Google, il faut ajouter le Wiki à la base de données de Google :
  • complétez le formulaire à l'adresse : https://www.google.com/webmasters/tools/submit-url