Changeset 3708357

Timestamp:

09/23/2026 02:48:32 AM (4 weeks ago)

Author:

sitehale

Message:

SiteHale 0.7.68

Location:

sitehale/trunk

Files:

• changelog.txt (modified) (1 diff)
• includes/class-sitehale-seo-import-options.php (modified) (4 diffs)
• includes/class-sitehale-seo-migration.php (modified) (1 diff)
• includes/class-sitehale-seo-sitemap.php (modified) (1 diff)
• readme.txt (modified) (2 diffs)
• sitehale.php (modified) (2 diffs)

sitehale/trunk/changelog.txt

@@ -3 +3 @@
 readme.txt carries only recent releases: wp.org truncates a Changelog
 section past 5,000 words, silently, at import. This file is the full
-record, newest first (0.7.67 down to 0.1.0).
+record, newest first (0.7.68 down to 0.1.0).
+
+= 0.7.68 =
+* Requests for an old `news-sitemap.xml` address now go to your current sitemap instead of returning "not found".
+* Imports existing SEO settings from two more plugins, Rank Math and SEOPress. A site switching from either keeps its page titles, descriptions, social sharing text and search-engine settings, for posts, pages and category archives alike — and from either one, its title templates, verification codes, social profile links and business details — plus, from Rank Math, any FAQ or How-to information it had added.
 
 = 0.7.67 =

sitehale/trunk/includes/class-sitehale-seo-import-options.php

@@ -469 +469 @@
          * @return array
          */
