PublishPress Capabilities: User Role Access Control, Admin Area Permissions icon
Membership & Users

PublishPress Capabilities: User Role Access Control, Admin Area Permissions hooks reference

  • By PublishPress
  • v2.53.0
  • Updated

PublishPress Capabilities: User Role Access Control, Admin Area Permissions 2.53.0 has 44 actions and 90 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.

How to use these hooks

Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.

functions.phpyour child theme
// Run your own code when PublishPress Capabilities: User Role Access Control, Admin Area Permissions fires an action
add_action( 'pp_capabilities_after_role_copied', function( $role_slug, $copied_role ) {
	// Your code runs here.
}, 10, 2 );

// Change a value PublishPress Capabilities: User Role Access Control, Admin Area Permissions is about to use
add_filter( 'pp_roles_fields', function( $fields, $current ) {
	// Change $fields here.
	return $fields;
}, 10, 2 );

Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.

All hooks

  • includes/roles/class/class-pp-roles-admin.php line 313 · used in 2 places
    /**
     * Customize fields presented on role screen.
     */
    apply_filters( 'pp_roles_fields', $fields, $current );
  • includes/roles/class/class-pp-roles-actions.php line 368
    /**
     * Allow other plugins to perform action after role is copied.
     */
    do_action( 'pp_capabilities_after_role_copied', $role_slug, $copied_role );
  • includes/admin-load.php line 795
    /**
     * Action called when the plugin is downgraded.
     */
    do_action( 'pp_capabilities_downgrade', $previous_version );
  • includes/features/editor-features-classic.php line 41
    /**
     * Add support for section description
     */
    do_action( "pp_capabilities_feature_classic_{$section_slug}_section", $def_post_types, $ce_elements, $ce_post_disabled );
  • includes/features/editor-features-gutenberg.php line 40
    /**
     * Add support for section description
     */
    do_action( "pp_capabilities_feature_gutenberg_{$section_slug}_section", $def_post_types, $gutenberg_elements, $gutenberg_post_disabled );
  • includes/features/frontend-features/frontend-features-restrict.php line 52
    /**
     * Filter if frontend feature should use cache data. Check
     * https://github.com/publishpress/PublishPress-Capabilities/issues/1152
     */
    apply_filters( 'pp_capabilities_frontend_feature_cache', true );
  • includes/admin-load.php line 788
    /**
     * Action called when the plugin is installed.
     */
    do_action( 'pp_capabilities_install', $current_version );
  • includes/test-user.php line 128
    /**
     * Action called before redirecting user after setting authentication for
     * testing user.
     */
    do_action( 'pp_capabilities_test_user_authenticated', $request_user_id, $original_user_id );
  • includes/test-user.php line 93
    /**
     * Action called before redirecting user back
     */
    do_action( 'pp_capabilities_test_user_restored', $original_user_id, $request_user_id );
  • includes/admin-load.php line 802
    /**
     * Action called when the plugin is upgraded.
     */
    do_action( 'pp_capabilities_upgrade', $previous_version );
  • pp_roles_tabs

    filter
    includes/roles/class/class-pp-roles-admin.php line 140
    /**
     * Customize fields tabs presented on role screen.
     */
    apply_filters( 'pp_roles_tabs', $fields_tabs, $current );
  • includes/roles/class/class-pp-roles-manager.php line 110
    /**
     * The computational strategy to use when counting the users.
     */
    apply_filters( 'ppc_role_count_users_time_strategy', true );
  • includes/admin-load.php line 292 · used in 7 places
    apply_filters( 'pp_capabilities_feature_post_types', ['post', 'page'] );
  • classes/pp-capabilities-installer.php line 84 · used in 6 places
    apply_filters( 'cme_publishpress_capabilities_capabilities', [] );
  • includes/admin.php line 269 · used in 5 places
    apply_filters( 'pp_unfiltered_taxonomies', $unfiltered['taxonomy'] );
  • includes/admin.php line 255 · used in 4 places
    apply_filters( 'cme_filterable_taxonomies', get_taxonomies(['public' => true, 'show_ui' => true], 'object', 'or') );
  • includes/admin-load.php line 501 · used in 4 places
    apply_filters( 'editable_roles', wp_roles()->roles );
  • includes/admin.php line 265 · used in 4 places
    apply_filters( 'presspermit_unfiltered_post_types', ['forum','topic','reply', 'customize_changeset'] );
  • includes/admin.php line 782 · used in 3 places
    apply_filters( 'cme_plugin_capabilities', [] );
  • includes/admin.php line 266 · used in 3 places
    apply_filters( 'pp_unfiltered_post_types', $unfiltered['type'] );
  • includes/admin.php line 1411 · used in 2 places
    apply_filters( 'capsman_get_capabilities', array_keys( $this->capabilities ), $this->ID );
  • includes/admin.php line 247 · used in 2 places
    apply_filters( 'cme_filterable_post_types', $post_types );
  • includes/admin.php line 690 · used in 2 places
    apply_filters( 'cme_grouped_capabilities', $grouped_caps );
  • includes/admin.php line 1412 · used in 2 places
    apply_filters( 'members_get_capabilities', $all_capabilities );
  • includes/features/admin-menus/admin-menus-controller.php line 162 · used in 2 places
    apply_filters( 'pp_capabilities_admin_menus_new_menu_enabled', false );
  • includes/features/admin-styles/admin-styles.php line 619 · used in 2 places
    apply_filters( 'pp_capabilities_admin_styles_css_file_exists', $file_exists, $file_path, $style_slug, $file_name, $style, $upload_dir );
  • includes/admin-load.php line 718 · used in 2 places
    do_action( 'pp_capabilities_dashboard_feature_updated', $feature, $feature_status );
  • includes/features/editor-features-classic.php line 17 · used in 2 places
    apply_filters( 'pp_capabilities_editor_features_titles', [] );
  • includes/functions.php line 1313 · used in 2 places
    apply_filters( 'pp_capabilities_nav_menu_access_role_restrictions', $user_roles );
  • includes/pp-ui.php line 235 · used in 2 places
    apply_filters( 'pp_hidden_taxonomies', array() );
  • capsman-enhanced.php line 188 · used in 2 places
    do_action( 'publishpress_capabilities_loaded' );
  • includes/functions-admin.php line 116 · used in 2 places
    apply_filters( 'use_block_editor_for_post_type', $use_block, $post_type, PHP_INT_MAX );
  • framework/lib/users.php line 48
    apply_filters( 'alkivia_roles_translate', $roles );
  • includes/filters.php line 204
    apply_filters( 'cme_assisted_post_types', $post_types, $type_args );
  • includes/filters.php line 222
    apply_filters( 'cme_assisted_taxonomies', $taxonomies, $tx_args );
  • includes/admin.php line 1418
    apply_filters( 'cme_capability_descriptions', [] );
  • includes/network.php line 91
    apply_filters( 'cme_dashboard_feature_sync_batch_size', 50, $feature, $status, $network_id );
  • includes/filters.php line 237
    apply_filters( 'cme_detailed_taxonomies', $taxonomies, $tx_args );
  • includes/cap-helper.php line 231
    do_action( 'cme_distinct_post_capabilities', $enabled_types );
  • includes/plugin-capabilities.php line 225
    apply_filters( 'cme_echo_knowledge_base_capabilities', [ 'admin_eckb_access_manager_page', 'admin_eckb_access_crud_users', 'admin_eckb_access_frontend_editor_write', 'admin_eckb_access_search_analytics_read', 'admin_eckb_access_order_articles_write', 'admin_eckb_access_need_help_read', 'admin_eckb_access_addons_news_read' ] );
  • includes/plugin-capabilities.php line 84
    apply_filters( 'cme_gravityforms_capabilities', [ 'gravityforms_create_form', 'gravityforms_delete_forms', 'gravityforms_edit_forms', 'gravityforms_preview_forms', 'gravityforms_view_entries', 'gravityforms_edit_entries', 'gravityforms_delete_entries', 'gravityforms_view_entry_notes', 'gravityforms_edit_entry_notes', 'gravityforms_export_entries', 'gravityforms_view_settings', 'gravityforms_edit_settings', 'gravityforms_view_updates', 'gravi... );
  • includes/plugin-capabilities.php line 66
    apply_filters( 'cme_multiple_authors_capabilities', [] );
  • includes/handler.php line 404
    apply_filters( 'cme_network_sync_batch_size', 50, $role_name, $do_role_sync, $do_option_sync );
  • includes/plugin-capabilities/publishpress.php line 26
    apply_filters_deprecated( 'cme_publishpress_capabilities', [$caps], '2.11.0', 'cme_plugin_capabilities' );
  • includes/plugin-capabilities/publishpress-cart.php line 50
    apply_filters( 'cme_publishpress_cart_capabilities', $groups );
  • includes/plugin-capabilities.php line 202
    apply_filters( 'cme_taxopress_capabilities', [ 'simple_tags', 'admin_simple_tags' ] );
  • includes/plugin-capabilities.php line 279
    apply_filters( 'cme_woocommerce_capabilities', $woocommerce_caps );
  • includes/plugin-capabilities.php line 123
    apply_filters( 'cme_wpml_capabilities', [ 'wpml_manage_translation_management', 'wpml_manage_languages', 'wpml_manage_translation_options', 'wpml_manage_troubleshooting', 'wpml_manage_taxonomy_translation', 'wpml_manage_wp_menus_sync', 'wpml_manage_translation_analytics', 'wpml_manage_string_translation', 'wpml_manage_sticky_links', 'wpml_manage_navigation', 'wpml_manage_theme_and_plugin_localization', 'wpml_manage_media_translation'... );
  • includes/plugin-capabilities.php line 158
    apply_filters( 'cme_wsform_capabilities', [ 'create_form', 'delete_form', 'edit_form', 'export_form', 'import_form', 'publish_form', 'read_form', 'lock_form', 'unlock_form', 'delete_submission', 'edit_submission', 'export_submission', 'read_submission', 'create_form_style', 'delete_form_style', 'edit_form_style', 'export_form_style', 'import_form_style', 'publish_form_style', 'read_form_style', 'lock_form_style', 'unlock_form_style', '... );
  • includes/plugin-capabilities.php line 251
    apply_filters( 'cme_yoast_seo_capabilities', [ 'view_site_health_checks', 'wpseo_bulk_edit', 'wpseo_edit_advanced_metadata', 'wpseo_manage_options' ] );
  • includes/functions.php line 796
    apply_filters( 'is_pp_capabilities_admin_page', $is_pp_capabilities_page );
  • includes/features/admin-features.php line 185
    do_action( "pp_capabilities_admin_features_{$section_slug}_before_subsection_tr" );
  • includes/features/restrict-admin-features.php line 56
    apply_filters( 'pp_capabilities_admin_features_actions', $actions );
  • includes/features/admin-features.php line 327
    do_action( 'pp_capabilities_admin_features_after_table' );
  • includes/features/admin-features.php line 323
    do_action( 'pp_capabilities_admin_features_after_table_tr' );
  • includes/features/restrict-admin-features.php line 24
    apply_filters( 'pp_capabilities_admin_features_elements', $elements );
  • includes/features/restrict-admin-features.php line 80
    apply_filters( 'pp_capabilities_admin_features_icons', $icons );
  • includes/features/restrict-admin-features.php line 40
    apply_filters( 'pp_capabilities_admin_features_titles', $titles );
  • includes/features/admin-menus/admin-menus-filters.php line 802
    apply_filters( 'pp_capabilities_admin_menu_apply_role_restrictions', $user_roles, compact('menu', 'submenu') );
  • includes/features/admin-menus/admin-menus-controller.php line 183
    do_action( 'pp_capabilities_admin_menus_enqueue_scripts' );
  • includes/functions.php line 776
    apply_filters( 'pp_capabilities_admin_pages', $pp_capabilities_pages );
  • includes/features/admin-styles/admin-styles.php line 677
    apply_filters( 'pp_capabilities_admin_styles_css_url', $css_url, $style_slug, $file_name, $style, $upload_dir );
  • includes/features/admin-styles/admin-styles.php line 521
    apply_filters( 'pp_capabilities_admin_styles_upload_dir', $upload_dir, $uploads );
  • includes/application-passwords.php line 242
    apply_filters( 'pp_capabilities_application_password_subjects', $subjects );
  • includes/functions-admin.php line 281
    apply_filters( 'pp_capabilities_backup_sections', $backup_sections );
  • includes/functions-admin.php line 482
    apply_filters( 'pp_capabilities_dashboard_features', $features );
  • includes/roles/disabled-roles.php line 45
    apply_filters( 'pp_capabilities_disabled_roles', $disabled_roles );
  • includes/roles/disabled-roles.php line 127
    apply_filters( 'pp_capabilities_disabled_roles_preserved_roles', $preserved_roles, $roles, $args );
  • includes/functions-admin.php line 631
    apply_filters( 'pp_capabilities_display_admin_menu_on_subsite', true, $current_user );
  • includes/functions.php line 43
    apply_filters( 'pp_capabilities_editable_role', isset($editable_roles[$role_name]), $role_name );
  • includes/manager.php line 687
    do_action( 'pp_capabilities_editor_features' );
  • framework/lib/formating.php line 60
    do_action( 'pp_capabilities_error' );
  • includes/admin.php line 580
    apply_filters( 'pp_capabilities_extra_post_capability_tabs', [] );
  • includes/features/editor-features-classic.php line 189
    do_action( 'pp_capabilities_features_classic_after_table' );
  • includes/features/editor-features-classic.php line 182
    do_action( 'pp_capabilities_features_classic_after_table_tr' );
  • includes/features/editor-features-gutenberg.php line 185
    do_action( 'pp_capabilities_features_gutenberg_after_table' );
  • includes/features/editor-features-gutenberg.php line 178
    do_action( 'pp_capabilities_features_gutenberg_after_table_tr' );
  • includes/features/frontend-features/frontend-features.php line 146
    do_action( "pp_capabilities_frontend_features_{$section_slug}_before_subsection_tr" );
  • includes/features/frontend-features/frontend-features.php line 227
    do_action( 'pp_capabilities_frontend_features_after_table' );
  • includes/features/frontend-features/frontend-features-data.php line 18
    apply_filters( 'pp_capabilities_frontend_features_elements', $elements );
  • includes/features/frontend-features/frontend-features-ui.php line 136
    do_action( 'pp_capabilities_frontend_features_metabox_post_types' );
  • includes/features/frontend-features/frontend-features-ui.php line 121
    do_action( 'pp_capabilities_frontend_features_pages' );
  • includes/admin.php line 545
    apply_filters( 'pp_capabilities_full_width_tabs', [] );
  • classes/pp-capabilities-installer.php line 21
    do_action( 'pp_capabilities_installed', $currentVersion );
  • includes/functions.php line 1236
    apply_filters( 'pp_capabilities_nav_menu_apply_role_restrictions', $user_roles, compact('menu') );
  • includes/features/restrict-editor-features.php line 490
    apply_filters( 'pp_capabilities_post_feature_elements', $elements );
  • includes/features/restrict-editor-features.php line 222
    apply_filters( 'pp_capabilities_post_feature_elements_classic', $elements );
  • includes/features/profile-features.php line 217
    do_action( 'pp_capabilities_profile_features_after_table' );
  • includes/features/profile-features.php line 214
    do_action( 'pp_capabilities_profile_features_after_table_tr' );
  • includes/features/restrict-profile-features.php line 99
    apply_filters( 'pp_capabilities_profile_features_elements', $elements );
  • includes/settings-ui.php line 160
    do_action( 'pp_capabilities_settings_after_capabilities_content' );
  • includes/settings-ui.php line 39
    do_action( 'pp_capabilities_settings_after_menu_list' );
  • includes/settings-ui.php line 48
    do_action( 'pp_capabilities_settings_before_menu_content' );
  • includes/settings-ui.php line 33
    do_action( 'pp_capabilities_settings_before_menu_list' );
  • includes/functions-admin.php line 369
    apply_filters( 'pp_capabilities_settings_options', $settings_options );
  • includes/admin-load.php line 781
    apply_filters( 'pp_capabilities_skip_installation', false, $previous_version, $current_version );
  • includes/functions-admin.php line 603
    apply_filters( 'pp_capabilities_sub_menu_lists', $sub_menu_pages, $cme_fakefunc );
  • includes/admin-load.php line 298
    apply_filters( 'pp_capabilities_unsupported_post_types', ['attachment'] );
  • classes/pp-capabilities-installer.php line 63
    do_action( 'pp_capabilities_upgraded', $currentVersions );
  • includes/manager.php line 49
    apply_filters( 'pp_caps_core_roles', array( 'administrator', 'editor', 'revisor', 'author', 'contributor', 'subscriber' ) );
  • includes/pp-ui.php line 137
    apply_filters( 'pp_hidden_post_types', $hidden );
  • includes/roles/class/class-pp-roles-admin.php line 532
    apply_filters( 'pp_roles_fields_tabs', self::get_fields_tabs($current, $role_edit, $role_copy), $current, $role_edit, $role_copy );
  • includes/settings.php line 20
    do_action( 'pp-capabilities-settings-ui' );
  • includes/pp-ui.php line 197
    do_action( 'pp-capabilities-type-specific-ui' );
  • includes/roles/class/class-pp-roles-manager.php line 148
    apply_filters( 'pp-roles-get-system-roles', $roles );
  • includes/roles/class/class-pp-roles-manager.php line 165
    apply_filters( 'pp-roles-is-system-role', $is, $role );
  • includes/features/restrict-admin-features.php line 424
    do_action( 'ppc_admin_feature_restriction', $all_disabled_elements );
  • includes/features/frontend-features/frontend-features-restrict.php line 127
    apply_filters( 'ppc_ff_page_restriction_cache_expire_days', $expire_days );
  • includes/features/frontend-features/frontend-features-restrict.php line 118
    do_action( 'ppc_frontend_features_role_raw_restricted_data', $role_disabled_features );
  • includes/features/frontend-features/frontend-features-restrict.php line 119
    do_action( 'ppc_frontend_features_role_restricted_data', $page_restriction_data );
  • includes/functions.php line 513
    apply_filters( 'ppc_login_redirect_bypass', false, $redirect_to, $user );
  • includes/functions.php line 667
    apply_filters( 'ppc_logout_redirect_bypass', false, $redirect_to, $user );
  • includes/functions.php line 441
    apply_filters( 'ppc_registration_redirect_bypass', false, '', $user );
  • includes/roles/class/class-pp-roles-manager.php line 121
    apply_filters( 'ppc_role_count_users_cache_expire_days', $expire_days );
  • includes/functions.php line 572
    apply_filters( 'ppc_woocommerce_login_redirect_bypass', false, $redirect_to, $user );
  • includes/admin.php line 1427
    apply_filters( 'presspermit_cap_descriptions', $plugin_cap_descriptions );
  • includes/pp-ui.php line 136
    apply_filters( 'presspermit_hidden_post_types', [] );
  • includes/functions-admin.php line 29
    apply_filters( 'presspermit_rest_post_id', 0 );
  • includes/functions-admin.php line 824
    apply_filters( 'publishpress_caps_capability_tab_auto_group_sizes', $default_group_sizes, $role, $capabilities );
  • includes/functions-admin.php line 866
    apply_filters( 'publishpress_caps_capability_tab_group_label', $tab_label, $tab_slug, $role, $capabilities );
  • includes/functions-admin.php line 839
    apply_filters( 'publishpress_caps_capability_tab_group_size', $group_size, $tab_slug, $role, $capabilities );
  • includes/functions-admin.php line 900
    apply_filters( 'publishpress_caps_capability_tab_group_title', $group_title, $group_label, $group_start, $group_end, sanitize_key($tab_slug), $role, $group_size, $capabilities );
  • includes/functions-admin.php line 853
    apply_filters( 'publishpress_caps_enable_capability_tab_grouping', $group_enabled, $tab_slug, $group_size, $role, $capabilities );
  • includes/admin.php line 1836
    apply_filters( 'publishpress_caps_manage_additional_caps', $this->capabilities );
  • includes/admin.php line 1211
    apply_filters( 'publishpress_caps_manager_typecaps', $type_caps );
  • includes/admin.php line 1449
    apply_filters( 'publishpress_caps_plugin_capability_groups', [], $plugin_title_raw, $all_plugin_caps, $default );
  • includes/admin.php line 1209
    do_action( 'publishpress-caps_manager_postcaps_section', compact('current', 'rcaps', 'pp_metagroup_caps', 'is_administrator', 'default_caps', 'custom_types', 'defined', 'unfiltered', 'pp_metagroup_caps','caps_manager_postcaps_section', 'active_tab_id') );
  • includes/admin.php line 1190
    do_action( 'publishpress-caps_manager_postcaps_table', $cap_type, $item_type, compact('current', 'rcaps', 'pp_metagroup_caps', 'is_administrator', 'default_caps', 'custom_types', 'defined', 'unfiltered', 'pp_metagroup_caps', 'active_tab_id') );
  • includes/admin.php line 32
    do_action( 'publishpress-caps_manager-load' );
  • includes/handler.php line 34
    do_action( 'publishpress-caps_process_update' );
  • includes/admin.php line 2169
    do_action( 'publishpress-caps_sidebar_bottom' );
  • includes/admin.php line 2008
    do_action( 'publishpress-caps_sidebar_top' );
  • includes/handler.php line 132
    apply_filters( 'publishpress-caps_submission_ok', false );
  • includes/functions-admin.php line 167
    apply_filters( 'use_block_editor_for_post', true, get_post(pp_capabilities_get_post_id()), PHP_INT_MAX );

Generated from PublishPress Capabilities: User Role Access Control, Admin Area Permissions's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.

Can't find the right hook?

We can build the customisation for you. Describe what you need: