=== CSPG Basic SEO Helper ===
Contributors: cspgeeks
Tags: seo, meta tags, open graph, sitemaps, schema
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.2.18
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight SEO helper adding Open Graph, Twitter Cards, Schema.org markup, meta templates, and XML sitemaps.

== Description ==

**CSPG Basic SEO Helper** is a lightweight, performance-focused WordPress SEO plugin designed to simplify essential on-page SEO and social sharing optimization without unnecessary complexity.

The plugin automatically generates:
- Open Graph meta tags for Facebook and social platforms
- Twitter Card metadata
- Schema.org structured data
- Dynamic SEO titles and descriptions using configurable templates
- XML sitemaps for improved search engine indexing

All features are built to work automatically out of the box while still giving administrators full control through clean, easy-to-use settings pages.

Perfect for small businesses, bloggers, and developers who want modern SEO fundamentals without bloated overhead.

== Features ==

* AI Agent Support added through API access to SEO Meta Fields (enables headless CMS workflows) 
* Automatic Open Graph meta tags
* Built-in Twitter Card support
* Schema.org structured data output
* Dynamic Meta Templates for SEO titles and descriptions
* 10+ dynamic variables including `{site_name}`, `{post_title}`, `{excerpt}`, and more
* Custom field variables using `{custom_field:key}`
* Live SEO template preview in the admin panel
* Free XML Sitemap generation
* Improved sitemap performance and reliability
* Clean, user-friendly admin interface
* Improved admin UI consistency
* Optimized for performance and stability
* Compatible with modern WordPress versions (6.4+)

== Installation ==

1. Upload the `cspg-basic-seo-helper` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **Settings → Basic SEO Helper** to configure your preferences.
4. Optionally customize your Dynamic Meta Templates and Sitemap settings.

== Frequently Asked Questions ==

= Does this plugin replace a full SEO suite like Yoast or RankMath? =
No. CSPG Basic SEO Helper is designed as a lightweight SEO foundation, not a full enterprise SEO suite. It focuses on essential metadata, templates, and sitemap generation.

= Does this plugin generate XML sitemaps automatically? =
Yes. XML sitemap generation is included by default and works automatically after activation.

= Does it support dynamic SEO titles and descriptions? =
Yes. You can configure template-based titles and descriptions using dynamic variables.

= Will this slow down my site? =
No. The plugin is optimized for performance and uses efficient WordPress hooks without heavy processing overhead.

= Is this plugin Agent firendly? =
Yes. You can have your AI Agent, like OpenClaw, manage your SEO meta tags

= Is this plugin free? =
Yes. CSPG Basic SEO Helper is completely free. Some advanced functionality is available as a separate Premium version of this plugin. Use of the free version does not require the Premium plugin.

== Screenshots ==

1. Main SEO Dashboard
2. Dynamic Meta Templates editor
3. XML Sitemap Configuration
4. General Settings
5. Sitemap
6. Post Meta Data Entry

== Changelog ==

= 1.2.18 =
* Added: Support for AI Agents, like Open Claw, to manage SEO Meta Tag Data
* Added: REST API support for all SEO meta fields (enables headless CMS workflows)
* Added: Exposed 12 meta fields via WordPress REST API with proper authentication
* Added: API access for SEO title, description, image, Open Graph, Twitter Cards, Schema, and robots settings
* Improvement: Headless WordPress and block editor integrations now fully supported

= 1.2.17 =
* Added: Standard meta description tag output
* Added: Open Graph locale (og:locale) tag
* Added: Robots meta tag control (noindex, nofollow, noarchive, nosnippet)
* Fixed: All PHPCS WordPress-Core blocking errors

= 1.2.16 =
* Maintenance: Reformatted admin JavaScript to align with WordPress-Core spacing, resolving PHPCS findings.
* Release: Bumped version and rebuilt distribution package for 1.2.16.

= 1.2.14 =
* Removed: Unnecessary load_plugin_textdomain() functionality per WordPress.org guidelines
* Removed: class-cspg-basic-seo-helper-i18n.php file (translations auto-loaded since WP 4.6+)
* Improved: Code quality and reduced plugin footprint
* Fixed: PHPCBF corrections (332 formatting issues)

