tomekthewo

Adds useful functions for rendering image fields, link fields, repeater fields and flexible content for the Advanced Custom Fields plugin. For <a href="https://bitbucket.org/tomekthewo/advanced-custom-fields-snippets/src/master/" rel="nofollow ugc">detailed info look on Bitbucket</a>.
<h3>Main advantages</h3>
<ul>
<li>write less code (do not repet same blocks of the code when writing down ACF custom fields)</li>
<li>built-in filters</li>
<li>works also for Gutenberg ACF Blocks</li>
<li>no init hooks etc (no impact on performance)</li>
</ul>
Usage
<h4>Link</h4>
Returns the snippet of a specific link field.
<pre><code><?php
 acf_snippet_get_link($selector, [$postId], [$args]);
?>
</code></pre>
Displays the snippet of a specific link field.
<pre><code><?php
 acf_snippet_the_link($selector, [$postId], [$args]);
?>
</code></pre>
Parameters 
 $selector (string) (Required) ACF field name or ACF field key. Based on <a href="https://www.advancedcustomfields.com/resources/get_field/" rel="nofollow ugc">ACF get_field function</a>. 
 $postId (integer|bool) (Optional) The post ID where the value is saved. Use <code>true</code> for getting sub field. Default value: <code>false</code> (current post). 
 $args (array) (Optional) Array of link output arguments. Default value: <code>null</code>. 
    ‘class’ (string) <code>class</code> attribute of the anchor. 
    ‘id’ (string) <code>id</code> attribute of the anchor. 
    ‘title’ (string) <code>title</code> attribute text of the anchor.
<h4>Image</h4>
Returns the snippet of a specific image field.
<pre><code><?php
 acf_snippet_get_image($selector, [$postId], [$args]);
?>
</code></pre>
Displays the snippet of a specific image field.
<pre><code><?php
 acf_snippet_the_image($selector, [$postId], [$args]);
?>
</code></pre>
Parameters 
 $selector (string) (Required) ACF field name or ACF field key. Based on <a href="https://www.advancedcustomfields.com/resources/get_field/" rel="nofollow ugc">ACF get_field function</a>. 
 $postId (integer|bool) (Optional) The post ID where the value is saved. Use <code>true</code> for getting sub field. Default value: <code>false</code> (current post). 
 $args (array) (Optional) Array of image output arguments. Default value: <code>null</code>. 
    ‘size’ (string) Image size to use. Accepts any valid image size. Default value is <code>full</code>. 
    ‘alt’ (string) <code>alt</code> attribute of the image. 
    ‘id’ (string) <code>id</code> attribute of the image. 
    ‘class’ (string) <code>class</code> attribute of the image. 
    ‘title’ (string) <code>title</code> attribute of the image. 
    ‘srcset’ (bool) Use <code>true</code> for retrieving image’s <code>srcset</code> attribute. Default value: <code>false</code>. 
    ‘loading’ (string) <code>loading</code> attribute of the image. Default value: <code>lazy</code>. 
    ‘link’ (bool|array) Array of attributes for anchor wrapped around the image. Default value: <code>false</code>. 
        ‘href’ (string) <code>href</code> attribute of the link. 
        ‘target’ (string) <code>target</code> attribute of the link. 
        ‘class’ (string) <code>class</code> attribute of the link. 
        ‘id’ (string) <code>id</code> attribute of the link. 
        ‘title’ (string) <code>title</code> attribute of the link.
<h4>Repeater</h4>
Displays the snippet of a specific repeater field.
<pre><code><?php
 acf_snippet_the_repeater($selector, [$postId], [$args]);
