', '' ); ?>
get_placeholder_help( [ '%title%', '%site_name%', '%tagline%', '%excerpt%', '%post_type%', '%date%', '%modified_date%', '%separator%' ] ), [ 'code' => [] ] ); ?>
get_placeholder_help( [ '%excerpt%', '%content_summary%', '%title%', '%site_name%', '%tagline%', '%post_type%', '%date%', '%modified_date%' ] ), [ 'code' => [] ] ); ?>
' . esc_html( $placeholder ) . '';
},
$placeholders
);
return sprintf(
/* translators: %s is a comma-separated list of placeholders. */
__( 'Available placeholders: %s', 'admin-optimizer' ),
implode( ', ', $placeholders )
);
}
/**
* Get description fallback text.
*
* @param int $post_id Post ID.
* @param string $fallback Fallback key.
*
* @return string
*/
private function get_description_fallback( $post_id, $fallback ) {
$post = get_post( $post_id );
if ( ! $post instanceof \WP_Post ) {
return '';
}
switch ( $fallback ) {
case 'content':
return $this->get_trimmed_text_context( $post->post_content, 160 );
case 'site_tagline':
return get_bloginfo( 'description' );
case 'empty':
return '';
case 'excerpt':
default:
return $this->get_excerpt_text( $post );
}
}
/**
* Get clean excerpt text.
*
* @param \WP_Post $post Post object.
*
* @return string
*/
private function get_excerpt_text( $post ) {
$excerpt = has_excerpt( $post ) ? $post->post_excerpt : wp_trim_words( $this->get_trimmed_text_context( $post->post_content, 600 ), 30, '' );
return $this->get_trimmed_text_context( $excerpt, 160 );
}
/**
* Get canonical URL for singular content.
*
* @param int $post_id Post ID.
* @param array $seo_data Post SEO data.
* @param array $settings Module settings.
*
* @return string
*/
private function get_canonical_url( $post_id, $seo_data, $settings ) {
if ( empty( $settings['allow_canonical_override'] ) ) {
return ! empty( $settings['auto_canonical'] ) ? get_permalink( $post_id ) : '';
}
$canonical_url = $this->sanitize_canonical_url( isset( $seo_data['canonical_url'] ) ? $seo_data['canonical_url'] : '', $post_id );
if ( ! empty( $settings['allow_canonical_override'] ) && ! empty( $canonical_url ) ) {
return $canonical_url;
}
return ! empty( $settings['auto_canonical'] ) ? get_permalink( $post_id ) : '';
}
/**
* Determine whether a URL points to this post's permalink, including old slugs.
*
* @param string $url URL to test.
* @param int $post_id Post ID.
*
* @return bool
*/
private function is_own_permalink_url( $url, $post_id ) {
$normalized_url = $this->normalize_url_for_comparison( $url );
$normalized_permalink = $this->normalize_url_for_comparison( get_permalink( $post_id ) );
if ( '' === $normalized_url ) {
return false;
}
if ( $normalized_permalink === $normalized_url ) {
return true;
}
if ( url_to_postid( $url ) === (int) $post_id ) {
return true;
}
$path = (string) wp_parse_url( $normalized_url, PHP_URL_PATH );
$slug = basename( untrailingslashit( $path ) );
$old_slugs = get_post_meta( $post_id, '_wp_old_slug', false );
return '' !== $slug && in_array( $slug, $old_slugs, true );
}
/**
* Normalize URLs for same-URL comparison.
*
* @param string $url URL to normalize.
*
* @return string
*/
private function normalize_url_for_comparison( $url ) {
$url = esc_url_raw( trim( (string) $url ) );
if ( '' === $url ) {
return '';
}
$parts = wp_parse_url( $url );
if ( empty( $parts['host'] ) ) {
return untrailingslashit( $url );
}
$scheme = ! empty( $parts['scheme'] ) ? strtolower( $parts['scheme'] ) . '://' : '';
$host = strtolower( $parts['host'] );
$port = ! empty( $parts['port'] ) ? ':' . (int) $parts['port'] : '';
$path = ! empty( $parts['path'] ) ? untrailingslashit( $parts['path'] ) : '';
$query = ! empty( $parts['query'] ) ? '?' . $parts['query'] : '';
return $scheme . $host . $port . $path . $query;
}
/**
* Sanitize a canonical URL override.
*
* Canonical overrides should be absolute URLs. Relative paths are easy for
* AI to guess incorrectly for child pages, so leave them empty and let the
* automatic permalink canonical handle the current post.
*
* @param mixed $url URL to sanitize.
* @param int $post_id Post ID.
* @param array $known_own_urls Additional URLs known to belong to this post.
*
* @return string
*/
private function sanitize_canonical_url( $url, $post_id = 0, $known_own_urls = [] ) {
if ( is_array( $url ) || is_object( $url ) ) {
return '';
}
if ( ! is_array( $known_own_urls ) ) {
$known_own_urls = [];
}
$url = esc_url_raw( trim( (string) $url ) );
if ( '' === $url ) {
return '';
}
$parts = wp_parse_url( $url );
if ( ! is_array( $parts ) ) {
return '';
}
$scheme = isset( $parts['scheme'] ) ? strtolower( $parts['scheme'] ) : '';
if ( empty( $parts['host'] ) || ! in_array( $scheme, [ 'http', 'https' ], true ) ) {
return '';
}
if ( $post_id && $this->is_own_permalink_url( $url, $post_id ) ) {
return '';
}
$normalized_url = $this->normalize_url_for_comparison( $url );
foreach ( $known_own_urls as $known_url ) {
if ( $normalized_url && $normalized_url === $this->normalize_url_for_comparison( $known_url ) ) {
return '';
}
}
return $url;
}
/**
* Get social image URL using the per-post priority chain.
*
* @param int $post_id Post ID.
* @param string $post_image Post-level image URL.
* @param string $default_image Global fallback image URL.
*
* @return string
*/
private function get_social_image( $post_id, $post_image, $default_image ) {
if ( ! empty( $post_image ) ) {
return $post_image;
}
$featured_image = get_the_post_thumbnail_url( $post_id, 'full' );
if ( $featured_image ) {
return $featured_image;
}
$content_image = $this->get_first_content_image_url( get_post_field( 'post_content', $post_id ) );
if ( $content_image ) {
return $content_image;
}
return $default_image;
}
/**
* Check whether current archive/system page should be noindexed.
*
* @return bool
*/
private function get_global_noindex_for_current_request() {
$settings = $this->get_module_settings();
$rules = isset( $settings['default_noindex'] ) && is_array( $settings['default_noindex'] ) ? $settings['default_noindex'] : [];
if ( empty( $rules ) ) {
return false;
}
return ( is_search() && in_array( 'search', $rules, true ) )
|| ( is_author() && in_array( 'author', $rules, true ) )
|| ( is_date() && in_array( 'date', $rules, true ) )
|| ( is_category() && in_array( 'category', $rules, true ) )
|| ( is_tag() && in_array( 'tag', $rules, true ) )
|| ( is_404() && in_array( '404', $rules, true ) );
}
/**
* Sanitize a schema type value.
*
* @param mixed $schema_type Schema type.
*
* @return string
*/
private function sanitize_schema_type( $schema_type ) {
if ( is_array( $schema_type ) || is_object( $schema_type ) ) {
return 'auto';
}
$schema_type = sanitize_key( $schema_type );
return array_key_exists( $schema_type, $this->get_schema_type_options() ) ? $schema_type : 'auto';
}
/**
* Sanitize SEO data.
*
* @param array $data SEO data.
* @param int $post_id Post ID.
*
* @return array
*/
private function sanitize_seo_data( $data, $post_id = 0 ) {
$focus_keyword = '';
if ( isset( $data['focus_keyword'] ) && ! is_array( $data['focus_keyword'] ) && ! is_object( $data['focus_keyword'] ) ) {
$focus_keyword = $this->limit_text_length( sanitize_text_field( $data['focus_keyword'] ), 100 );
}
$secondary_keywords = [];
if ( isset( $data['secondary_keywords'] ) && ! is_object( $data['secondary_keywords'] ) ) {
$secondary_keywords = $this->sanitize_secondary_keywords( $data['secondary_keywords'] );
}
$known_own_urls = [];
if ( isset( $data['_rendered_permalink'] ) && ! is_array( $data['_rendered_permalink'] ) && ! is_object( $data['_rendered_permalink'] ) ) {
$known_own_urls[] = $data['_rendered_permalink'];
}
$canonical_url = isset( $data['canonical_url'] ) ? $this->sanitize_canonical_url( $data['canonical_url'], $post_id, $known_own_urls ) : '';
return [
'focus_keyword' => $focus_keyword,
'secondary_keywords' => $secondary_keywords,
'meta_title' => isset( $data['meta_title'] ) ? sanitize_text_field( $data['meta_title'] ) : '',
'meta_description' => isset( $data['meta_description'] ) ? sanitize_textarea_field( $data['meta_description'] ) : '',
'facebook_image' => isset( $data['facebook_image'] ) ? esc_url_raw( $data['facebook_image'] ) : '',
'x_image' => isset( $data['x_image'] ) ? esc_url_raw( $data['x_image'] ) : '',
'canonical_url' => $canonical_url,
'noindex' => empty( $data['noindex'] ) ? 0 : 1,
'schema_type' => isset( $data['schema_type'] ) ? $this->sanitize_schema_type( $data['schema_type'] ) : 'auto',
];
}
/**
* Sanitize secondary keywords into a deduplicated, capped array of keyword
* strings. Accepts either the raw comma-separated string submitted by the
* form field, or an already-split array (e.g. re-sanitizing a stored
* value read back from post meta).
*
* @param string|array $raw Raw secondary keywords input.
*
* @return array
*/
private function sanitize_secondary_keywords( $raw ) {
$keywords = is_array( $raw ) ? $raw : explode( ',', (string) $raw );
$seen = [];
$result = [];
foreach ( $keywords as $keyword ) {
if ( is_array( $keyword ) || is_object( $keyword ) ) {
continue;
}
$keyword = $this->limit_text_length( sanitize_text_field( trim( $keyword ) ), 100 );
if ( '' === $keyword ) {
continue;
}
$dedup_key = strtolower( $keyword );
if ( isset( $seen[ $dedup_key ] ) ) {
continue;
}
$seen[ $dedup_key ] = true;
$result[] = $keyword;
if ( count( $result ) >= 5 ) {
break;
}
}
return $result;
}
/**
* Determine whether SEO Manager should print a fallback title tag.
*
* @return bool
*/
private function should_output_title_tag(): bool {
if ( current_theme_supports( 'title-tag' ) ) {
return false;
}
if ( function_exists( 'wp_is_block_theme' ) && wp_is_block_theme() ) {
return false;
}
return true;
}
/**
* Strip and trim content for AI context.
*
* @param string $text Text.
* @param int $max Maximum characters.
*
* @return string
*/
private function get_trimmed_text_context( $text, $max ) {
$text = strip_shortcodes( (string) $text );
$text = wp_strip_all_tags( $text, true );
$text = preg_replace( '/\s+/', ' ', $text );
$text = trim( $text );
return $this->limit_text_length( $text, $max );
}
/**
* Get the first image URL in post content.
*
* @param string $content Post content.
*
* @return string
*/
private function get_first_content_image_url( $content ) {
if ( preg_match( '/