説明
The plugin allows developers/users to display a meta field as a block on the front end, supporting ACF fields. It can be nested inside a parent block that has postId
, postType
context such as Query Block
or stand-alone.
How to use the block with ACF Field Types?
- All basic field types that return strings or can cast to strings are supported – The output is from the
get_field
function. - Link type – The output markup is
<a href={url} target={target} rel="noreferrer noopener">{title}</a>
. There is norel
attribute if thetarget
is not_blank
- Image type – The output markup by the wp_get_attachment_image function. The image size is from the Preview Size setting.
- Page link type, Post object type – The output markup for a single-value field is
<a class="post-link" href={url} rel="bookmark">{title}</a>
, and for a multiple-value field is<ul><li><a class="post-link" href={url} rel="bookmark">{title}</a></li></ul>
. - Relationship type – The output markup is
<ul><li><a class="post-link" href={url} rel="bookmark">{title}</a></li></ul>
- Taxonomy type – The output markup is
<ul><li><a class="term-link" href={term_url}>{term_name}</a></li></ul>
- User type – The output markup for a single-value field is
<a class="user-link" href={author_url}>{display_name}</a>
, and for a multiple-value field is<ul><li><a class="user-link" href={author_url}>{display_name}</a></li></ul>
. - For other complex field types, you can code a custom output markup by the hook
apply_filters( 'meta_field_block_get_acf_field', 'field_value', 'post_id', 'field' )
or by the general hook in the advanced use cases.
Advanced use cases
- How to change the output of the block?
- How to display a complex value like a dynamic field that depends on multiple meta fields?
If this plugin is useful for you, please do a quick review and rate it on WordPress.org to help us spread the word. I would very much appreciate it.
Please check out my other plugins if you’re interested:
- Content Blocks Builder – A tool to create blocks, patterns or variations easily for your site directly on the Block Editor.
- Block Enhancements – A plugin to add more useful features to blocks likes: icons, box-shadow, transform…
- Icon separator – A tiny block just like the core/separator block but with the ability to add an icon to it.
- SVG Block – A block to insert inline SVG images easily and safely. It also bundles with more than 3000 icons and some common non-rectangular dividers.
- Counting Number Block – A block to display a number that has the number-counting effect.
- Breadcrumb Block – A simple breadcrumb trail block that supports JSON-LD structured data.
- Better Youtube Embed Block – Embed Youtube videos without slowing down your site.
The plugin is developed using @wordpress/create-block.
ブロック
このプラグインは1個のブロックを提供します。
- Meta Field Block Display a meta field as a block on frontend, supporting ACF fields.
インストール
- Upload the plugin files to the
/wp-content/plugins/meta-field-block
directory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress
FAQ
-
Who needs this plugin?
-
This plugin is created for developers, but end users can also use it.
-
Does it support inputting and saving meta value?
-
No, It does not. It only displays meta fields as blocks.
-
Does it support all types of meta fields?
-
Only simple types such as string, integer, or number can be used directly. Other complex types such as object, array need to be converted to HTML markup strings.
-
Does it support all types of ACF fields?
-
It supports all basic field types that return strings or cast to strings. Some complex field types like image, link, page_link, post_object, relationship, taxonomy, and user are also supported in a basic format.
-
What are the prefix and suffix for?
-
The value for those settings should be plain text or some allowed HTML elements. Their values will be formatted with
wp_kses( $prefix, wp_kses_allowed_html( "post" ) )
. They’re helpful for some use cases like displaying the name of the meta field or a value with a prefix or suffix, e.g. $100, 100px, etc. -
Does it include some style for the meta field?
-
The block does not provide any CSS style for the meta field value. But it does provide a basic display inline style from the settings.
-
Does it support other meta-field frameworks?
-
Yes, it does as long as those meta fields can be accessed value via REST API.
評価
貢献者と開発者
変更履歴
1.1.1
Release Date – 14 Mar 2023
- DEV – Add a hideEmpty setting to hide the whole block if the value is empty
- DEV – Add an emptyMessage setting to show a custom text in case the value is empty
- FIX – The meta field did not show on the archive template
1.1.0
Release Date – 06 Mar 2023
- DEV – Refactor all the source code for more upcoming features
- DEV – Make sure the block works with all return formats for the image field, link field
- DEV – Get all custom rest fields to show on the suggested help
- DEV – Allow changing the tagName from the block toolbar
- DEV – Improve performance
- DEV – Add more core support features
- DEV – Add more meaningful messages for some use cases
- FIX – Allow displaying links without text
1.0.10
Release Date – 02 Feb 2023
- DEV – Support multiple values for ACF User type
1.0.9
Release Date – 15 Sep 2022
- FIX – Change the textdomain to the plugin slug
1.0.8
Release Date – 10 Sep 2022
- FIX – Wrong handle for wp_set_script_translations. Thanks to Loïc Antignac (@webaxones)
1.0.7
Release Date – 07 Sep 2022
- FIX – Add a null check for meta fields value before accessing it’s property
1.0.6
Release Date – 25 Jun 2022
- DEV – Add an option to show the block’s outline on the Editor
1.0.5
Release Date – 21 Jun 2022
- DEV – Display the placeholder text on the template context
1.0.4
Release Date – 02 May 2022
- DEV – Support displaying some field types for ACF such as image, link, page_link, post_object, relationship, taxonomy
1.0.3
Release Date – 30 April 2022
- DEV – Add supports for borders, and full typography options
1.0.2
Release Date – 28 April 2022
- DEV – Add the title to block registration in JS
- REFACTOR source code
1.0.1
Release Date – 23 March 2022
- FIX – The block does not work in the site editor.
1.0.0
Release Date – 22 February 2022