Sommaire |
[modifier] Backward Navigation
Cette extension est la version popup (div css) de WhatLinksHere. Elle permet d'afficher la liste des pages pointant sur la page courante.
[modifier] Installation
Nous vous conseillons très vivement de procéder à une installation sur un serveur de test avant de modifier votre serveur de production. Un backup est toujours une bonne chose avant d'apporter des modifications.
[modifier] Installation des fichiers de l'extension
Après avoir téléchargé l'archive : BackwardNavigation_1.0.1.tgz
Décompactez là dans votre dossier extension, vous devez alors avoir l'arborescence suivante :
./BackwardNavigation.i18n.php ./BackwardNavigation.php ./BackwardNavigation_body.php ./BackwardNavigation_template.php ./licence.txt ./README.art122-5 ./skins ./skins/Art122_5.php ./skins/Tests.php
[modifier] Modification de LocalSettings.php
Ajoutez à la fin de votre fichier (Après l'extension MultiLanguageManager si vous l'utilisez) les lignes suivantes :
require_once("$IP/extensions/BackwardNavigation/BackwardNavigation.php");
[modifier] Intégration dans votre template
Pour afficher la sélection des referers, vous devez modifier votre template pour ajouter le code suivant là où vous souhaiter voir apparaitre la zone de sélection:
<?php global $wgTitle; $backNav_controller=new BackwardNavigation(); echo $backNav_controller->executeBackwardNavigation($wgTitle->getArticleID()); ?>
Vous devez également apporter des modifications à vos fichiers CSS, cf Modification des CSS.
[modifier] Customisation
L'extension BackwardNavigation est faite pour s'adapter à différents skins. Les fonctions de rendus graphiques sont isolées dans le fichier BackwardNavigation_template.php contenant la classe du même nom. Elle contient les différentes routines utilisées pour le rendu.
Toute fois vous ne devez pas la modifier. En effet le module n'utilise cette classe qu'en cas d'absence d'une classe spécifique pour votre skin.
[modifier] Création du fichier de skin
Dans le répertoire extensions/BackwardNavigation/skins dupliquez le fichier Default.php et nommez la copie du nom de votre skin (le même nom de fichier que le .php du répertoire skins du wiki)
Par défaut cette classe ne contient que le constructeur, mais vous pouvez surcharger toutes les méthodes de votre choix. Un exemple est donné avec le fichier Art122-5.php modifiant le rendu de la popup pour correspondre au style du wiki.
[modifier] Modification des CSS
Vous avez également la possibilité de personnaliser les CSS. Le nom des différentes classes utilisées est paramétrable en surchargeant les variables $class_ de la classe BackwardNavigation_template (un exemple de configuration CSS est donné au début de ce fichier)
- class_referer_disabled = referer_disabled : aucun referer
- class_referer_activated = referer_activated : un seul referer
- class_popup = popup : le lien affichant la popup
- class_cadre_popup = cadre_popup : la popup elle même
[modifier] Utilisation
L'utilisation est tout ce qu'il y a de plus simple:
- Si la page n'est référencer par aucune autre, le texte "Page précédente" n'est pas un lien.
- Si une seule page référence la page courante, "Page précédente" est un lien vers cette page
- Si plusieurs pages référencent la page courante, amener la souris sur "Page précédente" affiche une popup contenant la liste de ces pages.
- Si trop de pages référencent la page courante, le lien renvoi vers le classique "WhatLinksHere"
[modifier] Licence
Cette extension est distribuée sous licence GPL v2
* Copyright (C) 2007 Marc Despland * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */
Vous avez la liberté de :
- modifier
- distribuer
- utiliser
cette extension, dans un but commercial ou non.
Toute fois vous ne pouvez redistribuer cette extension en dehors du cadre prévu par la GPL, en particulier :
- Même si vous la modifiez, cette extension reste sous GPL
- Vous n'êtes pas autorisé à supprimer les informations relatives à son auteur ou à la licence
