Smart Content Sync lets you create reusable content blocks and insert them consistently across posts, pages, and WooCommerce products — without copy‑pasting.

Instead of duplicating content everywhere, you create it once as Smart Content and reuse it manually or automatically, while keeping a single source of truth.

This plugin is designed for performance, editorial control, and long‑term scalability.

Development / Source Code

This plugin ships compiled assets in /dist for performance.
Human-readable source is included in /resources.

Build instructions:
1) npm install
2) npm run build (or “npm run dev” for the dev build)

Core concepts

Smart Content = reusable content blocks (custom post type)
Single rendering pipeline for frontend, editors, previews, and auto‑insert
Predictable behavior with explicit rules (no magic, no surprises)

Features

Smart Content Blocks

Dedicated Smart Content custom post type
Centralized editing with live preview
Internal notes for editors (never shown on frontend)

Editor Integrations

Classic Editor
- TinyMCE button to insert Smart Content
Gutenberg
- Dynamic Smart Content block
Shortcodes
- [smart_content id="123"]
- [smart_content slug="shipping-policy"]

Auto Insert (v1.0 Free)

Automatically inject Smart Content at predefined locations.

Supported locations:
* WordPress content
* Prepend to content
* Append to content
* WooCommerce
* Single product page locations

Runtime guarantees:
* WordPress:
* Runs on is_singular() only
* No archives
* WooCommerce:
* Single product pages only
* Never runs in:
* Admin
* REST requests
* Feeds
* Previews

Ordering:
* Auto‑inserted blocks render in Smart Content order
* Ordering is stable across saves and index rebuilds

Performance:
* Uses an internal option‑based index
* Avoids slow meta queries at runtime

Smart Variables

Smart Content supports context‑aware variables via a unified rendering pipeline.

Available contexts include:
* Site
* Post / Page
* WooCommerce product
* Shortcode attributes

Rendering is consistent across:
* Frontend
* Editors
* Previews
* Auto‑insert

SEO Analysis Compatibility (v1.0)

Smart Content manual inserts are visible to SEO analyzers
Server-side rendering ensures analyzers see expanded HTML (not placeholders)
Draft-aware analysis:
- Unsaved editor changes are included during SEO analysis
Supported SEO plugin:
- Yoast SEO

Not included in v1.0:
* Auto Inserted Smart Content is not yet included in SEO analysis
* Additional SEO plugins (Rank Math, AIOSEO) are planned for future releases

Permissions & Safety

Dedicated capabilities for Smart Content
Rendering guarded against:
- Admin screens
- Feeds
- REST contexts
- SEO analysis requests

Settings

Central Settings page under Smart Content
Uninstall behavior option:
- Optional deletion of Smart Content posts on uninstall

Uninstall Behavior

By default, uninstalling Smart Content Sync will:
* Remove internal caches and runtime options
* Preserve all Smart Content posts and metadata

You may optionally enable deletion of Smart Content posts from:
Smart Content Settings Uninstall

Extensibility

Smart Content Sync exposes filters and hooks for:
* Auto‑insert locations
* Rendering behavior
* Smart Variable contexts
* Permissions and guards

The architecture is intentionally designed to support future Pro features without breaking v1.0 behavior.

License

This plugin is licensed under the GPLv2 or later.