🎉 A curated list of awesome things related to YOURLS
.gitattributes | ||
CONTRIBUTING.md | ||
LICENSE | ||
README.md |
Awesome YOURLS
A curated list of awesome things related to YOURLS
Contents
- Official Links - Official guides and tools
- Plugins - what makes YOURLS so versatile and powerful
- Themes - to customize how YOURLS looks
- Translations - YOURLS in your language
- Integrations - Third-party integrations and frameworks
- Guides & tutorials - Community resources
Something missing or incorrect ? Want to get your work listed ? See how you can contribute !
Official Links ⇪
Official material from the YOURLS team
- Official Readme
- GitHub Repo
- Release Notes
- YOURLS News
- Official Forum
- YOURLS using Docker
- YOURLS using Helm for Kubernetes
Plugins ⇪
All known plugins - either from the community, or from the YOURLS team, marked with a ☑️
Jump to 0-9 | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z
0-9 ⇡
- 302-Instead - Send a 302 (temporary) redirect instead of 301 (permanent), for sites where shortlinks may change
- 302-Instead - A fork of previous plugin, with some more options
- 404 If Not Found☑️ - Give a 404 Not Found if the short URL is not found
A ⇡
- AAF Rapid Connect auth - AAF Rapid Connect authentication plugin for YOURLS
- Abuse Desk for YOURLS - A Google Safe Browsing implementation for YOURLS to avoid spam links
- Access Control Allow Origin - Prevents CORS issue with domain CNAMES and aliases for admin actions
- Additional Charsets - Define additional character sets for short URLs
- Admin Issue Diagnostic - A.I.D. - Collects YOURLS environmentals and formats a template to copy/paste into a YOURLS issue. Just fill in the blanks! Fantastic for newbies, great for experts!
- Admin NoReCAPTCHA - Protect logins with Google's No CAPTCHA reCAPTCHA (Google's ReCAPTCHA v2.0)
- Admin reCaptcha - Spam protection for private YOURLS admin interface with reCaptcha
- Advanced Reserved URLs - Extends the reserved word functionality, blocking short URLs containing reserved words, even if mixed case or written in leetspeak
- Allow Aliases - Allow YOURLS to work with alias hostnames for the server
- Allow Forward Slashes in Short URLs - Just as the name says.
- Always-302 - A newer alternative to 302-Instead, tested with YOURLS 1.7.x
- Amazon Affiliate - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection.
- Amazon Affiliate With Notice - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection with a notice of Amazon Affiliate link usage.
- Anonymise - Anonymise the log data that YOURLS captures.
- Antispam☑️ - Merciless antispam plugin using the 3 major domain blacklists
- YOURLS APC Cache - Add support for APC to reduce MySQL queries
- API Action☑️ - Example plugin for YOURLS 1.6+ to show how to implement custom API actions
- API Delete - Add a "delete" action to the API
- API Edit URL - Add an "update" action to the API to edit a URL, and a "geturl" action to get the long URL of a short URL
- Append Query String - Appends the query string to a long URL- as is
- Auth Manager - Assign users to roles like "Editor" and "Contributor" to limit the changes they are permitted to make (edit URLs, manage plugins...)
- Auth Manager Plus - Seperates user data & manages authorization with role-based access controls (RBAC)
B ⇡
- Blacklist Domains - A simple plugin to blacklist domains from shortening URLs
- Blacklist IPs - A simple plugin to blacklist IPs from shortening URLs
- Bulk Import and Shorten - Import links from a CSV file
- Bulk URL Shortening - Shortening of multiple URLs with one API request
C ⇡
- cAuth - Client side SSL certificate authentication for admin pages.
- Cache Stat Pages☑️ - Serve stat pages (
http://sho.rt/blah+
) from cache - CAS Plugin - Enable authentication through a CAS server
- Case Insensitive - Makes all keywords case insensitive (creates and calls all keywords lowercase)
- Case Insensitive - Make YOURLS case insensitive: if you create
http://sho.rt/MyLink
, then variations likemylink
orMYLINK
will redirect to the same URL. - Change Error Messages - Changes the error message when a keyword or URL already exists and displays the long URL.
- YOURLS GWall Change Logo - Allows you to change the image of the YOURLS logo and its alt and title tags.
- Change Password☑️ - Change your password from within YOURLS instead of editing the config file
- Change Password - Allow users to change their password via the administration interface.
- Check URL - Check if a long URL is reachable before creating a short URL
- API Concurrency Fix - A plugin to resolve concurrency issues with the API as described in Issue 765.
- Compliance - Anti-abuse plugin, designed to address link complaints from 3rd parties.
- Conditional Toolbar☑️ - A plugin to conditionally enable the toolbar:
http://sho.rt/blah
for normal redirect,http://sho.rt/tb/blah
for a toolbar - Conditional Advertisements - A plugin to conditionally send links through various link monetizing services:
http://your.site/short
is normal,http://your.site/a/short
redirects through AdFly - Custom Header & Footer - A plugin administration page to add custom header and footer style and content
- Custom Javascript - Add custom javascript to admin pages
- Custom Protocol☑️ - If the user is known, this plugin adds custom protocol (eg
blah://
) to authorized protocols, otherwise restricts tohttp|s
D ⇡
- Disable JSONP - Disables JSONP access for the YOURLS API.
- DNSBL - Uses various DNSBLs to check the submitter's IP and prevent shortening URLs if any malicious activity has been detected.
- Domain Limit - Limit the domains that users can create shortlinks to
- Domain Limiter - Fork of Nic Waller's plugin with the addition of an admin panel to edit the white list from the admin area
- Do TLS - Always use SSL/TLS for a destination url if available
- Don't Log Bots☑️ - Ignore bot hits in your stats (both click count as seen in the main admin page and in detailed stats)
- Don't Log Crawlers - A fork of the
Don't Log Bots
, with more bots filtered out. - Don't Log Health Checker - A fork of
Don't Log Bots
, with more bots filtered out. - Don't Track Admin Clicks - Don't count clicks on short URL if user is logged in
E ⇡
- Edition Logger - Logs to a file every url insertion, deletion, or modification, to provide traceability of users' actions allowing an open edition policy.
- Email Notify - Sends you an email with identifying information whenever someone clicks the link they were sent.
- Enhanced Auth Cookies☑️ - Enhances the cookie based authentication, making each auth cookie name unique and time based.
- Every Click Counts - Click count include multiple clicks for the same client (ie there will be no browser caching of the redirection)
- Expiry - Defines optional conditions under which links will expire, able to set time and click limited links globally or per individual links.
F ⇡
- Fallback URL☑️ - Redirect to a custom URL when the short URL does not exist
- Favicon☑️ - Properly displayed favicon in all cases (home screen on iOS, Android, Chrome, Safari...)
- Filter Code - Allow to select 3XX Status Code to return per keyword
- Fix long URLs - Fix long URLs that contain %20 and other similar encodings
- Force Lowercase☑️ - Force lowercase so
http://sho.rt/ABC
→http://sho.rt/abc
- Fuzzy Keyword Suggestions - Handles typos and other "near-misses" for any shortened link (eg if you have
sho.rt/dh1ik
but someone typessho.rt/dhlik
, the 404 page will show suggestions for similar short URLs)
G ⇡
- GA MP - Track YOURLS link clicks with Google Analytics Measurement protocol in Real Time
- Git Version - Add version information from the git repository into the footer of the admin page
- Geo API - Plugin to look up country code from another 3rd party API (geoiplookup.net)
- GeoShortURL - Plugin to add per-country support to existing short URLs (use it with 302-Instead)
- Google Analytics Link Tagging - Add GA tags (utm_source and others) to your shortened links
- Google Auth - Enables Google Authentication for YOURLS
- Google Analytics YOURLS Plugin - Add your Google Analytics tags to admin and stat pages
- Google Safe Browsing☑️ - Check every new URL against Google's Safe Browsing Lookup service
- GTM for YOURLS - Google Tag Manager for every single click
H ⇡
- hexdec - Changes the sequential keywords from base36 to base16 (ie
[0-9a-f]
) - Hide Referrer - Hide referrer on all or some short links
- Hide Version String - Hide the version string in the footer
- HTTP:BL - Prevent spam using the black list from Project Honeypot.
- HTTP Proxy - Get remote content using an HTTP proxy, for instance when YOURLS is running behind a firewall (e.g. corporate intranet)
- HTTP status per link - Plugin to allow you to select
3XX
Status Code to return per keyword. - HTTP status per link - Select
3XX
Status Code to return per keyword.
I ⇡
- Identi.ca for YOURLS - Share YOURLS links via identi.ca
- YOURLS IDN☑️ - Add IDN support to YOURLS
- Image Placeholder☑️ - Simple image placeholder service for YOURLS
- YOURLS Import Export - A plugin to import and export YOURLS URL
- Integrated QRCodes - Integrated QRCodes is an updated fork of Inline QRCode, but more compact, configurable, and just as efficient with more features.
- iOS URL - Adds support for URLs starting with
itms-apps://
anditms-services://
- iTunes-Affiliate - Adds your iTunes Affiliate-Token to all iTunes URLs before redirection
J ⇡
- Jappix - Adds a JappixMini chat on your YOURLS admin pages
- JSON Response - Add
.json
(or a custom string/character) to the short URL to get info about it as a JSON response.
K ⇡
- Keep Query String - Adds the short URL's query string (if any) to the long URL
- Keywords, Charset & Length - Custom charset, custom link length and random short urls, all in one plugin, with an admin panel.
- Keyword not found - If keyword isn't found in the database, redirect to admin page and pre-populate the short URL field
- Keyword Prefix - Adds a defined prefix to your short URLs
L ⇡
- LDAP - Enables use of LDAP for user authentication.
- Link Anonymizer - Generate a link that will take you to an anonymizer service.
- Link List - List recent links added, in the admin interface or on a public page
- Limit keyword length - This plugin limits the number of characters allowed for the custom keyword.
- Limited Links☑️ -limit the number of redirections of a specific link.
- log-login - Logs login atempts to YOURLS. To be used with fail2ban.
- Login Timeout - Adds a timeout after a certain number of failed logins to mitigate brute force logins.
- Lookup keywords by long URL substring - Add a "lookup-url-substr" action to YOURLS API which searches keywords by long URL substring (implements
url LIKE %substr%
SQL operation). - lowercase username - Makes the username lowercase when logging in.
M ⇡
- Mailto - Adds a "mailto:" sharing option, next to Twitter and Facebook
- Mailto Bookmarklet - Adds a bookmarklet to share links by mail
- Mass Remove Link ⭐ - Remove several links at once. Select by date, date range, IP or URL matching.
- Mass Update - Adds an API action to mass update links from
old_domain
tonew_domain
- Memcached - Memcached plugin for YOURLS
- Meta Redirect - Redirect using HTML meta tag when you prepend the short URL with an underscore (eg
http://sho.rt/_bleh
) - Multi User - Add support for multiple users
- Mobile Detect - Add ability to redirect by user device OS
N ⇡
- No Traking Admins - No loggin clicks for authenticated users (compatible with OIDC).
O ⇡
- OAuth Sign In - Enable OAuth sign in support (using GitLab as an example)
- OIDC - OpenID Connect authentication against a generic OpenID Connect server
- Open Graph Meta Scraper - Get Open Graph (OG) information for your shortened links
P ⇡
- Password Protection - Password protect any Short URL you want so that users are prompted for a password before redirection
- Phishtank - Prevent spam links using Phishtank's API
- Phishtank 2.0 - Functional rewrite of the old Phishtank plugin with more features
- Piwik-YOURLS - Piwik and a few other features
- Popular Clicks - Display the top of the most clicked links during past days
- Popular Clicks Extended - Shows which short links get clicked the most during a specific time frame
- Popular Links - Adds an admin page that displays your shortener's most popular links
- Preview URL☑️ - Add the character '~' to a short URL to display a preview screen before redirection
- Preview URL with QR Code - Add the character '~' to a short URL to display a preview screen & QR code before redirection
- Preview URL with QR Code And Thumbnail - Add the character '~' to a short URL to display a QR code and Thumbnail image before redirection
- Public "Prefix n' Shorten"☑️ - Redirect
http://sho.rt/http://someurl.com/
to a public interface instead of the admin area - YOURLS Pseudonymize - This plugin "pseudonymizes" the IP addresses so that it is in line with the German privacy laws (the last 2 segments/bytes of a visitor's IP address are removed)
- PUNS - A Plugin Update Notification System: provides a report-generating page and an API with optional email notifications.
Q ⇡
- QRCode☑️ - Add ".qr" to short URLs to display the shorturl's QR code
- QRCode - Creates and displays QR Codes within YOURLS
- QR Google Charts - Another QR Code plugin, using Google Charts API
- QRCode - Another QR Code plugin. Get the QR code by simply clicking on a button in the Admin area (or by adding ".qr" to the end of the keyword.)
- QueryString Forward - Forward the query string on short link to long URL (eg
http://sho.rt/kk?a=1
tohttp://very.long.url/somepage/?a=1
) - Query String Keeper - Pass the query string from the shortlink to the long URL (eg
http://sho.rt/kk?hey
forwards tohttp://longurl/bleh/?hey
)
R ⇡
- reCaptcha - YOURLS plugin implementing reCaptcha for unauthenticated users in your public interface
- Redirect Index - Redirect the user to another site if they go to the base directory of your YOURLS installation
- Regenerate URL - Regenerate a new keyword for a URL that has already been shortened.
- Remove The Share Function - Remove the Share button and box that toggles the sharing options on the Admin page
- Remove YouTube Play Indicator - Removes the triangle from the title of Youtube shortened URL
- Reset URLs☑️ - Deletes all URLs. For your test install needs.
- Reverse Proxy - Fixes the user IPs to point to the actual user instead of your cloud provider’s infrastructure IPs (Cloudflare, Heroku...)
- rscrub - An "HTTP referrer scrubbing swiss army knife for YOURLS" (evolution of the Hide Referrer plugin)
S ⇡
- Semantic Scuttle - Allows the sharing of the URL to a Semantic Scuttle installation.
- Separate Users - Adds a username to each created URL, and filters the admin interface.
- Shaarli - Allows the sharing of the URL to a Shaarli installation
- Share G+ - Adds Google+ to the Quick Share Box.
- Share LinkedIn - Adds LinkedIn to the Quick Share Box.
- Share with Tumblr☑️ - In the Quick Share box, add a one-click share to Tumblr link.
- Shibboleth - Enable authentication with Shibboleth
- ShortShort - Checks if a URL is already shortened (e.g. t.co, bit.ly, youtu.be) to avoid nested shortened links.
- Show Git Branch☑️ - Using YOURLS on a dev box under Git? Show the current branch in page footer.
- SimpleDB Clickqueue - Queue clicks to Amazon SimpleDB before processing. This allows using a regular MySQL store even in the face of a high frequency of writes, without concern of connection limit overflow. Clicks are inserted later into the database via an import job.
- Skimlinks - Push all links through Skimlinks to automatically embed affiliate codes
- Skip Click Count - Don't count clicks on short URLs
- SMTP Contact - Provides a public contact page using PHPMailer for outbound mail delivery
- Snapshot - Visual preview plugin with image caching powered by PhantomJS.
- YOURLS SQLite☑️ - SQLite driver for YOURLS. It is now considered outdated.
- YOURLS SQLite - A fork of the original SQLite driver for YOURLS, actively maintained.
- Static Titles - Provide two options to avoid the network traffic when retrieving URL titles.
- SSL for SSL - Generates SSL short links if the original link was SSL.
- Swap Short URL - A plugin to have
http://sho.rt/blah
while having YOURLS installed inhttp://sho.rt/yourls/
T ⇡
- Telegram Quickshare - Quickly share a shortened URL via Telegram Messenger.
- Title Refetch - Refetch page titles
- Timezones☑️ - Tell YOURLS your time zone and how you'd like times and dates displayed
- Thumbnail URL image - Get the Thumbnail URL image (long URL) by adding
.i
to the end of the keyword - Time-Period Clicks - A simple API plugin for reporting URL clicks in a specific time period (e.g. the last week, January 1 - February 1, etc).
- Time Limit Link - Set a time limit for links
- Track Custom Keyword - Add a new field to YOURLS designed to track if a keyword was randomly assigned or manually specified
- Typer, a yourls prank plugin - Add an underscore * to your shortlink and the user will be shown a page where they have to type the shortlink themselves.
U ⇡
- Upload and Shorten - Upload and share files with YOURLS
- U-SRV - Provides secure links to files while obfuscating filesystem paths, allowing easy, secure access to files between plugins or from 3rd party scripts. Manual uploading of files is supported.
- Update 30X - An API plugin to test single, domain based, or all available links and update the URL in YOURLS if redirection occures at the destination.
- URL Health Check - Checks submitted URLs for validity, reachability, and redirection. In the case of redirection, the final destination URL will be stored avoiding nested redirects.
W ⇡
- wallabag - Allows the sharing of the URL to a Wallabag installation (previously named Poche)
- Whatsapp quickshare - Allows you to share your short URL via whatsapp
- Word Based Short URLs☑️ - Generate short URLs with adjectives and nouns, like
http://sho.rt/FluffyArrogantUnicorn
X ⇡
Y ⇡
- YAPCache - YAPCache is an APC based cache designed to reduce the database load of YOURLS and increase performance
- YOURS-TN - Display thumbnails on YOURLS admin page and stats page, using thumbnail.ws
- YouTube Title Fix - Fetch YouTube page titles via Google API
Z ⇡
Themes ⇪
This will be the next big thing when YOURLS fully support theming
- ∞² - Infinity Squared, a beautiful public page theme for YOURLS
- Air 66 - A responsive admin theme for YOURLS
- Sleeky - A sleek and simple frontend & backend theme for YOURLS with light and dark modes
Translations ⇪
YOURLS supports localization: this means if a language file for YOURLS in available in your language, YOURLS will speak your language!
- Brazilian: here and here (
pt_BR
) - Bulgarian (
bg_BG
) - Czech (
cs_CZ
) - Danish (
da_DK
) - Dutch (
nl_NL
) - Farsi (
fa_FA
) - Finnish (
fi_FI
) - French (
fr_FR
) - German (
de_DE
) - Hindi (
hi-IN
) - Indonesian (
id_ID
) - Italian (
it_IT
) - Japanese (
ja_JP
) - Korean (
ko_KR
) - Norwegian (bokmål) (
nb_NO
) - Polish (
pl_PL
) - Portuguese (
pt_PT
) - Russian (
ru_RU
) - Simplified Chinese (
zh_CN
) - Slovak (
sk_SK
) - Spanish (
es_ES
) - Telugu (
te_IN
) - Turkish (
tr_TR
) - Traditional Chinese (
zh_TW
) - Viet Nam (
vi_VN
)
Integrations ⇪
Make YOURLS work with other platforms, programming languages or tools
3rd party Integrations and Frameworks ⇡
- WordPress
- YOURLS Link Creator
- YOURLS Widget - Fetch and display YOURLS links and a QR code in a widget.
- There are numerous WordPress plugins with YOURLS support.
- Drupal - YOURLS for Drupal. Requires the title-refetch and API Concurrency Fix plugins to be installed in YOURLS. See this Drupal issue for details.
- CakePHP - Plugin to integrate YOURLS
- FreeBSD Freshport - a FreeBSD package
- Laraval
- Perl
- WWW::Shorten::Yourls - A Perl module to shorten URLs using YOURLS
- AmazonAffiliatesToYourls - Amazon affiliate management
- Ruby - A Ruby wrapper for the YOURLS API
- Python 3 - A Python client for YOURLS, built for Python 3
- Python 2 - Alternative Python 2 client for YOURLS
- status.net - Plugin for status.net to use YOURLS
- VB .Net - A VB .Net 4.0 wrapper for the YOURLS API
- Javascript - JavaScript bindings for the YOURLS API to leverage JSONP support
- YOURLS API for nodejs
- Gnome Desktop - Gnome Shell extension to shorten links in the clipboard
- Telegram bot - A Telegram bot to shorten links
Applications ⇡
-
Android
- aYourls - A dedicated app for YOURLS supporting server-side deletion (needs API Delete)
- iC-YOURLS - A simple YOURLS app for Android, supports receiving links from other apps
-
iOS
- ShortFox2
- Short Menu - YOURLS support requires a one-time in-app purchase of about $2 USD (See also: Setup instructions)
-
Chrome
-
Firefox
-
Mac
- Short Menu - Available for $6 from the App Store or directly from the developer (See also: Setup instructions)
Guides & Tutorials ⇪
Installation guides ⇡
- Installing YOURLS on a Plesk-Hosted Domain
- How to Install YOURLS using Softaculous
- How to Install YOURLS on a VPS or shared hosting
- YOURLS on Azure
- CentOS
- YOURLS on Cloudron
- YOURLS on Installatron
- YOURLS on Fedora
- Guides for Ubuntu :
Installation guides in other languages ⇡
Other tutorials ⇡
Contribute ⇪
Contributions welcome! Read the contribution guidelines first.