rationalwp

<p>Rational SEO provides 100% of the technical SEO requirements for modern sites with 0% of the database bloat, UI clutter, or performance drag.</p>
<h4>Philosophy</h4>
<p>Rational SEO rigorously rejects features that do not directly influence search engines or social crawlers:</p>
<ul>
<li><strong>No Content Scoring</strong> – No traffic lights, readability checks, or keyword density counters</li>
<li><strong>No Dashboard</strong> – No “SEO Overview” widget or React-powered admin home</li>
<li><strong>No Analytics</strong> – No ranking tracking or Google Search Console API integrations</li>
<li><strong>No Frontend Assets</strong> – Zero CSS or JS files loaded on the frontend</li>
<li><strong>No 404 Logging</strong> – Never writes 404 hits to the database</li>
</ul>
<h4>Features</h4>
<p><strong>Meta Tags</strong></p>
<ul>
<li>Custom title tags with configurable separator</li>
<li>Meta descriptions (manual or auto-generated from excerpt/content)</li>
<li>Robots meta (index/noindex control)</li>
<li>Canonical URLs</li>
<li>Google and Bing verification meta tags</li>
</ul>
<p><strong>Social Media</strong></p>
<ul>
<li>Open Graph tags (og:title, og:description, og:image, og:url, og:type, og:locale, og:site_name)</li>
<li>Twitter Cards (summary or summary_large_image)</li>
<li>Per-post social image override</li>
</ul>
<p><strong>Structured Data</strong></p>
<ul>
<li>JSON-LD schema output using @graph format</li>
<li>Organization or Person schema (configurable)</li>
<li>WebSite schema with publisher linking</li>
<li>WebPage schema</li>
<li>Article schema on posts/pages with author, dates, and images</li>
</ul>
<p><strong>XML Sitemaps</strong></p>
<ul>
<li>Sitemap index at /sitemap.xml</li>
<li>Per-post-type sitemaps with pagination</li>
<li>Transient caching with stale-while-revalidate</li>
<li>Content freshness filtering (exclude old content)</li>
<li>Post type exclusions</li>
</ul>
<p><strong>Editor Integration</strong></p>
<ul>
<li>Meta box on all public post types</li>
<li>Custom SEO title and description fields</li>
<li>Focus keyword field with real-time presence indicators (title, description, first paragraph, URL slug)</li>
<li>Noindex toggle per post</li>
<li>Canonical URL override</li>
<li>Social image override</li>
<li>Taxonomy term SEO fields (title, description, noindex, canonical)</li>
</ul>
<p><strong>Post Type Archives</strong></p>
<ul>
<li>Custom SEO title and description for each post type archive</li>
<li>Configure via Settings > Rational SEO > Archives tab</li>
</ul>
<p><strong>AI Assistant (optional)</strong></p>
<ul>
<li>AI-powered focus keyword suggestions</li>
<li>AI-generated SEO titles and meta descriptions</li>
<li>One-click “Suggest All” for keyword, title, and description together</li>
<li>Uses OpenAI GPT-4o-mini (requires your own API key)</li>
<li>Data sent only when you click — never in the background</li>
</ul>
<h3>External Services</h3>
<p>This plugin connects to the following external services:</p>
<h4>RationalWP Plugin Directory</h4>
<p>This plugin fetches a list of available RationalWP plugins from <a href="https://rationalwp.com/" rel="nofollow ugc">rationalwp.com</a> to display in the WordPress admin menu. Only the menu file version number is sent as a cache-busting query parameter. No user data is transmitted. The response is cached locally for 24 hours.</p>
<ul>
<li>Service URL: <a href="https://rationalwp.com/plugins.json" rel="nofollow ugc">https://rationalwp.com/plugins.json</a></li>
<li>Terms of Service: <a href="https://rationalwp.com/terms/" rel="nofollow ugc">https://rationalwp.com/terms/</a></li>
<li>Privacy Policy: <a href="https://rationalwp.com/privacy/" rel="nofollow ugc">https://rationalwp.com/privacy/</a></li>
</ul>
<h4>OpenAI API (optional)</h4>
<p>This plugin provides optional AI-powered SEO suggestions using the <a href="https://openai.com/" rel="nofollow ugc">OpenAI API</a>. When a site administrator configures an OpenAI API key in Settings > Rational SEO > General, users can click “Suggest” or “Generate” buttons in the post editor to receive AI-generated focus keywords, SEO titles, and meta descriptions.</p>
<p>Data is only sent when a user explicitly clicks an AI suggestion button. The data sent includes the post title and up to 2000 characters of post content (stripped of HTML), along with the user’s own API key for authentication. No data is sent automatically or in the background.</p>
<ul>
<li>Service URL: <a href="https://api.openai.com/v1/chat/completions" rel="nofollow ugc">https://api.openai.com/v1/chat/completions</a></li>
<li>Terms of Use: <a href="https://openai.com/policies/terms-of-use/" rel="nofollow ugc">https://openai.com/policies/terms-of-use/</a></li>
<li>Privacy Policy: <a href="https://openai.com/policies/privacy-policy/" rel="nofollow ugc">https://openai.com/policies/privacy-policy/</a></li>
</ul>
<h3>Hooks for developers</h3>
<p>RationalSEO exposes a complete set of filters and actions so themes and plugins can customize or extend output without forking the plugin. All hooks were introduced in version 1.0.6.</p>
<h4>Short-circuit filters</h4>
<p><strong>Return non-null to short-circuit default resolution; return null to fall through to internal logic.</strong></p>
<p>These filters let you override the data that RationalSEO resolves internally. Return a non-null value to bypass the built-in logic entirely, or return null to let RationalSEO proceed as normal.</p>
<ul>
<li><code>rationalseo_og_image_data</code> — Return a (partial) image data array; missing keys are filled with safe defaults. Signature: <code>($pre, $context)</code>.</li>
<li><code>rationalseo_meta_description</code> — Return a string to override the meta description. An empty string <code>''</code> means “explicitly no description” and suppresses the tag. Signature: <code>($pre, $context)</code>.</li>
<li><code>rationalseo_post_seo_meta</code> — Return an array of post SEO meta to override the database lookup. Signature: <code>($pre, $post_id)</code>.</li>
<li><code>rationalseo_term_seo_meta</code> — Return an array of term SEO meta to override the database lookup. Signature: <code>($pre, $term_id)</code>.</li>
</ul>
<h4>Per-value filters</h4>
<p>These filters run on the resolved value just before it is output. All use the signature <code>($value, $context)</code>.</p>
<ul>
<li><code>rationalseo_document_title</code> — string. The <code><title></code> tag value before output.</li>
<li><code>rationalseo_canonical_url</code> — string. The <code>rel=canonical</code> URL before output.</li>
<li><code>rationalseo_robots</code> — array. The robots directives array (joined with <code>,</code> for output).</li>
<li><code>rationalseo_og_locale</code> — string. <code>og:locale</code> value before output.</li>
<li><code>rationalseo_og_type</code> — string. <code>og:type</code> value (e.g. <code>website</code> / <code>article</code>) before output.</li>
<li><code>rationalseo_og_title</code> — string. <code>og:title</code> value before output.</li>
<li><code>rationalseo_og_description</code> — string. <code>og:description</code> value before output.</li>
<li><code>rationalseo_og_url</code> — string. <code>og:url</code> value before output.</li>
<li><code>rationalseo_og_site_name</code> — string. <code>og:site_name</code> value before output.</li>
<li><code>rationalseo_twitter_card_type</code> — string. <code>twitter:card</code> value before output.</li>
<li><code>rationalseo_twitter_title</code> — string. <code>twitter:title</code> value before output.</li>
<li><code>rationalseo_twitter_description</code> — string. <code>twitter:description</code> value before output.</li>
</ul>
<h4>Skip filters</h4>
<p>Return a truthy value to suppress an entire output block. Signature: <code>($skip, $context)</code>.</p>
<ul>
<li><code>rationalseo_skip_meta_description</code> — Skip the meta description tag entirely.</li>
<li><code>rationalseo_skip_canonical</code> — Skip the canonical link tag entirely.</li>
<li><code>rationalseo_skip_open_graph</code> — Skip all Open Graph tags entirely.</li>
<li><code>rationalseo_skip_twitter_cards</code> — Skip all Twitter Card tags entirely.</li>
</ul>
<p>Example — disable Open Graph on the entire site:</p>
<pre><code>add_filter( 'rationalseo_skip_open_graph', '__return_true' );
</code></pre>
<h4>Action injection points</h4>
<p>These actions fire immediately before and after each social meta block is emitted. They fire only when the block is not skipped via the corresponding skip filter. Signature: <code>do_action( '...', $context )</code>.</p>
<ul>
<li><code>rationalseo_before_open_graph</code> — Fires before the Open Graph tags are output.</li>
<li><code>rationalseo_after_open_graph</code> — Fires after the Open Graph tags are output.</li>
<li><code>rationalseo_before_twitter_cards</code> — Fires before the Twitter Card tags are output.</li>
<li><code>rationalseo_after_twitter_cards</code> — Fires after the Twitter Card tags are output.</li>
</ul>
<p>Example — append a custom og:* tag after the standard Open Graph block:</p>
<pre><code>add_action( 'rationalseo_after_open_graph', function( $ctx ) {
    // Append extra og:* tags here.
    echo "<meta property=\"og:custom\" content=\"value\" />\n";
} );
</code></pre>
<h4>The $context array</h4>
<p>All per-value filters, skip filters, and action hooks receive a <code>$context</code> array as their last argument. It is built by the internal <code>build_context()</code> method and always contains the following keys:</p>
<ul>
<li><code>mode</code> — string. One of: <code>front_page</code>, <code>home</code>, <code>singular</code>, <code>archive_term</code>, <code>archive_post_type</code>, <code>archive_author</code>, <code>archive_date</code>, <code>search</code>, <code>404</code>, <code>fallback</code>.</li>
<li><code>queried_object</code> — mixed. Result of <code>get_queried_object()</code> at resolution time. May be <code>WP_Post</code>, <code>WP_Term</code>, <code>WP_Post_Type</code>, <code>WP_User</code>, or <code>null</code>.</li>
<li><code>post_id</code> — int. Queried post ID when on a singular view; <code>0</code> otherwise.</li>
<li><code>term_id</code> — int. Queried term ID when on a taxonomy archive; <code>0</code> otherwise.</li>
</ul>
<h4>Worked example</h4>
<p>Override <code>og:type</code> to <code>event</code> for a custom post type, leaving all other post types unchanged:</p>
<pre><code>add_filter( 'rationalseo_og_type', function( $type, $context ) {
    if ( 'singular' === $context['mode'] && 'tribe_events' === get_post_type( $context['post_id'] ) ) {
        return 'event';
    }
    return $type;
}, 10, 2 );
</code></pre>
<p>(<code>tribe_events</code> is illustrative — works for any CPT slug.)</p>


