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.

Pat O'Brien

Own your snippets! No longer require the use of a cloud service to host your snippets for you when you can host them right on your own WordPress site! codeSnips allows you to quickly add and embed code snippets to your website with syntax highlighting available for 124 languages! codeSnips uses custom post types where you create a new snippet post, select the programming language, enter the code snippet and publish the post. You then can either access the snippet post directly for sharing, or embed it into another post using the shortcode.
View all of your snippets in an archived list, or even on the snippet page itself – without embedding into a new post. You can access all your snippets using a customizable pretty URL permalink. For example: http://yoursite.com/snippets
You can also view the raw plain text snippet directly, which is ideal for copy & pasting.
Features:
<ul>
<li>Quickly add new snippets with syntax highlighting available in 124 programming languages. </li>
<li>Plain text snippets are supported.</li>
<li>Syntax highlighting changes dynamically if you select a new code language from the dropdown while editing.</li>
<li>Embed the snippets using a shortcode that has many options.</li>
<li>You can embed multiple snippets per post.</li>
<li>Access a snippet post directly via URL.</li>
<li>Access a plain text raw view of the snippet directly via URL. Ideal for copying snippets.</li>
<li>Set a description for the snippet post that will display right on the snippet post page.</li>
<li>Change the URL slug for the list of snippets to suit your site.</li>
<li>Work with a particular code language a lot? Select a default snippet code language.</li>
<li>Each snippet also has a filename field that you can use as a reference for that snippet.</li>
<li>Uninstalling the plugin will clean up all data it has stored in the WordPress database.</li>
</ul>
The default list of snippets will display as a post archive list using your theme. You can customize the way this list looks by simply adding a file in your theme called “archive-snippets.php”. Likewise, if you add a theme file called “single-snippets.php” it allows you to customize the way the direct snippet pageis rendered. There are examples located included with the plugin under the “templates” folder.

codeSnips

A very good plugin to maintain a code listing. Well conceive and Jetpack Markdown compatible.



Need some code library ?

I like the approach,
It allows to have more readable post tutorials writing process, by outsourcing the code snippets (than can sometimes can be long) on their own post types.
More, it allows to have archive and shortcode if you want to use it somewhere else.
Pretty nice !



Intersting

Quickly create and embed individual code snippet posts. Access the snippet post directly, view raw, or show all snippets in an archive list.

Advanced Custom Fields: Snippets vs codeSnips