Smart Content Sync

外掛說明

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.