array(
'title' => '_yoast_wpseo_title',
'desc' => '_yoast_wpseo_metadesc',
),
self::SEO_RANKMATH => array(
'title' => 'rank_math_title',
'desc' => 'rank_math_description',
),
self::SEO_NATIVE => array(
'title' => '_asgm_meta_title',
'desc' => '_asgm_meta_description',
),
);
/**
* Detect which SEO plugin is active.
*
* @return string One of SEO_YOAST, SEO_RANKMATH, or SEO_NATIVE.
*/
public static function detect_seo_plugin() {
// Rank Math check.
if ( defined( 'RANK_MATH_VERSION' ) || class_exists( '\\RankMath\\Paper\\Paper' ) ) {
return self::SEO_RANKMATH;
}
// Yoast check.
if ( defined( 'WPSEO_VERSION' ) ) {
return self::SEO_YOAST;
}
return self::SEO_NATIVE;
}
/**
* Get detection info for the admin UI and setup wizard.
*
* @return array{plugin: string, label: string, title_key: string, desc_key: string}
*/
public static function get_detection_info() {
$plugin = self::detect_seo_plugin();
$labels = array(
self::SEO_YOAST => 'Yoast SEO',
self::SEO_RANKMATH => 'Rank Math',
self::SEO_NATIVE => 'AEO God Mode (native)',
);
$keys = self::META_KEYS[ $plugin ];
return array(
'plugin' => $plugin,
'label' => $labels[ $plugin ],
'title_key' => $keys['title'],
'desc_key' => $keys['desc'],
);
}
/**
* Write generated metadata to a post.
*
* @param int $post_id Post ID.
* @param string $meta_title Generated meta title.
* @param string $meta_description Generated meta description.
* @param string $product_desc Optional product short description (for WooCommerce/EDD).
* @return array{success: bool, written: array, seo_plugin: string}
*/
public static function write( $post_id, $meta_title, $meta_description, $product_desc = '' ) {
$post = get_post( $post_id );
if ( ! $post ) {
return array(
'success' => false,
'error' => 'Post not found.',
);
}
$plugin = self::detect_seo_plugin();
$keys = self::META_KEYS[ $plugin ];
$written = array();
// Write meta title.
if ( ! empty( $meta_title ) ) {
update_post_meta( $post_id, $keys['title'], sanitize_text_field( $meta_title ) );
// Every generated-title flow writes through this class. Keeping
// the provenance stamp here prevents the generator from writing a
// title successfully while the AEO sidebar still says it was
// never optimized.
update_post_meta( $post_id, '_asgm_generated_title', 'yes' );
$written[] = 'meta_title';
}
// Write meta description.
if ( ! empty( $meta_description ) ) {
update_post_meta( $post_id, $keys['desc'], sanitize_text_field( $meta_description ) );
$written[] = 'meta_description';
}
// Product short description — WooCommerce products and EDD downloads.
$product_types = array( 'product', 'download' );
if ( ! empty( $product_desc ) && in_array( $post->post_type, $product_types, true ) ) {
wp_update_post( array(
'ID' => $post_id,
'post_excerpt' => wp_kses_post( $product_desc ),
) );
$written[] = 'product_description';
}
return array(
'success' => true,
'written' => $written,
'seo_plugin' => $plugin,
'post_type' => $post->post_type,
);
}
/**
* Read existing metadata for a post (for preview/comparison).
*
* @param int $post_id Post ID.
* @return array{meta_title: string, meta_description: string, product_desc: string, seo_plugin: string}
*/
public static function read( $post_id ) {
$plugin = self::detect_seo_plugin();
$keys = self::META_KEYS[ $plugin ];
$post = get_post( $post_id );
return array(
'meta_title' => get_post_meta( $post_id, $keys['title'], true ) ?: '',
'meta_description' => get_post_meta( $post_id, $keys['desc'], true ) ?: '',
'product_desc' => $post ? $post->post_excerpt : '',
'seo_plugin' => $plugin,
);
}
/**
* Render native ASGM meta tags in wp_head when no SEO plugin is active.
*
* Called from the Main class render_native_meta method.
*/
public static function render_native_meta() {
if ( self::detect_seo_plugin() !== self::SEO_NATIVE ) {
return; // Yoast or Rank Math handles this.
}
if ( ! is_singular() ) {
return;
}
$post_id = get_the_ID();
if ( ! $post_id ) {
return;
}
$desc = get_post_meta( $post_id, '_asgm_meta_description', true );
if ( ! empty( $desc ) ) {
echo '' . "\n";
}
}
/**
* Filter the native document title before core renders wp_head.
*
* @param string $title Existing document title.
* @return string
*/
public static function filter_native_title( $title ) {
if ( self::SEO_NATIVE !== self::detect_seo_plugin() || ! is_singular() ) {
return $title;
}
$post_id = get_queried_object_id();
$stored = $post_id ? get_post_meta( $post_id, '_asgm_meta_title', true ) : '';
return '' !== trim( (string) $stored ) ? wp_strip_all_tags( $stored ) : $title;
}
/**
* Get context data from a post for AI generation.
*
* Collects title, content, categories, tags, price, and attributes
* to send as context for the AI metadata generator.
*
* @param int $post_id Post ID.
* @param int $max_chars Max characters of content to include.
* @return array Context data for the AI prompt.
*/
public static function get_post_context( $post_id, $max_chars = 5000 ) {
$post = get_post( $post_id );
if ( ! $post ) {
return array();
}
$content = trim( wp_strip_all_tags( strip_shortcodes( $post->post_content ) ) );
// Fallback: If content is too short (e.g. Page Builders, Custom Templates) fetch the frontend HTML.
// This ensures the AI metadata generator has actual context for these pages.
if ( str_word_count( $content ) < 15 && 'publish' === $post->post_status ) {
$url = get_permalink( $post_id );
if ( $url ) {
$response = wp_remote_get( $url, array(
'timeout' => 5,
'sslverify' => false, // Ensure local/dev environments work
) );
if ( ! is_wp_error( $response ) && 200 === wp_remote_retrieve_response_code( $response ) ) {
$body = wp_remote_retrieve_body( $response );
$body = preg_replace( '@@si', '', $body );
$body = preg_replace( '@@si', '', $body );
$body = preg_replace( '@@si', '', $body );
$body = preg_replace( '@@si', '', $body ); // Skip navigation header/footer
$body = preg_replace( '@@si', '', $body ); // Skip footer
$fallback = trim( wp_strip_all_tags( $body ) );
if ( str_word_count( $fallback ) > str_word_count( $content ) ) {
$content = $fallback;
}
}
}
}
// Additional cleanup: Removing excessive whitespaces and newlines
$content = preg_replace( '/\s+/', ' ', $content );
if ( strlen( $content ) > $max_chars ) {
$content = substr( $content, 0, $max_chars );
}
$context = array(
'post_id' => $post_id,
'post_type' => $post->post_type,
'title' => $post->post_title,
'content' => $content,
'categories' => array(),
'tags' => array(),
);
// Categories and tags vary by post type.
switch ( $post->post_type ) {
case 'product':
$context['categories'] = wp_list_pluck( wp_get_post_terms( $post_id, 'product_cat' ), 'name' );
$context['tags'] = wp_list_pluck( wp_get_post_terms( $post_id, 'product_tag' ), 'name' );
// WooCommerce price.
if ( function_exists( 'wc_get_product' ) ) {
$product = wc_get_product( $post_id );
if ( $product ) {
$context['price'] = $product->get_price();
$context['attributes'] = array();
foreach ( $product->get_attributes() as $attr ) {
if ( is_object( $attr ) && method_exists( $attr, 'get_name' ) ) {
$context['attributes'][ $attr->get_name() ] = $attr->get_options();
}
}
}
}
break;
case 'download':
$context['categories'] = wp_list_pluck( wp_get_post_terms( $post_id, 'download_category' ), 'name' );
$context['tags'] = wp_list_pluck( wp_get_post_terms( $post_id, 'download_tag' ), 'name' );
// EDD price.
if ( function_exists( 'edd_get_download_price' ) ) {
$context['price'] = edd_get_download_price( $post_id );
}
break;
default:
$cats = wp_get_post_categories( $post_id, array( 'fields' => 'names' ) );
$context['categories'] = is_array( $cats ) ? $cats : array();
$tags = wp_get_post_tags( $post_id, array( 'fields' => 'names' ) );
$context['tags'] = is_array( $tags ) ? $tags : array();
break;
}
// Existing metadata for comparison.
$context['existing_meta'] = self::read( $post_id );
return $context;
}
}