Plugin for Yourls : Domain blacklisting
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 7 commits ahead of Panthro:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Plugin for Yourls that disallows blacklisted domains. Further, if YourlsBlacklistIPs is installed it also blacklists the submitter's IP address.

This plugin is intended to be used with YOURLS (cf.

It has been tested on YOURLS v1.5.1 and YourlsBlacklistIPs v1.3

Current version is 0.03

Contact : apelly[ at ]len[ dot ]io


  • In user/plugins, git clone
  • Go to the plugins administration page and activate the plugin.


  • In user/plugins/YourlsBlacklistDomains, git pull


You will see in the admin section a new admin page where you can manage the blacklist.

Enter one domain on each line, the blacklisting relies on simple substring matching within the whole URL.

If you have YourlsBlacklistIPs installed and activated then any IP that attempts to shorten a blacklisted URL will automatically be blacklisted by that plugin too.


Thanks to Panthro for YourlsWhiteListDomains which was basically all of the code for this, and for kindly giving permission to puplish under GPL.

You are free to fork whatever you want, that's what code is for!

Also thanks to LudoBoggio for the YourlsBlacklistIPs plugin which was the base for YourlsWhiteListDomains.

I've written this plugin for the community, to help Yourls users, to help Yourls author, to help to spread this software, to pay my free use of it, and to learn a bit more of programming. I didn't provide any license informations because I never tried to understand them. Therefore, I leave you all rights to use my plugin in any way you want, the fact that it help to bring more Yourls user is just enough from my point of view.


v0.03 Fix some crap code (of mine)
v0.02 Cosmetic changes
v0.01 Initial code


Neither YourlsWhiteListDomains, nor YourlsBlacklistIPs are distributed with licensing or copyright details but both Panthro and LudoBoggio have given explicit permission to use and distribute their code.

Copyright© (2012) Aaron Pelly


This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <>.