RationalSEO

Technical SEO essentials with zero bloat. No dashboards, analytics, content scoring, or frontend assets.

ranklite

<p><strong>RankLite</strong> focuses on the essentials of on-page SEO. It’s intentionally small, fast, and easy to configure. You get all the core tools—without the kitchen sink:</p>
<ul>
<li><strong>Titles & Meta Descriptions</strong> per post/page with live counters</li>
<li>Global defaults with smart fallbacks</li>
<li><strong>Open Graph</strong> & <strong>Twitter Cards</strong> (title, description, image)</li>
<li><strong>Canonical</strong> and <strong>robots</strong> meta (index/noindex, follow/nofollow)</li>
<li><strong>XML Sitemaps</strong> (<code>/sitemap.xml</code>) with pretty permalink support and <strong>pings to Google & Bing</strong></li>
<li><strong>JSON-LD Schema</strong> for Website, Article, Breadcrumbs + FAQ/How-to blocks (basic)</li>
<li><strong>Breadcrumbs</strong> output helper</li>
<li><strong>Manual 301 Redirects</strong></li>
<li><strong>Analytics helpers</strong> (Google Analytics/GTAG & Google Tag Manager passthrough)</li>
<li>Optional <strong>data wipe</strong> on uninstall</li>
<li>Multisite-aware and performance-minded</li>
</ul>
<p>No telemetry. No ad pixels. No phone-home calls—everything stays on your site.</p>
<h3>Why RankLite?</h3>
<ul>
<li><strong>Performance first.</strong> Lightweight code, minimal queries, no admin nag spam.</li>
<li><strong>No lock-in.</strong> Uses standard WordPress fields/meta so you can switch any time.</li>
<li><strong>Clean UI.</strong> Sensible defaults and clear controls that won’t overwhelm you.</li>
</ul>
<h3>What’s included in the Free version?</h3>
<ul>
<li>Titles/meta with counters and fallbacks</li>
<li>Canonical, robots</li>
<li>Open Graph & Twitter Cards</li>
<li>Website/Article/Breadcrumbs + FAQ/How-to schema (basic, JSON-LD)</li>
<li>XML sitemaps with <strong>Google/Bing pings</strong></li>
<li>Breadcrumbs helper</li>
<li>Manual redirects (301)</li>
<li>Analytics & GTM helpers</li>
<li>Tools page with <strong>wipe on uninstall</strong> option</li>
</ul>
<h3>Pro add-on</h3>
<p>A separate Pro add-on (not required) can extend RankLite with AI-assisted titles/descriptions/alt-text/articles, advanced schema & sitemaps, a 404 monitor, and auto-redirects. The free plugin is fully functional on its own and does not require Pro.</p>
<h3>Features</h3>
<ul>
<li><strong>Meta box on posts/pages</strong> for custom SEO Title & Description</li>
<li><strong>Smart fallback</strong> to site title/tagline or post excerpt</li>
<li><strong>Open Graph/Twitter image</strong> fallback</li>
<li><strong>Robots</strong> (index/noindex, follow/nofollow) per post and global</li>
<li><strong>Sitemaps</strong>: index + post types; pretty <code>/sitemap.xml</code> with:
<ul>
<li>Fallback query route for non-pretty permalinks</li>
<li><strong>Automatic pings to Google and Bing</strong> when content changes (with safe throttling)</li>
</ul>
</li>
<li><strong>Schema</strong>: Website, Article, Breadcrumbs + FAQ/How-to via blocks (basic) with safe defaults</li>
<li><strong>Breadcrumbs</strong>: simple template function/filter to output a trail</li>
<li><strong>Redirects</strong>: add simple 301 manual redirects from an admin screen</li>
<li><strong>Analytics</strong>: GA4/gtag and GTM helpers (paste ID and go)</li>
<li><strong>Developer-friendly</strong> (filters/actions documented below)</li>
<li><strong>Privacy-friendly</strong>: no data leaves your site</li>
</ul>
<h3>Privacy</h3>
<p>This plugin <strong>does not</strong>:</p>
<ul>
<li>Collect personal data</li>
<li>Send usage data to third parties</li>
<li>Set cookies on the front end by itself</li>
</ul>
<p>If you enable Analytics or GTM helpers, you are integrating external services—ensure you have the proper disclosures/consent (e.g., via your cookie banner).</p>
<h3>Performance</h3>
<ul>
<li>Minimal queries and safe caching behavior</li>
<li>No assets loaded on the front end unless necessary</li>
<li>Short timeouts and safe throttling for sitemap pings to Google/Bing</li>
</ul>
<h3>External services</h3>
<p>This plugin can optionally connect to the following external services:</p>
<ol>
<li>Google Search and Bing (sitemap ping)</li>
</ol>
<p>– What it does: When sitemap pinging is enabled, RankLite can notify search engines that your sitemap has been updated.<br />
– What is sent: The public URL of your sitemap is sent as a query parameter to:<br />
  – https://www.google.com/ping?sitemap=<br />
  – https://www.bing.com/ping?sitemap=<br />
