This hook wraps the standard Misago function used to check whether a user has permission to restore a post from a post edit. Raises Django's PermissionDenied if they don't.
This hook can be imported from misago.permissions.hooks:
from misago.permissions.hooks import check_restore_post_edit_permission_hookdef custom_check_restore_post_edit_permission_filter(
action: CheckRestorePostEditPermissionHookAction,
permissions: 'UserPermissionsProxy',
post_edit: PostEdit,
) -> None:
...A function implemented by a plugin that can be registered in this hook.
Next function registered in this hook, either a custom function or Misago's standard one.
See the action section for details.
A proxy object with the current user's permissions.
A post edit to check permissions for.
def check_restore_post_edit_permission_action(
permissions: 'UserPermissionsProxy', post_edit: PostEdit
) -> None:
...Misago function used to check if a user has permission to restore a post from a post edit. Raises Django's PermissionDenied if they don't.
A proxy object with the current user's permissions.
A post edit to check permissions for.
The code below implements a custom filter function that blocks a user from restoring a post from a post edit if it contains disallowed words.
from django.core.exceptions import PermissionDenied
from django.utils.translation import pgettext
from misago.edits.models import PostEdit
from misago.permissions.hooks import check_restore_post_edit_permission_hook
from misago.permissions.proxy import UserPermissionsProxy
@check_restore_post_edit_permission_hook.append_filter
def check_user_can_hide_protected_post_edit(
action,
permissions: UserPermissionsProxy,
post_edit: PostEdit,
) -> None:
# Run standard permission checks
action(permissions, post_edit)
if (
not permissions.is_global_moderator
and post_edit.old_content
and "swear" in post_edit.old_content.lower()
):
raise PermissionDenied(
pgettext(
"edits permission error",
"You can't restore the post from this edit."
)
)