+        /**
+         * Rank Math's site-level titles/robots options → our slots.
+         *
+         * Shapes read off a live Rank Math 1.0.279 install, not from memory:
+         * `rank-math-options-titles` holds `title_separator`, `homepage_title`,
+         * `pt_<post_type>_title`/`_description`, `tax_<taxonomy>_title`/
+         * `_description`, `author_archive_title`, `date_archive_title`,
+         * `search_title`, `404_title`, and the `noindex_*` toggles.
+         *
+         * ⚠️ ITS VARIABLES ARE SINGLE PERCENTS, and one of them is a trap:
+         * `%term%` is the taxonomy TITLE while `%term_description%` is its
+         * description, so a naive prefix match maps both to the same slot. The
+         * longest key is replaced first for that reason — the same care
+         * `map_yoast_slots` takes with `%%excerpt%%` / `%%excerpt_only%%`.
+         *
+         * Anything still carrying `%…%` after translation is REFUSED, never
+         * published: a template we cannot resolve renders the literal token to
+         * a crawler, which is the AIOSEO smart-tag lesson in a third syntax.
+         *
+         * @param array $titles `rank-math-options-titles`.
+         * @return array{templates:array,separator:string,robots_defaults:array,drops:array}
+         */
+        public static function map_rankmath_slots( $titles ) {
+                $out = array( 'templates' => array(), 'separator' => '',
+                              'robots_defaults' => array(), 'drops' => array() );
+                if ( ! is_array( $titles ) || ! $titles ) {
+                        return $out;
+                }
+
+                // Longest first: %term_description% must not be eaten by %term%.
+                $vocab = array(
+                        '%term_description%' => '#taxonomy_description',
+                        '%category_title%'   => '#taxonomy_title',
+                        '%search_query%'     => '#search_term',
+                        '%customterm%'       => '#taxonomy_title',
+                        '%sitedesc%'         => '#tagline',
+                        '%sitename%'         => '#site_title',
+                        '%excerpt%'          => '#post_excerpt',
+                        '%seo_title%'        => '#post_title',
+                        '%pt_plural%'        => '#archive_title',
+                        '%pt_single%'        => '#archive_title',
+                        '%category%'         => '#taxonomy_title',
+                        '%caption%'          => '#attachment_caption',
+                        '%term%'             => '#taxonomy_title',
+                        '%title%'            => '#post_title',
+                        '%name%'             => '#author_name',
+                        '%date%'             => '#archive_date',
+                        '%sep%'              => '#separator_sa',
+                );
+
+                $fixed = array(
+                        'homepage_title'        => 'site_title',
+                        'homepage_description'  => 'site_description',
+                        'author_archive_title'  => 'author_title',
+                        'author_archive_description' => 'author_description',
+                        'date_archive_title'    => 'date_title',
+                        'search_title'          => 'search_title',
+                        '404_title'             => 'error_title',
+                );
+
+                $translate = static function ( $tpl ) use ( $vocab ) {
+                        // Pagination is ours to add, never theirs to carry.
+                        $tpl = str_replace( array( '%page%', '%pagenumber%', '%pagetotal%' ), '', $tpl );
+                        $tpl = strtr( $tpl, $vocab );
+                        $tpl = trim( preg_replace( '/\s+/u', ' ', $tpl ) );
+                        // ⚠️ Still in Rank Math syntax = untranslatable. NOT a bare `%`
+                        // test: "50% off" is a legitimate template literal.
+                        return preg_match( '/%[a-z][a-z0-9_]*(\([^)]*\))?%/i', $tpl ) ? null : $tpl;
+                };
+
+                foreach ( $titles as $key => $value ) {
+                        if ( 'title_separator' === $key && is_string( $value ) && '' !== trim( $value ) ) {
+                                $out['separator'] = self::separator( trim( $value ) );
+                                continue;
+                        }
+                        if ( ! is_string( $value ) || '' === trim( $value ) ) {
+                                continue;
+                        }
+                        $slot = null;
+                        if ( isset( $fixed[ $key ] ) ) {
+                                $slot = $fixed[ $key ];
+                        } elseif ( preg_match( '/^pt_(.+)_title$/', $key, $m ) ) {
+                                $slot = 'post' === $m[1] ? 'post_title' : 'post_title:' . $m[1];
+                        } elseif ( preg_match( '/^pt_(.+)_description$/', $key, $m ) ) {
+                                $slot = 'post' === $m[1] ? 'post_description' : 'post_description:' . $m[1];
+                        } elseif ( preg_match( '/^tax_(.+)_title$/', $key, $m ) ) {
+                                $slot = 'term_title:' . $m[1];
+                        } elseif ( preg_match( '/^tax_(.+)_description$/', $key, $m ) ) {
+                                $slot = 'term_description:' . $m[1];
+                        }
+                        if ( null === $slot ) {
+                                continue;   // Not a slot we render. Silence, not a drop.
+                        }
+                        $tpl = $translate( trim( $value ) );
+                        if ( null === $tpl ) {
+                                $out['drops'][ 'template.' . $key ] =
+                                        'carries Rank Math variables with no equivalent here: ' . trim( $value );
+                                continue;
+                        }
+                        if ( '' !== $tpl ) {
+                                $out['templates'][ $slot ] = $tpl;
+                        }
+                }
+
+                // Robots defaults. TRUE FLAGS ONLY, and only the policies our head
+                // actually honours — `noindex_empty_taxonomies` has no equivalent
+                // (we do not render a term archive differently for being empty) and
+                // `disable_author_archives` REDIRECTS rather than noindexes, so
+                // importing it as noindex would state something the site does not do.
+                $policy = array(
+                        'noindex_search'           => 'noindex_search',
+                        'noindex_archive_subpages' => 'noindex_paginated',
+                );
+                foreach ( $policy as $theirs => $ours ) {
+                        if ( isset( $titles[ $theirs ] ) && 'on' === strtolower( (string) $titles[ $theirs ] ) ) {
+                                $out['robots_defaults'][ $ours ] = true;
+                        }
+                }
+
+                // ⚠️ THE PER-TYPE ROBOTS NEED THEIR GATE READ TOO. Rank Math stores
+                // `<thing>_robots` as a list AND `<thing>_custom_robots` as on/off,
+                // and the list is inert while the gate is off — a fresh install ships
+                // `pt_attachment_robots: ['noindex']` with its gate ON and
+                // `pt_post_robots: ['index']` with its gate OFF. Reading the list
+                // alone would import directives the site does not serve, which is
+                // the defect this work has now hit three times.
+                //
+                // Only the two our head actually honours are carried: author and
+                // attachment archives. `date_archive_robots` and the per-taxonomy
+                // lists have no equivalent — our policy has no key for them — and a
+                // value stored where nothing reads it is a lie with a long fuse.
+                $gated = array(
+                        'author'        => 'noindex_author',
+                        'pt_attachment' => 'noindex_attachment',
+                );
+                foreach ( $gated as $theirs => $ours ) {
+                        $on   = isset( $titles[ $theirs . '_custom_robots' ] )
+                                && 'on' === strtolower( (string) $titles[ $theirs . '_custom_robots' ] );
+                        $list = isset( $titles[ $theirs . '_robots' ] ) && is_array( $titles[ $theirs . '_robots' ] )
+                                ? array_map( 'strtolower', $titles[ $theirs . '_robots' ] ) : array();
+                        if ( $on && in_array( 'noindex', $list, true ) ) {
+                                $out['robots_defaults'][ $ours ] = true;
+                        }
+                }
+
+                // The share-card shape is a site-level choice our store already has a
+                // slot for, and it is the difference a parity run sees on every page.
+                $card = isset( $titles['twitter_card_type'] ) ? (string) $titles['twitter_card_type'] : '';
+                if ( in_array( $card, array( 'summary', 'summary_large_image' ), true ) ) {
+                        $out['twitter_card'] = $card;
+                }
+                return $out;
+        }
+
+        /**
+         * Rank Math's knowledge-graph identity and social URLs.
+         *
+         * `knowledgegraph_type` is `person` or `company`; only a company is an
+         * Organization, and importing a person's name as an organization name
+         * would be a factual claim about the business (rule 3).
+         *
+         * @param array $titles  `rank-math-options-titles`.
+         * @param array $general `rank-math-options-general`.
+         * @return array{profiles:array,organization:array,tags:array,drops:array}
+         */
+        public static function map_rankmath_identity( $titles, $general ) {
+                $out = array( 'profiles' => array(), 'organization' => array(),
+                              'tags' => array(), 'drops' => array() );
+                $titles  = is_array( $titles ) ? $titles : array();
+                $general = is_array( $general ) ? $general : array();
+
+                $type = strtolower( (string) ( isset( $titles['knowledgegraph_type'] ) ? $titles['knowledgegraph_type'] : '' ) );
+                $name = trim( (string) ( isset( $titles['knowledgegraph_name'] ) ? $titles['knowledgegraph_name'] : '' ) );
+                if ( 'company' === $type && '' !== $name ) {
+                        $out['organization']['name'] = $name;
+                } elseif ( '' !== $name && 'person' === $type ) {
+                        $out['drops']['organization.name'] =
+                                'Rank Math calls this site a person, not a company — importing the '
+                                . 'name as an Organization would state something about the business';
+                }
+                $logo = trim( (string) ( isset( $titles['knowledgegraph_logo'] ) ? $titles['knowledgegraph_logo'] : '' ) );
+                if ( 'company' === $type && 0 === strpos( $logo, 'http' ) ) {
+                        $out['organization']['logo'] = $logo;
+                }
+
+                // Social profile URLs. A handle where a URL belongs is refused for the
+                // same reason map_identity() refuses one: sameAs takes URLs, and
+                // guessing the domain is a claim about an account that may not be ours.
+                $profiles = array(
+                        'social_url_facebook'  => 'facebookPageUrl',
+                        'social_url_instagram' => 'instagramUrl',
+                        'social_url_linkedin'  => 'linkedinUrl',
+                        'social_url_youtube'   => 'youtubeUrl',
+                        'social_url_pinterest' => 'pinterestUrl',
+                );
+                foreach ( $profiles as $theirs => $ours ) {
+                        $value = trim( (string) ( isset( $titles[ $theirs ] ) ? $titles[ $theirs ] : '' ) );
+                        if ( '' === $value ) {
+                                continue;
+                        }
+                        if ( 0 !== strpos( $value, 'http' ) ) {
+                                $out['drops'][ 'profile.' . $ours ] = 'not an absolute URL: ' . $value;
+                                continue;
+                        }
+                        $out['profiles'][ $ours ] = $value;
+                }
+                $handle = trim( (string) ( isset( $titles['twitter_author_names'] ) ? $titles['twitter_author_names'] : '' ) );
+                if ( '' !== $handle ) {
+                        $out['organization']['twitter_handle'] = '@' . ltrim( $handle, '@' );
+                }
+
+                // Webmaster verification, same meta names map_verification() uses.
+                $verify = array(
+                        'google_verify'    => 'google-site-verification',
+                        'bing_verify'      => 'msvalidate.01',
+                        'yandex_verify'    => 'yandex-verification',
+                        'baidu_verify'     => 'baidu-site-verification',
+                        'pinterest_verify' => 'p:domain_verify',
+                        'norton_verify'    => 'norton-safeweb-site-verification',
+                );
+                foreach ( $verify as $theirs => $meta ) {
+                        $value = trim( (string) ( isset( $general[ $theirs ] ) ? $general[ $theirs ] : '' ) );
+                        if ( '' !== $value ) {
+                                $out['tags'][ $meta ] = $value;
+                        }
+                }
+                return $out;
+        }
+
+        /**
+         * SEOPress's site-level options → our slots.
+         *
+         * Shapes read off a live SEOPress install, and the key names checked
+         * against its own source. Three options carry it:
+         * `seopress_titles_option_name` (separator, templates, noindex flags),
+         * `seopress_social_option_name` (knowledge graph, accounts, card) and
+         * `seopress_advanced_option_name` (verification codes).
+         *
+         * ⚠️ ITS TEMPLATES ARE NESTED, not flat: `single_titles[<post_type>]`,
+         * `tax_titles[<taxonomy>]` and `archive_titles[<post_type>]`, each an
+         * array of `title`/`description`. A flat scan finds the four archive
+         * templates and silently misses every per-type one — which is most of
+         * the site.
+         *
+         * ⚠️ AND ITS TAXONOMY TOKENS ARE PER-TAXONOMY: `%%_category_title%%`
+         * (leading underscore) and `%%tag_title%%`, not one generic term token.
+         * Ours is generic, so both map to `#taxonomy_title` — and the longest
+         * key is replaced first so `%%_category_description%%` is not eaten by
+         * `%%_category_title%%`'s prefix.
+         *
+         * @param array $titles `seopress_titles_option_name`.
+         * @return array{templates:array,separator:string,robots_defaults:array,drops:array}
+         */
+        public static function map_seopress_slots( $titles ) {
+                $out = array( 'templates' => array(), 'separator' => '',
+                              'robots_defaults' => array(), 'drops' => array() );
+                if ( ! is_array( $titles ) || ! $titles ) {
+                        return $out;
+                }
+
+                $vocab = array(
+                        '%%_category_description%%' => '#taxonomy_description',
+                        '%%_category_title%%'       => '#taxonomy_title',
+                        '%%term_description%%'      => '#taxonomy_description',
+                        '%%tag_description%%'       => '#taxonomy_description',
+                        '%%search_keywords%%'       => '#search_term',
+                        '%%archive_title%%'         => '#archive_title',
+                        '%%archive_date%%'          => '#archive_date',
+                        '%%post_excerpt%%'          => '#post_excerpt',
+                        '%%post_author%%'           => '#author_name',
+                        '%%cpt_plural%%'            => '#archive_title',
+                        '%%post_title%%'            => '#post_title',
+                        '%%term_title%%'            => '#taxonomy_title',
+                        '%%tag_title%%'             => '#taxonomy_title',
+                        '%%sitetitle%%'             => '#site_title',
+                        '%%tagline%%'               => '#tagline',
+                        '%%sep%%'                   => '#separator_sa',
+                );
+
+                $translate = static function ( $tpl ) use ( $vocab ) {
+                        $tpl = str_replace( array( '%%current_pagination%%', '%%page%%' ), '', (string) $tpl );
+                        $tpl = strtr( $tpl, $vocab );
+                        $tpl = trim( preg_replace( '/\s+/u', ' ', $tpl ) );
+                        // A dangling separator is what a stripped pagination token leaves
+                        // behind ("%%cpt_plural%% %%current_pagination%% %%sep%%").
+                        $tpl = trim( preg_replace( '/(\s*#separator_sa\s*)+$/', '', $tpl ) );
+                        return preg_match( '/%%[^%]+%%/', $tpl ) ? null : $tpl;
+                };
+
+                $take = function ( $slot, $raw, $key ) use ( &$out, $translate ) {
+                        if ( ! is_string( $raw ) || '' === trim( $raw ) ) {
+                                return;
+                        }
+                        $tpl = $translate( trim( $raw ) );
+                        if ( null === $tpl ) {
+                                $out['drops'][ 'template.' . $key ] =
+                                        'carries SEOPress variables with no equivalent here: ' . trim( $raw );
+                                return;
+                        }
+                        if ( '' !== $tpl ) {
+                                $out['templates'][ $slot ] = $tpl;
+                        }
+                };
+
+                if ( ! empty( $titles['seopress_titles_sep'] ) ) {
+                        $out['separator'] = self::separator( trim( (string) $titles['seopress_titles_sep'] ) );
+                }
+                $take( 'site_title', isset( $titles['seopress_titles_home_site_title'] ) ? $titles['seopress_titles_home_site_title'] : '', 'home_site_title' );
+                $take( 'site_description', isset( $titles['seopress_titles_home_site_desc'] ) ? $titles['seopress_titles_home_site_desc'] : '', 'home_site_desc' );
+                $take( 'author_title', isset( $titles['seopress_titles_archives_author_title'] ) ? $titles['seopress_titles_archives_author_title'] : '', 'author_title' );
+                $take( 'date_title', isset( $titles['seopress_titles_archives_date_title'] ) ? $titles['seopress_titles_archives_date_title'] : '', 'date_title' );
+                $take( 'search_title', isset( $titles['seopress_titles_archives_search_title'] ) ? $titles['seopress_titles_archives_search_title'] : '', 'search_title' );
+                $take( 'error_title', isset( $titles['seopress_titles_archives_404_title'] ) ? $titles['seopress_titles_archives_404_title'] : '', '404_title' );
+
+                $nested = array(
+                        'seopress_titles_single_titles'  => array( 'post_title', 'post_description' ),
+                        'seopress_titles_tax_titles'     => array( 'term_title', 'term_description' ),
+                        'seopress_titles_archive_titles' => array( 'archive_title', 'archive_description' ),
+                );
+                foreach ( $nested as $option_key => $slots ) {
+                        if ( empty( $titles[ $option_key ] ) || ! is_array( $titles[ $option_key ] ) ) {
+                                continue;
+                        }
+                        foreach ( $titles[ $option_key ] as $subtype => $pair ) {
+                                if ( ! is_array( $pair ) ) {
+                                        continue;
+                                }
+                                foreach ( array( 'title' => 0, 'description' => 1 ) as $which => $i ) {
+                                        if ( ! isset( $pair[ $which ] ) ) {
+                                                continue;
+                                        }
+                                        $slot = $slots[ $i ];
+                                        // `post` is the default slot; everything else is qualified,
+                                        // exactly as the AIOSEO and Yoast mappers do it.
+                                        if ( 'post_title' === $slot || 'post_description' === $slot ) {
+                                                $slot = ( 'post' === $subtype ) ? $slot : $slot . ':' . $subtype;
+                                        } else {
+                                                $slot = $slot . ':' . $subtype;
+                                        }
+                                        $take( $slot, $pair[ $which ], $option_key . '.' . $subtype . '.' . $which );
+                                }
+                        }
+                }
+
+                // Noindex flags. '1' is on; only the policies our head honours are
+                // carried. `archives_date_noindex` has no key here, and storing it
+                // where nothing reads it would be a value that quietly means nothing.
+                $flags = array(
+                        'seopress_titles_archives_author_noindex'       => 'noindex_author',
+                        'seopress_titles_attachments_noindex'           => 'noindex_attachment',
+                        'seopress_titles_archives_search_title_noindex' => 'noindex_search',
+                );
+                foreach ( $flags as $theirs => $ours ) {
+                        if ( isset( $titles[ $theirs ] ) && '1' === (string) $titles[ $theirs ] ) {
+                                $out['robots_defaults'][ $ours ] = true;
+                        }
+                }
+                return $out;
+        }
+
+        /**
+         * SEOPress's knowledge graph, social accounts, card shape and
+         * verification codes.
+         *
+         * @param array $social   `seopress_social_option_name`.
+         * @param array $advanced `seopress_advanced_option_name`.
+         * @return array{profiles:array,organization:array,tags:array,twitter_card:string,drops:array}
+         */
+        public static function map_seopress_identity( $social, $advanced ) {
+                $out = array( 'profiles' => array(), 'organization' => array(),
+                              'tags' => array(), 'twitter_card' => '', 'drops' => array() );
+                $social   = is_array( $social ) ? $social : array();
+                $advanced = is_array( $advanced ) ? $advanced : array();
+
+                $type = (string) ( isset( $social['seopress_social_knowledge_type'] ) ? $social['seopress_social_knowledge_type'] : '' );
+                $name = trim( (string) ( isset( $social['seopress_social_knowledge_name'] ) ? $social['seopress_social_knowledge_name'] : '' ) );
+                // Person is not an Organization (rule 3, as for Rank Math).
+                if ( '' !== $name && '' !== $type && 'Person' !== $type ) {
+                        $out['organization']['name'] = $name;
+                        $logo = trim( (string) ( isset( $social['seopress_social_knowledge_img'] ) ? $social['seopress_social_knowledge_img'] : '' ) );
+                        if ( 0 === strpos( $logo, 'http' ) ) {
+                                $out['organization']['logo'] = $logo;
+                        }
+                } elseif ( '' !== $name && 'Person' === $type ) {
+                        $out['drops']['organization.name'] =
+                                'SEOPress calls this site a person, not an organization';
+                }
+
+                $profiles = array(
+                        'seopress_social_accounts_facebook'  => 'facebookPageUrl',
+                        'seopress_social_accounts_instagram' => 'instagramUrl',
+                        'seopress_social_accounts_linkedin'  => 'linkedinUrl',
+                        'seopress_social_accounts_youtube'   => 'youtubeUrl',
+                        'seopress_social_accounts_pinterest' => 'pinterestUrl',
+                );
+                foreach ( $profiles as $theirs => $ours ) {
+                        $value = trim( (string) ( isset( $social[ $theirs ] ) ? $social[ $theirs ] : '' ) );
+                        if ( '' === $value ) {
+                                continue;
+                        }
+                        if ( 0 !== strpos( $value, 'http' ) ) {
+                                $out['drops'][ 'profile.' . $ours ] = 'not an absolute URL: ' . $value;
+                                continue;
+                        }
+                        $out['profiles'][ $ours ] = $value;
+                }
+                // ⚠️ SEOPress stores the X account as a USERNAME, not a URL — its own
+                // field validates `^[A-Za-z0-9_]{1,15}$`. So this one is a handle by
+                // design and is stored as a handle, where a Rank Math or AIOSEO URL
+                // would be parsed down to one.
+                $handle = trim( (string) ( isset( $social['seopress_social_accounts_twitter'] ) ? $social['seopress_social_accounts_twitter'] : '' ) );
+                if ( '' !== $handle ) {
+                        $out['organization']['twitter_handle'] = '@' . ltrim( $handle, '@' );
+                }
+
+                // 'large' is its own word for summary_large_image; anything else is
+                // the default card.
+                $size = strtolower( (string) ( isset( $social['seopress_social_twitter_card_img_size'] ) ? $social['seopress_social_twitter_card_img_size'] : '' ) );
+                if ( 'large' === $size ) {
+                        $out['twitter_card'] = 'summary_large_image';
+                } elseif ( 'default' === $size ) {
+                        $out['twitter_card'] = 'summary';
+                }
+
+                $verify = array(
+                        'seopress_advanced_advanced_google'    => 'google-site-verification',
+                        'seopress_advanced_advanced_bing'      => 'msvalidate.01',
+                        'seopress_advanced_advanced_yandex'    => 'yandex-verification',
+                        'seopress_advanced_advanced_pinterest' => 'p:domain_verify',
+                        'seopress_advanced_advanced_baidu'     => 'baidu-site-verification',
+                );
+                foreach ( $verify as $theirs => $meta ) {
+                        $value = trim( (string) ( isset( $advanced[ $theirs ] ) ? $advanced[ $theirs ] : '' ) );
+                        if ( '' !== $value ) {
+                                $out['tags'][ $meta ] = $value;
+                        }
+                }
+                return $out;
+        }
+
+        /**
+         * Is SEOPress the plugin actually describing this site's output?
+         * Same shape and reason as the other two predicates.
+         */
+        public static function seopress_is_renderer() {
+                return defined( 'SEOPRESS_VERSION' )
+                        && ! defined( 'AIOSEO_VERSION' )
+                        && ! defined( 'WPSEO_VERSION' )
+                        && ! defined( 'RANK_MATH_VERSION' );
+        }
+
         public static function map_yoast_social( $social ) {
                 $out = array();
@@ -959 +1410 @@
         }
 
