LW SEO

composer require lwplugins/lw-seo

<!-- Open Graph -->
<meta property="og:title" content="Post Title">
<meta property="og:description" content="Post description...">
<meta property="og:image" content="https://example.com/image.jpg">
<meta property="og:url" content="https://example.com/post/">
<meta property="og:type" content="article">
<meta property="og:site_name" content="Site Name">
 
<!-- Twitter Cards -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Post Title">
<meta name="twitter:description" content="Post description...">
<meta name="twitter:image" content="https://example.com/image.jpg">
<meta name="twitter:site" content="@lwplugins">

https://yoursite.com/sitemap.xml

42, 156, 789

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://yoursite.com/</loc>
    <lastmod>2024-01-15T10:30:00+00:00</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
  <url>
    <loc>https://yoursite.com/sample-post/</loc>
    <lastmod>2024-01-14T15:20:00+00:00</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

[lw_html_sitemap]

[lw_html_sitemap post_types="page,post" taxonomies="category" max="100" order="date"]

# Submit URLs now, or add them to the queue
wp lw-seo indexnow submit https://yoursite.com/a/ https://yoursite.com/b/
wp lw-seo indexnow submit https://yoursite.com/a/ --queue
 
# State: enabled, key file, queue and the last submissions
wp lw-seo indexnow status [--format=<table|csv|json>]
 
# Key file URL; --regenerate replaces the key
wp lw-seo indexnow key [--regenerate]

X-Content-Signals: ai-train=yes, ai-input=yes, search=yes

<meta name="ai-content-signals" content="ai-train=yes, ai-input=no, search=yes" />

https://yoursite.com/hello-world/md/
https://yoursite.com/category/news/md/
https://yoursite.com/product/shoes/md/

https://yoursite.com/?p=123&format=md

curl -H "Accept: text/markdown" https://yoursite.com/hello-world/

Content-Type: text/markdown; charset=UTF-8
X-Content-Signals: ai-train=yes, ai-input=yes, search=yes
X-Markdown-Tokens: 1250

---
title: "Hello World"
url: "https://yoursite.com/hello-world/"
date: "2026-03-21"
modified: "2026-03-21"
author: "Admin"
language: "hu_HU"
categories: ["WordPress"]
tags: ["example"]
featured_image: "https://yoursite.com/image.jpg"
---
 
# Hello World
 
Your post content converted to markdown...

User-agent: GPTBot
Disallow: /

+36 1 234 5678

[email protected]

{
  "@context": "https://schema.org",
  "@type": "Restaurant",
  "name": "My Business",
  "description": "A great local business",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main Street",
    "addressLocality": "Budapest",
    "postalCode": "1051",
    "addressCountry": "HU"
  },
  "telephone": "+36 1 234 5678",
  "email": "[email protected]",
  "priceRange": "$$",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 47.4979,
    "longitude": 19.0402
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": "Monday",
      "opens": "09:00",
      "closes": "17:00"
    }
  ]
}

/old-page/
/blog/2023/old-post/
/products/discontinued-item/

Source: ^/category/(.*)$
Destination: /blog/category/$1

Source: ^/blog/(\d{4})/(\d{2})/(.*)$
Destination: /articles/$1-$2-$3

Source: ^/shop/(.*)$
Destination: /store/$1

source,destination,type,regex
/old-page/,/new-page/,301,false
^/category/(.*)$,/blog/$1,301,true
/deleted-page/,,410,false

wp lw-seo redirect test /old-page/

/page-a/ -> /page-b/
/page-b/ -> /page-a/  <- Loop!

# .htaccess
Redirect 301 /old-page/ /new-page/
RedirectMatch 301 ^/blog/(.*)$ /articles/$1

source,destination,type,regex
/old-page/,/new-page/,301,false
^/blog/(.*)$,/articles/$1,301,true

# List logged URLs, most recent first
wp lw-seo not-found list [--search=<text>] [--orderby=<last_seen|hits|url>] [--limit=<1-100>] [--format=<table|csv|json|count>]
 
# Empty the log
wp lw-seo not-found clear [--yes]
 
# Apply the retention window and row cap now
wp lw-seo not-found prune

<!-- Removed: -->
<link rel='shortlink' href='https://example.com/?p=123' />

<!-- Removed: -->
<link rel="EditURI" type="application/rsd+xml" href="https://example.com/xmlrpc.php?rsd" />

