EdwardBock

Palasthotel GmbH

greatestview

Benjamin Birkenhake

<p>Let’s you add more than one author to your posts.</p>
<h3>Arbitrary section</h3>


Additional Authors

Let's you add more than one author to your posts.

starbist

<p>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>
<h4>Features</h4>
<ul>
<li>Define YAML schemas for page templates and template partials</li>
<li>15+ field types including string, rich-text, images, blocks, taxonomies, data objects, and more</li>
<li>Easy-to-use admin interface for managing schemas and data</li>
<li><strong>Three-level data hierarchy:</strong>
<ul>
<li>Per-page data for individual customization (stored in post meta)</li>
<li>Per-template global data shared across all posts using the same template</li>
<li>Site-wide global data for partials like headers and footers</li>
</ul>
</li>
<li><strong>Per-field global/local toggle:</strong> Each field can independently use template global data or page-specific data</li>
<li><strong>Visual dual-field interface:</strong> See both template global and page-specific values side-by-side</li>
<li>Data Objects for managing structured, reusable data (universities, companies, etc.)</li>
<li>Data Validation page for reviewing imported content</li>
<li>Consolidated Export/Import page for all data types (settings, page data, data objects)</li>
<li>Simple template functions with ACF-like syntax and auto-merge behavior</li>
<li>Administrator-only access for security</li>
<li>Clean uninstall removes all database records</li>
<li>WordPress Coding Standards compliant</li>
</ul>
<h4>Supported Field Types</h4>
<ul>
<li><strong>String</strong> – Single-line text with min/max length</li>
<li><strong>Text</strong> – Multi-line textarea</li>
<li><strong>Rich Text</strong> – WordPress WYSIWYG editor</li>
<li><strong>Code</strong> – Code editor with syntax highlighting</li>
<li><strong>Boolean</strong> – Checkbox for true/false values</li>
<li><strong>Number</strong> – Number input with min/max constraints</li>
<li><strong>Date</strong> – Date picker with optional time</li>
<li><strong>Select</strong> – Dropdown with single/multiple selection</li>
<li><strong>Taxonomy</strong> – WordPress categories, tags, or custom taxonomies with single/multiple selection</li>
<li><strong>Post Type</strong> – Dropdown to select registered post types (Post, Page, custom post types)</li>
<li><strong>Data Object</strong> – Reference to structured data objects managed independently (universities, companies, team members, etc.)</li>
<li><strong>Image</strong> – WordPress media uploader for images</li>
<li><strong>File</strong> – WordPress media uploader for any file</li>
<li><strong>Object</strong> – Nested group of fields</li>
<li><strong>Block</strong> – Repeatable blocks for flexible page builders</li>
</ul>
<h4>Usage Example</h4>
<p>In your theme template:</p>
<pre><code><?php
$hero_title = ycf_get_field('hero_title');
$hero_image = ycf_get_image('hero_image', null, 'full');
$category = ycf_get_term('category');
$post_type = ycf_get_post_type('content_type');
$university = ycf_get_data_object('university');
$features = ycf_get_field('features');
?>

<div class="hero">
  <?php if ($hero_image): ?>
    <img src="<?php echo esc_url($hero_image['url']); ?>" alt="<?php echo esc_attr($hero_image['alt']); ?>">
  <?php endif; ?>
  <h1><?php echo esc_html($hero_title); ?></h1>
  <?php if ($category): ?>
    <span class="category"><?php echo esc_html($category->name); ?></span>
  <?php endif; ?>
  <?php if ($university): ?>
    <p><?php echo esc_html($university['name']); ?></p>
  <?php endif; ?>
</div>
</code></pre>
<h3>Developer Documentation</h3>
<h4>Template Functions</h4>
<p><strong>Get a single field value:</strong></p>
<pre><code>$value = ycf_get_field('field_name');
$value = ycf_get_field('field_name', 123); // Specific post ID
$value = ycf_get_field('logo', 'partial:header.php'); // From partial
$value = ycf_get_field('title', null, $block); // From block context
</code></pre>
<p><strong>Get image field with details:</strong></p>
<pre><code>$image = ycf_get_image('field_name', null, 'full');
$image = ycf_get_image('field_name', 123, 'thumbnail'); // Specific post ID
$image = ycf_get_image('icon', null, 'medium', $block); // From block context

