=== SEO Help Flow for ACF and Elementor ===
Contributors: croberta84
Tags: elementor, acf, dynamic-content, schema, agency
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.7.0
Requires PHP: 7.4
Requires Plugins: elementor, advanced-custom-fields
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build client-safe, SEO-ready Elementor sites with ACF dynamic content, template health checks, schema blocks, and agency handoff tools.

== Description ==

**If you build sites with Elementor + Advanced Custom Fields, you already know the pain:** great content in ACF, beautiful layout in Elementor—but wiring them together often means shortcodes, fragile templates, or custom PHP you do not want to maintain.

**SEO Help Flow** fixes that. It is a **native Elementor integration** for ACF: pick fields in the panel, see them on the canvas, ship faster, check broken field connections, and keep structured data close to the content your editors already maintain.

**From SEO Help Marketing** — built for agencies, freelancers, and teams who care about **SEO that matches real content**, not duplicate “SEO boxes.”

**Why this stack benefits from a dedicated bridge**

* **One workflow** — editors update ACF; designers stay in Elementor; you stop duplicating text between “content” and “SEO fields.”
* **Template Health checks** — scan Elementor templates and pages for missing or renamed ACF fields before clients find broken layouts.
* **Client-safe handoff** — map approved field groups and hide layout-editing shortcuts for client roles.
* **Structured data without copy-paste** — output **Article**, **FAQPage**, **WebPage**, and **BreadcrumbList** JSON-LD from ACF repeaters and text fields where it makes sense.

**What you can build today** 🎯

* **ACF widgets for Elementor** — Text, Dynamic Text, Heading, Image, Link, Button Advanced, Gallery, Author Meta, Read Time, TOC, CTA Banner and more.
* **ACF Repeater** — grids, lists, sliders; template-driven rows without leaving Elementor.
* **Template Health** — a practical checker for Elementor + ACF field connections.
* **Client-Safe Mode** — agency handoff controls for safer client editing.
* **SEO Intent Blocks** — Local Service, FAQ, Blog Article, Comparison and Testimonial workflows with ACF contracts.
* **ACF JSON-LD (SEO)** — map fields to **schema.org** so search engines see the same story visitors see.
* **Site Blueprint** — export field contracts, template health and workflow settings for reuse across agency projects.

**Who it is for**

* **Agencies** shipping many Elementor + ACF sites and needing a repeatable pattern.
* **Developers** who want maintainable dynamic UI—not one-off hacks per project.
* **SEO-minded builders** who want **valid, maintainable structured data** tied to CMS fields.

**Works with your existing SEO plugin?**

Often yes. Avoid publishing **two competing JSON-LD blocks** for the same thing on the same URL (e.g. two FAQ schemas). Pick one source per schema type—this plugin, or Yoast / Rank Math / etc.—and stay consistent.

**Requirements**

* **WordPress** 6.0+ · **PHP** 7.4+ · **Elementor** + **Advanced Custom Fields** (see *Requires Plugins*).

== Installation ==

1. Install and activate **Elementor** and **Advanced Custom Fields** (required).
2. Install **SEO Help Flow for ACF and Elementor** from **Plugins → Add New** (search) or upload the ZIP.
3. Activate the plugin.
4. Open any page or template in **Elementor**.
5. In the widget panel, open the **Help Flow** category (label may reflect your white-label setting).
6. Drag a widget (e.g. **ACF Text**), select the **ACF field** to use, preview, publish.

**Next step:** In wp-admin, open the plugin’s **Getting Started** page for links, tips, and links to documentation.

== Frequently Asked Questions ==

= Do I need both Elementor and ACF? =

Yes. The plugin is built specifically for sites that use **Elementor** for layout and **Advanced Custom Fields** for structured content. Both are listed under *Requires Plugins*.

= How does the plugin help SEO if it is not a classic SEO plugin? =

It connects **your real content** (ACF) to **structured data** and **semantic output** in Elementor. Instead of pasting static JSON-LD or duplicating text in a separate SEO box, you can drive **Article**, **FAQ**, **WebPage**, and **breadcrumb** schema from fields you already maintain—so SEO stays closer to what users see on the page.

= Is everything free on WordPress.org? =

Yes. Every widget and feature in this WordPress.org build is available **without paying**. No feature is locked behind an upgrade inside this distribution.

= How is this different from generic dynamic tags or shortcodes? =

You get **dedicated ACF widgets** plus agency workflow tools: Template Health, Client-Safe Mode, SEO Intent Blocks and Site Blueprint export—not one generic tag for everything.

= Can I use this with other SEO plugins (Yoast, Rank Math, etc.)? =

In many cases, yes. Avoid outputting **conflicting duplicate JSON-LD** for the same entity on the same page. Pick **one** source of truth per schema type (for example, either your SEO plugin or **ACF JSON-LD (SEO)** for FAQ)—whichever matches your workflow.

= Can I translate the plugin? =

Yes. Text domain: **seohelp-flow-for-acf-and-elementor**. Community translations can be contributed via translate.wordpress.org when available.

= Will this slow down my site? =

The plugin follows WordPress patterns for scripts and styles. As with any Elementor site, keep third-party widgets reasonable and test with your host and caching setup.

== Screenshots ==

1. **Help Flow in Elementor** — the widget category with ACF Text, ACF Dynamic Text, Conditional Logic, ACF Image, ACF Link/Button, ACF Gallery, and ACF JSON-LD (SEO).
2. **Core widgets in the panel** — quick access to ACF Text, ACF Dynamic Text, ACF Repeater Builder, and Conditional Logic from the same category.
3. **Edit ACF Text** — Content tab: choose the ACF field (e.g. Text, Text Area), set the HTML tag (e.g. a paragraph), and options like Hide if empty.
4. **ACF Repeater Builder** — map a Repeater or Flexible field, pick an Elementor template for each row, and lay out items in a grid (columns, gap, responsive controls).
5. **Conditional Logic** — define when a block shows: conditions such as equals, not equals, is empty, or is not empty on the selected ACF field.
6. **More field types in one widget** — ACF Field dropdown including Text, Number, Text Area, and Image, plus control of the output HTML tag.
7. **Insert imported templates** — starter sections (Hero, features, CTA layouts, and more); one click adds them to the Elementor library and creates the **ACF Flow Starter** field group automatically.
8. **Template Health** — scan Elementor templates for missing ACF fields and incomplete widget mappings.
9. **Agency workflows** — Client-Safe Mode, SEO Intent Blocks and Site Blueprint tools for repeatable handoffs.

== Changelog ==

= 1.7.0 =

* Added Template Health Scan for Elementor + ACF field connections.
* Added Client-Safe Mode handoff settings for agency workflows.
* Added SEO Intent Blocks for Local Service, FAQ, Blog Article, Comparison and Testimonial workflows.
* Added Site Blueprint export/import preview for reusable ACF contracts and template health reports.
* Updated directory copy around Elementor ACF dynamic content, schema and agency workflow keywords.

= 1.4.3 =

* Initial release on WordPress.org.
* Readme: conversion-focused directory copy and expanded FAQ.

== Upgrade Notice ==

= 1.7.0 =

Adds Template Health Scan, Client-Safe Mode, SEO Intent Blocks and Site Blueprint workflows for agencies building Elementor + ACF sites.