=== AgilePress Content Block for ACF ===

Contributors:       AgilePress
Donate link:        https://agilepress.net
Tags:               acf, advanced custom fields, display custom fields, repeater, dynamic content
Tested up to:       6.9
Stable tag:         1.0.0
Requires at least:  6.1
Requires PHP:       7.0
License:            GPLv2 or later
License URI:        https://www.gnu.org/licenses/gpl-2.0.html

Display ACF fields, Repeaters, and Galleries on the frontend using simple HTML. No PHP coding required.

== Description ==

**AgilePress Content Block for ACF** is the easiest way to **display Advanced Custom Fields (ACF)** data on your site without writing PHP code.

This plugin bridges the gap between ACF and the Block Editor, allowing you to render field values, loop through **Repeaters**, and display **Image Galleries** using custom HTML templates directly in the editor.

**Key Features:**

* **Display ACF on Frontend:** Render any custom field value using `{field_name}`.
* **No Coding Required:** Stop editing theme files; build templates inside the block.
* **ACF Repeater Support:** Easily loop through repeater rows with simple tags.
* **Group & Nested Fields:** Access complex data structures like `{group:subfield}`.
* **Dynamic HTML:** Full control over your HTML structure and CSS classes.

**Supported Syntax:**

* **Simple fields:** `{field_name}` (Text, Number, Email, etc.)
* **Group fields:** `{group_name:sub_field_name}`
* **Repeaters & Galleries:** `{{repeater_name}}` content `{{/repeater_name}}`

**Requirements:**
* Advanced Custom Fields (Free or PRO) installed and activated.

== Installation ==

1. Install and activate **Advanced Custom Fields**.
2. Install "AgilePress Content Block for ACF".
3. Add the block to any post or page.
4. Enter your HTML and ACF tags in the sidebar settings.

== Frequently Asked Questions ==

= How do I display simple ACF fields? =
Wrap the field name in curly braces: `{title}` or `{price}`.

= How do I access Group fields? =
Use a colon to separate the group and sub-field: `{location:city}`.

= How do I loop through Repeaters or Galleries? =
Use double curly braces to open and close the loop. Inside, use single braces for sub-fields.

    {{team_members}}
       <h3>{name}</h3>
       <p>{position}</p>
    {{/team_members}}

= Does it work with ACF PRO? =
Yes, it works seamlessly with both the Free and PRO versions (including Gallery and Repeater fields).

== Screenshots ==

1. Block editor with sidebar settings.
2. Syntax guide in the inspector panel.
3. Frontend display example (display ACF fields).
4. Repeater field loop example.
5. Group field example.

== Changelog ==

= 1.0.0 =
* Initial release.

== Usage Examples ==

**1. Display Simple Field:**

    <div class="product-info">
      <h1>{product_name}</h1>
      <p>Price: {price}</p>
    </div>

**2. Display Group Field:**

    <div class="contact-details">
      <p>Email: {contact:email}</p>
      <p>Phone: {contact:phone}</p>
    </div>

**3. Display Repeater or Gallery:**

    <ul class="image-gallery">
      {{my_gallery}}
        <li>
           <img src="{url}" alt="{alt}">
           <span>{caption}</span>
        </li>
      {{/my_gallery}}
    </ul>