Andrew Whittaker

This plugin provides a set of simple, powerful helper functions to reduce boilerplate code and streamline the process of retrieving and displaying ACF field values in your templates. It includes helpers for getting single values (with support for nested groups), and for easily looping over repeater fields. The plugin is built with security and best practices in mind, ensuring that all output can be properly escaped.
<h3>Features:</h3>
<ul>
<li><code>get_acf()</code>: A versatile function to get any field value. It supports dot notation for nested group fields and automatically handles <code>get_sub_field()</code> context within repeaters.</li>
<li><code>repeater()</code>: A clean way to loop through repeater fields with callbacks. Includes optional callbacks for before and after the main loop, and allows passing an arguments array to the row callback. (Requires ACF Pro)</li>
<li><code>get_repeater_field()</code>: Fetch a specific sub-field value from a specific row, or an array of all values for a sub-field across all rows. (Requires ACF Pro)</li>
<li>Lightweight and secure.</li>
<li>Logs to the PHP error log for easy debugging.</li>
</ul>
<h3>Usage Examples:</h3>
<h3>get_acf()</h3>
This is your main function for retrieving any ACF field value.
<ol>
<li>
Basic Usage: Get the value of a text field named <code>page_headline</code>.
<pre><code><h1><?php echo get_acf('page_headline'); ?></h1>
</code></pre>
</li>
<li>
Providing a Default Value: If the <code>page_subtitle</code> field might be empty, provide a fallback.
<pre><code><h2><?php echo get_acf('page_subtitle', 'This is a default subtitle'); ?></h2>
</code></pre>
</li>
<li>
Escaping HTML: When outputting a value inside an HTML attribute, always escape it.
<pre><code><?php
$alt_text = get_acf('image_alt_text', 'Default alt text', 'attr');
echo '<img src="..." alt="' . $alt_text . "'>";
</code></pre>
</li>
</ol>
Other escape options: <code>html</code>, <code>url</code>, <code>js</code>, <code>text</code>.
<ol>
<li>
Getting a Value from an Options Page: To get a field value from an ACF Options Page, pass <code>option</code> as the <code>$post_id</code>.
<pre><code><?php
$footer_copyright = get_acf('footer_copyright_text', '', 'html', 'option');
</code></pre>
</li>
<li>
Getting a Value from a Nested Group Field: Use dot notation to access fields inside a group.
<pre><code><?php
$phone = get_acf('contact_details.phone_number');
</code></pre>
</li>
<li>
Automatic Sub Field Usage: Inside a standard ACF <code>have_rows</code> loop, <code>get_acf()</code> automatically uses <code>get_sub_field()</code> so you don’t have to change your function calls.
<pre><code><?php
if (have_rows('team_members')) :
 while (have_rows('team_members')) : the_row();
 // This correctly gets the 'member_name' sub field for the current row.
 echo '<h3>' . get_acf('member_name', '', 'html') . '</h3>';
 endwhile;
endif; 
</code></pre>
</li>
</ol>
<h3>repeater() (ACF Pro Only)</h3>
This function simplifies looping over repeater fields.
<ol>
<li>
Basic Repeater Loop: To display a list of testimonials from a repeater named <code>testimonials</code> with a sub-field <code>testimonial_text</code>:
<pre><code><?php
repeater('testimonials', function($index) {
 echo '<blockquote>' . get_acf('testimonial_text', '', 'html') . '</blockquote>';
});
</code></pre>
</li>
<li>
Using Before and After Callbacks: To wrap your repeater output in <code><ul></code> and <code><li></code> tags.
<pre><code><?php
repeater(
 'service_list',
 function($index) { // Main row callback
 echo '<li>' . get_acf('service_name') . '</li>';
 },
 [], // No args needed for this example
 function() { // Before callback
 echo '<ul>';
 },
 function() { // After callback
 echo '</ul>';
 }
);
</code></pre>
</li>
<li>
Passing Arguments to the Callback: To make your repeater template more reusable, pass in arguments.
<pre><code><?php
$args = [
 'item_class' => 'faq-item',
 'heading_level' => 'h3'
];