// Returns: array('id', 'url', 'alt', 'title', 'caption', 'description', 'width', 'height')
</code></pre>
<p><strong>Get file field with details:</strong></p>
<pre><code>$file = ycf_get_file('field_name', null);
$file = ycf_get_file('field_name', 123); // Specific post ID
$file = ycf_get_file('document', null, $block); // From block context

// Returns: array('id', 'url', 'path', 'filename', 'filesize', 'mime_type', 'title')
</code></pre>
<p><strong>Get taxonomy field (term or terms):</strong></p>
<pre><code>$term = ycf_get_term('field_name', null);
$term = ycf_get_term('field_name', 123); // Specific post ID
$term = ycf_get_term('category', null, $block); // From block context

// Returns: WP_Term object or array of WP_Term objects (for multiple selection)
</code></pre>
<p><strong>Get post type field:</strong></p>
<pre><code>$post_type = ycf_get_post_type('field_name', null);
$post_type = ycf_get_post_type('field_name', 123); // Specific post ID
$post_type = ycf_get_post_type('content_type', null, $block); // From block context

// Returns: WP_Post_Type object or null
</code></pre>
<p><strong>Get data object field:</strong></p>
<pre><code>$university = ycf_get_data_object('field_name', null);
$university = ycf_get_data_object('field_name', 123); // Specific post ID
$university = ycf_get_data_object('university', null, $block); // From block context

// Returns: Array with data object entry fields or null
</code></pre>
<p><strong>Get all entries of a data object type:</strong></p>
<pre><code>$all_universities = ycf_get_data_objects('universities');
foreach ($all_universities as $entry_id => $university) {
    echo esc_html($university['name']);
}

// Returns: Array of all entries for the specified data object type
</code></pre>
<p><strong>Get all fields:</strong></p>
<pre><code>$fields = ycf_get_fields();
$fields = ycf_get_fields(123); // Specific post ID
$fields = ycf_get_fields('partial:footer.php'); // From partial
</code></pre>
<p><strong>Check if field exists:</strong></p>
<pre><code>if (ycf_has_field('hero_title')) {
    echo ycf_get_field('hero_title');
}
</code></pre>
<p><strong>Working with Block fields:</strong></p>
<pre><code>$blocks = ycf_get_field('features');

if (!empty($blocks)) {
    foreach ($blocks as $block) {
        // Access nested fields using context_data parameter
        $title = ycf_get_field('title', null, $block);
        $icon = ycf_get_image('icon', null, 'thumbnail', $block);
        $category = ycf_get_term('category', null, $block);

        echo '<h3>' . esc_html($title) . '</h3>';
        if ($icon) {
            echo '<img src="' . esc_url($icon['url']) . '">';
        }
        if ($category) {
            echo '<span>' . esc_html($category->name) . '</span>';
        }
    }
}
</code></pre>
<h4>Sample YAML Schema</h4>
<pre><code>fields:
  - name: hero_title
    label: Hero Title
    type: string
    required: true
    options:
      maxlength: 100
  - name: hero_image
    label: Hero Image
    type: image
  - name: category
    label: Category
    type: taxonomy
    options:
      taxonomy: category
  - name: tags
    label: Tags
    type: taxonomy
    multiple: true
    options:
      taxonomy: post_tag
  - name: content_type
    label: Content Type
    type: post_type
  - name: university
    label: University
    type: data_object
    options:
      object_type: universities
  - name: features
    label: Features
    type: block
    list: true
    blockKey: type
    blocks:
      - name: feature
        label: Feature Block
        fields:
          - name: title
            label: Title
            type: string
          - name: icon
            label: Icon
            type: image
          - name: description
            label: Description
            type: text
</code></pre>
<h4>Working with Partials</h4>
<p>For custom partials, add the @ycf marker in the file header:</p>
<pre><code><?php
/**
 * Custom Navigation Partial
 * @ycf
 */
</code></pre>
<p>Then click “Refresh Template List” in the YAML Custom Fields admin page.</p>
<h4>Template Global Fields</h4>
<p>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>
<p><strong>Setting up Template Global:</strong></p>
<ol>
<li>Go to <strong>YAML Custom Fields</strong> admin page</li>
<li>Enable YAML for your template (e.g., page.php)</li>
<li>Click <strong>Add Template Global</strong> to define the template global schema</li>
<li>Define fields that should have shared default values</li>
<li>Click <strong>Manage Template Global Data</strong> to set the default values</li>
</ol>
<p><strong>Using Template Global in Posts:</strong></p>
<p>When editing a post that uses a template with Template Global fields, you’ll see a dual-field interface for each field:</p>
<ul>
<li><strong>Template Global (All Pages)</strong> – Read-only display showing the default value (with Edit link)</li>
<li><strong>Page-Specific Value</strong> – Editable field for this post only</li>
<li><strong>Checkbox</strong> – “Use template global for this field” – Toggle per field</li>
</ul>
<p><strong>Benefits:</strong></p>
<ul>
<li><strong>Consistency:</strong> Set default values once, use across all posts</li>
<li><strong>Flexibility:</strong> Override any field on any post individually</li>
<li><strong>Clarity:</strong> See both global and local values side-by-side</li>
<li><strong>Efficiency:</strong> Update template global to affect all posts at once</li>
</ul>
<p><strong>Data Priority (when using template functions):</strong></p>
<p>When a field uses template global, <code>ycf_get_field()</code> returns data in this priority order:</p>
<ol>
<li>Page-specific value (if “use template global” is unchecked)</li>
<li>Template global value (if “use template global” is checked)</li>
<li>Site-wide global value (if template has site-wide global enabled)</li>
<li>null (if no value exists)</li>
</ol>
<h4>Data Storage</h4>
<ul>
<li><strong>Page/Post data:</strong> Stored in post meta with key <code>_yaml_cf_data</code></li>
<li><strong>Template Global preferences:</strong> Stored in post meta with key <code>_yaml_cf_use_template_global_fields</code> (per-field array)</li>
<li><strong>Template Global schemas:</strong> Stored in options table with key <code>yaml_cf_template_global_schemas</code></li>
<li><strong>Template Global data:</strong> Stored in options table with key <code>yaml_cf_template_global_data</code></li>
<li><strong>Site-wide global schema:</strong> Stored in options table with key <code>yaml_cf_global_schema</code></li>
<li><strong>Site-wide global data:</strong> Stored in options table with key <code>yaml_cf_global_data</code></li>
<li><strong>Partial data:</strong> Stored in options table with key <code>yaml_cf_partial_data</code></li>
<li><strong>Schemas:</strong> Stored in options table with key <code>yaml_cf_schemas</code></li>
<li><strong>Data Object Types:</strong> Stored in options table with key <code>yaml_cf_data_object_types</code></li>
<li><strong>Data Object Entries:</strong> Stored in options table with keys <code>yaml_cf_data_object_entries_{type_slug}</code></li>
</ul>
<h3>Privacy Policy</h3>
<p>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>
<h3>Third-Party Libraries</h3>
<p>This plugin includes the following third-party libraries:</p>
<ul>
<li><strong>Symfony YAML Component</strong> (v6.4) – Licensed under MIT License (GPL-compatible)
<ul>
<li>Homepage: https://symfony.com/components/Yaml</li>
<li>License: https://github.com/symfony/yaml/blob/7.3/LICENSE</li>
</ul>
</li>
</ul>
<h3>Credits</h3>
<ul>
<li>Author: <a href="https://www.silvestar.codes" rel="nofollow ugc">Silvestar Bistrovic</a></li>
</ul>
<h3>Support</h3>
<p>For documentation, examples, and support, visit:<br />
* <a href="https://github.com/maliMirkec/yaml-custom-fields" rel="nofollow ugc">Plugin Documentation</a><br />
* <a href="https://github.com/maliMirkec/yaml-custom-fields/issues" rel="nofollow ugc">Report Issues</a></p>


YAML Custom Fields

A WordPress plugin for managing YAML frontmatter schemas in theme templates and partials.

Additional Authors vs YAML Custom Fields