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.

<a href="https://www.mxp.tw/" rel="nofollow ugc">Chun</a> 的 WordPress 開發實用外掛整理。
特色功能(Features):
<ul>
<li>作者開發常用外掛列表。</li>
<li>Themeforest 網站外掛主題下載安裝工具（需自行輸入授權碼）。</li>
<li>批次修改內容類型（Post Type）作者的工具。</li>
<li>快速搜尋與安裝外掛的工具。</li>
<li>外掛打包下載的工具</li>
<li>主題打包下載的工具。</li>
<li>查看 <code>wp-config.php</code> 與網站主機檔案相關設定工具。</li>
<li>資料庫打包匯出工具。</li>
<li>網站 <code>wp-content</code> 目錄打包下載工具。</li>
<li>資料庫關鍵字搜尋與取代工具。</li>
<li>資料庫最佳化設定的工具。</li>
</ul>
需求(Requirements):
<blockquote>
需使用最高管理員身分使用。
</blockquote>

一介資男(Mxp.TW) 開發工具箱

頭香

此外掛為 Chun (Mxp.TW) 開發常用外掛整理之批次安裝工具

Advanced Custom Fields: Snippets vs 一介資男(Mxp.TW) 開發工具箱