Plugin allows to turn Matomo (Piwik) instance into URL Shortener.
Before using, please read content in
as it contains steps required to make plugin work with your Matomo instance!
After correctly setting up this plugin (please see section below), you are ready for shortening your Urls.
There is one new section in top reporting menu called "Shortcodes".
This view gives you possibility to shorten any URL you want and operate with shortcode retrieved.
Additionally this plugin integrates with Page URL's report - hover over URL you want to shorten and click scissors icon.
This will call popup with appropriate shortcode, so you don't need to manually shorten any URL you already track with your Matomo instance.
Besides of functional Matomo instance with this plugin enabled you will also need special configuration for your webserver.
It's purpose is to redirect any short url hitting your server to proper API method doing the magic.
Below you can find example configurations
Please be aware that in your case this configuration may be different, so please contact your system/webserver admin for advisory!
Before you can start shortening your URLs you need to perform following steps:
After you confirm that plugin has been enabled: * go to Administration -> Plugin Settings, * go to ShortcodeTracker section, * fill in Shortener URL input, * if you want to track external sites, you need to decide to which Matomo page those actions will be attributed (see External redirects tracking section below), * click 'save', * additionally you have to make Shortener URL a trusted host for Matomo by entering it in settings section,
This is necessary to perform, as otherwise you will not be able to generate shortened URLs or use them with Matomo.
It is possible to also track redirect actions for external URLs (i.e. which URL doesn't match any page tracked within your Matomo instance). However, it is required to decide to which site this traffic will be attributed to.
It is recommended to create a separate Website in Matomo instance only dedicated to this traffic, so that other websites reports won't be affected by redirect events.
To select which site should collect redirects:
Do not collect external shortcode redirects,
Please direct any feedback regarding plugin to Github repository issue tracker available at https://github.com/mgazdzik/plugin-ShortcodeTracker/issues.
Scissors icon visible in Actions report is originating from https://icons8.com/.