' . esc_html__( 'Author with core blocks only — client sites do not have Kadence Blocks.', 'bw-guides-server' ) . '
';
echo '';
echo '';
echo '';
echo '
';
echo '';
echo '';
echo '' . esc_html__( 'Used only when "Specific client" is selected above. Every active site whose Client (set on Guides → Sites) matches this slug will receive the guide — including sites added after this guide is published.', 'bw-guides-server' ) . '';
echo '
';
if ( empty( $sites ) ) {
echo '
' . esc_html__( 'No sites registered yet — add them under Guides → Sites.', 'bw-guides-server' ) . '
';
echo '' . esc_html__( 'One rule per line: Heading text :: keyword, keyword, keyword. Use * as the heading for guide-level keywords (not tied to a section).', 'bw-guides-server' ) . ' ';
echo '
';
echo '
' . esc_html__( 'Heading text must match a current heading exactly (case-insensitive) or you\'ll see a warning after saving — it still saves either way.', 'bw-guides-server' ) . '
';
}
/**
* Distinct non-empty categories already in use, for the datalist.
*
* @return string[]
*/
private function existing_categories() {
global $wpdb;
$categories = $wpdb->get_col(
"SELECT DISTINCT meta_value FROM {$wpdb->postmeta} WHERE meta_key = '_bw_guides_category' AND meta_value != '' ORDER BY meta_value ASC"
);
return array_values( array_filter( (array) $categories ) );
}
public function save_keywords( $post_id, $post ) {
// Same guard shape as save_targeting(): absent on autosaves/REST-only
// saves that don't submit metaboxes — bail without touching existing meta.
if ( ! isset( $_POST['bw_guides_keywords_nonce'] ) ) {
return;
}
if ( ! wp_verify_nonce( sanitize_key( wp_unslash( $_POST['bw_guides_keywords_nonce'] ) ), 'bw_guides_keywords_' . $post_id ) ) {
return;
}
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
if ( wp_is_post_revision( $post_id ) || ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
$category = isset( $_POST['bw_guides_category'] ) ? sanitize_text_field( wp_unslash( $_POST['bw_guides_category'] ) ) : '';
update_post_meta( $post_id, '_bw_guides_category', $category );
// NOTE: editing _bw_guides_category / _bw_guides_section_keywords via
// `wp eval`/wp-cli directly (rather than through this metabox) does
// NOT bump post_modified_gmt, so clients relying on modified_gmt to
// decide whether to re-pull a guide won't see the change. A metabox
// save always goes through wp_update_post() (via the block-editor
// metabox-compat submission) and bumps it correctly. If content is
// ever edited via wp-cli alone, follow with
// `wp post update --post_title="$(wp post get --field=post_title)"`
// (or any no-op wp_update_post( array( 'ID' => ) ) call) to touch it.
$raw_lines = isset( $_POST['bw_guides_section_keywords'] ) ? (string) wp_unslash( $_POST['bw_guides_section_keywords'] ) : '';
$rows = array();
foreach ( preg_split( '/\r\n|\r|\n/', $raw_lines ) as $line ) {
$line = trim( $line );
if ( '' === $line ) {
continue;
}
$parts = explode( '::', $line, 2 );
if ( count( $parts ) < 2 ) {
continue; // No "::" separator — nothing to reliably parse, skip the line.
}
$heading = trim( $parts[0] );
$keywords = trim( $parts[1] );
if ( '' === $heading ) {
continue;
}
$rows[] = array(
'heading' => $heading,
'keywords' => $keywords,
);
}
update_post_meta( $post_id, '_bw_guides_section_keywords', $rows );
$this->check_keyword_heading_mismatches( $post_id, $post, $rows );
}
/**
* Flag (but never block on) keyword lines whose heading no longer
* exists in the guide's content — usually because a heading was
* reworded after the keyword line was written.
*/
private function check_keyword_heading_mismatches( $post_id, $post, $rows ) {
$current_headings = array();
if ( preg_match_all( '#<(h[23])\b[^>]*>(.*?)#is', (string) $post->post_content, $m ) ) {
foreach ( $m[2] as $h ) {
$current_headings[] = trim( wp_strip_all_tags( $h ) );
}
}
$current_lc = array_map( 'strtolower', $current_headings );
$mismatches = array();
foreach ( $rows as $row ) {
if ( '*' === $row['heading'] ) {
continue; // Guide-level keywords are not tied to a heading.
}
if ( ! in_array( strtolower( $row['heading'] ), $current_lc, true ) ) {
$mismatches[] = $row['heading'];
}
}
if ( ! empty( $mismatches ) ) {
set_transient( 'bw_guides_server_kw_mismatch_' . $post_id, $mismatches, 60 );
} else {
delete_transient( 'bw_guides_server_kw_mismatch_' . $post_id );
}
}
public function render_keyword_mismatch_notice() {
global $pagenow;
if ( 'post.php' !== $pagenow || empty( $_GET['post'] ) ) {
return;
}
$post_id = absint( $_GET['post'] );
if ( BW_Guides_Server_CPT::POST_TYPE !== get_post_type( $post_id ) ) {
return;
}
$mismatches = get_transient( 'bw_guides_server_kw_mismatch_' . $post_id );
if ( empty( $mismatches ) || ! is_array( $mismatches ) ) {
return;
}
delete_transient( 'bw_guides_server_kw_mismatch_' . $post_id );
echo '
'
. esc_html__( 'BW Guides: some keyword lines reference headings that don\'t currently exist in this guide:', 'bw-guides-server' )
. '
';
foreach ( $mismatches as $h ) {
echo '
' . esc_html( $h ) . '
';
}
echo '
' . esc_html__( 'The guide still saved — check for a renamed or removed heading.', 'bw-guides-server' ) . '