=Requiring files based on Site class settings

Jake Vanderwerf

2026-04-26 86c6cd3cc099d2480932ede03c12cea01e625c94

 inc/meta/Form.php

@@ -2,6 +2,7 @@
namespace JVBase\meta;

use DateTime;
use JVBase\registrar\Registrar;

if (!defined('ABSPATH')) {
   exit;
@@ -87,7 +88,7 @@
   // Helper Methods
   // ─────────────────────────────────────────────────────────────

   protected static function fieldWrap(string $name, string $content, array $config): string
   public static function fieldWrap(string $name, string $content, array $config): string
   {
      $classes = static::buildClasses($config);
      $datasets = static::buildDatasets($config);
@@ -107,6 +108,8 @@
      $output .= static::buildLabel($name, $config);
      if (!array_key_exists('skipInput', $config)) {
         $output .= static::buildInput($content);
      } else {
         $output .= $content;
      }

      $output .= static::buildHint($config);
@@ -570,30 +573,47 @@

   protected static function renderRadio(string $name, mixed $value, array $config): string
   {
      $options = $config['options'] ?? [];
      $options    = $config['options'] ?? [];
      $inputClass = !empty($config['inputClass']) ? ' class="' . esc_attr($config['inputClass']) . '"' : '';
      $idPrefix   = $config['idPrefix'] ?? '';

      $radios = sprintf(
         '<fieldset>
         <legend>%s%s</legend>',
        <legend>%s%s</legend>',
         array_key_exists('label', $config) ? esc_html($config['label']) : 'Select an option',
         array_key_exists('required', $config) && $config['required']===true ? '<span class="required" aria-label="required">*</span>' : ''
         array_key_exists('required', $config) && $config['required'] === true
            ? '<span class="required" aria-label="required">*</span>' : ''
      );

      foreach ($options as $optValue => $optLabel) {
      foreach ($options as $optValue => $optConfig) {
         if (is_array($optConfig)) {
            $optLabel    = $optConfig['label'] ?? $optValue;
            $optIcon     = $optConfig['icon'] ?? null;
            $optDisabled = !empty($optConfig['disabled']) ? ' disabled' : '';
         } else {
            $optLabel    = $optConfig;
            $optIcon     = null;
            $optDisabled = '';
         }

         $labelContent = $optIcon
            ? jvbDashIcon($optIcon)
            : '<span>' . esc_html($optLabel) . '</span>';

         $optId = esc_attr($idPrefix . $name . '-' . $optValue);

         $radios .= sprintf(
            '
                    <input type="radio" name="%s" id="%s-%s" value="%s"%s />
            <label class="radio-option" for="%s-%s">
                    <span>%s</span>
                </label>',
            '<input type="radio" name="%s" id="%s" value="%s"%s%s%s />
            <label class="radio-option" for="%s" title="%s">%s</label>',
            esc_attr($name),
            esc_attr($name),
            $optValue,
            $optId,
            esc_attr($optValue),
            checked($value, $optValue,false),
            esc_attr($name),
            $optValue,
            esc_html($optLabel)
            checked($value, $optValue, false),
            $optDisabled,
            $inputClass,
            $optId,
            esc_html($optLabel),
            $labelContent
         );
      }

@@ -655,16 +675,9 @@
         $content = $config['content'];

         $config['data']['content'] = $content;
         $plural =
            JVB_CONTENT[$content]['plural']
            ?? JVB_TAXONOMY[$content]['plural']
            ?? JVB_USER[$content]['plural']
            ?? str_replace('_', ' ', $content) . 's';

         $singular = JVB_CONTENT[$content]['singular']
            ?? JVB_TAXONOMY[$content]['singular']
            ?? JVB_USER[$content]['singular']
            ?? str_replace('_', ' ',$config['content']);
         $registrar = Registrar::getInstance($content);
         $plural = $registrar->getPlural()??str_replace('_', ' ', $content).'s';
         $singular = $registrar->getSingular()??str_replace('_', ' ', $content);
      }
      if ($config['limit'] > 0) {
         $config['data']['max-files'] = $config['limit'];
@@ -726,6 +739,13 @@
      }

      $input .= '</div>'; // closes .file-upload-container

      $input .= sprintf(
         '<input type="hidden" name="%s" value="%s">',
         esc_attr($name),
         esc_attr(!empty($attachmentIds) ? implode(',', $attachmentIds) : '')
      );

      unset($config['description']);
      unset($config['label']);
      return static::fieldWrap($name, $input, $config);
@@ -1159,18 +1179,20 @@
         'type'      => $config['subtype'],
      ], $config);

      $icon = match ($config['subtype']) {
         'taxonomy' => JVB_TAXONOMY[$config['taxonomy']]['icon'] ?? jvbDefaultIcon(),
         'content' => JVB_CONTENT[$config['content']]['icon'] ?? jvbDefaultIcon(),
         'user' => JVB_USER[$config['role']]['icon'] ?? 'user',
         default => jvbDefaultIcon(),
      };
      $registrar = Registrar::getInstance($config[$config['subtype']]);
      $icon = jvbDefaultIcon();
      if ($registrar){
         $icon = $registrar->getIcon()??jvbDefaultIcon();
      }

      $containerId = sprintf('%s-%s-selector', $name, $config['subtype']);

      $input = sprintf(
         '<div class="row btw">
         <label for="%s-autocomplete">%s<span>%s</span></label>',
    <input type="hidden" name="%s" value="%s">
    <label for="%s-autocomplete">%s<span>%s</span></label>',
         esc_attr($name),
         esc_attr(!empty($ids) ? implode(',', $ids) : ''),
         esc_attr($name),
         jvbIcon($icon),
         esc_html($config['label']),
@@ -1183,58 +1205,64 @@
      }
      $plural = static::getPlural($config);
      $input .= sprintf(
         '<div class="selected-item row" role="region" aria-label="Selected %s"></div>',
         '<div class="selected-items row" role="region" aria-label="Selected %s"></div>',
         $plural[1]??''
      );

      $input .= '</div>'; //Close the first div.row.btw

      $config['type'] = 'selector';
      unset($config['label']);
      unset($config['description']);
      unset($config['hint']);
      $config['skipInput'] = true;
      return static::fieldWrap($containerId, $input, $config);
      return static::fieldWrap($name, $input, $config);
   }

      protected static function getPlural(array $config):array
      {
         $single = $plural = '';
         switch ($config['subtype']) {
            case 'taxonomy':
               if (array_key_exists($config['taxonomy'], JVB_TAXONOMY)) {
                  $single = JVB_TAXONOMY[$config['taxonomy']]['singular'];
                  $plural = JVB_TAXONOMY[$config['taxonomy']]['plural'];
               $registrar = Registrar::getInstance($config['taxonomy']);
               if ($registrar) {
                  $single = $registrar->getSingular();
                  $plural = $registrar->getPlural();
               } else {
                  $taxonomy = get_taxonomy($config['taxonomy']);
                  if (!$taxonomy) {
                     return [];
                  if ($taxonomy) {
                     $single = $taxonomy->labels->singular_name;
                     $plural = $taxonomy->labels->name;
                  }
                  $single = $taxonomy->labels->singular_name;
                  $plural = $taxonomy->labels->name;
               }
               break;
            case 'content':
               if (array_key_exists($config['content'], JVB_CONTENT)) {
                  $single = JVB_CONTENT[$config['content']]['singular'];
                  $plural = JVB_CONTENT[$config['content']]['plural'];
               $registrar = Registrar::getInstance($config['content']);
               if ($registrar) {
                  $single = $registrar->getSingular();
                  $plural = $registrar->getPlural();
               } else {
                  $postType = get_post_type_object($config['content']);
                  if (!$postType) {
                     return '';
                  if ($postType) {
                     $single = $postType->labels->singular_name;
                     $plural = $postType->labels->name;
                  }
                  $single = $postType->labels->singular_name;
                  $plural = $postType->labels->name;

               }
               break;

            case 'user':
               if (array_key_exists($config['user'], JVB_USER)) {
                  $single = JVB_USER[$config['user']]['singular'];
                  $plural = JVB_USER[$config['user']]['plural'];
               $registrar = Registrar::getInstance($config['user']);

               if ($registrar) {
                  $single = $registrar->getSingular();
                  $plural = $registrar->getPlural();
               } else {
                  $user = get_role($config['user']);
                  if (!$user) {
                     return '';
                  if ($user) {
                     $single = 'User';
                     $plural = 'Users';
                  }
                  $single = 'User';
                  $plural = 'Users';
               }
               break;
         }
@@ -1245,9 +1273,10 @@
      {
         switch ($config['subtype']) {
            case 'taxonomy':
               if (array_key_exists($config['taxonomy'], JVB_TAXONOMY)) {
                  $single = JVB_TAXONOMY[$config['taxonomy']]['singular'];
                  $plural = JVB_TAXONOMY[$config['taxonomy']]['plural'];
               $registrar = Registrar::getInstance($config['taxonomy']);
               if ($registrar) {
                  $single = $registrar->getSingular();
                  $plural = $registrar->getPlural();
               } else {
                  $taxonomy = get_taxonomy($config['taxonomy']);
                  if (!$taxonomy) {
@@ -1257,16 +1286,17 @@
                  $plural = $taxonomy->labels->name;
               }
               $attr = sprintf(
                  ' data-taxonomy="%s" data-single="%s" data-plural="%s',
                  ' data-taxonomy="%s" data-single="%s" data-plural="%s"',
                  $config['taxonomy'],
                  $single,
                  $plural
               );
               break;
            case 'content':
               if (array_key_exists($config['content'], JVB_CONTENT)) {
                  $single = JVB_CONTENT[$config['content']]['singular'];
                  $plural = JVB_CONTENT[$config['content']]['plural'];
               $registrar = Registrar::getInstance($config['content']);
               if ($registrar) {
                  $single = $registrar->getSingular();
                  $plural = $registrar->getPlural();
               } else {
                  $postType = get_post_type_object($config['content']);
                  if (!$postType) {
@@ -1276,7 +1306,7 @@
                  $plural = $postType->labels->name;
               }
               $attr = sprintf(
                  ' data-content="%s" data-single="%s" data-plural="%s',
                  ' data-content="%s" data-single="%s" data-plural="%s"',
                  $config['content'],
                  $single,
                  $plural
@@ -1284,9 +1314,10 @@
               break;

            case 'user':
               if (array_key_exists($config['user'], JVB_USER)) {
                  $single = JVB_USER[$config['user']]['singular'];
                  $plural = JVB_USER[$config['user']]['plural'];
               $registrar = Registrar::getInstance($config['user']);
               if ($registrar){
                  $single = $registrar->getSingular();
                  $plural = $registrar->getPlural();
               } else {
                  $user = get_role($config['user']);
                  if (!$user) {
@@ -1296,7 +1327,7 @@
                  $plural = 'Users';
               }
               $attr = sprintf(
                  ' data-user="%s" data-single="%s" data-plural="%s',
                  ' data-user="%s" data-single="%s" data-plural="%s"',
                  $config['user'],
                  $single,
                  $plural
@@ -1324,7 +1355,7 @@
            $dataAttrs[] = 'data-selected="'.esc_attr(implode(',',$selected)).'"';
         }
         if ($config['autocomplete']) {
            $dataAttrs[] = 'autocomplete';
            $dataAttrs[] = 'data-autocomplete';
         }
         if (array_key_exists('hidden', $config) && $config['hidden']) {
            $dataAttrs[] = 'hidden';
@@ -1341,15 +1372,15 @@
            jvbIcon('plus-square')
         );
      }
      protected static function buildSelectorAutocomplete(string $name, array $config):string
      {
         return sprintf(
         '<input type="hidden" id="%s-autocomplete" autocomplete="off" data-ignore data-autocomplete>
            <p class="message" hidden aria-live="polite">{ <span>Loading items</span> }</p>
            <div class="auto-wrapper" hidden><ul class="search-results"></ul><button class="submit-term" hidden data-ignore><strong>Create: </strong> "<span></span>"</button></div>',
            $name
         );
      }
   protected static function buildSelectorAutocomplete(string $name, array $config): string
   {
      return sprintf(
         '<input type="search" id="%s-autocomplete" autocomplete="off" data-ignore data-autocomplete>
        <p class="message" hidden aria-live="polite">{ <span>Loading items</span> }</p>
        <div class="auto-wrapper" hidden><ul class="search-results"></ul><button class="submit-term" hidden data-ignore><strong>Create: </strong> "<span></span>"</button></div>',
         esc_attr($name)
      );
   }

   protected static function renderTaxonomy(string $name, mixed $value, array $config): string
   {
@@ -1566,8 +1597,8 @@
   {
      $fields = $config['fields'] ?? [];
      $rows = is_array($value) ? $value : [];
      if(array_key_exists('row_label', $config)) {
         $config['data']['label'] = esc_attr($config['row_label']);
      if(array_key_exists('add_label', $config)) {
         $config['data']['label'] = esc_attr($config['add_label']);
      }

      $input = sprintf(
@@ -1594,6 +1625,7 @@
      array_key_exists('add_label', $config) ? $config['add_label'] : 'Add Item'
      );

      unset($config['label']);
      return static::fieldWrap($name, $input, $config);
   }
      protected static function renderRepeaterRow(array $fields, array $values, int|string $index, string $name, string $rowTitle='New Item'):string