= 1.2.13 =
* Fixed: Updated plugin action link to point to specific premium plugin page
* Fixed: Changed date() to gmdate() in sitemap footer to comply with WordPress coding standards
* Improved: Code quality and WordPress.org submission compliance

= 1.2.12 =
* Addresses all WordPress.org Round 3 manual review requirements for final submission compliance.
* Extracts all inline CSS and JavaScript to properly enqueued asset files with wp_localize_script for data passing.
* Removes load_plugin_textdomain() call (WordPress.org auto-loads translations from language directory).
* Adds ABSPATH protection to all 7 core class files preventing direct execution outside WordPress context.
* Removes JSON_UNESCAPED_SLASHES and JSON_PRETTY_PRINT flags from wp_json_encode() per WordPress standards.
* Fixes wp_print_inline_script_tag() usage by removing echo wrapper (function outputs directly).
* Applies PHPCBF auto-formatting across entire plugin fixing 1,317 PSR12 violations (spacing, indentation, brackets).
* Documents 85 remaining PSR12 errors as WordPress architectural requirements (method naming, namespaces, class names).
* Maintains XSL sitemap inline CSS as technical requirement per W3C XSL specification (documented with PHPCS comments).
* Achieves zero rejection-level compliance issues - ready for WordPress.org approval.

= 1.2.11 =
* Achieves 100% WordPress Coding Standards compliance (0 PHPCS errors, 316 non-blocking whitespace warnings).
* Fixes 26 Yoda condition violations and 1 class naming convention issue per WordPress-Core standards.
* Improves code formatting with 8,949 automated fixes (97% violation reduction overall).
* Maintains full backward compatibility - no functional changes or breaking updates.

= 1.2.10 =
* Shortens the plugin's WordPress.org short description so it renders without parser warnings.
* Keeps the sitemap and sanitization fixes from 1.2.9 intact for the patched release.

= 1.2.9 =
* Restores sitemap stylesheet compatibility by annotating the XSL link and exposing a filter for custom CSS.
* Fully sanitizes submitted social profile URLs, including network keys, to satisfy WordPress security guidelines.
* Adds PHPCS documentation for inline schema output to maintain JSON-LD integrity while passing automated scans.

= 1.2.8 =
* Prevents duplicate canonical tags by disabling the WordPress core canonical output when the plugin provides its own.
* Documents the canonical suppression safeguard for sites relying on Basic SEO Helper meta management.

= 1.2.7 =
* Added ABSPATH guards to every executable PHP endpoint for hardened direct-access protection.
* Removed development-only and backup artifacts from the shipped plugin package.
* Completed final compliance audit updates ahead of WordPress.org submission review.

= 1.2.6 =
* First public production release
* Automatic Open Graph meta tags for improved social sharing
* Built-in Twitter Card support
* Schema.org structured data for better search visibility
* Dynamic Meta Templates for automated SEO titles and descriptions
* 10+ dynamic variables including `{site_name}`, `{post_title}`, `{excerpt}`, and more
* Custom field variable support using `{custom_field:key}`
* Live preview of SEO templates in the admin panel
* Free XML Sitemap generation for faster indexing
* Improved sitemap performance and reliability
* Custom-styled XSL sitemap display
* Clean, user-friendly admin interface
* Improved admin UI consistency
* Optimized codebase for performance and stability
* Enhanced compatibility with WordPress 6.4+
* Fully compliant with WordPress.org plugin guidelines

== Upgrade Notice ==

= 1.2.12 =
Final WordPress.org submission compliance update. All inline assets extracted, ABSPATH protection added, JSON handling normalized. Zero breaking changes.

= 1.2.11 =
Code quality improvements with 100% WordPress Coding Standards compliance. Safe upgrade with no functional changes.

= 1.2.10 =
Eliminates WordPress.org parser warnings by tightening documentation without changing core functionality.

= 1.2.9 =
Improves security and validation by sanitizing social profile input and clarifying sitemap stylesheet behavior for PHPCS compliance.

= 1.2.8 =
Prevents duplicate canonical tags by letting the plugin control canonical output when enabled.

= 1.2.7 =
Prepares the plugin for WordPress.org review by locking down direct access safeguards and cleaning the package for distribution.

= 1.2.6 =
Initial public release of CSPG Basic SEO Helper with full social metadata, sitemap generation, and dynamic SEO templates.