orbit-compat-rankmathlisted

# 🪐 orbit-compat-rankmath — RankMath SEO coexistence RankMath grew to ~3M sites in ~5 years. More aggressive default-on features than Yoast — schema, breadcrumbs, redirections, all enabled by default. --- ## What this skill checks ### 1. Schema graph (RankMath ships ALL schema types by default) RankMath registers schema for Article, Organization, WebSite, Product, Recipe, Event, etc. — most are on by default. Your plugin's schema duplicates. ```php // Hook into RankMath's pipeline instead add_filter( 'rank_math/schema/snippet', 'my_plugin_extend_rm_schema' ); add_filter( 'rank_math/schema/data', 'my_plugin_alter_rm_schema_data' ); ``` ### 2. Title + meta description **Whitepaper intent:** RankMath replaces `<title>` and `<meta name="description">`. Don't double-output. Detect and defer: ```php if ( class_exists( 'RankMath' ) || defined( 'RANK_MATH_VERSION' ) ) { // Don't output title / meta description } ``` ### 3. Sitemap (RankMath ships sitemap.xml) Same conflict as Yoast — RM generates `/sitemap_index.xml`. Hook in instead of duplicating. ### 4. Redirections RankMath has a "Redirections" module (404 → URL mapping). Plugins that ALSO redirect (membership plugins, multilingual) conflict on the same URL. Order of precedence: - WP core `template_redirect` action - RankMath redirections (priority 11) - Other plugins Document where your plugin sits in the priority chain. ### 5. REST namespace `/wp-json/rankmath/v1/` — don't shadow. ### 6. Breadcrumb function ```p