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.

Jeff Starr

Display Beautiful Code
Display beautiful code snippets with Prism.js, Highlight.js, or plain code escaping:
<ul>
<li>Prism.js – Code escape + syntax highlight using <a href="https://prismjs.com/" rel="nofollow ugc">Prism.js</a></li>
<li>Highlight.js – Code escape + syntax highlight using <a href="https://highlightjs.org/" rel="nofollow ugc">Highlight.js</a></li>
<li>Plain Flavor – Code escape without syntax highlighting</li>
</ul>
<blockquote>
👉 The only 3-in-1 syntax highlighter!
</blockquote>
Live Examples
Here are some live examples showing Prismatic displaying colorful code snippets:
<ul>
<li><a href="https://plugin-planet.com/usp-pro-support-additional-file-types/" rel="nofollow ugc">PHP highlighting</a></li>
<li><a href="https://perishablepress.com/all-css-filter-functions/" rel="nofollow ugc">CSS highlighting</a></li>
<li><a href="https://perishablepress.com/vanilla-javascript-add-class-to-image-links/" rel="nofollow ugc">JavaScript highlighting</a></li>
<li><a href="https://wp-mix.com/html5-starter-template/" rel="nofollow ugc">HTML highlighting</a></li>
<li><a href="https://digwp.com/2019/07/better-inline-script/" rel="nofollow ugc">Escaped code without highlighting</a></li>
</ul>
Prismatic is used to display thousands of code snippets on the above sites. Also here is a post showing some <a href="https://dev-tricks.com/favorite-highlight-js-styles/" rel="nofollow ugc">favorite Highlight.js styles</a> 🙂
Prism.js Features
<ul>
<li>Supports 60+ coding languages</li>
<li>Choose from all 8 available Prism themes</li>
<li>Provides a Gutenberg block for adding code snippets</li>
<li>Provides TinyMCE/Visual buttons for adding code snippets</li>
<li>Option to enable Prism plugin <a href="https://prismjs.com/plugins/line-numbers/" rel="nofollow ugc">Line Numbers</a></li>
<li>Option to enable Prism plugin <a href="https://prismjs.com/plugins/line-highlight/" rel="nofollow ugc">Line Highlight</a></li>
<li>Option to enable Prism plugin <a href="https://prismjs.com/plugins/show-language/" rel="nofollow ugc">Show Language</a></li>
<li>Option to enable Prism plugin <a href="https://prismjs.com/plugins/copy-to-clipboard/" rel="nofollow ugc">Copy Code Button</a></li>
<li>Option to enable Prism plugin <a href="https://prismjs.com/plugins/command-line/" rel="nofollow ugc">Command Line</a></li>
<li>Highlights code in post content, excerpts, and comments</li>
<li>Detects <code>language-</code> and <code>lang-</code> class prefixes</li>
<li>Limit syntax highlighting to Posts and Pages</li>
<li>Highlight single-line and multi-line code</li>
<li>Granular control over code escaping</li>
<li>Smart loading of CSS & JS assets</li>
<li>Support for ACF on single post views</li>
</ul>
Highlight.js Features
<ul>
<li>Supports 50+ coding languages</li>
<li>Choose from all 90+ available Highlight themes</li>
<li>Provides a Gutenberg block for adding code snippets</li>
<li>Provides TinyMCE/Visual buttons for adding code snippets</li>
<li>Customize the Highlight.js init JavaScript</li>
<li>Highlights code in post content, excerpts, and comments</li>
<li>Limit syntax highlighting to Posts and Pages</li>
<li>Highlight multi-line blocks of code</li>
<li>Detects <code>language-</code> and <code>lang-</code> class prefixes</li>
<li>Enable support for no-prefix class names</li>
<li>Granular control over code escaping</li>
<li>Smart loading of CSS & JS assets</li>
</ul>
Plain Flavor Features
<ul>
<li>Enable code escaping for post content, excerpts, and/or comments</li>
<li>Enable code escaping on the frontend, Admin Area, or both</li>
<li>Provides a Gutenberg block for adding code snippets</li>
<li>Provides TinyMCE/Visual buttons for adding code snippets</li>
<li>Escapes single-line and multi-line code snippets</li>
<li>Escapes <code><code></code> tags (based on configuration)</li>
</ul>
General Features
<ul>
<li>Easy to set up and use</li>
<li>Built with WordPress APIs</li>
<li>Born of simplicity, no frills</li>
<li>Squeaky clean, error-free code</li>
<li>Lightweight, fast and flexible</li>
<li>Focused on performance and security</li>
<li>Loads CSS/JS assets only when required</li>
<li>Adheres to HTML coding best practices</li>
<li>Works with the Gutenberg Block Editor</li>
<li>Regularly updated and “future proof”</li>
</ul>
<blockquote>
👉 Prismatic escapes only the essentials to keep your code clean.
👉 <a href="https://wordpress.org/plugins/prismatic/#screenshots" rel="ugc">Check out the screenshots</a> for more details!
</blockquote>
Privacy
This plugin does not collect or store any user data. It does not set any cookies, and it does not connect to any third-party locations. Thus, this plugin does not affect user privacy in any way.
Prismatic is developed and maintained by <a href="https://x.com/perishable" rel="nofollow ugc">Jeff Starr</a>, 15-year <a href="https://plugin-planet.com/" rel="nofollow ugc">WordPress developer</a> and <a href="https://books.perishablepress.com/" rel="nofollow ugc">book author</a>.
Support development
I develop and maintain this free plugin with love for the WordPress community. To show support, you can <a href="https://monzillamedia.com/donate.html" rel="nofollow ugc">make a donation</a> or purchase one of my books:
<ul>
<li><a href="https://wp-tao.com/" rel="nofollow ugc">The Tao of WordPress</a></li>
<li><a href="https://digwp.com/" rel="nofollow ugc">Digging into WordPress</a></li>
<li><a href="https://htaccessbook.com/" rel="nofollow ugc">.htaccess made easy</a></li>
<li><a href="https://wp-tao.com/wordpress-themes-book/" rel="nofollow ugc">WordPress Themes In Depth</a></li>
<li><a href="https://books.perishablepress.com/downloads/wizards-collection-sql-recipes-wordpress/" rel="nofollow ugc">Wizard’s SQL Recipes for WordPress</a></li>
</ul>
And/or purchase one of my premium WordPress plugins:
<ul>
<li><a href="https://plugin-planet.com/bbq-pro/" rel="nofollow ugc">BBQ Pro</a> – Blazing fast WordPress firewall</li>
<li><a href="https://plugin-planet.com/blackhole-pro/" rel="nofollow ugc">Blackhole Pro</a> – Automatically block bad bots</li>
<li><a href="https://plugin-planet.com/banhammer-pro/" rel="nofollow ugc">Banhammer Pro</a> – Monitor traffic and ban the bad guys</li>
<li><a href="https://plugin-planet.com/ga-google-analytics-pro/" rel="nofollow ugc">GA Google Analytics Pro</a> – Connect WordPress to Google Analytics</li>
<li><a href="https://plugin-planet.com/head-meta-pro/" rel="nofollow ugc">Head Meta Pro</a> – Ultimate Meta Tags for WordPress</li>
<li><a href="https://plugin-planet.com/simple-ajax-chat-pro/" rel="nofollow ugc">Simple Ajax Chat Pro</a> – Unlimited chat rooms</li>
<li><a href="https://plugin-planet.com/usp-pro/" rel="nofollow ugc">USP Pro</a> – Unlimited front-end forms</li>
</ul>
Links, tweets and likes also appreciated. Thank you! 🙂

Prismatic

Prismatic is good plugins for show code in my content,
but Line Numbers + Line Highlight Not Working in my site.



Line Numbers + Line Highlight Not Working


Thank you for contributing this plugin. I went looking for a good option when I noticed the previous one I was using was not working well in Gutenberg. I have been using Prismatic for the last three years without issue.


Works Well No Issues

Display beautiful syntax-highlighted code snippets with Prism.js or Highlight.js

Advanced Custom Fields: Snippets vs Prismatic