<!-- Removed: -->
<link rel="wlwmanifest" type="application/wlwmanifest+xml" href="https://example.com/wp-includes/wlwmanifest.xml" />

<!-- Removed: -->
<meta name="generator" content="WordPress 6.4" />

<meta name="google-site-verification" content="your-google-code" />
<meta name="msvalidate.01" content="your-bing-code" />

<meta name="author" content="Your Name">
<meta name="copyright" content="Your Company">

42, 156, 789

<!-- LW SEO Debug: Title template: %%title%% %%sep%% %%sitename%% -->
<!-- LW SEO Debug: Meta desc: auto-generated from content -->

%%title%% %%sep%% %%sitename%%                              # Standard post
%%sitename%% %%sep%% %%sitedesc%%                            # Homepage
%%term_title%% Archives %%sep%% %%sitename%%                 # Archives

%%sitename%% %%sep%% %%title%% %%sep%% %%category%% %%sep%% %%author%%
# Too long, keyword stuffing

%%sitename%%
# Too short, no context

[lw_breadcrumbs]

[lw_breadcrumbs separator=" / " home="Start"]

[lw_breadcrumbs schema="false"]

<nav class="lw-seo-breadcrumbs" aria-label="Breadcrumb">
  <ol itemscope itemtype="https://schema.org/BreadcrumbList">
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <a itemprop="item" href="https://example.com/">
        <span itemprop="name">Home</span>
      </a>
      <meta itemprop="position" content="1" />
    </li>
    <li>>></li>
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <span itemprop="name">Current Page</span>
      <meta itemprop="position" content="2" />
    </li>
  </ol>
</nav>

<?php
if ( function_exists( 'lw_seo_breadcrumbs' ) ) {
    lw_seo_breadcrumbs();
}
?>

[lw_html_sitemap]

[lw_html_sitemap post_types="page" order="date"]

[lw_address]

[lw_address format="short"]

[lw_address schema="false"]

<address class="lw-seo-address" itemscope itemtype="https://schema.org/PostalAddress">
  <span itemprop="streetAddress">123 Main Street, Suite 100</span><br>
  <span itemprop="postalCode">1051</span>
  <span itemprop="addressLocality">Budapest</span>,
  <span itemprop="addressRegion">Budapest</span><br>
  <span itemprop="addressCountry">HU</span>
</address>

[lw_phone]

[lw_phone link="false"]

[lw_phone schema="false"]

<span class="lw-seo-phone" itemprop="telephone">
  <a href="tel:+3612345678">+36 1 234 5678</a>
</span>

[lw_email]

[lw_email link="false"]

<span class="lw-seo-email" itemprop="email">
  <a href="mailto:[email protected]">[email protected]</a>
</span>

[lw_hours]

[lw_hours format="list"]

[lw_hours format="table" schema="false"]

<div class="lw-seo-hours">
  <table class="lw-seo-hours-table">
    <tbody>
      <tr>
        <th>Monday</th>
        <td>
          <time itemprop="openingHours" datetime="Monday 09:00-17:00">
            09:00 - 17:00
          </time>
        </td>
      </tr>
      <tr>
        <th>Saturday</th>
        <td>Closed</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="lw-seo-hours">
  <ul class="lw-seo-hours-list">
    <li><strong>Monday:</strong> 09:00 - 17:00</li>
    <li><strong>Saturday:</strong> Closed</li>
  </ul>
</div>

[lw_map]

[lw_map height="300" zoom="17"]

[lw_map width="600" height="400"]

<div class="lw-seo-map" style="width:100%;height:400px;">
  <iframe
    src="https://maps.google.com/maps?q=123+Main+Street%2C+Budapest&output=embed&z=15"
    width="100%"
    height="100%"
    style="border:0;"
    allowfullscreen=""
    loading="lazy"
    referrerpolicy="no-referrer-when-downgrade"
    title="My Business">
  </iframe>
</div>

/* Breadcrumbs */
.lw-seo-breadcrumbs {
  padding: 10px 0;
  font-size: 14px;
}
 
.lw-seo-breadcrumbs ol {
  list-style: none;
  display: flex;
  flex-wrap: wrap;
  gap: 5px;
  margin: 0;
  padding: 0;
}
 
/* Address */
.lw-seo-address {
  font-style: normal;
  line-height: 1.6;
}
 
/* Hours Table */
.lw-seo-hours-table {
  width: 100%;
  border-collapse: collapse;
}
 
.lw-seo-hours-table th,
.lw-seo-hours-table td {
  padding: 8px;
  border-bottom: 1px solid #eee;
  text-align: left;
}
 
/* Map */
.lw-seo-map {
  border-radius: 8px;
  overflow: hidden;
}

/wp-json/lw-seo/v1/

Authorization: Basic base64(username:app_password)

{
  "title": "Post Title - Site Name",
  "description": "Meta description for the post...",
  "canonical": "https://example.com/post-slug/",
  "robots": {
    "index": "index",
    "follow": "follow"
  },
  "og": {
    "locale": "en_US",
    "type": "article",
    "title": "Post Title",
    "description": "OG description...",
    "url": "https://example.com/post-slug/",
    "site_name": "Site Name",
    "image": "https://example.com/wp-content/uploads/image.jpg",
    "article:published_time": "2024-01-15T10:30:00+00:00",
    "article:modified_time": "2024-01-16T14:22:00+00:00",
    "article:author": "John Doe"
  },
  "twitter": {
    "card": "summary_large_image",
    "title": "Post Title",
    "description": "Twitter description...",
    "image": "https://example.com/wp-content/uploads/image.jpg"
  }
}

curl "https://example.com/wp-json/lw-seo/v1/meta/123"

{
  "title": "Category Name - Site Name",
  "description": "Category description...",
  "canonical": "https://example.com/category/slug/",
  "robots": {
    "index": "index",
    "follow": "follow"
  },
  "og": {
    "locale": "en_US",
    "type": "website",
    "title": "Category Name - Site Name",
    "description": "Category description...",
    "url": "https://example.com/category/slug/",
    "site_name": "Site Name",
    "image": "https://example.com/wp-content/uploads/default-og.jpg"
  },
  "twitter": {
    "card": "summary_large_image",
    "title": "Category Name - Site Name",
    "description": "Category description...",
    "image": "https://example.com/wp-content/uploads/default-og.jpg"
  }
}

# Get category meta
curl "https://example.com/wp-json/lw-seo/v1/meta/term/5"
 
# Get custom taxonomy term meta
curl "https://example.com/wp-json/lw-seo/v1/meta/term/10?taxonomy=product_cat"

{
  "title": "John Doe - Site Name",
  "description": "Author bio description...",
  "canonical": "https://example.com/author/johndoe/",
  "robots": {
    "index": "index",
    "follow": "follow"
  },
  "og": {
    "locale": "en_US",
    "type": "profile",
    "title": "John Doe - Site Name",
    "description": "Author bio description...",
    "url": "https://example.com/author/johndoe/",
    "site_name": "Site Name",
    "image": "https://secure.gravatar.com/avatar/..."
  },
  "twitter": {
    "card": "summary",
    "title": "John Doe - Site Name",
    "description": "Author bio description...",
    "image": "https://secure.gravatar.com/avatar/..."
  }
}

curl "https://example.com/wp-json/lw-seo/v1/meta/author/1"

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "WebSite",
      "@id": "https://example.com/#website",
      "url": "https://example.com/",
      "name": "Site Name",
      "description": "Site tagline",
      "inLanguage": "en_US",
      "potentialAction": {
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://example.com/?s={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      },
      "publisher": {
        "@id": "https://example.com/#organization"
      }
    },
    {
      "@type": "Organization",
      "@id": "https://example.com/#organization",
      "name": "Company Name",
      "url": "https://example.com/",
      "logo": {
        "@type": "ImageObject",
        "@id": "https://example.com/#logo",
        "url": "https://example.com/logo.png"
      },
      "sameAs": [
        "https://facebook.com/example",
        "https://twitter.com/example"
      ]
    },
    {
      "@type": "WebPage",
      "@id": "https://example.com/post-slug/#webpage",
      "url": "https://example.com/post-slug/",
      "name": "Post Title",
      "isPartOf": {"@id": "https://example.com/#website"},
      "inLanguage": "en_US",
      "datePublished": "2024-01-15T10:30:00+00:00",
      "dateModified": "2024-01-16T14:22:00+00:00",
      "primaryImageOfPage": {"@id": "https://example.com/#primaryimage"},
      "thumbnailUrl": "https://example.com/wp-content/uploads/image.jpg"
    },
    {
      "@type": "Article",
      "@id": "https://example.com/post-slug/#article",
      "headline": "Post Title",
      "datePublished": "2024-01-15T10:30:00+00:00",
      "dateModified": "2024-01-16T14:22:00+00:00",
      "mainEntityOfPage": {"@id": "https://example.com/post-slug/#webpage"},
      "wordCount": 1250,
      "inLanguage": "en_US",
      "author": {
        "@type": "Person",
        "@id": "https://example.com/author/johndoe/#author",
        "name": "John Doe",
        "url": "https://example.com/author/johndoe/"
      },
      "publisher": {"@id": "https://example.com/#organization"},
      "image": {
        "@type": "ImageObject",
        "@id": "https://example.com/#primaryimage",
        "url": "https://example.com/wp-content/uploads/image.jpg"
      },
      "keywords": "Category 1, Category 2"
    }
  ]
}

curl "https://example.com/wp-json/lw-seo/v1/schema/123"

[
  {
    "title": "Home",
    "url": "https://example.com/",
    "position": 1
  },
  {
    "title": "Category Name",
    "url": "https://example.com/category/slug/",
    "position": 2
  },
  {
    "title": "Post Title",
    "url": "https://example.com/post-slug/",
    "position": 3
  }
]

curl "https://example.com/wp-json/lw-seo/v1/breadcrumbs/123"

// Fetch SEO data for a post
async function getPostSEO(postId) {
  const response = await fetch(
    `https://example.com/wp-json/lw-seo/v1/meta/${postId}`
  );
  return response.json();
}
 
// Use in Next.js page
export async function generateMetadata({ params }) {
  const seo = await getPostSEO(params.id);
 
  return {
    title: seo.title,
    description: seo.description,
    alternates: {
      canonical: seo.canonical,
    },
    openGraph: {
      title: seo.og.title,
      description: seo.og.description,
      url: seo.og.url,
      siteName: seo.og.site_name,
      images: seo.og.image ? [seo.og.image] : [],
      locale: seo.og.locale,
      type: seo.og.type,
    },
    twitter: {
      card: seo.twitter.card,
      title: seo.twitter.title,
      description: seo.twitter.description,
      images: seo.twitter.image ? [seo.twitter.image] : [],
    },
    robots: {
      index: seo.robots.index === 'index',
      follow: seo.robots.follow === 'follow',
    },
  };
}

// composables/useSeo.js
export async function useSeo(postId) {
  const { data: seo } = await useFetch(
    `https://example.com/wp-json/lw-seo/v1/meta/${postId}`
  );
 
  useHead({
    title: seo.value.title,
    meta: [
      { name: 'description', content: seo.value.description },
      { property: 'og:title', content: seo.value.og.title },
      { property: 'og:description', content: seo.value.og.description },
      { property: 'og:image', content: seo.value.og.image },
      { name: 'twitter:card', content: seo.value.twitter.card },
    ],
    link: [
      { rel: 'canonical', href: seo.value.canonical },
    ],
  });
 
  return seo;
}

// Fetch SEO data from another WordPress site
$response = wp_remote_get( 'https://example.com/wp-json/lw-seo/v1/meta/123' );
$seo = json_decode( wp_remote_retrieve_body( $response ), true );
 
// Use the data
echo '<title>' . esc_html( $seo['title'] ) . '</title>';
echo '<meta name="description" content="' . esc_attr( $seo['description'] ) . '">';

{
  "code": "error_code",
  "message": "Human readable error message",
  "data": {
    "status": 404
  }
}

namespace LightweightPlugins\SEO;
 
// Classes are in includes/ directory
// LightweightPlugins\SEO\Plugin -> includes/Plugin.php
// LightweightPlugins\SEO\Admin\Settings -> includes/Admin/Settings.php

/**
 * Filter the generated title.
 *
 * @param string $title The generated title.
 * @param int    $post_id Post ID (0 for non-singular pages).
 */
$title = apply_filters( 'lw_seo_title', $title, $post_id );
 
/**
 * Filter the title separator.
 *
 * @param string $separator The separator character.
 */
$separator = apply_filters( 'lw_seo_title_separator', $separator );

/**
 * Filter the meta description.
 *
 * @param string $description The meta description.
 * @param int    $post_id Post ID.
 */
$description = apply_filters( 'lw_seo_meta_description', $description, $post_id );
 
/**
 * Filter auto-generated description length.
 *
 * @param int $length Maximum characters.
 */
$length = apply_filters( 'lw_seo_description_length', 155 );

/**
 * Filter Open Graph meta tags.
 *
 * @param array $og_tags Array of OG tags.
 * @param int   $post_id Post ID.
 */
$og_tags = apply_filters( 'lw_seo_og_tags', $og_tags, $post_id );
 
/**
 * Filter the default social image URL.
 *
 * @param string $image_url Image URL.
 */
$image_url = apply_filters( 'lw_seo_default_social_image', $image_url );

/**
 * Filter JSON-LD schema output.
 *
 * @param array $schema Schema data array.
 * @param string $type Schema type (Organization, LocalBusiness, etc).
 */
$schema = apply_filters( 'lw_seo_schema', $schema, $type );
 
/**
 * Filter LocalBusiness schema.
 *
 * @param array $schema LocalBusiness schema array.
 */
$schema = apply_filters( 'lw_seo_local_schema', $schema );

/**
 * Filter sitemap URLs before output.
 *
 * @param array $urls Array of URL entries.
 */
$urls = apply_filters( 'lw_seo_sitemap_urls', $urls );
 
/**
 * Filter post types included in sitemap.
 *
 * @param array $post_types Post type names.
 */
$post_types = apply_filters( 'lw_seo_sitemap_post_types', $post_types );
 
/**
 * Exclude specific post from sitemap.
 *
 * @param bool $exclude Whether to exclude.
 * @param int  $post_id Post ID.
 */
$exclude = apply_filters( 'lw_seo_sitemap_exclude_post', false, $post_id );

/**
 * Filter the image URLs listed for a post in the image sitemap.
 *
 * @param array   $urls Absolute image URLs.
 * @param WP_Post $post Post.
 */
$urls = apply_filters( 'lw_seo_sitemap_images', $urls, $post );
 
/**
 * Whether images found in the content are listed (default true).
 * Return false to list the featured image only.
 *
 * @param bool    $include Whether to list them.
 * @param WP_Post $post    Post.
 */
$include = apply_filters( 'lw_seo_sitemap_content_images', true, $post );

/**
 * Filter the sections of the HTML sitemap before they are rendered.
 *
 * @param array $sections Sections: label, type, items, archive_url.
 * @param array $args     Resolved arguments: post_types, taxonomies, max, order.
 */
$sections = apply_filters( 'lw_seo_html_sitemap_sections', $sections, $args );
 
/**
 * Filter the HTML sitemap markup.
 *
 * @param string $html Markup.
 * @param array  $args Resolved arguments.
 */
$html = apply_filters( 'lw_seo_html_sitemap_output', $html, $args );

/**
 * Filter whether IndexNow may notify search engines from this site (1.9.2).
 * Only consulted while IndexNow is switched on. Default: paused while search
 * engines are discouraged or the environment type is not production.
 *
 * @param bool   $active Default decision.
 * @param string $reason 'not_public', 'environment', or '' when active.
 */
$active = apply_filters( 'lw_seo_indexnow_active', $active, $reason );
 
// Example: allow IndexNow on a public staging site.
add_filter( 'lw_seo_indexnow_active', fn( $active, $reason ) => 'environment' === $reason ? true : $active, 10, 2 );

/**
 * Filter whether a singular post is noindex.
 *
 * @param bool    $noindex Whether the post is noindex by its meta or post type setting.
 * @param WP_Post $post    The post.
 */
$noindex = apply_filters( 'lw_seo_post_noindex', $noindex, $post );

/**
 * Filter one Offer of the product markup (a variation's offer too).
 *
 * @param array      $offer   The Offer. A non-array return is ignored.
 * @param WC_Product $product The product (or the variation) it offers.
 */
$offer = apply_filters( 'lw_seo_woo_offer', $offer, $product );
 
/**
 * Which attribute slugs map to which schema.org property in ProductGroup markup.
 *
 * @param array $map Attribute slug (without `pa_`) => schema.org property name.
 */
$map = apply_filters( 'lw_seo_woo_varies_by_map', $map );
 
/**
 * Filter the product page's final Product markup, built by WooCommerce or by LW SEO.
 * Use it to add shipping or return policy details.
 *
 * @param array      $markup  Product markup.
 * @param WC_Product $product The product.
 */
$markup = apply_filters( 'lw_seo_woo_product_schema', $markup, $product );

/**
 * Filter breadcrumb items.
 *
 * @param array $items Breadcrumb items array.
 */
$items = apply_filters( 'lw_seo_breadcrumb_items', $items );
 
/**
 * Filter breadcrumb separator.
 *
 * @param string $separator Separator HTML.
 */
$separator = apply_filters( 'lw_seo_breadcrumb_separator', '>>' );

/**
 * Control whether a request should receive markdown output.
 */
add_filter( 'lw_seo_markdown_is_supported', function ( bool $supported, WP_Query $query ): bool {
    // Disable markdown for a specific post type.
    if ( $query->is_singular( 'secret_docs' ) ) {
        return false;
    }
    return $supported;
}, 10, 2 );
 
/**
 * Add or modify YAML frontmatter fields.
 */
add_filter( 'lw_seo_markdown_frontmatter', function ( array $data, WP_Post|WP_Term $object ): array {
    // Add custom field to product frontmatter.
    if ( $object instanceof WP_Post && 'product' === $object->post_type ) {
        $data['brand'] = get_post_meta( $object->ID, 'brand', true );
    }
    return $data;
}, 10, 2 );
 
/**
 * Modify or replace the markdown body content.
 */
add_filter( 'lw_seo_markdown_body', function ( string $body, WP_Post|WP_Term $object ): string {
    // Append related posts to the body.
    if ( $object instanceof WP_Post ) {
        $body .= "\n## Related\n\n";
        // ... add related post links ...
    }
    return $body;
}, 10, 2 );
 
/**
 * Override Content Signals for any content type.
 */
add_filter( 'lw_seo_content_signals', function ( array $signals, WP_Post|WP_Term|null $object ): array {
    // Disable AI training for premium posts.
    if ( $object instanceof WP_Post && has_tag( 'premium', $object ) ) {
        $signals['ai-train'] = 'no';
    }
    return $signals;
}, 10, 2 );
 
/**
 * Full output override (escape hatch).
 */
add_filter( 'lw_seo_markdown_output', function ( string $output, WP_Post|WP_Term $object ): string {
    // Completely replace output for a custom post type.
    if ( $object instanceof WP_Post && 'event' === $object->post_type ) {
        return "---\ntitle: ...\n---\n\nCustom event markdown...";
    }
    return $output;
}, 10, 2 );

/**
 * Fires before SEO meta tags are output.
 */
do_action( 'lw_seo_before_meta' );
 
/**
 * Fires after SEO meta tags are output.
 */
do_action( 'lw_seo_after_meta' );
 
/**
 * Fires when plugin settings are saved.
 *
 * @param array $old_options Previous options.
 * @param array $new_options New options.
 */
do_action( 'lw_seo_settings_saved', $old_options, $new_options );

use LightweightPlugins\SEO\Options;
 
// Get option with default
$value = Options::get( 'option_name', 'default_value' );
 
// Get all options
$all_options = Options::get_all();
 
// Option name constant
$option_key = Options::OPTION_NAME; // 'lw_seo_options'

// General
'separator'           // string: '-'
'title_home'          // string: '%%sitename%% %%sep%% %%sitedesc%%'
'desc_home'           // string: ''
'title_post'          // string: '%%title%% %%sep%% %%sitename%%'
'title_page'          // string: '%%title%% %%sep%% %%sitename%%'
'title_category'      // string: '%%term_title%% %%sep%% %%sitename%%'
'title_post_tag'      // string: '%%term_title%% %%sep%% %%sitename%%'
'title_author'        // string: '%%author%% %%sep%% %%sitename%%'
'title_date'          // string: '%%currentdate%% %%sep%% %%sitename%%'
'title_search'        // string: 'Search: %%searchphrase%% %%sep%% %%sitename%%'
'title_404'           // string: 'Page not found %%sep%% %%sitename%%'
'noindex_post'        // bool: false (also noindex_page, noindex_category, noindex_post_tag, noindex_author)
'noindex_date'        // bool: true
 
// Social
'opengraph_enabled'   // bool: true
'twitter_enabled'     // bool: true
'twitter_card_type'   // string: 'summary_large_image' (or 'summary')
'default_og_image'    // string: default social image
'social_facebook'     // string: profile URL (also social_twitter, social_instagram,
                      //   social_linkedin, social_youtube)
 
