ircredirect

Tool created by Ahecht. Source available at https://ircredirect.toolforge.org/source.php or on github.

The ircredirect tool redirects users to an irc channel on kiwiirc.com with a randomly generated username. The generated username consists of an adjective taken from a list of 20 adjectives, a noun taken from a list of nouns, and a two-digit number. The two digit number and the adjective are issued sequentially, while the noun is chosen randomly from the list.

By default, the script redirects to the main Wikipedia channel (#wikipedia on irc.libera.chat). This can be overridden by adding the server and channel to the url, e.g. https://ircredirect.toolforge.org/irc.libera.chat/wikipedia-en-help. You can also specify the channel= and server= paraters individually, e.g. https://ircredirect.toolforge.org/?server=irc.libera.chat&channel=wikipedia-en-help.

Per https://phabricator.wikimedia.org/T172612, user consent must be obtained before redirecting to a third-party server. If user consent was gained on the page linking to the ircredirect tool, add consent=yes to the end of the URL to silenty redirect to kiwiirc.com without displaying the disclaimer, e.g. https://ircredirect.toolforge.org/irc.libera.chat/wikipedia-en-help/?consent=yes

By default, the seed values for generating the usernames are taken from Wikipedia:IRC help disclaimer/nicks.json. This can be changed by adding the lang=, project=, and/or title= parameters, e.g. https://ircredirect.toolforge.org/?lang=en&project=wikipedia&title=Wikipedia:IRC_help_disclaimer/nicks.json. lang=, project=, and/or title= default to "en", "wikipedia", and "Wikipedia:IRC help disclaimer/nicks.json", respectively, if omitted. Using lang= and project= will also change the default IRC channel as appropriate if the channel is not specified.

Alternatively, the baseurl= parameter can be added to the url to represent the full URL of the plain text seed file. The URL should be urlencoded and must begin with "https", e.g. https://ircredirect.toolforge.org/?baseurl=https%3A%2F%2Fen.wikipedia.org%2Fw%2Findex.php%3Ftitle%3DWikipedia%3AIRC_help_disclaimer%2Fnicks.json%3Faction%3Draw

Seed value files will only be loaded from the following WMF-owned domains:

The seed value file is a JSON file, and should contain a "nouns" object and an "adjectives" array. If the file is not found or not properly formatted, the generated name will default to "WPHelp" followed by a two digit number. An example seed file can be found here.

The script will return the text of the redirect URL and other debugging information instead of actually performing the redirect if the debug= parameter is set to any value.


The MIT License

Copyright © 2017–2021 Ahecht

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.