repeater(
 'faqs',
 function($index, $args) {
 printf('<div class="%s">', esc_attr($args['item_class']));

 printf(
 '<%s>%s</%s>',
 esc_attr($args['heading_level']),
 esc_html(get_acf('question')),
 esc_attr($args['heading_level'])
 );

 echo '<div>' . get_acf('answer', '', 'html') . '</div></div>';
 },
 $args
); 
</code></pre>
</li>
</ol>
<h3>get_repeater_field() (ACF Pro Only)</h3>
Use this to get data from a repeater field without looping through it manually.
<ol>
<li>
Get All Values from a Sub-Field:
<pre><code><?php
$all_attendees = get_repeater_field('event_attendees', 'attendee_name');
// $all_attendees is now an array: ['John Doe', 'Jane Smith', ...]

echo 'Total attendees: ' . count($all_attendees) . '';
</code></pre>
</li>
<li>
Get a Value from a Specific Row:
<pre><code><?php
// Row index is 0-based, so 2 is the third row.
$third_image = get_repeater_field('slider', 'slide_image', 2);

if ($third_image) {
 // $third_image will contain the image array/ID from ACF
 echo wp_get_attachment_image($third_image, 'large');
}
</code></pre>
</li>
</ol>

Field Helper Functions For ACF Pro

A collection of helper functions to make working with Advanced Custom Fields Pro in your WordPress themes even easier.

SaffireTech