// Organization / Person
'knowledge_type'      // string: 'organization' (or 'person')
'knowledge_name'      // string: ''
'knowledge_logo'      // string: ''
 
// Sitemap
'sitemap_enabled'     // bool: true
'sitemap_posts'       // bool: true
'sitemap_pages'       // bool: true
'sitemap_categories'  // bool: true
'sitemap_tags'        // bool: false
'sitemap_post_types'  // array: post type => bool
'sitemap_taxonomies'  // array: taxonomy => bool
'sitemap_images'      // bool: true (image sitemap)
'sitemap_stylesheet'  // bool: true (browser view, XSL)
'html_sitemap_post_types' // array: post type => bool
'html_sitemap_taxonomies' // array: taxonomy => bool
'html_sitemap_max_items'  // int: 500
'html_sitemap_order'      // string: 'title' (or 'date')
 
// IndexNow
'indexnow_enabled'    // bool: false
 
// 404 and redirects
'redirects_enabled'   // bool: true
'redirect_404_to_home'// bool: false
'not_found_log_enabled'        // bool: false
'not_found_log_max_rows'       // int: 1000
'not_found_log_retention_days' // int: 30
'not_found_log_store_ua'       // bool: false
 
// Images
'image_alt_enabled'    // bool: false
'image_alt_template'   // string: '%%image_title%%'
'image_title_enabled'  // bool: false
'image_title_template' // string: '%%image_title%%'
 
// Advanced
'breadcrumbs_enabled' // bool: true
'schema_enabled'      // bool: true
'robots_txt_enabled'  // bool: true
'remove_shortlinks'   // bool: true
'remove_rsd'          // bool: true
'remove_wlw'          // bool: true
 
// WooCommerce
'woo_enabled'         // bool: true
'title_product'       // string: '%%title%% %%sep%% %%sitename%%'
'title_ptarchive_product' // string: '%%title%% %%sep%% %%sitename%%'
'noindex_product'     // bool: false
'woo_schema_enabled'  // bool: true
'woo_schema_reviews'  // bool: true
'woo_product_group'   // bool: false
'woo_default_brand'   // string: ''
'sitemap_products'    // bool: true (also sitemap_product_cat true, sitemap_product_tag false)
'woo_noindex_hidden'  // bool: true
'woo_sitemap_exclude_hidden'     // bool: true
'woo_sitemap_exclude_outofstock' // bool: false
'woo_shipping_enabled'  // bool: false (woo_shipping_countries, woo_shipping_rate_type 'flat',
                        //   woo_shipping_rate, woo_handling_min 0, woo_handling_max 1,
                        //   woo_transit_min 1, woo_transit_max 5)
'woo_returns_enabled'   // bool: false (woo_return_country, woo_return_category 'finite',
                        //   woo_return_days 14, woo_return_method 'by_mail', woo_return_fees 'free')
'wc_remove_category_base'         // bool: false
'wc_remove_category_parent_slugs' // bool: false
'wc_remove_product_base'          // bool: false
 
// Local SEO
'local_enabled'       // bool: false
'local_business_type' // string: 'LocalBusiness'
'local_business_name' // string: ''
'local_description'   // string: ''
'local_price_range'   // string: ''
'local_street'        // string: ''  (also local_street_2, local_city, local_state, local_zip, local_country)
'local_phone'         // string: ''
'local_email'         // string: ''
'local_lat'           // string: ''
'local_lng'           // string: ''
'local_hours_enabled' // bool: false
'local_hours_{day}_open'   // string: '' (day: monday ... sunday)
'local_hours_{day}_close'  // string: ''
'local_hours_{day}_closed' // bool: false
 
// AI/LLM
'llms_txt_enabled'    // bool: true
'llms_txt_max_items'  // int: 100
'llms_full_txt_enabled' // bool: false
'content_signals_ai_train' // string: '' (also content_signals_ai_input, content_signals_search)
'block_{crawler}'     // bool: false, one per crawler, e.g. block_gptbot, block_claudebot,
                      //   block_google_extended, block_ccbot
'block_purpose_{purpose}' // bool: false, blocks every crawler of a purpose

// Meta key prefix
$prefix = '_lw_seo_';
 
