Extension:Surl

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.svg
Surl

Release status:Extension status experimental

ImplementationTemplate:Extension#type Link markup
DescriptionTemplate:Extension#description Provides an easy configuration for shortening URLs using Yourls and Semantic MediaWiki
Author(s)Template:Extension#username primarily by MarkAHershberger, then by Edlira Dushku in part as WikiTranslate
MediaWikiTemplate:Extension#mediawiki 1.16+
Database changesTemplate:Extension#needs-updatephp Yes
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
Download
ExampleTemplate:Extension#example Long and short links to the same page:

Translate the Surl extension if it is available at translatewiki.net

Check usage and version matrix.

The Surl extension provides a special page that helps create shortened URLs for wiki pages. The short link is added to a semantic property 'Surl' of BASEPAGEs manually. 'Surl's for the SUBPAGEs can be added automatically. The extension adds the short and long links of the page to a separate Yourls database. Primarily developed for use in WikiTranslate.org. Surl stands for Short URL.

Requirements[edit]

  1. Extension:Semantic MediaWiki♙
  2. Yourls - Your Own URL Shortener
  3. Getting another domain for the website is optional. The shorter the domain name, the better, especially if you plan on sharing your short URLs on Twitter or any other medium where short is better.

Installation[edit]

  • Download and place the file(s) in a directory called Surl in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    require_once "$IP/extensions/Surl/Surl.php";
    $wgSurl = "/your/site/url/";
    
  • Run the update script which will automatically create the necessary database tables that this extension needs.
  • You can run "$IP/extensions/Surl/runSurl.php" once or setup a cron for it.
  • YesY Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

See also[edit]