=== DMValdez Semantic Engine ===
Contributors:      donaldmvaldez
Tags:              seo, schema, json-ld, sitemap, faq
Requires at least: 5.8
Tested up to:      7.0
Requires PHP:      7.4
Stable tag:        1.0.0
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Zero-bloat SEO & Schema: clean JSON-LD, an FAQ shortcode with real FAQPage schema, and an XML sitemap. No JS, no writing assistants, free forever.

== Description ==

**DMValdez Semantic Engine** is a schema-first technical SEO plugin, not an all-in-one content suite. If you want structured data, meta tags, and a sitemap done cleanly — without a keyword-research dashboard, an AI writing assistant, or a settings maze — this is built for exactly that.

Every feature ships as clean, valid output: a single JSON-LD block per page (no duplicate or conflicting schema), zero JavaScript on the frontend, and a free tier that's actually complete — not a teaser for a paywall.

= What's included in the free version =

**SEO Basics**
* Custom SEO Title, Meta Description, and Focus Keyword per post and page
* Character counters in the editor to keep you within recommended limits
* All fields saved directly as post meta — no lock-in

**Structured Data (JSON-LD Schema)**
* WebPage, Article, BlogPosting, AboutPage, ContactPage, and FAQPage schema types
* Automatic BreadcrumbList schema on all posts and pages
* Organization / Publisher schema linked to your site identity settings
* Clean, valid JSON-LD output — no inline microdata, no conflicting markup

**[dmvlite_faq] Shortcode**
* Render native HTML5 accordion FAQ sections anywhere in your content
* Injects FAQPage JSON-LD automatically for Google Rich Results eligibility
* Attributes: `htag` (h2/h3/h4/h5/none), `open` (none/first/all), `style` (card/minimal/flush)

**XML Sitemap**
* Generates `/sitemap.xml` listing your published posts and pages
* Respects per-post noindex settings — excluded posts don't appear in the sitemap
* Sitemap URL is automatically injected into your `robots.txt`
* 12-hour transient cache with automatic refresh on publish/update
* `[dmvlite_sitemap]` shortcode for an HTML sitemap on any page

**Open Graph & Twitter Cards**
* og:title, og:description, og:type, og:url, og:site_name, og:image
* Twitter Card (summary_large_image when a social image is set, summary otherwise)
* Falls back to Featured Image for og:image when no social image is specified

**Visibility Controls**
* noindex per post — hide specific content from search engines
* nofollow per post — block link equity on specific pages
* 301 Redirect — set a permanent redirect URL directly on any post or page

**Admin Columns**
* Schema Type and SEO Status columns on Posts and Pages list screens
* Quick visual confirmation of which pages have titles and descriptions set

= Going further with DMValdez Semantic Engine Pro =

