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.

interconnectit

Spectacula

cm2creative

Here at interconnect/it we have a policy of developing client sites with the premise of “content manage everything!” That means the little notices on sites, minor widgets and so on should not only be content managed, but they should be easy for both an end-user and a developer to work with.
To that end, we developed Spots. This creates a custom post type that allows you to create widgets using a visual editor, whilst also giving developers an easy hook for the creation of content managable elements within a theme.
The plugin now uses caching in order to help ensure that the load on a typical site is kept to a minimum. Performance is important!
The plugin is prepared for translation, if you’d like to drop us a line about your translation you can contact us through our <a href="http://interconnectit.com/about/contact/" rel="nofollow ugc">website</a>.
<h3>Developer Notes</h3>
Spots provides 2 template tags for developers to use shown below with their supported arguments.
<pre><code>icit_spot( $id_or_name, $template );
</code></pre>
<ul>
<li><code>$id_or_name</code>: Required. A numeric ID or the name of a spot as a string.</li>
<li><code>$template</code>: Optional. A string used in a call to <code>get_template_part()</code></li>
</ul>
This template tag always echos out the spot.
<pre><code>icit_get_spot( $id_or_name, $template, $echo );
</code></pre>
Same as the above with an extra argument:
<ul>
<li><code>$echo</code>: Optional. Defaults to false. A boolean to indicate whether to echo the spot content or just return it.</li>
</ul>
<h4>Basic Usage</h4>
You can use spots to replace boilerplate text in your themes. If you have areas in your themes where typically you would hard code the text you could use the following code:
<pre><code><?php
if ( function_exists( 'icit_spot' ) )
 icit_spot( 'Copyright' );
?>
</code></pre>
The above code would output the contents of a spot titled ‘Copyright’. If the spot does not exist it will be created as a draft. Spots in draft mode are only visible to logged in users with editing capabilities.
<h4>Templates</h4>
The plugin will initially look for a file in your theme using the <code>get_template_part()</code> function. If you have a file called <code>spot.php</code> in your theme that will be the default template for all spots. The <code>icit_spot()</code> function can take a second parameter for the template part to use for example:
<pre><code><?php
if ( function_exists( 'icit_spot' ) )
 icit_spot( 'Copyright', 'copyright' );
?>
</code></pre>
The above code will make the plugin look in your theme folder for a file called <code>spot-copyright.php</code> to use for the output. If not available it will fall back to <code>spot.php</code> and if that is not available it will simply output the spot contents.
Use templates when you want to display a featured image from a spot or if you require some additional/alternative markup for the spot. Spots are just like posts, so in the templates you retrieve the contents of the spot using <code>the_content()</code> just as would in the loop.
Basic spot template example:
<pre><code><div class="spot">
 <?php the_content(); ?>
</div>
</code></pre>
Spot template with featured image:
<pre><code><div class="spot-with-image">
 <?php
 if ( has_post_thumbnail() )
 the_post_thumbnail( 'medium' );
 the_content(); ?>
</div>
</code></pre>
<h4>Additional</h4>
There are many filters and hooks available to get even more out of spots so drop by the plugin homepage or use the forums if there is something you need to do with spots but aren’t sure how.

Spots

Default install on every site

Content manage those little snippets of text that you need across your WordPress site and in widgets properly. Forget the text widget.

Advanced Custom Fields: Snippets vs Spots