– When: Only when sitemap pinging is enabled in the plugin settings and a sitemap is generated/updated.<br />
– Terms / Privacy:<br />
  – Google: https://policies.google.com/privacy / https://policies.google.com/terms<br />
  – Microsoft (Bing): https://privacy.microsoft.com / https://www.microsoft.com/servicesagreement</p>
<ol>
<li>Google Analytics / Google Tag Manager (optional)</li>
</ol>
<p>– What it does: If you choose to enable Analytics or Tag Manager in RankLite, the plugin outputs the official tracking/snippet code provided by Google.<br />
– What is sent: Standard analytics/usage data as defined by Google, associated with your own property IDs (e.g. GA4, GTM). No additional data is sent by RankLite beyond what Google’s scripts normally collect.<br />
– When: Only when you explicitly enable these features and enter your own tracking IDs.<br />
– Terms / Privacy:<br />
  – Google Analytics / Tag Manager: https://marketingplatform.google.com/about/analytics/terms/us/<br />
  – Google Privacy Policy: https://policies.google.com/privacy</p>
<h3>Developers</h3>
<h3>Filter the final title string</h3>
<pre><code>`php
</code></pre>
<p>/**<br />
 * Filter the final  value RankLite outputs.<br />
 *<br />
 * @param string       $title Final title string.<br />
 * @param array        $parts Parsed parts (h1, site_name, brand, etc).<br />
 * @param WP_Post|null $post  Current post object (or null).<br />
 * @param string       $type  Detected type: ‘news’ | ‘product’ | ‘default’.<br />
 */<br />
add_filter( ‘ranklite_meta_title_final’, function( $title, $parts, $post, $type ) {<br />
    return $title;<br />
}, 10, 4 );<br />
    `</p>