[DMValdez Semantic Engine Pro](https://donaldvaldez.com/dmvaldez-semantic-engine-pro/) is the enterprise version of this plugin (requires this free plugin to be installed and active), built for agencies and developers who need precision technical SEO at scale.

**Pro adds:**
* **Enterprise @graph JSON-LD** — all entities mathematically linked; zero "Duplicate MainEntity" errors
* **15+ schema types** — LocalBusiness, ProfessionalService, Product, Event, NewsArticle, TechArticle, CollectionPage, and more
* **Google Places API integration** — auto-fetch live business name, address, hours, GPS, and star ratings by Place ID
* **Advanced split sitemap with XSL design** — index → per-type child files, taxonomy archives, author archives, branded stylesheet
* **SEO Data Bridge** — bidirectional import/export between DMValdez and Yoast, Rank Math, SEOPress, and Link Whisper
* **Live SEO Scorer & SERP Preview** — real-time scores and a pixel-accurate Google Search preview as you write
* **Bulk Meta Editor** — spreadsheet-style interface for managing hundreds of posts at once
* **Smart Interlinking** — keyword-powered internal link suggestions and orphaned-content audit
* **Keyword Cannibalization Checker** — prevent multiple pages from competing for the same keyword
* **Elementor deep integration** — full SEO panel inside the Elementor editor
* **OTA (Over-The-Air) updates** — plugin updates appear in your WP dashboard without manual uploads
* **Priority support**

[View Pro features and request pricing →](https://donaldvaldez.com/dmvaldez-semantic-engine-pro/)

= About the Developer =

Built by **Donald Valdez**, full-stack developer and digital marketing strategist.

* 🌐 [donaldvaldez.com](https://donaldvaldez.com)
* 💼 [LinkedIn](https://linkedin.com/in/donaldvaldez)
* 🐙 [GitHub](https://github.com/DonaldValdez)
* 🐦 [X / Twitter @donaldmvaldez](https://twitter.com/donaldmvaldez)
* 📧 donaldmvaldez@gmail.com

== Installation ==

1. Upload the `dmvaldez-semantic-engine` folder to `/wp-content/plugins/`
   — OR — install directly from **Plugins → Add New → Search** for "DMValdez Semantic Engine"
2. Click **Activate**
3. Go to **DMV SEO → Settings** and fill in your business name and entity type
4. Open any post or page — fill in the SEO Title and Meta Description fields in the **DMV Semantic Engine** metabox
5. Done — your meta tags and schema are live

= Setting up the FAQ shortcode =

Add this shortcode to any post or page content:

`[dmvlite_faq]
Q: What is DMValdez Semantic Engine?
A: A precision SEO and Schema plugin for WordPress. Free forever.

Q: Does it work with Elementor?
A: Yes — the metabox works in classic and Gutenberg editors. Elementor deep integration is available in DMValdez Semantic Engine Pro.
[/dmvlite_faq]`

The shortcode renders native HTML5 accordion elements and automatically injects FAQPage JSON-LD so Google can display Rich Results for your FAQ content.

== Frequently Asked Questions ==

= Will this conflict with Yoast SEO or Rank Math? =

Running multiple SEO plugins simultaneously can create duplicate meta tags. It is recommended to use only one SEO plugin at a time. If you are migrating from another plugin, **DMValdez Semantic Engine Pro** includes a one-click SEO Data Bridge to import your existing titles, descriptions, and keywords.

= Does it slow down my site? =

No. DMValdez Semantic Engine adds zero JavaScript to your frontend. All output is lightweight HTML meta tags and a single JSON-LD script block per page.

= Does it support custom post types? =

Yes. The SEO metabox appears on all public post types automatically.

= What is the [dmvlite_faq] shortcode? =

It renders collapsible accordion FAQ items using native HTML5 `<details>` and `<summary>` elements — no JavaScript required. It also automatically injects FAQPage JSON-LD schema so your FAQ content can appear in Google's Rich Results.

= Can I control which posts appear in the sitemap? =

Yes. Enable the **noindex** toggle in the DMV SEO metabox on any post/page to exclude it from both the sitemap and search engine indexing.

= Does this support llms.txt? =

Not built into Lite. DMValdez Pro includes a built-in llms.txt engine — or use our free [DMValdez AI Context](https://wordpress.org/plugins/dmvaldez-ai-context/) plugin to generate and serve an `/llms.txt` file at no cost.

= Where can I get DMValdez Semantic Engine Pro? =

Visit [donaldvaldez.com/dmvaldez-semantic-engine-pro](https://donaldvaldez.com/dmvaldez-semantic-engine-pro/) to see all Pro features and request pricing.

== Screenshots ==

1. The DMV SEO metabox in the WordPress post editor — SEO title, description, schema type, and visibility controls.
2. The Settings page showing site identity configuration and the Pro upgrade panel.
3. The XML Sitemap settings page with URL, cache controls, and Pro upgrade card.
4. Admin list columns showing Schema Type badges and SEO status indicators.
5. The Upgrade to Pro page listing all enterprise features.

== Changelog ==

= 1.0.0 =
* Initial release
* SEO Title, Meta Description, Focus Keyword fields per post/page
* WebPage, Article, BlogPosting, AboutPage, ContactPage, FAQPage schema types
* BreadcrumbList schema on all posts and pages
* [dmvlite_faq] shortcode with FAQPage JSON-LD (htag, open, style attributes)
* [dmvlite_sitemap] HTML sitemap shortcode
* XML sitemap at /sitemap.xml with 12-hour transient cache
* Sitemap injected into robots.txt automatically
* Open Graph and Twitter Card meta tags
* noindex / nofollow per post
* 301 Redirect per post
* hentry microformat class removal
* Character counters for title and description fields
* Schema Type and SEO Status admin columns
* Review nag after 30 days (dismissible per user)
* Full uninstall cleanup

== Upgrade Notice ==

= 1.0.0 =
Initial release.
