Jake Vanderwerf
2026-05-01 48721c85ebcfa973ee81719d2467ca80e4253dc9
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);
@@ -99,13 +100,16 @@
         '<div class="%s" data-field="%s" data-field-type="%s"%s>',
         $classes,
         $name,
         $config['type'],
         str_replace('_', '-', $config['type']),
         $datasets
      );
      $output .= static::buildCharacterLimit($config);
      $output .= static::buildLabel($name, $config);
      if (!array_key_exists('skipInput', $config)) {
         $output .= static::buildInput($content);
      } else {
         $output .= $content;
      }
      $output .= static::buildHint($config);
@@ -117,7 +121,7 @@
   }
      protected static function buildClasses(array $config): string
      {
         $classes = ['field field-' . ($config['type'] ?? 'text')];
         $classes = ['field '. (str_replace('_','-',sanitize_text_field($config['type'] ?? 'text')))];
         if (!empty($config['required'])) {
            $classes[] = 'required';
         }
@@ -179,6 +183,21 @@
            );
         }
   protected static function buildCharacterLimit(array $config): string
   {
      $type = $config['type'] ?? 'text';
      if (in_array($type, ['upload', 'gallery', 'selector'])) {
         return '';
      }
      if (empty($config['maxlength'])) {
         return '';
      }
      return sprintf(
         '<span class="char-limit"><span class="current">0</span> / <span class="limit">%s</span></span>',
         esc_html($config['maxlength'])
      );
   }
      protected static function buildLabel(string $name, array $config):string
      {
         if (!empty($config['label'])) {
@@ -192,7 +211,7 @@
         return '';
      }
      protected static function buildInput(string $content):string
      public static function buildInput(string $content):string
      {
         return sprintf(
            '<div class="field-input-wrapper">
@@ -276,7 +295,7 @@
   protected static function renderText(string $name, mixed $value, array $config): string
   {
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="%s"%s%s />',
         $config['subtype']??'text',
@@ -312,7 +331,7 @@
   {
      $attrs = static::inputAttrs($name, $config);
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="number"%s%s />',
         $value,
@@ -331,7 +350,7 @@
      $attrs = static::inputAttrs($name, $config);
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<div class="quantity">
            <button type="button" class="decrease" title="%s" aria-label="Decrease %s">%s</button>
@@ -354,7 +373,7 @@
   protected static function renderEmail(string $name, mixed $value, array $config): string
   {
      $config['validate'] = 'email';
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="email"%s%s />',
         $value,
@@ -367,7 +386,7 @@
   protected static function renderUrl(string $name, mixed $value, array $config): string
   {
      $config['validate'] = 'url';
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="url"%s%s />',
         $value,
@@ -380,7 +399,7 @@
   protected static function renderTel(string $name, mixed $value, array $config): string
   {
      $config['validate'] = 'phone';
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="tel"%s%s />',
         $value,
@@ -401,7 +420,7 @@
         }
      }
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="date"%s%s />',
         $value,
@@ -413,7 +432,7 @@
   protected static function renderTime(string $name, mixed $value, array $config): string
   {
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="time"%s%s />',
         $value,
@@ -425,7 +444,7 @@
   protected static function renderDatetime(string $name, mixed $value, array $config): string
   {
      $value = ($value === '') ? ' value="'.esc_attr($value).'"' : '';
      $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : '';
      $input = sprintf(
         '<input type="datetime-local"%s%s />',
         $value,
@@ -492,13 +511,15 @@
      $optionsHtml = '';
      if (empty($config['required'])) {
         $optionsHtml .= '<option value="">— Select —</option>';
      } else {
         $optionsHtml .= '<option value="" disabled selected hidden>— Select —</option>';
      }
      foreach ($options as $optValue => $optLabel) {
         $optionsHtml .= sprintf(
            '<option value="%s"%s>%s</option>',
            esc_attr($optValue),
            selected($value, $optValue),
            selected($value, $optValue, false),
            esc_html($optLabel)
         );
      }
@@ -538,7 +559,7 @@
            $optValue,
            esc_attr($optValue),
            $checked,
            $name,
            esc_attr($name),
            $optValue,
            esc_html($optLabel)
         );
@@ -552,28 +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" 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),
            $optId,
            esc_attr($optValue),
            checked($value, $optValue),
            $name,
            $optValue,
            esc_html($optLabel)
            checked($value, $optValue, false),
            $optDisabled,
            $inputClass,
            $optId,
            esc_html($optLabel),
            $labelContent
         );
      }
@@ -635,19 +675,12 @@
         $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']['limit'] = $config['limit'];
         $config['data']['max-files'] = $config['limit'];
      }
      $attachmentIds = static::parseIds($value);
@@ -693,7 +726,8 @@
      $input .= '<div class="file-error"></div>';
      $input .= jvbRenderProgressBar('', false, true, true);
      $input .= '</div>';
      $input .= '</div>'; // closes .file-upload-wrapper
      if ($config['destination'] === 'post_group') {
         $input .= static::renderUploadGroupAreaStart($config, $plural, $singular);
@@ -704,6 +738,14 @@
         $input .= static::renderUploadGroupAreaEnd($config, $plural, $singular);
      }
      $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);
@@ -1137,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']),
@@ -1161,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;
         }
@@ -1223,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) {
@@ -1235,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) {
@@ -1254,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
@@ -1262,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) {
@@ -1274,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
@@ -1302,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';
@@ -1319,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
   {
@@ -1441,59 +1494,83 @@
         $input .= static::render($newName, '', $fieldConfig);
      }
      $input .= sprintf(
         '<button type="button" class="button add-tag-item">%s<span>%s</span></button></div>',
         '<button type="button" class="button add-tag">%s<span>%s</span></button></div>',
         jvbIcon('plus'),
         $field['add_label']??'Add'
         $config['add_label']??'Add'
      );
      //Tag Display
      $input .= '<div class="tag-items">'.static::renderTagItem($config['fields'], $value, $name, null, $tagFormat).'</div>';
      $input .= '<div class="tag-items">'.static::renderTagItems($config['fields'], $value, $name, $tagFormat).'</div>';
      //Template for tags
      $input .= sprintf(
         '<template class="%s">%s</template>',
         uniqid('tagListItem'),
         static::renderTagItem($config['fields'], [], null, $name, $tagFormat)
         static::renderTagItem($config['fields'], [], $name, null, $tagFormat)
      );
      $input .= '</div>';
      unset($config['label']);
      return static::fieldWrap($name, $input, $config);
   }
      protected static function renderTagItems(array $fields, mixed $value, string $name, string $tagFormat):string
      {
         if (!$value || $value === '') {
            return '';
         }
         if (is_string($value)) {
            $value = explode(',', $value);
         }
         if (empty($value)) {
            return '';
         }
         $out = '';
         foreach ($value as $index => $v) {
            $out .= static::renderTagItem($fields, $v, $name, $index, $tagFormat);
         }
         return $out;
      }
      protected static function renderTagItem(array $fields, mixed $values, string $name, ?int $index, string $tagFormat):string
      {
         $tagText = static::getTagDisplayText($fields, $values, $tagFormat);
         $out = sprintf(
            '<div class="tag-item"%s><span class="tag-label">%s</span>',
            ($index) ? ' data-index="'.$index.'"' : '',
            ($index !== null) ? ' data-index="'.$index.'"' : '',
            $tagText
         );
         foreach ($fields as $fieldName => $fieldConfig) {
            $value = $values[$fieldName]??'';
            $fullName = (!$index) ? $fieldName : sprintf('%s:%s:%s', $name, $index, $fieldName);
            $fullName = ($index === null) ? $fieldName : sprintf('%s:%s:%s', $name, $index, $fieldName);
            $out .= sprintf(
               '<input type="hidden"
               name="%s"
               value="%s"
               data-field="%s",
               data-field-type="%s" />',
                  name="%s"
                  value="%s"
                  data-field="%s"
                  data-field-type="%s"
                  id="%s" />',
               esc_attr($fullName),
               esc_attr($value),
               esc_attr($fieldName),
               esc_attr($fieldConfig['type'])
            );
            $out .= sprintf(
               '<button type="button" class="remove-tag" aria-label="Remove">%s</button></div>',
               jvbIcon('x')
               esc_attr($fieldConfig['type']),
               esc_attr($fullName)
            );
         }
         $out .= sprintf(
            '<button type="button" class="remove-tag" aria-label="Remove">%s</button>',
            jvbIcon('x')
         );
         $out .='</div>';
         return $out;
      }
         protected static function getTagDisplayText(array $fields, mixed $values, string $tagFormat):string
         {
            if (empty($data)) {
            if (empty($values)) {
               return 'New Item';
            }
@@ -1502,7 +1579,7 @@
                  $firstKey = array_key_first($fields);
                  return $values[$firstKey] ?? 'New Item';
               case 'all_fields':
                  $values = array_filter(array_values($data));
                  $values = array_filter(array_values($values));
                  return implode(', ', $values) ?: 'New Item';
               default:
                  if (strpos($tagFormat, '{') !== false) {
@@ -1520,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(
@@ -1548,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
@@ -1608,12 +1686,13 @@
      foreach ($fields as $fieldName => $fieldConfig) {
         $fieldValue = $values[$fieldName] ?? '';
         $fullName = "{$name}:{$fieldName}";
         $fullName = array_key_exists('wrap', $config) ? $fieldName : "{$name}:{$fieldName}";
         $output .= static::render($fullName, $fieldValue, $fieldConfig);
      }
      $output .= sprintf('</%s>', esc_attr($wrapper));
      unset($config['label']);
      return static::fieldWrap($name, $output, $config);
   }