# Usage Guide Pro

This guide covers the additional features available in the Pro version of Dynamic Elementor ACF Repeater.

Start your 3-day free trial of the Pro version to unlock all features. Start Your Free Trial

# Multiple Loop Grids in a Single Post

As of version 1.0.2, the Pro version exclusively supports using multiple Loop Grid widgets with ACF Repeater fields in the same post or template. This powerful feature is not available in the free version.

# Features and Benefits

• Create diverse layouts using different Loop Grid widgets on the same page
• Display various repeater fields from the same post in different formats
• Apply unique styling and filtering to each Loop Grid independently
• Combine multiple ACF Repeater displays in a single template

# Implementation Steps

1. Create separate Loop Item templates for each repeater field you want to display
2. Add multiple Loop Grid widgets to your template
3. Configure each Loop Grid with:
   • Its own Loop Item template
   • Unique repeater field selection
   • Independent filtering options
   • Custom styling

# Use Cases

• Display product gallery and product specifications in different grid layouts
• Show team member photos in one grid and skills in another
• Present project images and project details with different styling

# Lightbox and Swiper Configuration

1. Find the "Lightbox" section in Loop Grid widget settings
2. Enable the lightbox and swiper features

   

3. Customize lightbox appearance:

# Repeater Lightbox Style

• Content Width: Adjust the width of lightbox content (default: 80%)
• Content Height: Set the height of lightbox content (default: 80%)
• Maximum Content Width: Define maximum width in pixels (default: 1920px)
• Lightbox Background: Choose background color for the lightbox overlay
• Content Padding: Set padding for top, right, bottom, and left
• Swiper Navigation Color: Customize the color of navigation arrows
• Swiper Navigation Size: Adjust the size of navigation arrows
• Lightbox Close Icon Color: Set the color of the close button
• Lightbox Close Icon Size: Adjust the size of the close button

# Element Visibility Control

Control how elements appear in different contexts:

1. Select any dynamic repeater element in your Loop Item template
2. Open the Content tab
3. Find the "Repeater Lightbox Visibility" section
4. Choose from:
   • Default: Visible everywhere
   • Hide in Lightbox: Only visible in loop grid
   • Show Only in Lightbox: Hidden in loop grid, visible in lightbox

# Advanced Filtering

Set up dynamic filtering for your Loop Grid:

# Basic Setup

1. In Loop Grid settings, find the "Filter" section
2. Enable filtering
3. Select filter source:
   • ACF field values
   • Custom taxonomies
   • Post meta

# Custom Taxonomy Filtering

The Custom Taxonomy Filter lets you filter your Loop Grid items using WordPress taxonomies (like categories, tags, or custom taxonomies).

# How It Works

# Default: Parent Post Taxonomy

By default, the filter uses taxonomy terms from the parent posts containing your repeater field.

Process:

1. The filter collects all taxonomy terms from posts that have your repeater field
2. When users select a term, it shows repeater items from posts with that term
3. All repeater items from the same post are filtered together

# Optional: Repeater Field Taxonomy

Enable "Use Repeater Taxonomy Field" to filter using taxonomy terms stored in your repeater field instead.

Process:

1. Choose a taxonomy (e.g., categories, tags)
2. Select which repeater field contains your taxonomy terms
3. Filter shows terms from the selected repeater field
4. Items are filtered based on their individual taxonomy values

# Display Options

Choose how users will interact with your filters:

1. Dropdown Menu

   • Clean, compact select menu
   • Good for lots of terms
   • Mobile-friendly

2. Checkbox List

   • Select multiple terms
   • All options visible
   • Great for multiple selections

3. Navigation Buttons

   • Button-style interface
   • Easy to click
   • Best for few terms

# Setup Steps

1. Enable the Filter:

   • Go to Loop Grid settings
   • Find the "Repeater Filter" section
   • Enable "Custom Taxonomy Filter"

2. Configure Filter:

   • Select which taxonomy to filter by (this will use parent post terms by default)
   • Choose your display style (dropdown/checkbox/navigation)
   • To use repeater field terms instead: Enable "Use Repeater Taxonomy Field" and select your repeater's taxonomy field

3. Customize Display:

   • Show/hide "All" option
   • Customize "All" text
   • Set filter alignment
   • Choose horizontal/vertical layout
   • Adjust spacing and margins

4. Style Your Filter:

   • Set colors and typography
   • Customize padding and margins
   • Style active/hover states
   • Adjust border and radius

# Common Applications and Examples

# Using Default Parent Post Taxonomy

Perfect when you have multiple posts and want to filter groups of repeater items:

1. Portfolio Websites

   • Example: A photography website with multiple project posts
   • Each project post is tagged (Wedding, Corporate, Events)
   • Each project contains multiple photos in a repeater
   • Filtering by "Wedding" shows all photos from wedding projects
   • All photos from the same project are filtered together

2. Real Estate Listings

   • Example: A property listing website
   • Properties (posts) tagged by location and type
   • Each property has multiple images in a repeater
   • Filter entire property galleries by "Beachfront" or "City Center"
   • All images from the same property show/hide together

# Using Repeater Field Taxonomy

Enable this when individual repeater items need their own taxonomy terms:

1. Product Catalogs

   • Example: A fashion store catalog
   • One post contains the entire season's collection
   • Each product in repeater has its own categories
   • Filter individual items by "Men's", "Women's", "Accessories"
   • Products can be filtered independently

2. Document Libraries

   • Example: A resource center
   • One post holds all company documents
   • Each document in repeater has topic tags
   • Filter by department or document type
   • Documents filter based on their own classifications

# ACF Relationship Query

The ACF Relationship Query feature allows you to display related content from across your site within your Loop Grid. This powerful feature helps you create dynamic content relationships and display them in your Elementor templates.

# Prerequisites

• ACF Relationship field configured in your field group
• Pro version of Dynamic Elementor ACF Repeater
• Loop Grid widget with ACF Repeater enabled

# Setting Up Relationship Queries

1. Open your Loop Grid widget settings
2. Find the "ACF Relationship" section
3. Enable "Use ACF Relationship"
4. Select your relationship field from the dropdown

# How It Works

When you enable relationship queries:

• The Loop Grid automatically queries all related posts
• Displays content based on your relationship field selections
• Works with any post type (posts, pages, custom post types)
• Shows all related posts without pagination
• Maintains relationships configured in ACF

# Common Use Cases

1. Related Content

   • Display related posts or articles
   • Show associated products
   • List team members by department

2. Content Relationships

   • Link projects to team members
   • Connect services to case studies
   • Associate events with venues

3. Dynamic Collections

   • Create featured content sections
   • Build cross-referenced galleries
   • Display linked resources

# Tips for Relationship Queries

• Use ACF's interface to manage content relationships
• Combine with visibility controls for flexible displays
• Mix with filtering for advanced content organization
• Leverage dynamic tags to show related post data

# Pro Field Types Support

The pro version adds support for these additional ACF field types:

# File Fields

• Add document downloads to your loops
• Display file type icons
• Show file size and download count
• Preview documents inline

# Gallery Fields

• Display multiple images in a grid or slider
• Enable lightbox for gallery items
• Configure gallery layouts and spacing
• Add hover effects and animations

# Relationship Fields

• Display related content from other posts
• Link to connected entries
• Show relationship field data in your loops
• Create complex content relationships

# Pro Tips

• Use visibility control to create different experiences in grid vs lightbox
• Combine slider with lightbox for image galleries
• Set up multiple filters for complex content organization
• Utilize relationship fields for connected content displays