check-reply-private-thread-permission-hook.md

check_reply_private_thread_permission_hook

This hook wraps the standard function that Misago uses to check if the user has permission to reply to a private thread. It raises Django's PermissionDenied with an error message if they can't post in it.

Location

This hook can be imported from misago.permissions.hooks:

from misago.permissions.hooks import check_reply_private_thread_permission_hook

Filter

def custom_check_reply_private_thread_permission_filter(
    action: CheckReplyPrivateThreadPermissionHookAction,
    permissions: 'UserPermissionsProxy',
    thread: Thread,
) -> None:
    ...

A function implemented by a plugin that can be registered in this hook.

Arguments

action: CheckReplyPrivateThreadPermissionHookAction

Next function registered in this hook, either a custom function or Misago's standard one.

See the action section for details.

user_permissions: UserPermissionsProxy

A proxy object with the current user's permissions.

thread: Thread

A thread to check permissions for.

Action

def check_reply_private_thread_permission_action(
    permissions: 'UserPermissionsProxy', thread: Thread
) -> None:
    ...

Misago function used to check if the user has permission to reply to a private thread. It raises Django's PermissionDenied with an error message if they can't reply to it.

Arguments

user_permissions: UserPermissionsProxy

A proxy object with the current user's permissions.

thread: Thread

A thread to check permissions for.

Example

The code below implements a custom filter function that prevents a user from replying to a private thread if they are a thread starter.

from django.core.exceptions import PermissionDenied
from misago.permissions.hooks import check_reply_private_thread_permission_hook
from misago.permissions.proxy import UserPermissionsProxy
from misago.threads.models import Thread

@check_reply_private_thread_permission_hook.append_filter
def check_user_can_reply_in_private_thread(
    action,
    permissions: UserPermissionsProxy,
    thread: Thread,
) -> None:
    user = permissions.user
    if user.is_authenticated and user.id == thread.starter_id:
        raise PermissionDenied("You can't reply to threads you've started.")

    action(permissions, thread)