Important fix for code fields. HTML\/JavaScript\/CSS code is now properly preserved using base64 encoding. Re-save any code fields that previously had content stripped.<\/p>","1.2.5":"
Bug fix for code field sanitization. Code fields now preserve raw content correctly without premature HTML entity encoding.<\/p>","1.2.4":"
Asset folder reorganization for better WordPress.org compliance. All functionality remains unchanged.<\/p>","1.2.3":"
Bug fix for dynamic block fields. Taxonomy, post type, and data object fields now render correctly when adding blocks dynamically.<\/p>","1.2.2":"
Important security update with nonce verification fixes. Updated to PHP 8.1+ requirement with Symfony 6.4 compatibility.<\/p>","1.2.1":"
Fixes for export\/import functionality and template global field handling. Recommended update for better data portability.<\/p>","1.2.0":"
Major feature update introducing Template Global Fields for shared default values across posts using the same template.<\/p>","1.1.0":"
Code quality improvements, consolidated Export\/Import page, and enhanced security. All functionality remains backwards compatible.<\/p>","1.0.0":"
Initial release of YAML Custom Fields.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3430736,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.2.3","1.2.4","1.2.5","1.2.6","1.2.7"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Main YAML Custom Fields admin page showing page templates and template partials with enable\/disable toggles","2":"Schema editor for main page templates with YAML syntax for defining custom fields","3":"Schema editor for partial templates (headers, footers, etc.)","4":"Partial data editor for managing global content in template partials","5":"Data Validation page for reviewing imported content","6":"Data Objects page for managing structured, reusable data types","7":"Export\/Import page with consolidated export\/import functionality for settings, page data, and data objects","8":"Documentation page with comprehensive guides and examples"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2010,253139,9051,1117,31642],"plugin_category":[55],"plugin_contributors":[253140],"plugin_business_model":[],"class_list":["post-259154","plugin","type-plugin","status-publish","hentry","plugin_tags-custom-fields","plugin_tags-frontmatter","plugin_tags-meta-fields","plugin_tags-schema","plugin_tags-yaml","plugin_category-seo-and-marketing","plugin_contributors-starbist","plugin_committers-starbist"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/yaml-custom-fields\/assets\/icon-256x256.png?rev=3430736","icon_2x":"https:\/\/ps.w.org\/yaml-custom-fields\/assets\/icon-256x256.png?rev=3430736","generated":false},"screenshots":[],"raw_content":"\n
YAML Custom Fields allows you to define structured content schemas with an intuitive interface and ACF-like template functions. Perfect for theme developers who want flexible, schema-based content management without the complexity.<\/p>\n\n
In your theme template:<\/p>\n\n
<?php\n$hero_title = ycf_get_field('hero_title');\n$hero_image = ycf_get_image('hero_image', null, 'full');\n$category = ycf_get_term('category');\n$post_type = ycf_get_post_type('content_type');\n$university = ycf_get_data_object('university');\n$features = ycf_get_field('features');\n?>\n\n<div class=\"hero\">\n <?php if ($hero_image): ?>\n <img src=\"<?php echo esc_url($hero_image['url']); ?>\" alt=\"<?php echo esc_attr($hero_image['alt']); ?>\">\n <?php endif; ?>\n <h1><?php echo esc_html($hero_title); ?><\/h1>\n <?php if ($category): ?>\n <span class=\"category\"><?php echo esc_html($category->name); ?><\/span>\n <?php endif; ?>\n <?php if ($university): ?>\n <p><?php echo esc_html($university['name']); ?><\/p>\n <?php endif; ?>\n<\/div>\n<\/code><\/pre>\n\nDeveloper Documentation<\/h3>\n\nTemplate Functions<\/h4>\n\n
Get a single field value:<\/strong><\/p>\n\n$value = ycf_get_field('field_name');\n$value = ycf_get_field('field_name', 123); \/\/ Specific post ID\n$value = ycf_get_field('logo', 'partial:header.php'); \/\/ From partial\n$value = ycf_get_field('title', null, $block); \/\/ From block context\n<\/code><\/pre>\n\nGet image field with details:<\/strong><\/p>\n\n$image = ycf_get_image('field_name', null, 'full');\n$image = ycf_get_image('field_name', 123, 'thumbnail'); \/\/ Specific post ID\n$image = ycf_get_image('icon', null, 'medium', $block); \/\/ From block context\n\n\/\/ Returns: array('id', 'url', 'alt', 'title', 'caption', 'description', 'width', 'height')\n<\/code><\/pre>\n\nGet file field with details:<\/strong><\/p>\n\n$file = ycf_get_file('field_name', null);\n$file = ycf_get_file('field_name', 123); \/\/ Specific post ID\n$file = ycf_get_file('document', null, $block); \/\/ From block context\n\n\/\/ Returns: array('id', 'url', 'path', 'filename', 'filesize', 'mime_type', 'title')\n<\/code><\/pre>\n\nGet taxonomy field (term or terms):<\/strong><\/p>\n\n$term = ycf_get_term('field_name', null);\n$term = ycf_get_term('field_name', 123); \/\/ Specific post ID\n$term = ycf_get_term('category', null, $block); \/\/ From block context\n\n\/\/ Returns: WP_Term object or array of WP_Term objects (for multiple selection)\n<\/code><\/pre>\n\nGet post type field:<\/strong><\/p>\n\n$post_type = ycf_get_post_type('field_name', null);\n$post_type = ycf_get_post_type('field_name', 123); \/\/ Specific post ID\n$post_type = ycf_get_post_type('content_type', null, $block); \/\/ From block context\n\n\/\/ Returns: WP_Post_Type object or null\n<\/code><\/pre>\n\nGet data object field:<\/strong><\/p>\n\n$university = ycf_get_data_object('field_name', null);\n$university = ycf_get_data_object('field_name', 123); \/\/ Specific post ID\n$university = ycf_get_data_object('university', null, $block); \/\/ From block context\n\n\/\/ Returns: Array with data object entry fields or null\n<\/code><\/pre>\n\nGet all entries of a data object type:<\/strong><\/p>\n\n$all_universities = ycf_get_data_objects('universities');\nforeach ($all_universities as $entry_id => $university) {\n echo esc_html($university['name']);\n}\n\n\/\/ Returns: Array of all entries for the specified data object type\n<\/code><\/pre>\n\nGet all fields:<\/strong><\/p>\n\n$fields = ycf_get_fields();\n$fields = ycf_get_fields(123); \/\/ Specific post ID\n$fields = ycf_get_fields('partial:footer.php'); \/\/ From partial\n<\/code><\/pre>\n\nCheck if field exists:<\/strong><\/p>\n\nif (ycf_has_field('hero_title')) {\n echo ycf_get_field('hero_title');\n}\n<\/code><\/pre>\n\nWorking with Block fields:<\/strong><\/p>\n\n$blocks = ycf_get_field('features');\n\nif (!empty($blocks)) {\n foreach ($blocks as $block) {\n \/\/ Access nested fields using context_data parameter\n $title = ycf_get_field('title', null, $block);\n $icon = ycf_get_image('icon', null, 'thumbnail', $block);\n $category = ycf_get_term('category', null, $block);\n\n echo '<h3>' . esc_html($title) . '<\/h3>';\n if ($icon) {\n echo '<img src=\"' . esc_url($icon['url']) . '\">';\n }\n if ($category) {\n echo '<span>' . esc_html($category->name) . '<\/span>';\n }\n }\n}\n<\/code><\/pre>\n\nSample YAML Schema<\/h4>\n\nfields:\n - name: hero_title\n label: Hero Title\n type: string\n required: true\n options:\n maxlength: 100\n - name: hero_image\n label: Hero Image\n type: image\n - name: category\n label: Category\n type: taxonomy\n options:\n taxonomy: category\n - name: tags\n label: Tags\n type: taxonomy\n multiple: true\n options:\n taxonomy: post_tag\n - name: content_type\n label: Content Type\n type: post_type\n - name: university\n label: University\n type: data_object\n options:\n object_type: universities\n - name: features\n label: Features\n type: block\n list: true\n blockKey: type\n blocks:\n - name: feature\n label: Feature Block\n fields:\n - name: title\n label: Title\n type: string\n - name: icon\n label: Icon\n type: image\n - name: description\n label: Description\n type: text\n<\/code><\/pre>\n\nWorking with Partials<\/h4>\n\n
For custom partials, add the @ycf marker in the file header:<\/p>\n\n
<?php\n\/**\n * Custom Navigation Partial\n * @ycf\n *\/\n<\/code><\/pre>\n\nThen click \"Refresh Template List\" in the YAML Custom Fields admin page.<\/p>\n\n
Template Global Fields<\/h4>\n\n
Template Global Fields allow you to define default values that are shared across all posts using the same template, while still allowing individual posts to override specific fields.<\/p>\n\n
Setting up Template Global:<\/strong><\/p>\n\n\n- Go to YAML Custom Fields<\/strong> admin page<\/li>\n
- Enable YAML for your template (e.g., page.php)<\/li>\n
- Click Add Template Global<\/strong> to define the template global schema<\/li>\n
- Define fields that should have shared default values<\/li>\n
- Click Manage Template Global Data<\/strong> to set the default values<\/li>\n<\/ol>\n\n
Using Template Global in Posts:<\/strong><\/p>\n\nWhen editing a post that uses a template with Template Global fields, you'll see a dual-field interface for each field:<\/p>\n\n
\n- Template Global (All Pages)<\/strong> - Read-only display showing the default value (with Edit link)<\/li>\n
- Page-Specific Value<\/strong> - Editable field for this post only<\/li>\n
- Checkbox<\/strong> - \"Use template global for this field\" - Toggle per field<\/li>\n<\/ul>\n\n
Benefits:<\/strong><\/p>\n\n\n- Consistency:<\/strong> Set default values once, use across all posts<\/li>\n
- Flexibility:<\/strong> Override any field on any post individually<\/li>\n
- Clarity:<\/strong> See both global and local values side-by-side<\/li>\n
- Efficiency:<\/strong> Update template global to affect all posts at once<\/li>\n<\/ul>\n\n
Data Priority (when using template functions):<\/strong><\/p>\n\nWhen a field uses template global, ycf_get_field()<\/code> returns data in this priority order:<\/p>\n\n\n- Page-specific value (if \"use template global\" is unchecked)<\/li>\n
- Template global value (if \"use template global\" is checked)<\/li>\n
- Site-wide global value (if template has site-wide global enabled)<\/li>\n
- null (if no value exists)<\/li>\n<\/ol>\n\n
Data Storage<\/h4>\n\n\n- Page\/Post data:<\/strong> Stored in post meta with key
_yaml_cf_data<\/code><\/li>\n- Template Global preferences:<\/strong> Stored in post meta with key
_yaml_cf_use_template_global_fields<\/code> (per-field array)<\/li>\n- Template Global schemas:<\/strong> Stored in options table with key
yaml_cf_template_global_schemas<\/code><\/li>\n- Template Global data:<\/strong> Stored in options table with key
yaml_cf_template_global_data<\/code><\/li>\n- Site-wide global schema:<\/strong> Stored in options table with key
yaml_cf_global_schema<\/code><\/li>\n- Site-wide global data:<\/strong> Stored in options table with key
yaml_cf_global_data<\/code><\/li>\n- Partial data:<\/strong> Stored in options table with key
yaml_cf_partial_data<\/code><\/li>\n- Schemas:<\/strong> Stored in options table with key
yaml_cf_schemas<\/code><\/li>\n- Data Object Types:<\/strong> Stored in options table with key
yaml_cf_data_object_types<\/code><\/li>\n- Data Object Entries:<\/strong> Stored in options table with keys
yaml_cf_data_object_entries_{type_slug}<\/code><\/li>\n<\/ul>\n\nPrivacy Policy<\/h3>\n\n
YAML Custom Fields does not collect, store, or transmit any user data outside of your WordPress installation. All data is stored locally in your WordPress database.<\/p>\n\n
Third-Party Libraries<\/h3>\n\n
This plugin includes the following third-party libraries:<\/p>\n\n
\n- Symfony YAML Component<\/strong> (v6.4) - Licensed under MIT License (GPL-compatible)\n\n
\n- Homepage: https:\/\/symfony.com\/components\/Yaml<\/li>\n
- License: https:\/\/github.com\/symfony\/yaml\/blob\/7.3\/LICENSE<\/li>\n<\/ul><\/li>\n<\/ul>\n\n
Credits<\/h3>\n\n\n- Author: Silvestar Bistrovic<\/a><\/li>\n<\/ul>\n\n
Support<\/h3>\n\n
For documentation, examples, and support, visit:\n* Plugin Documentation<\/a>\n* Report Issues<\/a><\/p>\n\n\nFrom WordPress Plugin Directory<\/h4>\n\n\n- Log in to your WordPress admin dashboard<\/li>\n
- Navigate to Plugins \u2192 Add New<\/strong><\/li>\n
- Search for \"YAML Custom Fields\"<\/li>\n
- Click Install Now<\/strong> next to the YAML Custom Fields plugin<\/li>\n
- Click Activate<\/strong> after installation completes<\/li>\n
- Go to YAML Custom Fields<\/strong> in the admin menu to configure your schemas<\/li>\n<\/ol>\n\n
Manual Installation<\/h4>\n\n\n- Download the plugin ZIP file<\/li>\n
- Log in to your WordPress admin dashboard<\/li>\n
- Navigate to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong><\/li>\n
- Choose the ZIP file and click Install Now<\/strong><\/li>\n
- Click Activate<\/strong> after installation completes<\/li>\n
- Go to YAML Custom Fields<\/strong> in the admin menu to configure your schemas<\/li>\n<\/ol>\n\n
Requirements<\/h4>\n\n\n- WordPress 5.0 or higher<\/li>\n
- PHP 8.1 or higher<\/li>\n
- The plugin includes all necessary dependencies<\/li>\n<\/ul>\n\n\n
\nWhat is YAML frontmatter?<\/h3><\/dt>\nYAML frontmatter is a structured way to define metadata for content. It's commonly used in static site generators and headless CMS systems. YAML Custom Fields brings this approach to WordPress themes.<\/p><\/dd>\n
How is this different from ACF?<\/h3><\/dt>\nWhile ACF is a comprehensive custom fields solution, YAML Custom Fields focuses on YAML-based schemas that are portable and version-controllable. It's ideal for developers who prefer code-first approaches and want simpler, more predictable data structures.<\/p><\/dd>\n
Can I use this with my existing theme?<\/h3><\/dt>\nYes! YAML Custom Fields works with any WordPress theme. You define schemas for your templates and use simple PHP functions to retrieve the data in your template files.<\/p><\/dd>\n
Does this work with Gutenberg?<\/h3><\/dt>\nYes, YAML Custom Fields is compatible with both the Classic and Block (Gutenberg) editors. The custom fields appear below the editor regardless of which editor you're using.<\/p><\/dd>\n
What happens to my data if I deactivate the plugin?<\/h3><\/dt>\nYour data remains in the database. Only when you delete<\/strong> the plugin (not just deactivate) will it clean up all settings, schemas, and custom field data.<\/p><\/dd>\nCan I use this for WooCommerce products?<\/h3><\/dt>\nCurrently, YAML Custom Fields supports pages and posts only. Support for custom post types including WooCommerce products may be added in future versions.<\/p><\/dd>\n
How do I report bugs or request features?<\/h3><\/dt>\n