vulcandigital/silverstripe-securelinkparser

Allows you to notify your viewers that they are being redirected to an external link

1.0 2018-01-11 09:03 UTC

This package is auto-updated.

Last update: 2024-04-18 19:46:42 UTC


README

This module provides you with a page and the functionality to redirect viewers to user defined links to:

TL;DR Will convert "https://google.com" into "https://yourdomain.com/external-links?url=https://google.com"

What's it do?

  • Warns the viewer that they're about to be redirected to external link
  • Give the user the ability to cancel the redirection.
  • If they cancel then provide them with an option to continue to the link anyway in case they changed their mind.
  • Track how many hits an external URL has had from your domain.
  • Prevents potentially breaking SSL due to insecure links

Requirements

  • silverstripe/framework: ^4
  • silverstripe/cms: ^4

Installation

composer install vulcandigital/silverstripe-securelinkparser

Usage

An extension is packaged with this module and gives you access to the $SecureUserDefinedLink method from within any PageController

<a href='$SecureUserDefinedLink($CustomLink)'>$CustomLinkTitle</a>

or

$link = \Vulcan\SecureLinkParser\SecureLinkParser::getSecureLink($this->CustomLink);

Configuration

The only configuration variable available is create_default_page, which will create the redirection page automatically upon dev/build

Vulcan\SecureLinkParser\Pages\SecureLinkParserPage:
    create_default_page: true

This is disabled by default, so you will need to create the page yourself anywhere in the site tree.

License

BSD 3-Clause © Vulcan Digital Ltd