AgilePress

AgilePress Content Block for ACF is a versatile tool developed by <a href="https://agilepress.net" rel="nofollow ugc">AgilePress</a> that allows you to create dynamic HTML content with Advanced Custom Fields integration. It supports four powerful syntaxes for different ACF field types:
<ul>
<li>Simple fields: Use <code>{field_name}</code> for text, number, and other simple fields</li>
<li>Group fields: Use <code>{group_name:sub_field_name}</code> to access fields within ACF groups</li>
<li>Repeaters & Galleries: Use <code>{{repeater_name}}</code> HTML content with <code>{sub_field}</code> tags <code>{{/repeater_name}}</code> to loop through repeater fields and image galleries</li>
<li>Conditionals: Use <code>{{#if field}}...{{/if}}</code> for conditional content display with support for <code>=</code> and <code>!=</code> comparisons</li>
</ul>
This block is perfect for:
<ul>
<li>Displaying custom field data in formatted HTML</li>
<li>Creating dynamic templates with ACF fields</li>
<li>Building complex layouts that pull data from custom fields</li>
<li>Looping through repeater fields and image galleries</li>
<li>Accessing nested group field data</li>
<li>Showing/hiding content based on field values</li>
<li>Integrating ACF data seamlessly into your content</li>
</ul>
The block provides an intuitive sidebar editor where you can write HTML and insert ACF field tags. On the frontend, these tags are automatically replaced with the actual values from your Advanced Custom Fields.
Requirements:
<ul>
<li>Advanced Custom Fields (free or PRO version)</li>
<li>WordPress 6.1 or higher</li>
<li>PHP 7.0 or higher</li>
</ul>
<h3>Usage Examples</h3>
Example 1 – Simple field display:
<pre><code><div class="location">
 Latitude: {latitude}
 Longitude: {longitude}
</div>
</code></pre>
Example 2 – Group field access:
<pre><code><div class="contact">
 <h3>{contact_info:name}</h3>
 Email: <a href="mailto:{contact_info:email}">{contact_info:email}</a>
 Phone: {contact_info:phone}
</div>
</code></pre>
Example 3 – Repeater field loop:
<pre><code><ul class="team-members">
 {{team_member}}
 <li>
 <h4>{name}</h4>
 {position}
 {bio}
 </li>
 {{/team_member}}
</ul>
</code></pre>
Example 4 – Gallery field loop:
<pre><code><div class="gallery">
 {{project_images}}
 <figure>
 <img src="{url}" alt="{alt}" width="{width}" height="{height}" />
 <figcaption>{caption}</figcaption>
 </figure>
 {{/project_images}}
</div>
</code></pre>
Example 5 – Conditional display:
<pre><code><article class="post">
 {{#if featured}}
 Featured
 {{/if}}

 <h2>{title}</h2>

 {{#if status = published}}
 Published: {date}
 {{#elseif status = draft}}
 This is a draft
 {{#else}}
 Pending review
 {{/if}}

 {{#if author_name != Anonymous}}
 By {author_name}
 {{/if}}
</article>
</code></pre>
Example 6 – Complex combination:
<pre><code><article class="project">
 <header>
 {{#if is_featured}}
 Featured Project
 {{/if}}

 <h2>{project_title}</h2>
 
 Location: {location:city}, {location:country} 
 Date: {project_date}
 
 </header>

 <div class="gallery">
 {{project_gallery}}
 <figure>
 <img src="{url}" alt="{alt}" loading="lazy" />
 <figcaption>{caption}</figcaption>
 </figure>
 {{/project_gallery}}
 </div>

 {{#if features}}
 <div class="features">
 <h3>Project Features</h3>
 <ul>
 {{features}}
 <li>
 {feature_name}: {feature_value}
 </li>
 {{/features}}
 </ul>
 </div>
 {{/if}}

 <footer>
 {{#if client_type = commercial}}
 Commercial Project
 {{/if}}

 Client: {client_info:company_name}

 {{#if client_info:email != none}}
 Contact: {client_info:email}
 {{/if}}
 </footer>
</article><h3>Additional Information</h3>
</code></pre>
Security: 
All field values are properly escaped using WordPress security functions (<code>esc_html()</code>, <code>esc_url()</code>, <code>wp_kses_post()</code>) to prevent XSS attacks and ensure safe output.
Performance: 
The block uses WordPress native functions and ACF’s optimized field retrieval methods. Field values are processed server-side during render, ensuring optimal frontend performance.
Compatibility:
<ul>
<li>WordPress 6.1+ (tested up to 6.9)</li>
<li>PHP 7.0+ (tested up to 8.3)</li>
<li>ACF free version 5.0+</li>
<li>ACF PRO 5.0+</li>
<li>Classic and Block themes</li>
</ul>
Developer Notes: 
The block follows WordPress coding standards and uses

AgilePress Content Block for ACF

Display ACF content using custom tags in HTML with support for groups, repeaters, galleries, and conditionals.

Slava Abakumov

Blocks Randomizer adds dynamic variety to your website by randomly displaying blocks from a collection you define. Simply add the “Blocks Randomizer” container block to any page or post, fill it with your desired content blocks, and the plugin will automatically select and display one (or more) randomly each time the page loads.
Perfect for creating fresh, engaging experiences for repeat visitors without manually updating content.
<h3>Key Features</h3>
<ul>
<li>Easy to Use: Works seamlessly with the WordPress Block Editor (Gutenberg)</li>
<li>Flexible Content: Add any type of block as a child – paragraphs, images, headings, galleries, custom blocks, and more</li>
<li>Multiple Display Options: Choose how many random blocks to show at once</li>
<li>No Coding Required: Simple drag-and-drop interface for managing randomized content</li>
<li>Performance Optimized: Lightweight and efficient randomization</li>
</ul>
<h3>Use Cases</h3>
Rotating Testimonials 
Create a collection of testimonial blocks and display a different customer review each time visitors load your page. Great for homepage hero sections or service pages.
Daily Tips & Quotes 
Add multiple quote or paragraph blocks with tips, motivational quotes, or daily advice. Each page load presents fresh inspiration to your audience.
Random Call-to-Actions 
Test different CTAs by randomly displaying various buttons, banners, or promotional blocks. Perfect for A/B testing messaging without complex tools.
Product Showcases 
Rotate featured products, services, or portfolio items on your homepage to give equal visibility to different offerings.
Educational Content 
Display random “Did You Know?” facts, learning tips, or course highlights to keep educational sites engaging for returning students.
Banner & Advertisement Rotation 
Cycle through different promotional banners, partner logos, or advertisement blocks without needing a separate ad management plugin.
Seasonal Greetings 
Add multiple greeting blocks for different occasions and let visitors see varied welcome messages throughout the year.
Team Member Spotlights 
Showcase different team members randomly on your about page, giving everyone fair representation.
<h3>How It Works</h3>
<ol>
<li>Add the “Blocks Randomizer” block to your page or post</li>
<li>Insert any blocks you want as direct children (top-level blocks will be picked during the randomization logic)</li>
<li>Configure how many blocks to display at once (optional)</li>
<li>Publish your page – visitors will see random content from your collection</li>
<li>Update anytime by adding, removing, or editing child blocks</li>
</ol>
<h3>Using with the Block Editor (Gutenberg)</h3>
The Blocks Randomizer is built natively for the WordPress Block Editor (Gutenberg). It works as a container block that accepts any other blocks as children:
<ul>
<li>Full compatibility with all core WordPress blocks (Paragraph, Image, Heading, Gallery, Button, Quote, etc.)</li>
<li>Drag-and-drop interface for easy block management within the randomizer</li>
<li>Live preview in the editor showing all your blocks (actual randomization happens on the front-end)</li>
<li>Block toolbar and settings work normally for blocks inside the randomizer</li>
</ul>
Simply add the Blocks Randomizer block anywhere you’d add any other block, and start building your randomized content collection.
<h3>Perfect For</h3>
<ul>
<li>Marketing and landing pages</li>
<li>Membership and community sites</li>
<li>Educational and training platforms</li>
<li>E-commerce and business websites</li>
<li>Blogs and content sites</li>
<li>Portfolio and agency websites</li>
</ul>
Whether you’re looking to increase engagement, test different messaging, or simply add variety to your content, Blocks Randomizer makes it simple and intuitive.
<h3>How to Create Rotating Testimonials</h3>
Creating rotating customer testimonials is one of the most popular uses for the Blocks Randomizer. Here’s a step-by-step guide:
<ol>
<li>Create or edit the page where you want testimonials to appear (typically your homepage, services page, or dedicated testimonials page)</li>
<li>Add the Blocks Randomizer block by clicking the “+” button and searching for “Blocks Randomizer” or typing <code>/random</code></li>
<li>Add your first testimonial inside the randomizer container – you can use Quote blocks, Paragraph blocks, or custom testimonial blocks from your theme</li>
<li>Format your testimonial with the customer’s quote, name, company, and optionally add their photo using an Image block</li>
<li>Add more testimonials by clicking the “+” button inside the randomizer and repeating the formatting for each customer review</li>
<li>Adjust display settings (optional) – in the block sidebar, you can set how many testimonials to show at once if you want to display multiple reviews</li>
<li>Publish or update your page – visitors will now see a different random testimonial each time they load the page</li>
</ol>
Pro tip: Use consistent formatting for all testimonials (same heading sizes, image dimensions, text styles) to ensure smooth visual transitions between random selections.
<h3>How to Set Up Random Call-to-Actions</h3>
Rotating different call-to-action messages helps you test which messaging resonates best with your audience:
<ol>
<li>Open the page where you want rotating CTAs (homepage, landing page, or product page)</li>
<li>Add the Blocks Randomizer block in the section where you want your CTA to appear</li>
<li>Create your first CTA using Button blocks, Heading + Paragraph combinations, or custom CTA blocks from your theme or page builder</li>
<li>Duplicate and modify – create variations with different:
<ul>
<li>Headline text (“Start Your Free Trial” vs “Get Started Today”)</li>
<li>Button colors and styles</li>
<li>Supporting copy and benefits messaging</li>
<li>Urgency elements (“Limited Time Offer” vs “No Credit Card Required”)</li>
</ul>
</li>
<li>Add each variation as a separate block group inside the randomizer</li>
<li>Set to display one CTA at a time using the “Number of blocks” setting (set to 1)</li>
<li>Monitor performance over time to see which messages drive more conversions</li>
</ol>
Pro tip: Keep the overall design structure similar across variations so the page layout remains consistent, but vary the messaging and emphasis to test different value propositions.
Pro tip 2: You can use different UTM values (specifically, <code>utm_content</code>) for your CTA buttons inside the randomizer, this way you can even track using any analytics solution (like Google Analytics, or Fathom Analytics, or Plausible Analytics) which CTA performs better.
<h3>How to Display Random Products</h3>
For e-commerce sites, rotating product showcases give equal visibility to your catalog:
<ol>
<li>Navigate to your homepage or shop page in the Block Editor</li>
<li>Add the Blocks Randomizer block where you want featured products to rotate</li>
<li>Insert WooCommerce or Easy Digital Downloads product blocks inside the randomizer – you can use:
<ul>
<li>Single Product blocks (for individual product showcases)</li>
<li>Products by Category blocks (for category spotlights)</li>
<li>Hand-picked Products blocks (for curated selections)</li>
</ul>
</li>
<li>Configure each product block with your desired layout, show/hide settings for price, ratings, “add to cart” button, etc.</li>
<li>Add multiple product configurations – create different product spotlights, categories, or seasonal collections</li>
<li>Adjust how many products to display using the randomizer settings</li>
<li>Publish your page – products will rotate automatically, giving fair exposure to different items</li>
</ol>
Pro tip: Group related products together or create themed product blocks (e.g., “Summer Collection,” “Best Sellers,” “New Arrivals”) for more cohesive random displays.
<h3>How to Rotate Banner Advertisements</h3>
If you display ads, partner logos, or promotional banners, the randomizer helps distribute visibility:
<ol>
<li>Prepare your banner images – ensure they’re all the same dimensions for a consistent layout</li>
<li>Add the Blocks Randomizer block to your sidebar, header, or content area where banners should appear</li>
<li>Insert Image blocks inside the randomizer, uploading each banner or advertisement</li>
<li>Add links to each image by selecting the image and clicking the link icon – set destinations for each ad</li>
<li>Include alt text for accessibility and SEO on each image</li>
<li>Add multiple banners – upload all your advertisement images or promotional graphics</li>
<li>Set display quantity based on your layout (1 for single banner rotation, multiple for ad grids)</li>
<li>Publish and monitor – banners will rotate fairly, ensuring all advertisers or promotions get equal exposure</li>
</ol>
Pro tip: Use the same aspect ratio for all banners to prevent layout shifts. Consider adding a Text block below images for additional context or disclaimers if needed.
<h3>How to Configure Block Display Settings</h3>
Fine-tuning how many random blocks appear gives you precise control over your content:
<ol>
<li>Select the Blocks Randomizer block by clicking on it in the editor</li>
<li>Open the Settings sidebar on the right side of the screen (if not visible, click the gear icon in the top-right)</li>
<li>Find the “Number of blocks” setting in the block settings panel</li>
<li>Adjust the number using the input field or arrows:
<ul>
<li>Set to 1 for single random block display (great for hero sections, testimonials)</li>
<li>Set to 2-3 for multiple testimonials or product showcases</li>
<li>Set to 0 to hide the entire block on the front-end (useful for temporarily disabling without deleting content)</li>
</ul>
</li>
<li>Preview changes by viewing the page on the front-end or using the editor preview</li>
<li>Consider your layout – ensure multiple random blocks fit well within your design at different screen sizes</li>
</ol>
Pro tip: The number you set is the maximum that will display. If you have fewer blocks inside the randomizer than the number specified, all available blocks will show.
<h3>Using with WooCommerce or Easy Digital Downloads</h3>
Perfect for e-commerce sites looking to rotate products, promotions, and calls-to-action:
<ul>
<li>Product blocks – Add Single Product, Products by Category, or Hand-picked Products blocks inside the randomizer</li>
<li>Product rotations – Showcase different products on your homepage or shop sidebar</li>
<li>Promotional banners – Rotate sale announcements and special offers</li>
<li>Category spotlights – Give equal visibility to different product categories</li>
<li>Cross-sells and upsells – Randomize product recommendations on product pages</li>
</ul>
Example use case: Add and configure a grid block on your homepage, then add a randomizer inside of it, then add 5-10 featured products to the randomizer, set it to display 3 at a time, and visitors will see a different product selection on each visit.
<h3>Using with Caching Plugins</h3>
Understanding how caching affects randomization is crucial:
WP Rocket: 
– Random blocks work with WP Rocket’s page caching 
– Content randomizes when cache regenerates (based on cache lifespan) 
– For per-visit randomization, add pages to cache exclusions 
– Consider using shorter cache lifespans for dynamic pages
W3 Total Cache: 
– Compatible with page and object caching 
– Random selection happens during cache generation 
– Configure cache expiration based on how often you want new random content 
– Use fragment caching to cache everything except the randomizer
WP Super Cache: 
– Works with WP Super Cache out of the box 
– Each cache refresh will select new random blocks 
– Set appropriate cache timeout for your content rotation needs
LiteSpeed Cache: 
– Fully compatible with LiteSpeed caching 
– Random blocks cached until cache expires 
– Use ESI (Edge Side Includes) for more dynamic behavior if needed
Cloudflare / CDN: 
– CDN caching will serve the same version to all users until cache expires 
– Configure page rules for pages with randomized content 
– Consider shorter TTL (Time To Live) for dynamic pages
Key principle: The Blocks Randomizer performs server-side randomization. Whatever is selected gets cached. New random selection happens when cache regenerates.
<h3>Using with SEO Plugins</h3>
The Blocks Randomizer is SEO-friendly since randomization happens server-side.
SEO best practices: 
– Don’t place critical, unchanging SEO content in the randomizer 
– Use the randomizer for supplementary elements (testimonials, CTAs, featured items) 
– All variations should be topically relevant to the page’s main purpose 
– Consider that search engines may index different random variations on different crawls
<h3>Using with Form Plugins</h3>
Randomize different contact forms or lead capture forms to determine which one performs better – collects more contacts or leads.
WPForms: 
– Insert WPForms blocks inside the randomizer 
– A/B test different form designs 
– Rotate forms for different services or products
Contact Form 7: 
– Add Contact Form 7 blocks to the randomizer 
– Test different form layouts and field combinations 
– Rotate forms for different audiences or purposes
Gravity Forms: 
– Add Gravity Forms blocks to random rotation 
– Test form conversion rates with different layouts 
– Display appropriate forms based on random selection
Formidable Forms: 
– Compatible with Formidable Forms blocks 
– Randomize contact forms, surveys, or calculators
<h3>Using with Membership & LMS Plugins</h3>
Display dynamic content for members or students:
LearnDash: 
– Randomize course highlights or lesson previews 
– Rotate student testimonials 
– Display random course modules or topics
MemberPress: 
– Rotate membership benefits or pricing tables 
– Randomize member testimonials 
– Display different membership tier highlights
LifterLMS: 
– Randomize course showcases 
– Rotate instructor spotlights 
– Display random learning paths

Content Randomizer – Rotate Any Block

Rotate and display random content blocks on every page load. Perfect for testimonials, CTAs, and dynamic content. Works with any block type.

AgilePress Content Block for ACF vs Content Randomizer – Rotate Any Block