Andrew Whittaker

<p>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.</p>
<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>
<p>This is your main function for retrieving any ACF field value.</p>
<ol>
<li>
<p><strong>Basic Usage:</strong> Get the value of a text field named <code>page_headline</code>.</p>
<pre><code><h1><?php echo get_acf('page_headline'); ?></h1>
</code></pre>
</li>
<li>
<p><strong>Providing a Default Value:</strong> If the <code>page_subtitle</code> field might be empty, provide a fallback.</p>
<pre><code><h2><?php echo get_acf('page_subtitle', 'This is a default subtitle'); ?></h2>
</code></pre>
</li>
<li>
<p><strong>Escaping HTML:</strong> When outputting a value inside an HTML attribute, always escape it.</p>
<pre><code><?php
$alt_text = get_acf('image_alt_text', 'Default alt text', 'attr');
echo '<img src="..." alt="' . $alt_text . "'>";
</code></pre>
</li>
</ol>
<p>Other escape options: <code>html</code>, <code>url</code>, <code>js</code>, <code>text</code>.</p>
<ol>
<li>
<p><strong>Getting a Value from an Options Page:</strong> To get a field value from an ACF Options Page, pass <code>option</code> as the <code>$post_id</code>.</p>
<pre><code><?php
$footer_copyright = get_acf('footer_copyright_text', '', 'html', 'option');
</code></pre>
</li>
<li>
<p><strong>Getting a Value from a Nested Group Field:</strong> Use dot notation to access fields inside a group.</p>
<pre><code><?php
$phone = get_acf('contact_details.phone_number');
</code></pre>
</li>
<li>
<p><strong>Automatic Sub Field Usage:</strong> 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.</p>
<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>
<p>This function simplifies looping over repeater fields.</p>
<ol>
<li>
<p><strong>Basic Repeater Loop:</strong> To display a list of testimonials from a repeater named <code>testimonials</code> with a sub-field <code>testimonial_text</code>:</p>
<pre><code><?php
repeater('testimonials', function($index) {
    echo '<blockquote>' . get_acf('testimonial_text', '', 'html') . '</blockquote>';
});
</code></pre>
</li>
<li>
<p><strong>Using Before and After Callbacks:</strong> To wrap your repeater output in <code><ul></code> and <code><li></code> tags.</p>
<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>
<p><strong>Passing Arguments to the Callback:</strong> To make your repeater template more reusable, pass in arguments.</p>
<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>
<p>Use this to get data from a repeater field without looping through it manually.</p>
<ol>
<li>
<p><strong>Get All Values from a Sub-Field:</strong></p>
<pre><code><?php
$all_attendees = get_repeater_field('event_attendees', 'attendee_name');
// $all_attendees is now an array: ['John Doe', 'Jane Smith', ...]

echo '<p>Total attendees: ' . count($all_attendees) . '</p>';
</code></pre>
</li>
<li>
<p><strong>Get a Value from a Specific Row:</strong></p>
<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.

Marko Hoven

<p>This plugin is a collection of various utilities, used by My Brain for different websites.<br />
We released this to the WordPress Plugin repository as we think it is also useful to others.</p>
<h4>HTAccess_Keeper</h4>
<p>Checks, backs up and restores your .htaccess and wp-config.php files.<br />
Makes a backup when files are modified and restores when a 0 bytes file has been detected. An e-mail will be sent to the Administration Email Address, whenever a damaged file has been restored.<br />
Originally developed because some plugins keep (re)writing to these two files and sometimes leave them damaged as empty file. That broke the complete website, but /index.php was still being executed, allowing this plugin to restore the damaged file.</p>
<h4>Keep_me_logged_in</h4>
<p>Stay logged in longer. WordPress will keep you logged in for 48 hours. If you’ve clicked the “Remember Me” checkbox at login, you get remembered for 14 days.<br />
This option keeps your login active longer than the standard WordPress Login Cookie time-out. You may need to login again after you change the time-out value.</p>
<h4>Console_Warning</h4>
<p>This plugin adds a warning in the browser console log to any visitor, to only continue if they understand the code and trust the source.<br />
Disable this option at your own risk.</p>
<h4>Clean_Head</h4>
<p>Option to cleanup some default WordPress HEAD entries.<br />
Keeps your HTML a little cleaner; remove the links to the rss-feeds and other lines.</p>
<h4>Openstreetmap/Leaflet Shortcode</h4>
<p>Adds a simple OpenStreetMap/Leaflet Shortcode to be used in your content/contact-page.<br />
Inludes a standard marker and optional information popup.</p>
<h3>Copyright</h3>
<p>Copyright (C) 1999-2025 My Brain</p>
<p>This program is free software: you can redistribute it and/or modify<br />
it under the terms of the GNU General Public License as published by<br />
the Free Software Foundation, either version 3 of the License, or<br />
(at your option) any later version.</p>
<p>This program is distributed in the hope that it will be useful,<br />
but WITHOUT ANY WARRANTY; without even the implied warranty of<br />
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the<br />
GNU General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License<br />
along with this program.  If not, see <a href="http://www.gnu.org/licenses/" rel="nofollow ugc">http://www.gnu.org/licenses/</a>.</p>
<p>MyBrain Utilities uses the following third-party resources:</p>
<p>WordPress plugin boilerplate generator, WPPB by Enrique Chavez<br />
License: GPLv2<br />
Source: <a href="https://wppb.me/" rel="nofollow ugc">https://wppb.me/</a></p>
<p>OpenStreetMap, by the OpenStreetMap Foundation (OSMF)<br />
License: Open Data Commons Open Database License (ODbL)<br />
Source: <a href="https://www.openstreetmap.org" rel="nofollow ugc">https://www.openstreetmap.org</a></p>
<p>Leaflet, created by Volodymyr Agafonkin<br />
License: MIT, BSD 2 clause<br />
Source: <a href="https://leafletjs.com/" rel="nofollow ugc">https://leafletjs.com/</a></p>


MyBrain Utilities

My Brain Wordpress Utilities - Backup of configuration files .htaccess and wp-config, stay logged-in longer & a simple OpenStreetMap Map.

Field Helper Functions For ACF Pro vs MyBrain Utilities