<h3>Add extra sitemap index entries (e.g. news/video)</h3>
<pre><code>`php
</code></pre>
<p>add_filter( ‘ranklite/sitemaps/index_items’, function( $extra, $opts ) {<br />
    $extra[] = array(<br />
        ‘loc’     => home_url( ‘/news-sitemap.xml’ ),<br />
        ‘lastmod’ => gmdate( ‘c’ ),<br />
    );<br />
    return $extra;<br />
}, 10, 2 );<br />
    `</p>
<h3>Tweak the breadcrumb trail before output</h3>
<pre><code>`php
</code></pre>
<p>add_filter( ‘ranklite_breadcrumb_trail’, function( $trail ) {<br />
    // $trail is an array of arrays like [ ‘name’ => ‘Blog’, ‘url’ => ‘https://example.com/blog/’ ].<br />
    return $trail;<br />
} );<br />
    `</p>
<h3>Programmatic redirect registration</h3>
<pre><code>`php
</code></pre>
<p>do_action( ‘ranklite/register_redirect’, ‘/old-path’, ‘/new-path’, 301 );<br />
    `</p>
<p>See inline docs for more hooks and parameters.</p>


RankLite – Fast, Clean SEO

Fast, clean SEO: titles & meta, Open Graph/Twitter Cards, JSON-LD schema, and XML sitemaps with Google/Bing pings. No bloat, no tracking.

RationalSEO vs RankLite – Fast, Clean SEO