Elevate your sales game with Dynamic Cart Messages for WooCommerce! This powerful tool enables you to display personalized messages on your WooCommerce cart page. Motivate your customers to increase their cart quantity or total spend on your favorite products or product categories, driving a boost in your sales.
<ul>
<li>Allows you to show messages based on 3 different types of rules – Simple, Price-based, or Quantity-based.</li>
<li>These messages can be set for a particular product, product category, or all products.</li>
<li>Allows you to set specific thresholds for price and quantity to incentivize customers to add a certain price amount/quantity to the cart to avail a discount.</li>
<li>Once the customer adds a product to the cart that qualifies the defined criteria for a message, depending on the rule type (price /quantity) customers will be able to see how much amount/quantity they need to add to the cart to avail the offer set by you.</li>
<li>The message can be shown to users on Cart Page, Checkout Page & Product Pages.</li>
<li>Allows you to set an expiry date for the message.</li>
<li>Allows you to add a Call-to-action with a URL in the message which you can use to link to a separate landing page or to a page that explains the terms & conditions of the offer.</li>
</ul>
Perfect for store owners who want to –
<ul>
<li>Show free shipping based on cart value like Amazon. E.g. “Add $50 of eligible items to your order to qualify for Free Delivery”.</li>
<li>Incentivise customers to add more quantity to the cart of a particular product or products of a particular category to buy ‘X’ items. E.g. “Buy 5 more to get a discount of 10%. Use Coupon FLAT10 at checkout”.</li>
<li>Incentivize customers to buy a certain amount value of a particular product or particular category E.g “Buy $10 worth of more T-shirts to be eligible for 5% cashback”.</li>
<li>Show a success message based on the condition set and threshold value reached.</li>
</ul>
Fast and Easy 
Easy to set conditions for the messages quickly in minutes.
Conditionally Dynamic 
The message changes automatically based on the specific amount/quantity set for the product/product category that customers need to add instead of showing a plain static message that drives them to buy more.
“Add $10 of products to your cart to avail free shipping” is more personalized, appealing, and convincing than a plain static message like “Free shipping on all orders above $100”.
Boost Sales 
By seeing messages, customers are tempted to buy more and thus it boosts sales. Also, you can increase the average order value by notifying customers about the amount to spend to get free shipping or a discount.
With <a href="https://www.saffiretech.com/dynamic-cart-messages-pro-woocommerce/?utm_source=wp_plugin&utm_medium=listing&utm_campaign=free2pro&utm_id=c1&utm_term=upgrade_now&utm_content=dcm" rel="nofollow ugc">Dynamic Cart Messages Pro for WooCommerce</a>, take your sales game to the next level with the following features:
<ul>
<li>Prioritize Cart Messages: Streamline customer decisions with prioritized Cart Messages. This feature allows you to sequence messages for similar products or categories, displaying them one at a time based on set priorities. Enhance the shopping experience by guiding customers through a clear, incentivized path, encouraging them to add more to their carts with strategic, sequential messaging.</li>
<li>Urgency-Driven Countdowns: Generate urgency with Countdown Timers alongside Cart Messages, urging buyers to act swiftly. Choose between Scheduled Countdowns for precise sale periods and Evergreen Countdowns for a continuous sense of urgency.</li>
<li>Strategic Message Placement: Strategically display Cart Messages on the Cart Page, Checkout Page, and Product Page, influencing purchasing decisions at crucial touchpoints.</li>
<li>Diverse Countdown Designs: Select from four captivating Countdown Designs, ensuring visually appealing and effective prompts for increased WooCommerce sales.</li>
<li>Icons and Emojis support: Elevate your messages with a vast selection of icons and emojis. The pro version empowers you to choose from a variety of icons, upload custom ones, and even incorporate emojis for expressive cart messages.</li>
<li>Scheduled Campaign in Advance: Plan your campaigns with ease. The pro version allows you to schedule campaigns by selecting the exact date and time in advance, ensuring a timely and strategic approach.</li>
<li>Creative Color Mastery: Unleash your creativity by customizing your cart message’s color scheme. Enjoy the flexibility of setting custom colors for every element and introducing gradient colors for an artistic touch, making your messages visually appealing.</li>
<li>Preview Perfection: Tailor your cart message to perfection. With the Dynamic Cart Messages Pro, you can customize your message to your liking and preview it effortlessly before going live, ensuring flawless execution with just a click.</li>
</ul>
Recommended Plugins:
<ul>
<li><a href="https://wordpress.org/plugins/bulk-edit-upsells-and-cross-sells-for-woocommerce/" rel="ugc">Bulk Edit Upsells and Cross-Sells for WooCommerce</a></li>
<li><a href="https://wordpress.org/plugins/discontinued-product-stock-status-woocommerce/" rel="ugc">Discontinued Product Stock Status for WooCommerce</a></li>
</ul>
HIRE THE EXPERTS
Need a tailor-made solution for WooCommerce that solves complex business problems? Our team of experienced developers have helped many businesses like yours to accomplish these goals. Hire us as your <a href="https://www.saffiretech.com/custom-woocommerce-development/?utm_source=wp_plugin&utm_medium=listing&utm_campaign=free2pro&utm_id=c1&utm_term=upgrade_now&utm_content=dcm" rel="nofollow ugc">WooCommerce Developers</a> today!
Keep up to date with us by <a href="https://www.saffiretech.com/blog/?utm_source=wp_plugin&utm_medium=listing&utm_campaign=free2pro&utm_id=c1&utm_term=upgrade_now&utm_content=dcm" rel="nofollow ugc">subscribing to the newsletter</a>, <a href="https://twitter.com/saffiretech" rel="nofollow ugc">following us on Twitter</a> and <a href="https://www.facebook.com/saffiretech" rel="nofollow ugc">liking us on Facebook</a>.
If you enjoy using the software <a href="https://wordpress.org/support/plugin/dynamic-cart-messages-woocommerce/reviews/" rel="ugc">we’d love it if you could give us a review!</a>

Dynamic Cart Messages for WooCommerce

Dynamic Cart Messages allows you to boost your sales on your WooCommerce site by allowing you to show tailored messages on the cart page to incentiviz …

Field Helper Functions For ACF Pro vs Dynamic Cart Messages for WooCommerce