// Available meta keys
'_lw_seo_title'           // Custom SEO title
'_lw_seo_description'     // Custom meta description
'_lw_seo_canonical'       // Custom canonical URL
'_lw_seo_noindex'         // bool: noindex this post
'_lw_seo_nofollow'        // bool: nofollow this post
'_lw_seo_og_title'        // Custom OG title
'_lw_seo_og_description'  // Custom OG description
'_lw_seo_og_image'        // Custom OG image (attachment ID)
'_lw_seo_exclude_sitemap' // bool: Exclude from sitemap
 
// Example usage
$custom_title = get_post_meta( $post_id, '_lw_seo_title', true );

/**
 * Output breadcrumbs.
 *
 * @param array $args {
 *     @type string $separator  Separator between items. Default '>>'.
 *     @type string $home       Home link text. Default 'Home'.
 *     @type bool   $schema     Include schema markup. Default true.
 *     @type bool   $echo       Echo or return. Default true.
 * }
 * @return string|void
 */
lw_seo_breadcrumbs( $args = [] );
 
// Example
lw_seo_breadcrumbs( [
    'separator' => ' / ',
    'home'      => 'Start',
    'schema'    => true,
] );

add_filter( 'lw_seo_schema', function( $schema, $type ) {
    if ( is_singular( 'product' ) ) {
        $schema['@type'] = 'Product';
        $schema['name'] = get_the_title();
        $schema['description'] = get_the_excerpt();
        // Add more product properties...
    }
    return $schema;
}, 10, 2 );

add_filter( 'lw_seo_title', function( $title, $post_id ) {
    // Replace custom variable
    if ( strpos( $title, '%%custom%%' ) !== false ) {
        $custom_value = 'My Custom Value';
        $title = str_replace( '%%custom%%', $custom_value, $title );
    }
    return $title;
}, 10, 2 );

add_filter( 'lw_seo_sitemap_urls', function( $urls ) {
    // Add custom URL
    $urls[] = [
        'loc'        => 'https://example.com/custom-page/',
        'lastmod'    => '2024-01-15',
        'changefreq' => 'monthly',
        'priority'   => '0.5',
    ];
    return $urls;
} );

add_filter( 'lw_seo_title', function( $title, $post_id ) {
    // Disable on specific pages
    if ( $post_id === 42 ) {
        return ''; // Return empty to use default WP title
    }
    return $title;
}, 10, 2 );

// Add custom frontmatter for 'event' post type.
add_filter( 'lw_seo_markdown_frontmatter', function ( array $data, WP_Post|WP_Term $object ): array {
    if ( ! $object instanceof WP_Post || 'event' !== $object->post_type ) {
        return $data;
    }
 
    $data['event_date'] = get_post_meta( $object->ID, 'event_date', true );
    $data['location']   = get_post_meta( $object->ID, 'event_location', true );
    $data['ticket_url'] = get_post_meta( $object->ID, 'ticket_url', true );
 
    return $data;
}, 10, 2 );

add_filter( 'lw_seo_markdown_frontmatter', function ( array $data, WP_Post|WP_Term $object ): array {
    if ( ! $object instanceof WP_Term || 'location' !== $object->taxonomy ) {
        return $data;
    }
 
    $data['map_url'] = get_term_meta( $object->term_id, 'map_url', true );
    return $data;
}, 10, 2 );

// Check if WooCommerce integration is active
if ( class_exists( 'LightweightPlugins\SEO\WooCommerce\Integration' ) ) {
    // WooCommerce features available
}

// Detected plugins that disable LW SEO output
$conflicting_plugins = [
    'wordpress-seo/wp-seo.php',           // Yoast SEO
    'seo-by-rank-math/rank-math.php',     // Rank Math
    'all-in-one-seo-pack/all_in_one_seo_pack.php', // AIOSEO
];

lw-seo/
├── lw-seo.php              # Main plugin file
├── composer.json           # Composer config
├── includes/
│   ├── Plugin.php          # Main plugin class
│   ├── Options.php         # Options handler
│   ├── Admin/
│   │   ├── Settings.php    # Settings page
│   │   └── Settings/
│   │       ├── TabGeneral.php
│   │       ├── TabContent.php
│   │       └── ...
│   ├── Frontend/
│   │   ├── Meta.php        # Meta tags output
│   │   ├── Schema.php      # JSON-LD output
│   │   └── ...
│   ├── Sitemap/
│   │   └── Generator.php
│   ├── Local/
│   │   ├── Schema.php
│   │   └── Shortcodes.php
│   └── WooCommerce/
│       └── Integration.php
└── assets/
    ├── css/
    └── js/