Smol Links

A WordPress dashboard interface for managing a self-hosted Shlink URL shortener instance.

• Create and edit Shlinks short links from a manager interface
• Optionally generate new short URLs upon saving new posts
• Manage multiple short URL domains, with an assigned default
• Automatically tag each short link, configurable with a filter hook
• Customize long URLs automatically using a filter hook (e.g., to add query arguments)
• Integrates with WordPress Sentry plugin, if installed

Filter hooks

• smol_links_tags – assigns tags to each saved short link (default: ["smol-links-server:$hostname", "smol-links-user:$username"] )
• smol_links_long_url – automatically adjust the long URL redirect
• smol_links_manager_tabs – customizes the manager tabs (array: [“Tab label” => [ Shlink API query ]])

Developer setup

Developer dependencies:

• node.js (tested on v20)
• Docker Desktop

Build and start:

./bin/build ./bin/start

Running tests:

docker compose exec web composer --working-dir="/var/www/html/wp-content/plugins/smol-links" test