terminal42/contao-shortlink

Extension to create shortlinks in Contao CMS

1.3.4 2024-04-10 16:51 UTC

Requires

• php: ^8.1
• composer-runtime-api: ^2.0
• composer/semver: *
• contao/core-bundle: ^4.13 || ^5.0
• hashids/hashids: ^3.0 || ^4.1

Requires (Dev)

• contao/manager-plugin: ^2.0
• terminal42/contao-build-tools: dev-main

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

MIT

• terminal42 gmbh

• url
• shortlink
• contao
• shortcut

README

This extension allows to create shortlinks in the Contao back end, similar to bit.ly and other shortener services.

Installation

Choose the installation method that matches your workflow!

Installation via Contao Manager

Search for terminal42/contao-shortlink in the Contao Manager and add it to your installation. Finally, update the packages.

Manual installation

Add a composer dependency for this bundle. Therefore, change in the project root and run the following:

composer require terminal42/contao-shortlink

Depending on your environment, the command can differ, i.e. starting with php composer.phar … if you do not have composer installed globally.

Bundle configuration

Default configuration:

terminal42_shortlink:
    host: ~
    catchall_redirect: ~
    salt: terminal42_shortlink
    log_ip: false

• host: The host to use for shortlinks. Can be different than the website host, but make sure it is set up on your hosting/server.

• catchall_redirect: If you configure a host exclusively for shortlinks, you can redirect all unknown requests to a URL (e.g. your regular website).

• salt: If a shortlink does not have a custom alias (path), a unique hash ID is generated from the database ID. By changing the salt you can get unique IDs for your installation.

• log_ip: This extension records how often a shortlink is accessed. Enable this flag to also capture IP addresses (not allowed under DSGVO in europe!)

License

This bundle is released under the MIT