External Link Tracker Plugin

Introduction

The goal of this plugin is to track users clicking on external links, and to report on external link tracking statistics. Links are obfuscated and identified only by link IDs, e.g. users can't see the destination link in view mode and edit mode.

An external link is written as %EXLINK{ID}%, with ID representing the link identifier. For example, %EXLINK{TWiki}% renders as TWiki.org.

Set the ownership of the extracted directories and files to the webserver user.

Plugin configuration and testing:

Run the configure script and enable the plugin in the Plugins section.

Make sure the {AllowRedirectUrl} configure setting is checked in the Security setup section (this is an expert setting).

Configure additional plugin settings in the Extensions section:

{Plugins}{ExternalLinkTrackerPlugin}{ExternalIcon} - Flag to show a small external icon next to external links.

{Plugins}{ExternalLinkTrackerPlugin}{NewWindow} - Flag to open up external link in a new window or tab.

{Plugins}{ExternalLinkTrackerPlugin}{ForceAuth} - Force authentication before redirecting to external links. If not set and if a non-authenticated user follows an external link, he/she will be recorded as TWikiGuest. It does not need to be set if users are authenticated at all times on the TWiki site.

{Plugins}{ExternalLinkTrackerPlugin}{AdminGroup} - Group that defines who can see the external link tracker statistics. Set to empty value to open it up to all. Default: ExternalLinkAdminGroup