Liste des personnalisations effectuées sur XWiki
Sommaire
- Personnaliser la traduction
- Configurer le Wiki
- Paramétrer le format date - heure
- Désactiver les suggestions de recherche
- Désactiver les Annotations
- Personnaliser le texte de la barre titre du navigateur Web
- Personnaliser le pied de page
- Ajouter un Favicon
- Filtrer la panneau / panel "Recently Modified" / "Dernières modifications"
- Configurer la barre d'outils de l'éditeur WYSIWYG
- Modifier le profil de l'administrateur
- Créer l'utilisateur "principal" Toto
- Autoriser les utilisateurs Anonymes à poster des commentaires
- Personnalisation des écrans
- Déclarer le Wiki au moteur de recherche Google
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).
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§ion=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§ion=Annotations
Personnaliser le texte de la barre titre du navigateur Web
- http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin§ion=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 : traduire la phrase de licence en français, ajouter un lien d'envoi de mail, ajouter un logo "Powered By XWiki", tout en conservant l'affichage de la version de XWiki et en limitant la hauteur occupée
- Allez sur la page d'admin http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin§ion=Elements&space=XWiki puis dans la section "Pied de page"
- dans la zone "Copyright", indiquez le code :
Contenu sous licence <a target="_blank" href="http://creativecommons.org/licenses/by/2.0/">Creative Commons 2.0</a> - Me <a href="mailto:Ldm Public <ldmpub@gmail.com>?subject=Les Tutos de Toto">contacter</a> - dans la zone "Version", indiquez le code :
XWiki Enterprise $xwiki.getVersion() - <a target="_blank" href="http://tinyurl.com/c9cylmd">Documentation</a><br><a target="_blank" href="http://www.xwiki.org"><img src="http://www.ip-m.com/skins/toucanet/xwiki-powered.png"></a>
- dans la zone "Copyright", indiquez le code :
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 4 pièces jointes; en fait ajoutez 4 fois la même image favicon mais avec les noms 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)
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 :
$services.localization.render('core.footer.modification', [
"#displayUserProfileLink($searchResult.author $searchResult.author_display)",
$xwiki.formatDate($searchResult.date)
])
</div>
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
- Aller sur la page : http://tutos.myxwiki.org/xwiki/bin/view/ColorThemes/Mint
- Ajouter le logo en pièce jointe à ce document
- Passer en mode modification sur le document puis cliquer sur l'emplacement du logo
- 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
- Numéroter automatiquement les niveaux de titre => fait grâce à l'extension Numbered Headings. après installation via l'Extension Manager, il faut modifier la Portée de la macro en définissant "Current Wiki" au lieu de "Global" par défaut, ça se passe ici.
- pour bénéficier de cette numérotation, ajouter le code suivant en début de page :
{{numberedheadings/}}
- pour bénéficier de cette numérotation, ajouter le code suivant en début de page :
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