mirror of https://github.com/zulip/zulip.git
help: Rename and redirect stream-sending-policy for channel.
This commit is contained in:
parent
5342d4ecfb
commit
c931966e1b
|
@ -39,7 +39,7 @@ The **bot type** determines what the bot can do.
|
|||
|
||||
Bot type | Permissions | Common uses
|
||||
---|---|---
|
||||
Generic | Like a normal user account | Automating tasks, bots that listen to all messages on a stream
|
||||
Generic | Like a normal user account | Automating tasks, bots that listen to all messages on a channel
|
||||
Incoming webhook | Limited to only sending messages into Zulip | Automated notifications into Zulip
|
||||
Outgoing webhook | Generic bot that also receives new messages via HTTP post requests | Third party integrations, most custom bots
|
||||
|
||||
|
@ -49,16 +49,16 @@ bot can.
|
|||
|
||||
A few more details:
|
||||
|
||||
* Bots can send messages to any stream that their owner can,
|
||||
inheriting their owner's [sending permissions](/help/stream-sending-policy).
|
||||
* Bots can send messages to any channel that their owner can,
|
||||
inheriting their owner's [sending permissions](/help/channel-posting-policy).
|
||||
|
||||
* Bots can be subscribed to streams, and their role can be modified if
|
||||
* Bots can be subscribed to channels, and their role can be modified if
|
||||
they need to have permission to do administrative actions.
|
||||
|
||||
* [Channel permissions](/help/channel-permissions) are the same for bots
|
||||
as for other users. Therefore, for private streams with protected
|
||||
as for other users. Therefore, for private channels with protected
|
||||
history, a bot can only access messages sent after it subscribed
|
||||
to the stream.
|
||||
to the channel.
|
||||
|
||||
* **Generic**: A generic bot is like a normal Zulip user account that
|
||||
cannot log in via a browser. Note that if you truly want to
|
||||
|
@ -66,7 +66,7 @@ A few more details:
|
|||
account), you'll need to use your **personal API key**.
|
||||
|
||||
* **Outgoing webhook**: The bot can read direct messages where the bot is a
|
||||
participant, and stream messages where the bot is [mentioned](/help/mention-a-user-or-group). When the
|
||||
participant, and channel messages where the bot is [mentioned](/help/mention-a-user-or-group). When the
|
||||
bot is DM'd or mentioned, it POSTs the message content to a URL of your
|
||||
choice. The POST request format can be in a Zulip format or a
|
||||
Slack-compatible format.
|
||||
|
|
|
@ -81,7 +81,7 @@ administrator can access private channel messages:
|
|||
<span class="legend_symbol">◾</span><span class="legend_label">If subscribed to the channel</span>
|
||||
|
||||
<span class="legend_symbol">✶</span><span class="legend_label">
|
||||
Configurable. See [Stream posting policy](/help/stream-sending-policy),
|
||||
Configurable. See [Channel posting policy](/help/channel-posting-policy),
|
||||
[Configure who can add users][add-users], and
|
||||
[Configure who can remove users][remove-users]
|
||||
for details.
|
||||
|
@ -112,7 +112,7 @@ for details.
|
|||
|
||||
<span class="legend_symbol">✶</span><span class="legend_label">
|
||||
Configurable, but at minimum must be subscribed to the channel.
|
||||
See [Stream posting policy](/help/stream-sending-policy),
|
||||
See [Channel posting policy](/help/channel-posting-policy),
|
||||
[Configure who can add users][add-users], and
|
||||
[Configure who can remove users][remove-users]
|
||||
for details.
|
||||
|
@ -121,7 +121,7 @@ for details.
|
|||
## Related articles
|
||||
|
||||
* [Roles and permissions](/help/roles-and-permissions)
|
||||
* [Stream sending policy](/help/stream-sending-policy)
|
||||
* [Channel sending policy](/help/channel-posting-policy)
|
||||
* [Web-public channels](/help/public-access-option)
|
||||
|
||||
[add-users]: /help/configure-who-can-invite-to-streams#configure-who-can-add-users
|
||||
|
|
|
@ -1,9 +1,9 @@
|
|||
# Stream posting policy
|
||||
# Channel posting policy
|
||||
|
||||
{!admin-only.md!}
|
||||
|
||||
By default, anyone who belongs to a stream can also send messages to
|
||||
the stream. However, sometimes it's useful to have a stream (often a
|
||||
By default, anyone who belongs to a channel can also send messages to
|
||||
the channel. However, sometimes it's useful to have a channel (often a
|
||||
[default stream](/help/set-default-streams-for-new-users)) where only
|
||||
certain users can send messages.
|
||||
|
||||
|
@ -11,11 +11,11 @@ certain users can send messages.
|
|||
|
||||
{relative|stream|all}
|
||||
|
||||
1. Select a stream.
|
||||
1. Select a channel.
|
||||
|
||||
{!select-channel-view-general.md!}
|
||||
|
||||
1. Under **Stream permissions**, configure **Who can post to the stream**.
|
||||
1. Under **Channel permissions**, configure **Who can post to the channel**.
|
||||
|
||||
{!save-changes.md!}
|
||||
|
|
@ -15,7 +15,7 @@ language](/help/change-your-language).
|
|||
Notices about stream settings changes, such as [name](/help/rename-a-stream),
|
||||
[description](/help/change-the-stream-description),
|
||||
[permission](/help/channel-permissions) and
|
||||
[policy](/help/stream-sending-policy) updates are sent to the
|
||||
[policy](/help/channel-posting-policy) updates are sent to the
|
||||
“stream events” topic in the stream that was modified.
|
||||
|
||||
### New stream announcements
|
||||
|
|
|
@ -202,7 +202,7 @@
|
|||
## Stream management
|
||||
* [Channel permissions](/help/channel-permissions)
|
||||
* [Public access option](/help/public-access-option)
|
||||
* [Stream posting policy](/help/stream-sending-policy)
|
||||
* [Channel posting policy](/help/channel-posting-policy)
|
||||
* [Restrict stream creation](/help/configure-who-can-create-streams)
|
||||
* [Restrict stream membership management](/help/configure-who-can-invite-to-streams)
|
||||
* [Add or remove users from a channel](/help/add-or-remove-users-from-a-channel)
|
||||
|
|
|
@ -53,7 +53,7 @@ problematic behavior.
|
|||
so only [moderators](/help/roles-and-permissions) can mention everyone in your organization.
|
||||
* Create a [default stream](/help/set-default-streams-for-new-users)
|
||||
for announcements where [only admins can
|
||||
post](/help/stream-sending-policy).
|
||||
post](/help/channel-posting-policy).
|
||||
* Restrict who can [send direct messages](/help/restrict-direct-messages).
|
||||
|
||||
## Response
|
||||
|
|
|
@ -229,9 +229,9 @@ channel](/help/create-a-channel#channel-options).
|
|||
For most classes, the following streams are recommended:
|
||||
|
||||
- **#announcements**: For general announcements about the class. When
|
||||
creating this stream, [restrict posting
|
||||
permissions](/help/stream-sending-policy) so that only course staff
|
||||
([Administrators and moderators](/help/roles-and-permissions) are
|
||||
creating this channel, [restrict posting
|
||||
permissions](/help/channel-posting-policy) so that only course staff
|
||||
([administrators and moderators](/help/roles-and-permissions)) are
|
||||
allowed to post.
|
||||
- **#staff (private)**: For discussions among course staff.
|
||||
- **#general**: For random topics, e.g. students forming study groups.
|
||||
|
|
|
@ -880,7 +880,7 @@
|
|||
</tr>
|
||||
<tr>
|
||||
<td class="comparison-table-feature">
|
||||
<a href="/help/stream-sending-policy">Stream posting permissions</a>
|
||||
<a href="/help/channel-posting-policy">Stream posting permissions</a>
|
||||
</td>
|
||||
<td class="comparison-value-positive cloud-cell"><i class="icon icon-check"></i></td>
|
||||
<td class="comparison-value-positive cloud-cell"><i class="icon icon-check"></i></td>
|
||||
|
|
|
@ -28,7 +28,7 @@
|
|||
|
||||
<div class="input-group">
|
||||
<label class="settings-field-label">{{t 'Who can post to the channel?'}}
|
||||
{{> ../help_link_widget link="/help/stream-sending-policy" }}
|
||||
{{> ../help_link_widget link="/help/channel-posting-policy" }}
|
||||
</label>
|
||||
<select name="stream-post-policy" class="stream_post_policy_setting prop-element settings_select bootstrap-focus-style" id="id_stream_post_policy" data-setting-widget-type="number">
|
||||
{{#each stream_post_policy_values}}
|
||||
|
|
|
@ -1359,7 +1359,7 @@ def send_change_stream_post_policy_notification(
|
|||
)
|
||||
notification_string = notification_string.format(
|
||||
user=user_mention,
|
||||
help_link="/help/stream-sending-policy",
|
||||
help_link="/help/channel-posting-policy",
|
||||
old_policy=Stream.POST_POLICIES[old_post_policy],
|
||||
new_policy=Stream.POST_POLICIES[new_post_policy],
|
||||
)
|
||||
|
|
|
@ -180,7 +180,7 @@ def convert_channel_data(
|
|||
|
||||
# If the channel is read-only, then only admins and moderators
|
||||
# should be allowed to post in the converted Zulip stream.
|
||||
# For more details: https://zulip.com/help/stream-sending-policy
|
||||
# For more details: https://zulip.com/help/channel-posting-policy
|
||||
#
|
||||
# See `Stream` model in `zerver/models/streams.py` to know about what each
|
||||
# number represent.
|
||||
|
|
|
@ -104,6 +104,7 @@ HELP_DOCUMENTATION_REDIRECTS: List[URLRedirect] = [
|
|||
"/help/manage-user-stream-subscriptions", "/help/manage-user-channel-subscriptions"
|
||||
),
|
||||
URLRedirect("/help/stream-permissions", "/help/channel-permissions"),
|
||||
URLRedirect("/help/stream-sending-policy", "/help/channel-posting-policy"),
|
||||
]
|
||||
|
||||
LANDING_PAGE_REDIRECTS = [
|
||||
|
|
|
@ -17868,7 +17868,7 @@ paths:
|
|||
- Stream [name](/help/rename-a-stream) and [description](/help/change-the-stream-description)
|
||||
- Stream [permissions](/help/channel-permissions), including
|
||||
[privacy](/help/change-the-privacy-of-a-stream) and [who can
|
||||
send](/help/stream-sending-policy).
|
||||
send](/help/channel-posting-policy).
|
||||
|
||||
Note that an organization administrator's ability to change a
|
||||
[private stream's permissions](/help/channel-permissions#private-channels)
|
||||
|
|
|
@ -1990,7 +1990,7 @@ class StreamAdminTest(ZulipTestCase):
|
|||
messages = get_topic_messages(user_profile, stream, "channel events")
|
||||
expected_notification = (
|
||||
f"@_**{user_profile.full_name}|{user_profile.id}** changed the "
|
||||
"[posting permissions](/help/stream-sending-policy) for this channel:\n\n"
|
||||
"[posting permissions](/help/channel-posting-policy) for this channel:\n\n"
|
||||
"* **Old permissions**: All channel members can post.\n"
|
||||
"* **New permissions**: Only organization administrators can post."
|
||||
)
|
||||
|
@ -2053,7 +2053,7 @@ class StreamAdminTest(ZulipTestCase):
|
|||
messages = get_topic_messages(user_profile, stream, "channel events")
|
||||
expected_notification = (
|
||||
f"@_**{user_profile.full_name}|{user_profile.id}** changed the "
|
||||
"[posting permissions](/help/stream-sending-policy) for this channel:\n\n"
|
||||
"[posting permissions](/help/channel-posting-policy) for this channel:\n\n"
|
||||
f"* **Old permissions**: {Stream.POST_POLICIES[old_post_policy]}.\n"
|
||||
f"* **New permissions**: {Stream.POST_POLICIES[policy]}."
|
||||
)
|
||||
|
|
Loading…
Reference in New Issue