Page Template Usage

For developers

Every default, limit and message has a filter, and every change fires an action. The full reference, with constants, abilities and WP-CLI, is in REFERENCE.md.

axle_page_template_usage_post_typesFilter

Post types to look at. Types without templates are left out on their own ( string[] $post_types )

axle_page_template_usage_sortableFilter

Return false to turn off sorting by template, which joins postmeta and is slow on very large sites ( bool $sortable, string $post_type )

axle_page_template_usage_capabilityFilter

Who may open Appearance > Axle Page Template Usage. Default edit_pages ( string $capability )

axle_page_template_usage_can_access_post_typeFilter

Whether the current user may see and change the templates of a post type, on every screen and in every ability. Default: the capability above and edit_posts on the post type ( bool $allowed, string $post_type )

axle_page_template_usage_move_limitFilter

Items one Move click handles. Default 500 ( int $limit, string $post_type )

axle_page_template_usage_show_missing_noticeFilter

Whether the list screen warns about items on missing templates ( bool $show, string $post_type, int $missing )

axle_page_template_usage_before_reassignAction

Fires before items move, from the screen or WP-CLI ( string $post_type, string $from, string $to, int $limit )

axle_page_template_usage_reassignedAction

Fires for every batch of items moved ( string $post_type, string $from, string $to, int[] $post_ids )

axle_page_template_usage_theme_check_capabilityFilter

Who may check a theme before switching, and save or remove a plan for it. Default switch_themes ( string $capability )

axle_page_template_usage_theme_templatesFilter

Templates a theme that is not active offers, when checking it ( array $templates, string $stylesheet, string $post_type, WP_Theme $theme )

axle_page_template_usage_theme_check_sample_sizeFilter

Example items listed under each template in the check. Default 5 ( int $size )

axle_page_template_usage_theme_mappingFilter

The plan used on activation, post type => ( from => to ). missing as from means every template the theme lacks ( array $mapping, string $stylesheet )

axle_page_template_usage_switch_batch_sizeFilter

Items moved per request after a theme switch. Default 500, the rest follows in the background ( int $size, string $stylesheet )

axle_page_template_usage_apply_on_switchFilter

Return false to keep the plan and run it by hand ( bool $apply, string $stylesheet )

axle_page_template_usage_show_switch_noticeFilter

Whether the notice with the Undo shows after a switch ( bool $show, array $state )

axle_page_template_usage_mapping_savedAction

Fires after a plan is saved or cleared (empty mapping) ( string $stylesheet, array $mapping )

axle_page_template_usage_mapping_appliedAction

Fires after items moved to match a theme that was just activated, once per run ( string $stylesheet, array $state )

axle_page_template_usage_history_capFilter

Changes the history keeps, oldest dropped first. Default 10000, minimum 100 ( int $cap )

axle_page_template_usage_history_retention_daysFilter

Days an entry is kept. Default 365, 0 for no age limit ( int $days )

axle_page_template_usage_history_should_recordFilter

Return false to leave a change out of the history ( bool $record, array $entry )

axle_page_template_usage_history_recordedAction

Fires when a change is recorded, before it is written ( array $entry )

axle_page_template_usage_history_per_pageFilter

Entries per page on the History tab. Default 20 ( int $per_page )

axle_page_template_usage_history_source_labelsFilter

Names shown for the source of a change ( array $labels )

axle_page_template_usage_can_undoFilter

Last word on whether an entry may be undone ( bool $allowed, object $entry )

axle_page_template_usage_undo_limitFilter

Changes one "Undo this batch" click handles. Default 500 ( int $limit )

axle_page_template_usage_undoneAction

Fires after one change was undone ( object $entry )

axle_page_template_usage_batch_undoneAction

Fires after a batch was undone, in whole or in part ( string $batch, array $summary )