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 :	Encore utilisé
Valeurs autorisées :	(array of strings) (string containing a regular expression before 1.6.0)
Valeur par défaut :	see below
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]

 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 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, voir [1])

Avertissement :

In MediaWiki 1.20.2+, adding "file:" without trailing slashes to $wgUrlProtocols will break image embedding using the [[File:Image.jpg]] syntax. This is a known bug related to a change that made URL protocol matching case-insensitive. As a workaround, use "file://" instead of "file:" as shown below.

To allow links to local files (which may make sense in an intranet context), put this into your LocalSettings.php :

$wgUrlProtocols[] = "file://";

En général, vous ne voudrez ajouter que des protocoles à ce tableau.

Default values

Version de MediaWiki :

≥ 1.24

$wgUrlProtocols = [
	'bitcoin:', 'ftp://', 'ftps://', 'geo:', 'git://', 'gopher://', 'http://',
	'https://', 'irc://', 'ircs://', 'magnet:', 'mailto:', 'mms://', 'news:',
	'nntp://', 'redis://', 'sftp://', 'sip:', 'sips:', 'sms:', 'ssh://',
	'svn://', 'tel:', 'telnet://', 'urn:', 'worldwind://', 'xmpp:', '//'
];

Versions de MediaWiki :

1.22 – 1.23

$wgUrlProtocols = array(
	'http://',
	'https://',
	'ftp://',
	'ftps://', // If we allow ftp:// we should allow the secure version.
	'ssh://',
	'sftp://', // SFTP > FTP
	'irc://',
	'ircs://', // @bug 28503
	'xmpp:', // Another open communication protocol
	'sip:',
	'sips:',
	'gopher://',
	'telnet://', // Well if we're going to support the above.. -ævar
	'nntp://', // @bug 3808 RFC 1738
	'worldwind://',
	'mailto:',
	'tel:', // If we can make emails linkable, why not phone numbers?
	'sms:', // Likewise this is standardized too
	'news:',
	'svn://',
	'git://',
	'mms://',
	'bitcoin:', // Even registerProtocolHandler whitelists this along with mailto:
	'magnet:', // No reason to reject torrents over magnet: when they're allowed over http://
	'urn:', // Allow URNs to be used in Microdata/RDFa <link ... href="urn:...">s
	'geo:', // urls define geo locations, they're useful in Microdata/RDFa and for coordinates
	'//', // for protocol-relative URLs
);

Versions de MediaWiki :

1.18 – 1.21

$wgUrlProtocols = array(
	'http://',
	'https://',
	'ftp://',
	'irc://',
	'ircs://', // @bug 28503
	'gopher://',
	'telnet://', // Well if we're going to support the above.. -ævar
	'nntp://', // @bug 3808 RFC 1738
	'worldwind://',
	'mailto:',
	'news:',
	'svn://',
	'git://',
	'mms://',
	'//', // for protocol-relative URLs
);

Advanced modification

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. Nevertheless, if you need to do so (for example, you already have a News: namespace), you can do something like this:

$wgUrlProtocols = array_diff($wgUrlProtocols, array('news:'));

Voir aussi

• MetaWiki:URI schemes
• Liens UNC