', '' )`) * respects directly. Works on any theme that calls `the_title()` for the * page heading. * * Strict gating keeps the override confined to the main H1 only — it does * NOT change the browser tab title, OG/Twitter meta tags, admin list-table * titles, nav-menu item labels, or breadcrumb segments. * * Allowed HTML in the override (sanitized at save time via wp_kses): * , , , ,
, * * Storage: post meta key `_bw_dev_title_override` — underscore prefix hides * it from the Custom Fields UI; default-state posts store nothing. * * @package BW_Dev */ defined( 'ABSPATH' ) || exit; class BW_Dev_Module_Title_Override implements BW_Dev_Module_Interface { const META_KEY = '_bw_dev_title_override'; const NONCE_FIELD = 'bw_dev_title_override_nonce'; const NONCE_ACTION = 'bw_dev_title_override_save'; /** * Defaults: enabled on `page` only. Posts and CPTs are opt-in via the * settings tab — most blogs don't want the override on every blog post. */ private const DEFAULTS = array( 'post_types' => array( 'page' ), ); public function slug(): string { return 'title_override'; } public function label(): string { return __( 'Title Override', 'bw-dev' ); } public function group(): string { return 'editor_admin'; } public function default_settings(): array { return self::DEFAULTS; } public function sanitize( array $data ): array { $valid_pts = array_keys( $this->available_post_types() ); $selected = isset( $data['post_types'] ) && is_array( $data['post_types'] ) ? $data['post_types'] : array(); $out = array(); foreach ( $selected as $pt ) { $pt = sanitize_key( (string) $pt ); if ( in_array( $pt, $valid_pts, true ) ) { $out[] = $pt; } } return array( 'post_types' => array_values( array_unique( $out ) ) ); } public function register(): void { add_action( 'add_meta_boxes', array( $this, 'add_meta_box' ), 10, 2 ); add_action( 'save_post', array( $this, 'save_meta_box' ), 10, 2 ); add_filter( 'the_title', array( $this, 'filter_title' ), 10, 2 ); } /* --------------------------------------------------------------------- * Helpers * ------------------------------------------------------------------- */ private function enabled_post_types(): array { $value = bw_dev()->settings()->get( $this->slug(), 'post_types', self::DEFAULTS['post_types'] ); return is_array( $value ) ? array_values( $value ) : self::DEFAULTS['post_types']; } private function is_post_type_enabled( string $post_type ): bool { return in_array( $post_type, $this->enabled_post_types(), true ); } /** * Public post types offered in the settings tab. Filterable in case a * site wants to expose a private CPT. */ public function available_post_types(): array { $types = get_post_types( array( 'public' => true ), 'objects' ); unset( $types['attachment'] ); $out = array(); foreach ( $types as $slug => $obj ) { $out[ $slug ] = $obj->labels->name; } return (array) apply_filters( 'bw_dev_title_override_post_types', $out ); } private function allowed_html(): array { return array( 'em' => array(), 'strong' => array(), 'i' => array(), 'b' => array(), 'br' => array(), 'span' => array( 'class' => array() ), ); } /* --------------------------------------------------------------------- * Meta box * ------------------------------------------------------------------- */ public function add_meta_box( $post_type, $post ): void { unset( $post ); if ( ! $this->is_post_type_enabled( (string) $post_type ) ) { return; } add_meta_box( 'bw_dev_title_override', __( 'Page Title Override (BW Dev)', 'bw-dev' ), array( $this, 'render_meta_box' ), $post_type, 'side', 'high' ); } public function render_meta_box( $post ): void { wp_nonce_field( self::NONCE_ACTION, self::NONCE_FIELD ); $value = (string) get_post_meta( $post->ID, self::META_KEY, true ); ?>

, , , ,
, .', 'bw-dev' ); ?>

Our Company" or "About
Our Company".', 'bw-dev' ); ?>

is_post_type_enabled( (string) $post->post_type ) ) { return; } $raw = isset( $post_data['bw_dev_title_override'] ) ? trim( (string) $post_data['bw_dev_title_override'] ) : ''; if ( '' === $raw ) { delete_post_meta( $post_id, self::META_KEY ); return; } $clean = wp_kses( $raw, $this->allowed_html() ); update_post_meta( $post_id, self::META_KEY, $clean ); } /* --------------------------------------------------------------------- * the_title filter — gated to the main H1 only * ------------------------------------------------------------------- */ public function filter_title( $title, $post_id = null ) { // Frontend-only: bail in admin. if ( is_admin() ) { return $title; } // Skip non-rendering contexts. if ( wp_doing_ajax() ) { return $title; } if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) { return $title; } // Skip during wp_head — that's when OG/Twitter/SEO plugins build the // document title and social meta tags, and we don't want to override // those. (We can't gate on in_the_loop() because some themes — Kadence // included — render the H1 hero in `kadence_hero_header` BEFORE the // `while ( have_posts() )` loop body, so in_the_loop() is false at // the moment our filter fires.) if ( doing_action( 'wp_head' ) ) { return $title; } // Need a singular main-query context. if ( ! is_singular() || ! is_main_query() ) { return $title; } // Only target the queried object's title — not embedded posts, related- // post widgets, or anything else that happens to filter through the_title. if ( ! $post_id || (int) $post_id !== (int) get_queried_object_id() ) { return $title; } // Only on enabled post types. $post_type = get_post_type( (int) $post_id ); if ( ! is_string( $post_type ) || ! $this->is_post_type_enabled( $post_type ) ) { return $title; } $override = get_post_meta( (int) $post_id, self::META_KEY, true ); if ( ! is_string( $override ) || '' === trim( $override ) ) { return $title; } // Stored value is already kses-cleaned at save time. Trust it on render. return $override; } /* --------------------------------------------------------------------- * Settings tab * ------------------------------------------------------------------- */ public function render_tab(): void { $prefix = BW_Dev_Settings::OPTION . '[' . $this->slug() . ']'; $enabled_pt = $this->enabled_post_types(); $pts = $this->available_post_types(); ?>

  • , , , ,
    , . Anything else is stripped on save.', 'bw-dev' ); ?>
delete( $wpdb->postmeta, array( 'meta_key' => self::META_KEY ), array( '%s' ) ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key } }