Extension:UrlShortener/nl

De extensie UrlShortener zorgt voor een basisdienst voor het verkorten van een URL. Om dit goed te laten werken zijn er enkele wijzigingen in de configuratie van uw webserver nodig. Het is origineel ontworpen om het RFC URL Shortener te implementeren.

LocalSettings.php
URL routing configuratie:

Configureert het te gebruiken sjabloon voor het genereren van de Korte URL. Om dit te kunnen gebruiken is mod_rewrite (of iets dergelijks) vereist. Indien de waarde false (standaard) is, dan zullen de korte URL's de 'not-so-short'   gebruiken omdat dat werkt ongeacht de webserver configuratie.

Als u korte URL's wilt in de vorm van, dat stelt u in:

Korte domeinnaam:

Als u een eigen korte domeinnaam heeft, dan kunt dat instellen met:

Indien ingesteld op false (standaard), gebruikt het.

Globale database:

Voer hier de databasenaam in die u als een centrale database voor uw farm wilt gebruiken. U kunt de standaardwaarde false gebruiken zodat de normale database van de wiki wordt gebruikt.

Als de database op een extern cluster staat, dan moet u dat ook instellen.

Willekeurige port toestaan:

Standaard worden alleen de port 80 en port 443 geaccepteerd en worden die automatisch verwijderd. Als uw wiki een andere port gebruikt, stel dit dan in op true, zodat een korte URL een willekeurige port kan hebben.

AllowedDomains reguliere expressie:

Configureert de domeinen waarvoor gebruikers links voor kunnen verzenden. Dit is een matrix met reguliere expressies. Indien de waarde false is (de standaardwaarde), dan wordt het een lijst met toegestane domeinen voor het huidige domein (met gebruik van $wgServer).

Voorbeeld: om een witte lijst te maken met wikipedia.org en wikimedia.org, dan zouden we kunnen gebruiken:

Als we elk domein willen toestaan:

ApprovedDomains documentatie:

Dit een matrix met toegestane domeinen in een leesbaar formaat. Het wordt weergegeven op Special:UrlShortener.

Indien de waarde false is (de standaardwaarde), dan is het de genormaliseerde versie van $wgServer.

Als u alleen wikipedia.org en wikimedia.org toelaat in het bovenstaande voorbeeld:

Shortcode karakterset:

Als u de karakterset wilt aanpassen die de shortcodes gebruiken, kunt u deze instelling overschrijven. Dit moet slechts één keer tijdens de instelling worden gedaan. Zodra deze later gewijzigd wordt, gaan alle bestaande korte URL's naar de verkeerde bestemming.

Het eerste teken in de lijst wordt behandeld als een voorloopnul; er worden geen shortcodes gemaakt die met dat teken beginnen en het wordt genegeerd wanneer het wordt gebruikt aan het begin van de shortcode in een URL (Voorbeeldː https://w.wiki/22222222w is hetzelfde als https://w.wiki/w).

Read-only mode:

Zet $wgUrlShortenerReadOnly op true om te voorkomen dat gebruikers nieuwe korte URL's maken. Dit is voornamelijk bedoeld als een hack tijdens het uitzetten op Wikimedia sites en zal worden verwijderd zodra het niet meer nodig is.

QR-codes:

Vanaf versie 1.1.0 van UrlShortener kunt u het delen van een QR-code activeren. Dit heeft twee configuratie-instellingen. Eén is gewoon QR-code delen in te schakelen.

Merk op dat nu ook $wgUrlShortenerEnableSidebar moet worden ingesteld als u wilt dat de link "" in de zijbalk verschijnt.

De link waar de QR-codes naar wijzen, wordt alleen verkort als die heel lang is. Dit komt omdat gebruikers liever een vertrouwd domein zien bij het scannen van een QR-code, maar als de URL te lang is dan zal de pixeldichtheid van de QR-code te moeilijk te scannen zijn. U kunt de lengte van URL's controleren die, wanneer ze worden overschreden, eerst worden verkort voordat u een QR-code maakt. Het aantal hier verwijst naar het aantal bytes, niet naar het aantal tekens.



VirtualHost of .htaccess
To have truly short URLs, you will need to set up rewrite rules, using mod_rewrite or something similar. An example of what to put in your  file comes with the extension. If our template was set up to, then we could use:

If you are using nginx, you can add the following within a  definition.

This assumes your is set to.

API
This extension provides the API module  to get the shortened url for a given url, creating it if does not exist already. See the API documentation here: https://meta.wikimedia.org/w/api.php?action=help&modules=shortenurl.


 * - URL to shorten.

Antwoord:

