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>

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

/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

<!-- 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_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 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
'title_separator'     // string: |, -, >, >>, *, /
'title_home'          // string: Homepage title template
'title_post'          // string: Post title template
'title_page'          // string: Page title template
'title_archive'       // string: Archive title template
'title_search'        // string: Search title template
 
// Social
'og_enabled'          // bool: Enable Open Graph
'twitter_enabled'     // bool: Enable Twitter Cards
'twitter_card_type'   // string: summary, summary_large_image
'social_twitter'      // string: Twitter handle
'default_social_image'// int: Attachment ID
 
// Sitemap
'sitemap_enabled'     // bool: Enable sitemap
'sitemap_posts'       // bool: Include posts
'sitemap_pages'       // bool: Include pages
 
// Local SEO
'local_enabled'       // bool: Enable LocalBusiness schema
'local_business_type' // string: Schema.org type
'local_business_name' // string: Business name
'local_street'        // string: Street address
'local_city'          // string: City
'local_phone'         // string: Phone number
'local_lat'           // string: Latitude
'local_lng'           // string: Longitude
'local_hours_enabled' // bool: Enable opening hours
'local_hours_{day}_open'   // string: Opening time
'local_hours_{day}_close'  // string: Closing time
'local_hours_{day}_closed' // bool: Closed on this day
 
// AI/LLM
'llms_txt_enabled'    // bool: Enable llms.txt
'block_gptbot'        // bool: Block GPTBot
'block_claude'        // bool: Block Claude-Web
// ... other crawlers

// 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/

curl -u "[email protected]:XXXX XXXX XXXX XXXX XXXX XXXX" <URL>

# Post meta
curl -u "user:app-password" \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/get-meta/run?input[post_id]=123"
 
# Term meta
curl -u "user:app-password" \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/get-meta/run?input[term_id]=5"

{
  "success": true,
  "type": "post",
  "id": 123,
  "meta": {
    "title": "Custom SEO Title",
    "description": "Meta description...",
    "noindex": "",
    "og_title": "Social Title",
    "og_description": "Social description...",
    "og_image": "https://example.com/image.jpg",
    "ai_train": "default",
    "ai_input": "no",
    "search": "default",
    "markdown_content": ""
  }
}

curl -u "user:app-password" \
  -X POST -H "Content-Type: application/json" \
  -d '{
    "input": {
      "post_id": 123,
      "meta": {
        "title": "New SEO Title",
        "description": "New meta description for search engines.",
        "og_title": "Share Title",
        "og_description": "Share description.",
        "ai_train": "no"
      }
    }
  }' \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/set-meta/run"

curl -u "user:app-password" \
  -X POST -H "Content-Type: application/json" \
  -d '{
    "input": {
      "term_id": 5,
      "meta": {
        "title": "Category SEO Title",
        "description": "Category description for search engines."
      }
    }
  }' \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/set-meta/run"

{
  "success": true,
  "message": "5 SEO fields updated.",
  "updated": ["title", "description", "og_title", "og_description", "ai_train"]
}

curl -u "user:app-password" \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/get-content-signals/run?input[post_id]=123"

{
  "success": true,
  "signals": {
    "ai-train": "yes",
    "ai-input": "no",
    "search": "yes"
  }
}

# Post/page markdown
curl -u "user:app-password" \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/get-markdown/run?input[post_id]=123"
 
# Taxonomy term markdown
curl -u "user:app-password" \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/get-markdown/run?input[term_id]=5"

{
  "success": true,
  "markdown": "---\ntitle: \"Hello World\"\nurl: \"https://example.com/hello-world/\"\ndate: \"2026-03-22\"\nauthor: \"Admin\"\nlanguage: \"en_US\"\n---\n\n# Hello World\n\nContent here...\n",
  "tokens": 125
}

curl -u "user:app-password" \
  "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/get-options/run"

{
  "success": true,
  "options": {
    "separator": "-",
    "title_home": "%%sitename%% %%sep%% %%sitedesc%%",
    "sitemap_enabled": true,
    "llms_txt_enabled": true,
    "content_signals_ai_train": true,
    "content_signals_ai_input": true,
    "content_signals_search": true,
    "schema_enabled": true,
    "breadcrumbs_enabled": true
  }
}

for id in 100 101 102 103; do
  curl -s -u "user:app-password" \
    -X POST -H "Content-Type: application/json" \
    -d "{\"input\":{\"post_id\":$id,\"meta\":{\"ai_train\":\"no\",\"ai_input\":\"yes\"}}}" \
    "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/set-meta/run"
  echo ""
done

ids=$(curl -s -u "user:app-password" \
  "https://example.com/wp-json/wp/v2/posts?per_page=100&_fields=id" \
  | python3 -c "import sys,json; [print(p['id']) for p in json.load(sys.stdin)]")
 
for id in $ids; do
  curl -s -u "user:app-password" \
    "https://example.com/wp-json/wp-abilities/v1/abilities/lw-seo/get-markdown/run?input[post_id]=$id" \
    | python3 -c "import sys,json; d=json.load(sys.stdin); open(f'post-{$id}.md','w').write(d.get('markdown',''))" 2>/dev/null
  echo "Exported post $id"
done