Projet:Scripts et gadgets/Notices/CategoryDeluxe/fr

PROJET SCRIPTS ET GADGETS

Centraliser les fonctions JavaScript et CSS pour éviter la dispersion du code.

(fr) • (en)[edit]

CategoryDeluxe est un code javascript qui permet, dans une page de catégorie, de charger dynamiquement les sous-catégories, pages ou fichiers qui ne sont pas listés car leur nombre dépasse la limite autorisée (généralement 200).

Description modifier

Le script s'active dans une page de catégorie (si l'on se trouve au début de celle-ci, c'est à dire que ce sont les toutes premières pages qui sont listées).

Il supprime les liens "200 précédents" et "200 suivantes" puis rajoute les siens permettant de lancer une requête pour des items supplémentaires. Il est à noter que les sous-catégories, les pages et les fichiers sont gérés indépendamment.

En cliquant sur un de ces liens, vous lancez une requête et lorsque celle-ci est finie le script affiche les items supplémentaires à la suite de ceux déjà présents.

Le rendu gère pour les nouveaux items les fonctions relatives à l'extension categorytree (liens permettant de voir les sous-catégories contenues dans une catégorie) ainsi que l'affichage des fichiers comme une galerie ou une simple suite de liens (mot magique __NOGALLERY__).

Installation modifier

Sur fr.wikipedia.org modifier

Pour installer cette fonction, ajouter à sa page common.js le code suivant :

obtenir('CategoryDeluxe');

Sur un autre wiki modifier

L'installation sur un autre wiki est possible sous réserve que la version de Mediawiki soit suffisamment récente.

Plusieurs variables peuvent nécessiter d'être paramétrées.

Créer une page .js (gadget ou sous-page utilisateur) et y ajouter le code suivant, en modifiant ce qui est nécessaire :

window.CategoryDeluxe_getSiteCustom = function(){

    /* **** Options **** */

    // Limite d'items affichés dans une catégorie
    CategoryDeluxe_PagesOnCategoryPage = 200;

}

mw.loader.load("//fr.wikipedia.org/w/index.php?title=Mediawiki:Gadget-CategoryDeluxe.js&action=raw&ctype=text/javascript");

Personnalisation modifier

Certaines options sont personnalisables par l'utilisateur.

Pour ce faire, il doit ajouter à sa page common.js le code suivant, en modifiant ce qui est nécessaire :

window.CategoryDeluxe_getUserCustom = function(){

    // Taille des requêtes supplémentaires
    CategoryDeluxe_RequestLimits = [1, 10, 25, 50, 100, 200];

}

Traduction modifier

Les textes du gadget peuvent faire l'objet d'une traduction.

Pour cela, il est nécessaire de créer une page de la forme MediaWiki:Gadget-CategoryDeluxe.js/i18n/XX.js, où XX est le code de la langue souhaitée (exemple : MediaWiki:Gadget-CategoryDeluxe.js/i18n/en.js).

Si vous souhaitez une traduction dans une langue qui n'est pas encore couverte, demandez à un administrateur de créer une telle page sur WP:DIMS en fournissant le code adéquat sur un brouillon.

Si vous souhaitez corriger une traduction existante, demander à un administrateur de la faire sur la page WP:DIMS.

Note : les textes relatifs à des éléments de l'extension categorytree devraient être similaires à ceux de l'extension.

Traductions existantes

Gadget-CategoryDeluxe.js/i18n/en.js

Discussions