Obscure Your Links - Joomla! Plugin - Logo


Name: Obscure Your Links - Version: 3.1.2 Type: Plugin - License: GPLv3
Description: With this plugin you may obscure internal and external links.

Overview of all downloads of the extension: OYL - Obscure Your Links Downloads

If you use OYL - Obscure Your Links, please post a rating and a review at the Joomla! Extensions Directory.

Obscures internal and external links - sets up redirection for long URLs

Plugin: OYL - Obscure Your Links
Function: With this plugin links can be obscured. You can also use it to shorten (example: web code) long URLs.
Languages: English and German

With this plugin you may obscure internal and external links. There are two obfuscation methods: manual and automatic redirections. With the manual method you can manually obscure certain links. The linking is done via a self-selected alias. In the automatic method, all links by a specific domain are completely obscured and automatically redirected via an additional script.

Of course, the plugin can also be used for internal redirects. So you can build up a webcode system. Long URLs can be called with short aliases. The web code can be distributed easily and comfortably in forums, etc..

In the manual method you can also specify whether you want to call the aliases via a query. This is necessary if mod_rewrite (.htaccess) is not activated. If you want to call the aliases directly, then you have to activate mod_rewrite.

In version 1.7-2 a second method was added. It allows fully automatic redirections of links to domains that have been previously defined in the settings of the plugin. The plugin will find all links of the specified domains on the loaded side and will convert them automatically. For the concealment the Blowfish algorithm is used. The link is converted by an additional script and afterwards redirected. The Blowfish algorithm requires a security token for the concealment. Without the security token the decryption of the encrypted links is not possible.

In version 1.7-3 another option was added: "Obscure all external links." This option allows you to obscure all external links automatically. The blacklist turns then to a white list. All links from domains that are entered in the list are not obscured!

On 28 January 2012 version 2.5-1 for Joomla! 2.5 was released.


  • Obscure internal and external links - call is done by an alias
  • Completely automatic obfuscation of links that lead to certain domains
  • Automatic obfuscation of all external links (with whitelist feature)
  • Set up redirects using short pregnant codes at long URLs
  • No limitation at the number of redirects
  • Query method
  • Query can be set manually
  • Individual security token for Blowfish algorithm
  • Languages: English and German


Install the plugin in the backend and adjust it in Extensions - Plugins - System - Obscure Your Links - OYL.


Manual Redirection

Using the settings of the plugin you may define the desired alias and the real link. For each forwarding you must use a new line.

Syntax [ALIAS][PIPE Symbol][Forwarding to URL]



You may set a link with desired options (new window, nofollow-attribute, title) to an alias. If this alias link is called, OYL will automatically forward to the defined site.

There are two ways of linking. If you select the query method, then you can use the aliases with the query function call (http://www.your-website.com/?QUERYSTRING=ALIAS). The query string is by default oyl, but can be set individually. This option has to be selected if mod_rewrite (.htaccess) is not used. If mod-rewrite (.htaccess) is enabled, then the aliases can also be directly addressed: http://www.your-website.com/ALIAS (no question mark). Therefore, the query method has to be disabled.

In the example above the plugin would forward the link http://www.your-website.com/12345 (with query method: http://www.your-website.com/?oyl=12345) to http://www.kubik-rubik.de and so on.

To redirect the call of the frontpage, you can enter:


The plugin can be use for long internal links:


Attention: You can not use folder names (e.g. components, modules oder plugins) as aliases!

Automatic redirection

With this method links to specific domains are obscured automatically. The Blowfish algorithm is used for the obfuscation.

Syntax [DOMAIN]



If you now set any link to one of the specified domains, it is obscured and automatically redirected via an additional script. You also can use the list as a white list (all external links are obscured except of the list entries).

The security token is needed for the Blowfish algorithm and is a required field. You don't have to remember the token.

It can't be eaysier to obscure your links!


+ = Added - ! = Removed - ^ = Changed - # = Fixed

Joomla! 3.x

Version 3.1.2 - 2016-04-12

  • # Changed function name in Blowfish class to avoid a PHP Parse error - Thanks for reporting to Karsten J.

Version 3.1.1 - 2016-04-08

  • + Code Refactoring
  • ^ Updated Language Files
  • ^ Updated Custom Field

Version 3.1.0 - 2015-08-01

  • + Donation Code Validation Process - Improved the validation process with a new server (HTTPS request) plus an independent, separated fallback server (HTTP request).
  • + New Download Server - Download packages are located independently of the project website on a new download server.
  • https://downloads.kubik-rubik.de/
  • ^ Semantic versioning - Switched to semantic versioning, see http://semver.org/ for more details. Please update manually since the core update server functionality will not recognize the new version!
  • Version 3-2 - 2015-02-21

    • + Update Server - Added the Joomla! core functionality for the update checks
    • ^ Updated Donation Code field - Uses the HTTP API for the requests and calls the check script via HTTPS
    • ^ Links in the language files - Updated outdated links to the JED (Joomla! Extensions Directory)
    • ^ HTTPS Links are obscured properly - in Automatic Mode
    • ! Removed Version Check field
    • ! Deprecated API functions

    Version 3-1 - 2013-12-15

    • First release for Joomla! 3.x.
    • This release is tested only with Joomla! 3.2 - do not use it in a lower Joomla! version. Do not report any problems with other Joomla! versions. Only the mentioned version is supported officially!

    Joomla! 2.5

    Version 2.5-3 - 24-Sep-2012

    + Implemented Versioncheck - Stay uptodate with the great new feature! The latest version can be checked once per session or on every load of the settings page.
    ^ Optimized Donation Code System - The entered donation code is checked only once per session.

    Version 2.5-2 - 06-Jun-2012

    + Implemented donation model

    Version 2.5-1 - 28-Jan-2012

    + First release for Joomla! 2.5

    Joomla! 1.7

    Version 1.7-3 - 30.11.2011

    + Obscure all external links - With this option all external links are automatically obscured. The black list will then turn into a white list. All links from domains that are listed in the white list, won't be obscured!

    Version 1.7-2 - 07.11.2011

    + Automatische Umleitungen - Links werden komplett automatisch von bestimmten Domains verschleiert. Zur Verschleierung wird der Blowfish-Algorithmus verwendet.
    + Query Methode - Wenn kann mod_rewrite benutzt wird, können die Aliase auch über einen Query angesprochen werden. Standardquery ist oyl.
    ^ Umbenennung der Dateien von obscureyourlinks zu oyl.

    Version 1.7-1 - 04.11.2011

    + Interne und externe Links verschleiern - Links können einfach über einen Alias gesetzt werden. Beim Aufruf des Alias wird auf die richtige URL umgeleitet
    + Umleitung auf lange URLs - von kurzen prägnanten Codes auf lange URLs umleiten
    + Keine Begrenzung der Anzahl an Umleitungen
    + Sprache: Deutsch und Englisch

    Joomla! 1.5

    Version 1.5-1 - 07.11.2011

    + Gleiche Features wie die Version 1.7-2


    Download - free, public versions

    Overview of all downloads of the extension: OYL - Obscure Your Links Downloads