Limnoria/plugins/Later
Valentin Lorentz 63eb6672ea Revert generic 'The Limnoria Contributors' in copyright notices
This commit reverts db7ef3f025
(though it keeps the year updates)

After discussion with several people, it seems better to mention
copyright owners explicitly. eg. https://reuse.software/faq/#vcs-copyright
explains the issue of using VCSs to track copyright.

As db7ef3f025 only replaced mentions
of my name with 'The Limnoria Contributors', this commit only needs
to undo that + add one person who contributed to setup.py.
2021-10-17 09:57:55 +02:00
..
locales Fix msgfmt warnings. 2020-03-26 22:10:28 +01:00
__init__.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
config.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
messages.pot PluginDownloader: update l10n-fi. 2014-03-22 16:38:16 +02:00
plugin.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00
README.rst all plugins: regenerate READMEs 2021-04-22 00:29:15 +02:00
test.py Revert generic 'The Limnoria Contributors' in copyright notices 2021-10-17 09:57:55 +02:00

Documentation for the Later plugin for Supybot

Purpose

Informal notes, mostly for compatibility with other bots. Based entirely on nicks, it's an easy way to tell users who refuse to register notes when they arrive later.

Usage

Used to do things later; currently, it only allows the sending of nick-based notes. Do note (haha!) that these notes are not private and don't even pretend to be; if you want such features, consider using the Note plugin.

Use the later tell command to leave a message to a user. If you sent the message by accident or want to cancel it, you can use the later undo command to remove the latest later, which you have sent.

You can also see the people who have notes waiting for them by using the later notes command. If you specify a nickname in later notes command, you will see the notes, which are waiting for the nickname.

Privacy

As you probably noticed from above, this plugin isn't private. Everyone can see notes sent by anyone and the laters are sent on channel by default and as the "plugin help later" says:

Used to do things later; currently, it only allows the sending of nick-based notes. Do note (haha!) that these notes are *not* private and don't even pretend to be; if you want such features, consider using the Note plugin.

The Note plugin identifies people by username instead of nickname and allows only users to send notes. The only people who are able to read notes are the sender, receiver, and the owner.

Commands

notes [<nick>]

If <nick> is given, replies with what notes are waiting on <nick>, otherwise, replies with the nicks that have notes waiting for them.

remove <nick>

Removes the notes waiting on <nick>.

tell <nick1[,nick2[,...]]> <text>

Tells each <nickX> <text> the next time <nickX> is seen. <nickX> can contain wildcard characters, and the first matching nick will be given the note.

undo <nick>

Removes the latest note you sent to <nick>.

Configuration

supybot.plugins.Later.format

This is a group of:

supybot.plugins.Later.format.senderHostname

This config variable defaults to "False", is not network-specific, and is not channel-specific.

Determines whether senders' hostname will be shown in messages (instead of just the nick).

supybot.plugins.Later.maximum

This config variable defaults to "0", is not network-specific, and is not channel-specific.

Determines the maximum number of messages to be queued for a user. If this value is 0, there is no maximum.

supybot.plugins.Later.messageExpiry

This config variable defaults to "30", is not network-specific, and is not channel-specific.

Determines the maximum number of days that a message will remain queued for a user. After this time elapses, the message will be deleted. If this value is 0, there is no maximum.

supybot.plugins.Later.private

This config variable defaults to "False", is not network-specific, and is not channel-specific.

Determines whether users will be notified in the first place in which they're seen, or in private.

supybot.plugins.Later.public

This config variable defaults to "True", is not network-specific, and is not channel-specific.

Determines whether this plugin is publicly visible.

supybot.plugins.Later.tellOnJoin

This config variable defaults to "False", is not network-specific, and is not channel-specific.

Determines whether users will be notified upon joining any channel the bot is in, or only upon sending a message.