Manual:$wgUrlProtocols/fr

Personnalisation du site: $wgUrlProtocols
Définit les protocoles qui sont supportés et traduits en HTML par l'analyseur mediawiki.
Introduit dans la version:	1.5.0(r10229)
Retiré dans la version:	toujours utilisé
Valeurs autorisées:	tableau de chaînes chaîne contenant une expression régulière avant 1.6.0
Valeur par défaut:	(voir ci-dessous)

Autres paramètres: Alphabétique | Par Fonction

Détails

Définit les protocoles d'URL que MediaWiki reconnaîtra. Cela est utilisé à de nombreux endroits. L'effet le plus visible est de déterminer quels protocoles sont permis pour les liens externes: les protocoles non reconnus sont ignorés, aucun lien n'est généré. Toutefois, il est aussi utilisé à de nombreux autres endroits, y compris le code pour Special:LinkSearch, et des fonctions utilitaires comme wfParseUrl() qui est utilisée dans un grand nombre d'endroits différents.

Quelques exemples qui ne fonctionnent pas (parce que "test://" n'est pas défini comme un protocole valide):

• test://www.example.com
• [test://www.example.com]
• [test://www.example.com texte du lien]

Pour permettre les liens vers des fichiers locaux (ce qui peut avoir du sens dans le contexte d'un intranet), mettez ceci dans votre LocalSettings.php:

$wgUrlProtocols[] = "file:";

 Note: Certains navigateurs, comme Mozilla Firefox, ne suivront pas les URLs de fichiers sur les pages qui ont été chargées via HTTP. C'est une mesure de sécurité. Voyez cet article de mozillaZine^(en) pour plus d'information, y compris certains trucs sur la manière de contourner cette restriction.

 Note: La plupart des navigateurs ne supportent pas des URLs de "fichiers distants" comme file://host/share (seul Internet Explorer les gère par défaut. Pour Firefox, un module complémentaire est requis, ou bien utilisez exactement 5 barres obliques comme file://///host/share; voyez [1])

En général, vous ne voudrez ajouter que des protocoles à ce tableau. Les protocoles par défaut devraient tous être sûrs en cliquant dessus (sans effet de bord pervers), et supprimer un protocole de la liste fera que les URLs utilisant ces protocoles ne seront plus reconnues à de nombreux endroits du logiciel. En particulier, supprimer 'http://' ou d'autres protocoles courants provoquera certainement de nombreux soucis.

Valeur par défaut

1.6.0 et suivants

Depuis la version 1.6.0, le format de ce paramètre est simplement un tableau de préfixes d'URL autorisés.

$wgUrlProtocols = array(
        'http://',
        'https://',
        'ftp://',
        'irc://',
        'gopher://',
        'telnet://', // Bien si nous allons supporter celui qui précède.. -ævar
        'nntp://', // @bug 3808 RFC 1738
        'worldwind://',
        'mailto:',
        'news:'
);

Cette valeur par défaut ajoute trois nouveaux protocoles à ceux couverts par les versions avant la 1.5.x:

• telnet://
• nntp://
• worldwind://

Les versions suivantes ajoutent quelques autres protocoles, de sorte qu'en 1.16, la liste est

$wgUrlProtocols = array(
    'http://',
    'https://',
    'ftp://',
    'irc://',
    'gopher://',
    'telnet://', // Bien si nous allons supporter celui qui précède.. -ævar
    'nntp://', // @bug 3808 RFC 1738
    'worldwind://',
    'mailto:',
    'news:',
    'svn://',
    'git://',
    'mms://',
);

1.5.x

Dans les premières versions, le paramètre était une expression régulière qui correspondait à la partie du début de l'URI; en d'autres termes, c'était un ensemble de préfixes séparés par '|' (avec '/' converti en '\/' car '/' a une signification spéciale dans une expression régulière.

$wgUrlProtocols = 'http:\/\/|https:\/\/|ftp:\/\/|irc:\/\/|gopher:\/\/|news:|mailto:';

Cette valeur par défaut fait que MediaWiki rend les URIs avec les préfixes suivants comme des liens externes:

• http://
• https://
• ftp://
• irc://
• gopher://
• news:
• mailto:

Versions plus anciennes

Si vous avez besoin de cette fonctionnalité dans les plus anciennes versions:

Il y a la fonction replaceExternalLinks dans ./includes/Parser.php. Ajoutez simplement une ligne là pour votre protocole.

Voir aussi

• MetaWiki:URI schemes ^(en)
• UNC links/fr
• Réponses de la FAQ pour les URLs file://^(en) (pour des raisons de sécurité, elles ne fonctionnent pas comme attendu sur de nombreux navigateurs)