Skip to content

Permissions delete

Permanently delete a Permission

Unlike $pages->trash(), pages deleted here are not restorable.

If you attempt to delete a page with children, and don’t specifically set the $recursive argument to true, then this method will throw an exception. If a recursive delete fails for any reason, an exception will be thrown.

Hook note:
If you want to hook this method, please hook the deleteReady, deleted, or Pages::delete method instead, as hooking this method will not hook relevant pages deleted directly through $pages->delete().

Usage

// basic usage
$bool = $permissions->delete($page);

// usage with all arguments
$bool = $permissions->delete($page, bool $recursive = false);

Arguments

Name

Type(s)

Description

page

Permission, Page

Permission to delete

recursive (optional)

bool

If set to true, then this will attempt to delete any pages below the Permission too.

Return value

bool

True on success, false on failure

Exceptions

Method can throw exceptions on error:

  • WireException