Whisper Warning

[Discourse]

	Summary	Adds a warning button to the composer so staff don’t accidentally post publicly when they meant to whisper
	Preview
	Repository	GitHub - discourse/discourse-whisper-warning: This component better distinguishes a public reply from a whisper. · GitHub
	Install Guide	How to install a theme or theme component
	New to Discourse Themes?	Beginner’s guide to using Discourse Themes

Install this theme component

Adds a toggle button to the composer that shows whether your reply will be a whisper (staff-only) or a public reply. Clicking the button toggles whisper mode, making it easy to catch mistakes before posting.

By default the warning appears in read_restricted categories, and in PMs. Setting can be used to customize the scope to your use-case.

Settings

Setting	Default	Description
Whisper only	off	Only show the button when actively composing a whisper. Hides it for public replies.
Show in read-restricted categories	on	Automatically show the warning in categories that aren’t publicly visible.
Show in group PMs	on	Automatically show the warning in PMs where you’re a member of one of the allowed groups.
Restrict to groups	empty	Limit the warning to members of specific groups. Leave empty to show for all users who can whisper.
Restrict to categories	empty	Only show the warning in specific categories. Works alongside the read-restricted setting.

When show in read-restricted categories, show in group PMs, or restrict to categories are configured, they act as context filters — the warning appears if any of them match. When none are configured, the warning shows everywhere.

Restrict to groups and whisper only are global filters that narrow visibility further.

[Lilly]

i think something is broken in this component because the Show in restricted categories and Restrict to categories settings seem to cancel each other out (rather than work alongside). now i cannot seem to get this component to work in every category, regardless of restrictions.

[david (David Taylor)]

In theory, disabling both those switches, and keeping the category list empty, should make it apply everywhere. Is that the combination you’re trying?

On Meta we have both of those checkboxes enabled, and it seems to be showing in private categories & in our group PMs correctly.

[Lilly]

ok i got it working again now. the setting descriptions aren’t very clear. not sure why it wasn’t working for me before in all categories when i had both of those unchecked before (i’ve been trying all combinations).

thanks David

[david (David Taylor)]

Ok, glad to hear it’s working!

If you have any ideas on improving the setting descriptions, please do let us know. I agree it’s kinda confusing how the different settings interact with each other.

We have this description in the OP at the moment:

@Discourse

When show in read-restricted categories, show in group PMs, or restrict to categories are configured, they act as context filters — the warning appears if any of them match. When none are configured, the warning shows everywhere.

[Lilly]

@Discourse

When none are configured, the warning shows everywhere.

yea i was trying this earlier, but it wasn’t working for me. probably issue between keyboard and chair though

edit: DEFINITELY an issue between keyboard and seat