?>
</code></pre>
Parameters 
 $selector (string) (Required) ACF field name or ACF field key. Based on <a href="https://www.advancedcustomfields.com/resources/get_field/" rel="nofollow ugc">ACF get_field function</a>. 
 $postId (integer|bool) (Optional) The post ID where the value is saved. Default value: <code>false</code> (current post). 
 $args (array) (Optional) Array of repeater output arguments. Default value: <code>null</code>. 
    ‘template’ (string|array) Template for items inside the loop. Arguments of <code>get_template_part</code> function. In the template use standard <code>get_sub_field function</code>. 
    ‘wrap_before’ (string) Text (HTML) before repeater items while have rows. 
    ‘wrap_after’ (string) Text (HTML) after repeater items while have rows 
    ’empty_html’ (string) Text (HTML) in case there are no rows in repeater.
<h4>Flexible content</h4>
Displays the snippet of a specific flexible field.
<pre><code><?php
 acf_snippet_the_flexible_content($selector, [$postId], [$args]);
?>
</code></pre>
Parameters 
 $selector (string) (Required) ACF field name or ACF field key. Based on <a href="https://www.advancedcustomfields.com/resources/get_field/" rel="nofollow ugc">ACF get_field function</a>. 
 $postId (integer|bool) (Optional) The post ID where the value is saved. Default value: <code>false</code> (current post). 
 $args (array) (Optional) Array of flexible content output arguments. Default value: <code>null</code>. 
    ‘templates’ (array) Array of templates for flexible content layouts. In the templates use standard <code>get_sub_field function</code>. 
        key (string) – layout name 
        value (string|array) arguments for <code>get_template_part</code> function.
Requires Advanced Custom Fields (Pro)
<h4>Examples</h4>
Link field
<pre><code><?php
 acf_snippet_the_link('more_info_link', false, [
 'class'=> 'link__out',
 ]
 );
?>
</code></pre>
Image field
<pre><code><?php
 echo acf_snippet_get_image('logo', 'option', [
 'size' => 'medium',
 'alt' => 'company name',
 'title' => false,
 'class' => 'header__logo',
 'id' => 'company-logo',
 'loading' => 'fetch',
 'link' => [
 'href' => get_home_url()
 ]
 ]
 );
?>
</code></pre>
Repeater field
<pre><code><?php
 acf_snippet_the_repeater( 'team_members', false, [
 'template' => [ 'templates/loops/loop', 'team-member' ],
 'wrap_before' => '<ul class="about__team">',
 'wrap_after' => '</ul>',
 'empty_html' => '' . __( 'No team members to show.', 'web' ) . ''
 ]
 );
?>
</code></pre>
Flexible content field
<pre><code><?php
 acf_snippet_the_flexible_content( 'fp_content', false, [
 'templates' => [
 'slider' => [ 'templates/homepage/snippet', 'slider' ],
 'counters' => [ 'templates/homepage/snippet', 'counters' ],
 'text_block' => [ 'templates/homepage/snippet', 'text_block' ]
 ]
 ] 
);
</code></pre>
?> 
`

Advanced Custom Fields: Snippets

Adds useful functions for rendering image fields, link fields, repeater fields and flexible content for the Advanced Custom Fields plugin.

eroux

Display “Badges” in the side-panel which points to a web-site and an image which is then used to build the “badge”.
To access the configuration you have to go to Appearance > Widgets and edit the settings in the Panel.
Using the Widget you can choose whether to:
<ol>
<li>(Optionally) display a Title</li>
<li>Link to a site</li>
<li>Required link to an image to mark that site (any size will work, but the “standard” seems to be 88 pixels wide by 31 pixels high)</li>
<li>Pad the Badge (including centring the text); some people may prefer using their own CSS, so this is an optional configuration.</li>
<li>Enable “Display Badge in a Box” (enabled by default)</li>
<li>Enable the Displaying of a Drop-Shadow</li>
</ol>
If more control is needed, or more badges need to be displayed, the <a href="https://wordpress.org/extend/plugins/badges/" title="Wordpress Plugin" rel="ugc">badges plugin</a> on the WordPress site might be a better fit.

Badge

Display a badge (based the "badges") without requiring file-system access or knowledge of HTML.

Advanced Custom Fields: Snippets vs Badge