Manual:$wgUrlProtocols

Parser: $wgUrlProtocols
Definieert de protocollen die worden ondersteund en vertaald in HTML door de mediawiki parser.
Geïntroduceerd in versie:	1.5.0 (r10229)
Verwijderd in versie:	nog steeds in gebruik
Toegelaten waardes:	(array van strings) (1.6+) (string met een reguliere expressie) (1.5)
Standaardwaarde:	Zie onder
Andere instellingen: Alfabetisch | Per functie

Details

Definieert de URL-protocollen die MediaWiki zal herkennen als geldig in UrlUtils::parse(). Dit wordt op veel plaatsen gebruikt. Het meest zichtbare effect is dat het bepaalt welke protocollen zijn toegestaan voor externe links: onherkenbare protocollen worden genegeerd, er wordt geen link gegenereerd. Het wordt echter ook op veel andere plaatsen gebruikt, waaronder de code voor Special:LinkSearch, en nuttige functies zoals UrlUtils::parse() die op veel verschillende plaatsen worden gebruikt.

Deze voorbeelden zouden niet werken (omdat "test://" niet is gedefinieerd als een geldig protocol):

• test://www.example.com
• [test://www.example.com]
• [test://www.example.com link tekst]

• Sommige browsers, zoals Mozilla Firefox, zullen de bestands-URL's op pagina's die via HTTP zijn geladen niet volgen. Dit is een veiligheidsmaatregel. Zie dit mozillaZine artikel voor meer informatie, inclusief enkele hints over hoe deze beperking te overwinnen.
• De meeste browsers ondersteunen geen "remote file" URL's zoals file://host/share (alleen Internet Explorer ondersteunt deze standaard. Voor Firefox is een plugin nodig of gebruik precies 5 slashes zoals file://///host/share, zie [1]).

Waarschuwing:

In MediaWiki 1.20.2+ zal het toevoegen van "file:" zonder schuine streepjes naar $wgUrlProtocols image embedding breken met behulp van de [[File:Image.jpg]] syntaxis. Dit is een bekende bug gerelateerd aan een wijziging die URL-protocol matching case-insensitive maakte. Gebruik als workaround "file://"" in plaats van "file:"" zoals hieronder weergegeven.

Om links naar lokale bestanden toe te staan (wat zinvol kan zijn in een intranetcontext), zet u dit in uw LocalSettings.php :

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

Meestal wilt u alleen protocollen toevoegen aan deze array.

Standaardwaarden

MediaWiki-versie:

≥ 1.38 Gerrit change 876412

MediaWiki-versie:

1.35 Gerrit change 876392

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

MediaWiki-versies:

1.24 – 1.37

$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:','slack://', '//', 
];

MediaWiki-versies:

1.22 – 1.23

$wgUrlProtocols = array(
	'http://',
	'https://',
	'ftp://',
	'ftps://', // Als we ftp:// toestaan, moeten we de beveiligde versie toestaan.
	'ssh://',
	'sftp://', // SFTP > FTP
	'irc://',
	'ircs://', // @bug 28503
	'xmpp:', // Een ander open communicatieprotocol
	'sip:',
	'sips:',
	'gopher://',
	'telnet://', // Nou, als we het bovenstaande gaan ondersteunen.. -ævar
	'nntp://', // @bug 3808 RFC 1738
	'worldwind://',
	'mailto:',
	'tel:', // Als we e-mails klikbaar kunnen maken, waarom dan geen telefoonnummers?
	'sms:', // Ook dit is gestandaardiseerd
	'news:',
	'svn://',
	'git://',
	'mms://',
	'bitcoin:', // Zelfs registerProtocolHandler zet dit samen met mailto op de witte lijst:
	'magnet:', // Geen reden om torrents over magnet te verbieden: wanneer ze via http:// mogen.
	'urn:', // URNS mogen worden gebruikt in microdata/RDFa's<link ...="" href="urn:..."/>
	'geo:', // URL's definiëren geografische locaties, ze zijn nuttig in Microdata/RDFa en voor coördinaten
	'//', // voor protocolgerelateerde URL's
);

MediaWiki-versies:

1.18 – 1.21

$wgUrlProtocols = array(
	'http://',
	'https://',
	'ftp://',
	'irc://',
	'ircs://', // @bug 28503
	'gopher://',
	'telnet://', // Nou, als we het bovenstaande gaan ondersteunen.. -ævar
	'nntp://', // @bug 3808 RFC 1738
	'worldwind://',
	'mailto:',
	'news:',
	'svn://',
	'git://',
	'mms://',
	'//', // voor protocolgerelateerde URL's
);

MediaWiki-versie:

1.17

$wgUrlProtocols = array(
	'http://',
	'https://',
	'ftp://',
	'irc://',
	'gopher://',
	'telnet://', // Nou, als we het bovenstaande gaan ondersteunen.. -ævar
	'nntp://', // @bug 3808 RFC 1738
	'worldwind://',
	'mailto:',
	'news:',
	'svn://',
	'git://',
	'mms://',
);

MediaWiki-versies:

1.15 – 1.16

$wgUrlProtocols = array(
	'http://',
	'https://',
	'ftp://',
	'irc://',
	'gopher://',
	'telnet://', // Nou, als we het bovenstaande gaan ondersteunen.. -ævar
	'nntp://', // @bug 3808 RFC 1738
	'worldwind://',
	'mailto:',
	'news:',
	'svn://',
);

MediaWiki-versies:

1.6 – 1.14

$wgUrlProtocols = array(
	'http://',
	'https://',
	'ftp://',
	'irc://',
	'gopher://',
	'telnet://', // Nou, als we het bovenstaande gaan ondersteunen.. -ævar
	'nntp://', // @bug 3808 RFC 1738
	'worldwind://',
	'mailto:',
	'news:'
);

MediaWiki-versie:

1.5

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

Geavanceerde wijzigen

De standaardprotocollen zouden allemaal veilig moeten zijn om op te klikken (geen kwaadaardige neveneffecten), en het verwijderen van een protocol uit de lijst zal ervoor zorgen dat URL's die deze protocollen gebruiken op veel plaatsen in de software onherkenbaar worden. Met name het verwijderen van 'http://' of andere gemeenschappelijke protocollen zal waarschijnlijk enorme hoeveelheden zaken onbruikbaar maken. Toch kan je, als het nodig is (je hebt bijvoorbeeld al een News: namespace), zoiets doen:

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

Zie ook

• URI schema's (historisch)
• UNC links