+        /**
+         * Is Rank Math the plugin actually describing this site's output?
+         *
+         * Same shape as `yoast_is_renderer()` and for the same reason: a
+         * deactivated plugin leaves every one of its options behind, so
+         * "its settings exist" says nothing about what the site serves. The
+         * constant is defined only while it is running.
+         *
+         * AIOSEO and Yoast both outrank it: on a site carrying two, the one
+         * that renders is the one whose settings are real, and those two are
+         * checked first everywhere else in this file.
+         */
+        public static function rankmath_is_renderer() {
+                return defined( 'RANK_MATH_VERSION' )
+                        && ! defined( 'AIOSEO_VERSION' )
+                        && ! defined( 'WPSEO_VERSION' );
+        }
+
         public static function collect() {
                 $read = static function ( $name ) {
@@ -1015 +1484 @@
                 }
 
+                // ⚠️ RANK MATH'S SITE-LEVEL OPTIONS, on the same terms as Yoast's:
+                // only where it is the one rendering. Its per-post meta has been
+                // importable since the Sep 2026 work, and a cutover without these
+                // leaves the site with its authored titles and NONE of the templates
+                // that produced every other page's — the hollyfrost failure in a
+                // different plugin's clothes.
+                //
+                // FILLS, never stomps: anything AIOSEO or Yoast already gave stands.
+                $rm_slots = array( 'templates' => array(), 'separator' => '',
+                                   'robots_defaults' => array(), 'drops' => array() );
+                $rm_identity = array( 'profiles' => array(), 'organization' => array(),
+                                      'tags' => array(), 'drops' => array() );
+                if ( self::rankmath_is_renderer() ) {
+                        $rm_titles   = $read( 'rank-math-options-titles' );
+                        $rm_slots    = self::map_rankmath_slots( $rm_titles );
+                        $rm_identity = self::map_rankmath_identity( $rm_titles, $read( 'rank-math-options-general' ) );
+                        foreach ( $rm_slots['templates'] as $slot => $tpl ) {
+                                if ( ! isset( $slots['templates'][ $slot ] ) ) {
+                                        $slots['templates'][ $slot ] = $tpl;
+                                }
+                        }
+                        foreach ( $rm_slots['robots_defaults'] as $k => $v ) {
+                                if ( ! isset( $robots_policy[ $k ] ) ) {
+                                        $robots_policy[ $k ] = $v;
+                                }
+                        }
+                        if ( ! empty( $rm_slots['twitter_card'] ) && ! isset( $social_policy['twitter_card'] ) ) {
+                                $social_policy['twitter_card'] = $rm_slots['twitter_card'];
+                        }
+                        foreach ( $rm_identity['profiles'] as $k => $v ) {
+                                if ( ! isset( $identity['profiles'][ $k ] ) ) {
+                                        $identity['profiles'][ $k ] = $v;
+                                }
+                        }
+                        foreach ( $rm_identity['organization'] as $k => $v ) {
+                                if ( ! isset( $identity['organization'][ $k ] ) ) {
+                                        $identity['organization'][ $k ] = $v;
+                                }
+                        }
+                        foreach ( $rm_identity['tags'] as $k => $v ) {
+                                if ( ! isset( $verification['tags'][ $k ] ) ) {
+                                        $verification['tags'][ $k ] = $v;
+                                }
+                        }
+                }
+
+                // SEOPress, on the same terms as the other two: only where it renders.
+                $sp_slots = array( 'templates' => array(), 'separator' => '',
+                                   'robots_defaults' => array(), 'drops' => array() );
+                $sp_identity = array( 'profiles' => array(), 'organization' => array(),
+                                      'tags' => array(), 'twitter_card' => '', 'drops' => array() );
+                if ( self::seopress_is_renderer() ) {
+                        $sp_slots    = self::map_seopress_slots( $read( 'seopress_titles_option_name' ) );
+                        $sp_identity = self::map_seopress_identity(
+                                $read( 'seopress_social_option_name' ),
+                                $read( 'seopress_advanced_option_name' )
+                        );
+                        foreach ( $sp_slots['templates'] as $slot => $tpl ) {
+                                if ( ! isset( $slots['templates'][ $slot ] ) ) {
+                                        $slots['templates'][ $slot ] = $tpl;
+                                }
+                        }
+                        foreach ( $sp_slots['robots_defaults'] as $k => $v ) {
+                                if ( ! isset( $robots_policy[ $k ] ) ) {
+                                        $robots_policy[ $k ] = $v;
+                                }
+                        }
+                        foreach ( $sp_identity['profiles'] as $k => $v ) {
+                                if ( ! isset( $identity['profiles'][ $k ] ) ) {
+                                        $identity['profiles'][ $k ] = $v;
+                                }
+                        }
+                        foreach ( $sp_identity['organization'] as $k => $v ) {
+                                if ( ! isset( $identity['organization'][ $k ] ) ) {
+                                        $identity['organization'][ $k ] = $v;
+                                }
+                        }
+                        foreach ( $sp_identity['tags'] as $k => $v ) {
+                                if ( ! isset( $verification['tags'][ $k ] ) ) {
+                                        $verification['tags'][ $k ] = $v;
+                                }
+                        }
+                        if ( '' !== $sp_identity['twitter_card'] && ! isset( $social_policy['twitter_card'] ) ) {
+                                $social_policy['twitter_card'] = $sp_identity['twitter_card'];
+                        }
+                }
+
                 $aioseo_sep = self::separator(
                         isset( $global['searchAppearance']['global']['separator'] )
@@ -1062 +1618 @@
                 // which is right by luck on asmc (`sc-dash`) and wrong on any
                 // client who chose a pipe or a bullet.
-                'separator' => ( '' !== $aioseo_sep ) ? $aioseo_sep : $yoast_slots['separator'],
+                // First renderer with one wins, in the same order as everything else
+                // here: AIOSEO, then Yoast, then Rank Math. Each branch above only
+                // ran if that plugin is the one rendering, so at most one is set.
+                'separator' => ( '' !== $aioseo_sep )
+                        ? $aioseo_sep
+                        : ( '' !== $yoast_slots['separator']
+                                ? $yoast_slots['separator']
+                                : ( '' !== $rm_slots['separator'] ? $rm_slots['separator'] : $sp_slots['separator'] ) ),
                 'yoast_drops' => $yoast_slots['drops'],
                 'current'   => get_option( SiteHale_SEO_Store::OPTION, array() ),

sitehale/trunk/includes/class-sitehale-seo-migration.php

@@ -200 +200 @@
 
         /** Sources this build has an importer for. Anything else has not been read. */
-        const READ_SOURCES = array( 'aioseo', 'yoast', 'none' );
+        /**
+         * Sources the importer may legitimately report having read.
+         *
+         * ⚠️ AN UNKNOWN SOURCE HOLDS THE GATE SHUT, which is the safe direction:
+         * the button deactivates the rival, so a source nobody has a reader for
+         * must never resolve to "migrated".
+         *
+         * Rank Math and SEOPress joined on 2026-09-22, and only once BOTH halves
+         * were read. Their per-post meta landed first and that was deliberately
+         * not enough — their taxonomy archives' titles and descriptions live in
+         * term meta (Yoast's in the `wpseo_taxonomy_meta` option), and a flip on
+         * a post-only import strips exactly those pages. The term reader is what
+         * earned them the place, which is why `is_clear()` still demands
+         * `terms` be `scanned` or `absent` alongside this list.
+         *
+         * @var string[]
+         */
+        const READ_SOURCES = array( 'aioseo', 'yoast', 'rankmath', 'seopress', 'none' );
 
         /**

sitehale/trunk/includes/class-sitehale-seo-sitemap.php

@@ -64 +64 @@
         const RETIRED = array(
                 'sitemap_index.xml',
+                // Found by the 404 log on macsolutions within minutes of 0.7.67
+                // (Garret, 2026-09-22): something still asks for it and gets a 404.
+                // AIOSEO advertised it on kava too — the robots unit documents that
+                // it has 404'd since 2026-08-05. A news sitemap is a different KIND
+                // of sitemap, so the 301 goes to the index like every other name
+                // here: the index is true, and a 404 is not.
+                'news-sitemap.xml',
                 'sitemap-index.xml',
                 'sitemap.rss',

sitehale/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 0.7.67
+Stable tag: 0.7.68
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -196 +196 @@
 
 == Changelog ==
+
+= 0.7.68 =
+* Requests for an old `news-sitemap.xml` address now go to your current sitemap instead of returning "not found".
+* Imports existing SEO settings from two more plugins, Rank Math and SEOPress. A site switching from either keeps its page titles, descriptions, social sharing text and search-engine settings, for posts, pages and category archives alike — and from either one, its title templates, verification codes, social profile links and business details — plus, from Rank Math, any FAQ or How-to information it had added.
 
 = 0.7.67 =

sitehale/trunk/sitehale.php

@@ -4 +4 @@
  * Plugin URI:        https://sitehale.com/how-it-works/
  * Description:       Free Site Checkup (cron, PHP errors, database, updates, admins, SEO basics, disk, mail) plus the companion to the SiteHale managed care service. Sends nothing anywhere until you click Connect.
- * Version:           0.7.67
+ * Version:           0.7.68
  * Requires at least: 5.7
  * Requires PHP:      7.4
@@ -30 +30 @@
 }
 
-define( 'SITEHALE_VERSION', '0.7.67' );
+define( 'SITEHALE_VERSION', '0.7.68' );
 define( 'SITEHALE_PLUGIN_FILE', __FILE__ );
 define( 'SITEHALE_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );