mirror of
https://github.com/PluralKit/PluralKit.git
synced 2026-02-04 04:56:49 +00:00
docs: multiple docs updates (#712)
* docs: user-guide, timezone clear Fix docs-to-commands inconsistency. Now properly says how to clear your set timezone. * docs: user-guide, group privacy Adds in detailed docs on group privacy (mostly copy-pasted from member privacy). * docs: user-guide, ping 🛎 reaction Lists the :bellhop: reaction as something that will trigger the "ping alter" behavior. * docs: user-guide, group privacy 2 Re-ordered to be consistent with command `pk;g <group> privacy` output & fixed leftover error from copy/pasting too hard from members. * docs: command-list, pk;sw add > pk;sw copy Replaces primary alias of pk;switch add to pk;switch copy following discussion on Discord. https://discord.com/channels/466707357099884544/1314433710250266632/1314608434951360552
This commit is contained in:
parent
eb7df8bddb
commit
b73dd370d1
2 changed files with 44 additions and 3 deletions
|
|
@ -124,7 +124,7 @@ You can have a space after `pk;`, e.g. `pk;system` and `pk; system` will do the
|
|||
- `pk;switch [member...]` - Registers a switch with the given members.
|
||||
- `pk;switch out` - Registers a 'switch-out' - a switch with no associated members.
|
||||
- `pk;switch edit <member...|out>` - Edits the members in the latest switch.
|
||||
- `pk;switch add <member...>` - Makes a new switch based off the current switch with the listed members added or removed.
|
||||
- `pk;switch copy <member...>` - Makes a new switch based off the current switch with the listed members added or removed.
|
||||
- `pk;switch move <time>` - Moves the latest switch backwards in time.
|
||||
- `pk;switch delete` - Deletes the latest switch.
|
||||
- `pk;switch delete all` - Deletes all logged switches.
|
||||
|
|
|
|||
|
|
@ -140,7 +140,7 @@ specifying an exact time zone code is the best way. To get your local time zone
|
|||
You can see the full list [here, on Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) (see the column *TZ database name*).
|
||||
You can also search by country code, either by giving the two-character [*ISO-3166-1 alpha-2* country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) (e.g. `GB` or `DE`), or just by a country flag emoji (e.g. `:flag_gb:` 🇬🇧 or `:flag_de:` 🇩🇪).
|
||||
|
||||
To clear a time zone, type `pk;config timezone` without any parameters.
|
||||
To clear a time zone, type `pk;config timezone clear`. Note that this does not ask for confirmation!
|
||||
|
||||
### Deleting a system
|
||||
If you want to delete your own system, simply use the command:
|
||||
|
|
@ -453,7 +453,7 @@ You can
|
|||
|
||||
#### Pinging the user who sent it
|
||||
If you'd like to "ping" the account behind a proxied message without having to query the message and ping them yourself,
|
||||
you can react to the message with the `:bell:` :bell: emoji (or `:exclamation:` :exclamation:, or even `:ping_pong:` :ping_pong:), and PluralKit will ping the relevant member and account in the same channel on your behalf with a link to the message you reacted to.
|
||||
you can react to the message with the `:bell:` :bell: emoji (or `:bellhop:` :bellhop:, `:exclamation:` :exclamation:, or even `:ping_pong:` :ping_pong:), and PluralKit will ping the relevant member and account in the same channel on your behalf with a link to the message you reacted to.
|
||||
|
||||
## Autoproxy
|
||||
The bot's *autoproxy* feature allows you to have messages be proxied without directly including the proxy tags. Autoproxy can be set up in various ways. There are three autoproxy modes currently implemented:
|
||||
|
|
@ -769,6 +769,47 @@ For example:
|
|||
pk;member Robert privacy birthday public
|
||||
pk;member Skyler privacy all private
|
||||
|
||||
### Group privacy
|
||||
|
||||
Additionally, groups also have privacy settings.
|
||||
|
||||
- Name
|
||||
- Description
|
||||
- Banner
|
||||
- Icon
|
||||
- Member list
|
||||
- Metadata *(group creation date)*
|
||||
- Visibility *(whether the group shows up on member cards)*
|
||||
|
||||
As with system and member privacy, each can be set to **public** or **private**. The same rules apply for how they are shown, too. When set to **public**, anyone who queries your system (by account or system ID, or through the API), will see this information. When set to **private**, the information will only be shown when *you yourself* query the information. The cards will still be displayed in the channel the commands are run in, so it's still your responsibility not to pull up information in servers where you don't want it displayed.
|
||||
|
||||
As with member privacy, there are two catches:
|
||||
- When the **name** is set to private, it will be replaced by the group's **display name**, but only if they have one! If the group has no display name, **name privacy will not do anything**. PluralKit still needs some way to refer to a group by name :)
|
||||
- When **visibility** is set to private, the group will not show up in group lists unless `-all` is used in the command (and you are part of the system).
|
||||
|
||||
To update a group's privacy, you can use the command:
|
||||
|
||||
pk;group <group> privacy <subject> <level>
|
||||
|
||||
* `subject` is one of:
|
||||
* `name`
|
||||
* `description`
|
||||
* `banner`
|
||||
* `avatar`
|
||||
* `members`
|
||||
* `metadata`
|
||||
* `visiblity`
|
||||
* `all` (to change all subjects at once)
|
||||
|
||||
* `level` is either `public` or `private`
|
||||
|
||||
For example:
|
||||
|
||||
pk;group MyGroup privacy visibility private
|
||||
pk;group "My Group" privacy description public
|
||||
pk;group SuperCoolGroup privacy banner public
|
||||
pk;group AwesomePeople privacy all private
|
||||
|
||||
## Importing and exporting data
|
||||
If you're a user of another proxy bot (e.g. Tupperbox), or you want to import a saved system backup, you can use the importing and exporting commands. Note, if you are on a mobile device, using the links is recommended - using the .json file from either bot may not work as Discord tends to break the file on download/upload.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue