'number', 'label' => 'Price']); * echo Form::render('email', '', ['type' => 'email', 'required' => true]); */ class Form { /** * Render a form field based on type */ public static function render(string $name, mixed $value, array $config = []): string { if ($value === null) { $value = ''; } if (!empty($config['hidden'])) { return ''; } $type = $config['type'] ?? 'text'; $method = 'render' . str_replace('_', '', ucwords($type, '_')); $output = method_exists(static::class, $method) ? static::$method($name, $value, $config) : static::renderText($name, $value, $config); return apply_filters('jvbRenderFormMeta', $output, $name, $config, $value, null); } /** * Render with Meta instance (convenience method) */ public static function renderFrom(Meta $meta, string $name): string { $value = $meta->get($name); $config = $meta->config($name) ?? ['type' => 'text']; return static::render($name, $value, $config); } /** * Render complete form from Meta instance */ public static function renderFormFrom(Meta $meta, string $endpoint, array $options = []): string { $id = $options['form-id'] ?? $endpoint; $classes = isset($options['classes']) ? ' class="' . implode(' ', $options['classes']) . '"' : ''; $output = ''; return $output; } // ───────────────────────────────────────────────────────────── // Helper Methods // ───────────────────────────────────────────────────────────── public static function fieldWrap(string $name, string $content, array $config, bool $col = false): string { if (!array_key_exists('type', $config)) { jvbDump('No type set for '.$name.' with config: '.print_r($config, true)); } $classes = static::buildClasses($config); $datasets = static::buildDatasets($config); if (!array_key_exists('type', $config)) { error_log('Config without type: '.print_r($config, true)); } $output = sprintf( '

', $classes, $name, str_replace('_', '-', $config['type']), $datasets ); $output .= static::buildCharacterLimit($config); $output .= static::buildLabel($name, $config); if (!array_key_exists('skipInput', $config)) { $output .= static::buildInput($content, $col); } else { $output .= $content; } $output .= static::buildHint($config); $output .= static::buildDescription($name, $config); $output .= '

'; return $output; } protected static function buildClasses(array $config): string { $classes = ['field '. (str_replace('_','-',sanitize_text_field($config['type'] ?? 'text')))]; if (!empty($config['required'])) { $classes[] = 'required'; } if (!empty($config['class'])) { if (!is_array($config['class'])) { $config['class'] = [$config['class']]; } $classes = array_merge($classes, $config['class']); } return trim(implode(' ',$classes)); } protected static function buildDatasets(array $config): string { $datasets = static::handleCustomDatasets($config); $datasets .= static::handleValidationLogic($config); $datasets .= static::handleConditionalLogic($config); return $datasets; } protected static function handleCustomDatasets($config):string { if (array_key_exists('data', $config) && !empty($config['data'])) { $datasets = array_map(function ($value, $key) use ($config) { $name = str_replace('_', '-', sanitize_title($key)); return ' data-'.$name.'="'.$value.'"'; }, array_values($config['data']), array_keys($config['data'])); return implode($datasets); } return ''; } protected static function handleValidationLogic($config):string { $datasets = ''; $dataAttrs = ['pattern', 'validate', 'min', 'max', 'minlength', 'maxlength', 'validation_message']; $attrs = []; foreach ($dataAttrs as $attr) { if (array_key_exists($attr, $config) && !empty($config[$attr])) { $attrs[$attr] = $config[$attr]; } } foreach($attrs as $attr => $value) { $datasets .= sprintf(' data-%s="%s"', $attr, esc_attr($value)); } return $datasets; } protected static function handleConditionalLogic($config):string { if (empty($config['condition'])) { return ''; } return sprintf( 'data-depends-on="%s" data-depends-value="%s" data-depends-operator="%s"', esc_attr($config['condition']['field']), esc_attr($config['condition']['value']), esc_attr($config['condition']['operator'] ?? '==') ); } 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( '0 / %s', esc_html($config['maxlength']) ); } protected static function buildLabel(string $name, array $config):string { if (!empty($config['label'])) { return sprintf( '%s%s', esc_attr($name), esc_html($config['label']), !empty($config['required']) ? '*' : '' ); } return ''; } public static function buildInput(string $content, bool $col = false):string { return sprintf( '

', $col ? ' col' : '', $content, jvbIcon('check-circle'), jvbIcon('x-circle') ); } protected static function buildHint(array $config):string { if (!empty($config['hint'])) { return sprintf( '%s', esc_html($config['hint']) ); } return ''; } protected static function buildDescription(string $name, array $config):string { if (!empty($config['description'])) { return sprintf( '

', esc_attr($name), esc_html($config['description']) ); } return ''; } protected static function inputAttrs(string $name, array $config): string { $attrs = [ 'id' => $name, 'name' => $name, ]; if (!empty($config['placeholder'])) { $attrs['placeholder'] = $config['placeholder']; } if (!empty($config['autocomplete'])) { $attrs['autocomplete'] = $config['autocomplete']; } if (isset($config['min'])) { $attrs['min'] = $config['min']; } if (isset($config['max'])) { $attrs['max'] = $config['max']; } if (isset($config['step'])) { $attrs['step'] = $config['step']; } $html = ''; //Add the attributes that stand on their own $standalones = ['required', 'disabled', 'readonly','multiple']; foreach($standalones as $s) { if (array_key_exists($s, $config) && $config[$s] === true) { $html .= ' '.$s; } } foreach ($attrs as $key => $val) { $html .= sprintf(' %s="%s"', $key, esc_attr($val)); } return $html; } // ───────────────────────────────────────────────────────────── // Type Renderers // ───────────────────────────────────────────────────────────── protected static function renderText(string $name, mixed $value, array $config): string { $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $config['subtype']??'text', $value, static::inputAttrs($name, $config) ); return static::fieldWrap($name, $input, $config); } protected static function renderTextarea(string $name, mixed $value, array $config): string { $rows = $config['rows'] ?? 5; $quill = (array_key_exists('quill', $config) && $config['quill'] === true) ? ' data-editor="true"' : ''; if ($quill !== '') { $allowImages = array_key_exists('allowImage', $config); $quill .= ($allowImages) ? ' data-allowimage="true"' : ' data-allowimage="false"'; } $textarea = sprintf( '', $rows, static::inputAttrs($name, $config), $quill, esc_textarea($value) ); return static::fieldWrap($name, $textarea, $config); } protected static function renderNumber(string $name, mixed $value, array $config): string { $attrs = static::inputAttrs($name, $config); $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $value, $attrs ); return static::fieldWrap($name, $input, $config); } protected static function renderQuantity(string $name, mixed $value, array $config): string { if (!array_key_exists('class', $config)) { $config['class']=[]; } $config['class'][] ='quantity-input'; $attrs = static::inputAttrs($name, $config); $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '

', array_key_exists('remove', $config) ? $config['remove'] : 'Decrease amount', array_key_exists('label', $config) ? $config['label'] : 'Amount', jvbIcon('minus-square'), $value, $attrs, array_key_exists('add', $config) ? $config['add'] : 'Increase amount', array_key_exists('label', $config) ? $config['label'] : 'Amount', jvbIcon('plus-square'), ); return static::fieldWrap($name, $input, $config); } protected static function renderEmail(string $name, mixed $value, array $config): string { $config['validate'] = 'email'; $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $value, static::inputAttrs($name, $config) ); return static::fieldWrap($name, $input, $config); } protected static function renderUrl(string $name, mixed $value, array $config): string { $config['validate'] = 'url'; $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $value, static::inputAttrs($name, $config) ); return static::fieldWrap($name, $input, $config); } protected static function renderTel(string $name, mixed $value, array $config): string { $config['validate'] = 'phone'; $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $value, static::inputAttrs($name, $config) ); return static::fieldWrap($name, $input, $config); } protected static function renderDate(string $name, mixed $value, array $config): string { $format = !empty($config['format']) ? $config['format'] : 'Y-m-d'; // Format the date if we have a value if (!empty($value)) { $date = DateTime::createFromFormat($format, $value); if ($date) { $value = $date->format('Y-m-d'); // HTML date input requires Y-m-d format } } $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $value, static::inputAttrs($name, $config) ); return static::fieldWrap($name, $input, $config); } protected static function renderTime(string $name, mixed $value, array $config): string { $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $value, static::inputAttrs($name, $config) ); return static::fieldWrap($name, $input, $config); } protected static function renderDatetime(string $name, mixed $value, array $config): string { $value = ($value !== '') ? ' value="'.esc_attr($value).'"' : ''; $input = sprintf( '', $value, static::inputAttrs($name, $config) ); return static::fieldWrap($name, $input, $config); } protected static function renderTrueFalse(string $name, mixed $value, array $config): string { if (!array_key_exists('class', $config)) { $config['class'] = []; } $config['class'][] ='row x-btw'; $checked = filter_var($value, FILTER_VALIDATE_BOOLEAN); $input = sprintf( '

%s %s ', static::inputAttrs($name, $config), $checked ? ' checked' : '', array_key_exists('required', $config) && $config['required']===true ? '*' : '', $config['label']??'' ); unset($config['label']); return static::fieldWrap($name, $input, $config); } protected static function renderToggleText($name, $value, $config):string { if (!isset($config['type'])) { $config['type'] = 'toggle-text'; } $input = sprintf( ' %s %s %s %s ', static::inputAttrs($name, $config), filter_var($value, FILTER_VALIDATE_BOOLEAN) ? ' checked' : '', $name, array_key_exists('before', $config) ? esc_html($config['before']) : '', array_key_exists('off', $config) ? esc_html($config['off']) : 'Off', array_key_exists('on', $config) ? esc_html($config['on']) : 'On', array_key_exists('after', $config) ? esc_html($config['after']) : '', ); return static::fieldWrap($name, $input, $config); } protected static function renderSelect(string $name, mixed $value, array $config): string { $options = $config['options'] ?? []; $optionsHtml = ''; if (empty($config['required'])) { $optionsHtml .= ''; } else { $optionsHtml .= ''; } foreach ($options as $optValue => $optLabel) { $optionsHtml .= sprintf( '', esc_attr($optValue), selected($value, $optValue, false), esc_html($optLabel) ); } $select = sprintf( '%s', static::inputAttrs($name, $config), $optionsHtml ); return static::fieldWrap($name, $select, $config); } protected static function renderCheckbox(string $name, mixed $value, array $config): string { $options = $config['options'] ?? []; $values = is_array($value) ? $value : explode(',', (string)$value); $values = array_map('trim', $values); $checkboxes = sprintf( '

%s%s', esc_html($config['label'] ?? 'Select Option(s)'), array_key_exists('required', $config) && $config['required']===true ? '*' : '' ); foreach ($options as $optValue => $optLabel) { $checked = in_array($optValue, $values) ? ' checked' : ''; $checkboxes .= sprintf( ' %s ', esc_attr($name), esc_attr($name), $optValue, esc_attr($optValue), $checked, esc_attr($name), $optValue, esc_html($optLabel) ); } $checkboxes .= '

'; unset($config['label']); return static::fieldWrap($name, $checkboxes, $config); } protected static function renderRadio(string $name, mixed $value, array $config): string { $options = $config['options'] ?? []; $inputClass = !empty($config['inputClass']) ? ' class="' . esc_attr($config['inputClass']) . '"' : ''; $idPrefix = $config['idPrefix'] ?? ''; $radios = sprintf( '

%s%s', array_key_exists('label', $config) ? esc_html($config['label']) : 'Select an option', array_key_exists('required', $config) && $config['required'] === true ? '*' : '' ); foreach ($options as $optValue => $optConfig) { $class = ''; if (is_array($optConfig)) { $optLabel = $optConfig['label'] ?? $optValue; $optIcon = $optConfig['icon'] ?? null; if ($optIcon) { $class = ' class="btn"'; } $optDisabled = !empty($optConfig['disabled']) ? ' disabled' : ''; } else { $optLabel = $optConfig; $optIcon = null; $optDisabled = ''; } $labelContent = $optIcon ? jvbDashIcon($optIcon) : '' . esc_html($optLabel) . ''; $optId = esc_attr($idPrefix . $name . '-' . $optValue); $radios .= sprintf( ' %s', esc_attr($name), $optId, esc_attr($optValue), $class, checked($value, $optValue, false), $optDisabled, $inputClass, $optId, esc_html($optLabel), $labelContent ); } $radios .= '

'; unset($config['label']); return static::fieldWrap($name, $radios, $config); } protected static function renderUpload(string $name, mixed $value, array $config): string { $defaults = [ //File Type 'subtype' => 'image', //'image', 'video', 'document', 'any' 'accepted' => null, //null = use subtype defaults, or define an array of specific MIME types //Upload Behaviours 'multiple' => false, //single or multiple uploads 'limit' => 15, //Max number of uploads (0 = unlimited) 'mode' => 'direct', // 'direct' or 'selection' TODO: unneeded? 'destination'=> 'meta', //'meta', 'post', 'post_group' //Processing Options 'max_size' => null, //override default size limits 'convert' => 'webp', //Image conversion format 'quality' => 90, //Conversion quality 'inputData' => [], 'data' => [] ]; $config = array_merge($defaults, $config); // Validate destination config if (in_array($config['destination'], ['post', 'post_group']) && empty($config['content'])) { error_log("Upload field '{$name}' has destination '{$config['destination']}' but no content defined"); return ''; } $validate = [ 'subtype' => ['image', 'video', 'document', 'any','timeline'], 'mode' => ['direct', 'selection'], 'destination'=> ['meta', 'post', 'post_group'] ]; foreach ($validate as $key => $options) { if (!in_array($config[$key], $options)) { error_log('Invalid option set for '.$key.': '.print_r($config[$key], true)); return ''; } } $acceptAttr = implode(',',static::getAllowedTypes($config)); //Add upload config to the datasets (handled by fieldWrap()) $attrs = ['subtype', 'mode', 'destination', 'max_size']; foreach ($attrs as $attr) { if (array_key_exists($attr, $config)) { $config['data'][$attr] = $config[$attr]; } } $config['data']['upload-field'] = ''; $config['data']['type'] = $config['multiple'] ? 'gallery' : 'single'; $plural = 'images'; $singular = 'image'; if (!empty($config['content'])) { $content = $config['content']; $config['data']['content'] = $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']; } $attachmentIds = static::parseIds($value); $input = sprintf( '', esc_attr($name), esc_attr(!empty($attachmentIds) ? implode(',', $attachmentIds) : '') ); $input .= sprintf( '

%s

Click to upload or drag and drop
%s (max. %s)

', static::inputAttrs($name, $config), $acceptAttr, esc_attr(static::getMaxFileSize($config)), array_key_exists('label', $config) ? esc_html($config['label']) : 'Upload file(s)', static::buildDescription($name, $config), esc_html(static::getAcceptedTypesLabel($config)), esc_html(static::formatFileSize(static::getMaxFileSize($config))) ); if ($config['destination'] === 'post_group') { $input .= sprintf( '

You can group images to create separate %s.

If a %s has multiple images, you can select the %s to set an image as the main one.

', $plural, $singular, jvbIcon('star') ); } if (array_key_exists('upload_description', $config) && $config['upload_description']!==''){ $input .= sprintf('

', esc_html($config['upload_description'])); } $input .= '

'; $input .= jvbRenderProgressBar('', false, true, true); $input .= '

'; // closes .file-upload-wrapper if ($config['destination'] === 'post_group') { $input .= static::renderUploadGroupAreaStart($config, $plural, $singular); } $input .= static::renderUploadItem($attachmentIds, $config['subtype']); if ($config['destination'] === 'post_group') { $input .= static::renderUploadGroupAreaEnd($config, $plural, $singular); } $input .= '

'; // closes .file-upload-container unset($config['description']); unset($config['label']); return static::fieldWrap($name, $input, $config); } protected static function renderUploadGroupAreaStart(array $config, string $plural='', string $singular = ''):string { return sprintf('

Select All

', jvbIcon('plus-square'), jvbIcon('trash'), jvbIcon('cloud-arrow-up'), $plural!==''? $plural : $config['content'], ); } protected static function renderUploadItem(array $attachmentIds, string $subtype):string { $out = jvbRenderProgressBar('Processing files... 0/0',false,true,true); $out .= '

'; // Render existing attachments foreach ($attachmentIds as $attachmentId) { $out .= static::renderExistingAttachment($attachmentId, $subtype); } $out .= '

'; return $out; } public static function renderExistingAttachment(int $attachmentId, string $subtype):string { switch ($subtype){ case 'video': return static::renderVideoPreview($attachmentId); case 'document': case 'file': return static::renderFilePreview($attachmentId); default: return static::renderImagePreview($attachmentId); } } protected static function renderUploadItemStart(?int $attachmentId = null):string { return sprintf( '

', $attachmentId, ($attachmentId) ? '-'.$attachmentId : '', ($attachmentId) ? '-'.$attachmentId : '' ); } protected static function renderUploadItemEnd():string { return ''; } protected static function renderUploadItemActions(?int $attachmentId = null):string { return sprintf( '

%s%s

', ($attachmentId) ? '-'.$attachmentId : '', jvbIcon('star'), jvbIcon('star', ['style' => 'fill']), jvbIcon('trash') ); } protected static function renderUploadItemMetaStart():string { return '

'; } protected static function renderUploadItemMetaEnd():string { return '

'; } protected static function renderVideoPreview(?int $ID = null, ?array $additionalFields = null):string { $out = static::renderUploadItemStart($ID); //add video preview $previewID = get_post_meta($ID, BASE.'poster', true); if ($previewID !== '') { $out .= jvbFormatImage($previewID, 'tiny', 'medium'); } else { $out .= '

'; } $out .= static::renderUploadItemEnd(); //add item actions $out .= static::renderUploadItemActions($ID); $out .= static::renderUploadItemMetaStart(); //Caption, description, title $caption = ($ID) ? wp_get_attachment_caption($ID) : ''; $description = ($ID) ? get_the_content($ID) : ''; $title = ($ID) ? get_the_title($ID) : ''; $fields = [ 'type' => 'group', 'wrap' => 'details', 'label' => 'Edit Video Meta', 'fields' => [ 'image-title' => [ 'type' => 'text', 'label' => 'Video Title', 'value' => $title, 'data' => ['id' => $ID] ], 'poster' => [ 'type' => 'upload', 'label' => 'Video Poster', 'value' => $previewID, 'multiple' => false, ], 'image-caption' => [ 'type' => 'textarea', 'value' => $caption, 'label' => 'Video Caption', 'data' => ['id' => $ID] ], // 'image-description' => [ // 'type' => 'textarea', // 'value' => $description, // 'label' => 'Video Description', // 'data' => ['id' => $ID] // ] ] ]; $out .= static::render('image_data', '', $fields); $out .= static::renderUploadItemMetaEnd(); if ($additionalFields) { $out .= static::additionalFields($additionalFields); } return $out; } protected static function renderFilePreview(?int $ID, ?array $additionalFields = null):string { $out = static::renderUploadItemStart($ID); $upload = wp_get_attachment_url($ID); $fileType = wp_check_filetype($upload)['ext']??false; $iconMap = [ 'pdf' => 'file-pdf', 'csv' => 'file-csv', 'doc' => 'file-doc', 'docx' => 'file-doc', 'txt' => 'file-txt', 'xls' => 'file-xls', 'xlsx' =>'file-xls' ]; $icon = ($fileType) ? jvbIcon($iconMap[$fileType]??'file') : jvbIcon('file'); $out .= ''.$icon.''; $out .= static::renderUploadItemEnd(); //add item actions $out .= static::renderUploadItemActions($ID); $out .= static::renderUploadItemMetaStart(); //Caption, description, title $caption = ($ID) ? wp_get_attachment_caption($ID) : ''; $description = ($ID) ? get_the_content($ID) : ''; $title = ($ID) ? get_the_title($ID) : ''; $fields = [ 'type' => 'group', 'wrap' => 'details', 'label' => 'Edit File Meta', 'fields' => [ 'image-title' => [ 'type' => 'text', 'label' => 'File Title', 'value' => $title, 'data' => ['id' => $ID] ], 'poster' => [ 'type' => 'upload', 'label' => 'File Poster', 'multiple' => false, ], 'image-caption' => [ 'type' => 'textarea', 'value' => $caption, 'label' => 'File Caption', 'data' => ['id' => $ID] ], // 'image-description' => [ // 'type' => 'textarea', // 'value' => $description, // 'label' => 'File Description', // 'data' => ['id' => $ID] // ] ] ]; $out .= static::render('image_data', '', $fields); $out .= static::renderUploadItemMetaEnd(); if ($additionalFields) { $out .= static::additionalFields($additionalFields); } return $out; } public static function renderImagePreview(?int $ID = null, ?array $additionalFields = null, bool $isTemplate = false):string { $out = static::renderUploadItemStart($ID, $isTemplate); //add image preview if ($ID) { $out .= jvbFormatImage($ID, 'tiny', 'medium'); } else { $out .= '

'.jvbDashIcon('edit').'Edit Fields

'; foreach ($fields as $name => $config) { $out .= static::render($name, '', $config); } $out .= '

'; return $out; } protected static function renderUploadGroupAreaEnd(array $config, string $plural, string $singular):string { return sprintf( '

%s These will become individual %s %s

', jvbIcon('arrow-elbow-left-up'), $plural, jvbIcon('arrow-elbow-right-up'), $plural, $plural, $singular, jvbIcon('arrow-elbow-left-up'), $singular, jvbIcon('arrow-elbow-left-up') ); } protected static function getAllowedTypes(array $config): array { if (!empty($config['accepted'])) { return $config['accepted']; } $defaults = [ 'image' => ['image/*'], 'video' => ['video/*'], 'document' => ['application/pdf', 'application/msword', 'application/vnd.ms-excel', 'text/plain', '.odt','application/vnd.openxmlformats-officedocument.wordprocessingml.document'], ]; $defaults['any'] = array_merge(array_values($defaults)); return $defaults[$config['subtype']]??$defaults['image']; } protected static function getMaxFileSize(array $config):string { $defaults = [ 'image' => 5242880, // 5MB 'video' => 104857600, // 100MB 'document' => 10485760 // 10MB ]; return absint($config['max_size']??$defaults[$config['subtype']] ?? $defaults['image']); } protected static function formatFileSize(int $bytes):string { if ($bytes >= 1073741824) { return number_format($bytes / 1073741824, 1) . 'GB'; } if ($bytes >= 1048576) { return number_format($bytes / 1048576, 1) . 'MB'; } if ($bytes >= 1024) { return number_format($bytes / 1024, 1) . 'KB'; } return $bytes . 'B'; } protected static function getAcceptedTypesLabel(array $config):string { if (!array_key_exists('subtype', $config) || $config['subtype'] === 'timeline') { $config['subtype'] = 'image'; } $labels = [ 'image' => 'JPG, JPEG, PNG, GIF, or WEBP', 'video' => 'MP4, WEBM, or MOV', 'document'=> 'PDF, DOC, XLS, or TXT', 'any' => 'Images, Videos, or Documents' ]; return $labels[$config['subtype']] ?? strtoupper(implode(', ', array_map(function($ext) { return ltrim($ext, '.'); }, array_slice($config['accepted'], 0, 3)))); } protected static function parseIds(mixed $value):array { if (empty($value)) { return []; } if (is_string($value)) { $value = explode(',',$value); } return array_filter(array_map('absint', $value), function($item) { return $item > 0; }); } protected static function renderGallery(string $name, mixed $value, array $config): string { $config['multiple'] = true; return static::renderUpload($name,$value,$config); } protected static function renderSelector(string $name, mixed $value, array $config, string $extra =''):string { $ids = static::parseIds($value); if (!array_key_exists('subtype', $config) || !in_array($config['subtype'], ['taxonomy', 'content', 'user'])){ error_log('Invalid subtype for Selector: '.print_r($config['subtype']??false, true)); return ''; } $config = array_merge([ 'max' => $config['max']??0, 'search' => $config['search']??true, 'createNew' => $config['createNew']??false, 'autocomplete'=> $config['autocomplete']??true, 'name' => $name, 'update' => $config['update']??true, 'required' => $config['required']??false, 'type' => $config['subtype'], ], $config); $registrar = Registrar::getInstance($config[$config['subtype']]); $icon = jvbDefaultIcon(); if ($registrar){ $icon = $registrar->getIcon()??jvbDefaultIcon(); } $containerId = sprintf('%s-%s-selector', $name, $config['subtype']); $input = sprintf( '

%s%s', esc_attr($name), esc_attr(!empty($ids) ? implode(',', $ids) : ''), esc_attr($name), jvbIcon($icon), esc_html($config['label']), ); $input .= static::buildSelectorButton($ids, $config); if ($config['autocomplete']) { $input .= static::buildSelectorAutocomplete($name, $config); } $plural = static::getPlural($config); $input .= sprintf( '

', $plural[1]??'' ); $input .= '

'; //Close the first div.row.btw $config['type'] = 'selector'; unset($config['label']); unset($config['description']); unset($config['hint']); $config['skipInput'] = true; return static::fieldWrap($name, $input, $config); } protected static function getPlural(array $config):array { $single = $plural = ''; switch ($config['subtype']) { case 'taxonomy': $registrar = Registrar::getInstance($config['taxonomy']); if ($registrar) { $single = $registrar->getSingular(); $plural = $registrar->getPlural(); } else { $taxonomy = get_taxonomy($config['taxonomy']); if ($taxonomy) { $single = $taxonomy->labels->singular_name; $plural = $taxonomy->labels->name; } } break; case 'content': $registrar = Registrar::getInstance($config['content']); if ($registrar) { $single = $registrar->getSingular(); $plural = $registrar->getPlural(); } else { $postType = get_post_type_object($config['content']); if ($postType) { $single = $postType->labels->singular_name; $plural = $postType->labels->name; } } break; case 'user': $registrar = Registrar::getInstance($config['user']); if ($registrar) { $single = $registrar->getSingular(); $plural = $registrar->getPlural(); } else { $user = get_role($config['user']); if ($user) { $single = 'User'; $plural = 'Users'; } } break; } return [$single, $plural]; } protected static function buildSelectorButton(array $ids, array $config):string { switch ($config['subtype']) { case 'taxonomy': $registrar = Registrar::getInstance($config['taxonomy']); if ($registrar) { $single = $registrar->getSingular(); $plural = $registrar->getPlural(); } else { $taxonomy = get_taxonomy($config['taxonomy']); if (!$taxonomy) { return ''; } $single = $taxonomy->labels->singular_name; $plural = $taxonomy->labels->name; } $attr = sprintf( ' data-taxonomy="%s" data-single="%s" data-plural="%s"', $config['taxonomy'], $single, $plural ); break; case 'content': $registrar = Registrar::getInstance($config['content']); if ($registrar) { $single = $registrar->getSingular(); $plural = $registrar->getPlural(); } else { $postType = get_post_type_object($config['content']); if (!$postType) { return ''; } $single = $postType->labels->singular_name; $plural = $postType->labels->name; } $attr = sprintf( ' data-content="%s" data-single="%s" data-plural="%s"', $config['content'], $single, $plural ); break; case 'user': $registrar = Registrar::getInstance($config['user']); if ($registrar){ $single = $registrar->getSingular(); $plural = $registrar->getPlural(); } else { $user = get_role($config['user']); if (!$user) { return ''; } $single = 'User'; $plural = 'Users'; } $attr = sprintf( ' data-user="%s" data-single="%s" data-plural="%s"', $config['user'], $single, $plural ); break; } $dataAttrs = []; if ($config['update']) { $dataAttrs[] = 'data-update="false"'; } if ($config['max']>0) { $dataAttrs[] = 'data-max="'.esc_attr($config['max']).'"'; } if ($config['search']) { $dataAttrs[] = 'data-search'; } if ($config['createNew']) { $dataAttrs[] = 'data-creatable'; } if (array_key_exists('types', $config) && is_array($config['types'])) { $dataAttrs[] = 'data-for="'.esc_attr(implode(',',$config['types'])).'"'; } if (!empty($selected)) { $dataAttrs[] = 'data-selected="'.esc_attr(implode(',',$selected)).'"'; } if ($config['autocomplete']) { $dataAttrs[] = 'data-autocomplete'; } if (array_key_exists('hidden', $config) && $config['hidden']) { $dataAttrs[] = 'hidden'; } $dataAttrs = implode(' ',$dataAttrs); return sprintf( '', $attr, $dataAttrs, $single, $plural, jvbIcon('plus-square') ); } protected static function buildSelectorAutocomplete(string $name, array $config): string { return sprintf( ' ', esc_attr($name) ); } protected static function renderTaxonomy(string $name, mixed $value, array $config): string { $config['subtype'] = 'taxonomy'; return static::renderSelector($name, $value, $config); } protected static function renderUser(string $name, mixed $value, array $config): string { $config['subtype'] = 'user'; return static::renderSelector($name, $value, $config); } protected static function renderContent(string $name, mixed $value, array $config): string { $config['subtype'] = 'content'; return static::renderSelector($name, $value, $config); } protected static function renderLocation(string $name, mixed $value, array $config): string { $googleMaps = JVB()->connect('maps'); if (!$googleMaps->isSetUp()) { return '

Google Maps not configured. Please configure in Integrations settings.

'; } $field_id = esc_attr($name); $map_id = sprintf('%s_map', $field_id); $components = ['address', 'lat', 'lng', 'street', 'city', 'province', 'postal_code', 'country']; if (!empty($value)) { $lat = (float)$value['lat']??''; $lng = (float)$value['lng']??''; $coords = [ 'lat' => $lat, 'ng' => $lng ]; } else { $coords = null; } if (!array_key_exists('data', $config)) { $config['data'] =[]; } $js_config = [ 'fieldId' => $field_id, 'initialCoords' => $coords ]; $json_config = htmlspecialchars(json_encode($js_config), ENT_QUOTES, 'UTF-8'); $config['data']['location-field-init'] = $json_config; $input = ''; if (!empty($value) && array_key_exists('address', $value)) { $input = sprintf( '

Current location: %s

Search below to change:

', esc_html($value['address']) ); } $links = (!empty($value)) ? jvbLocationLinks($value) : ''; $input .= sprintf( '

', esc_attr($map_id), $links ); if (!empty($value)) { foreach($components as $el) { $input .= sprintf( '', esc_attr($name), $el, $value[$el]??'', $el ); } } $input .= '

'; return static::fieldWrap($name, $input, $config); } protected static function renderTagList(string $name, mixed $value, array $config):string { $tagFormat = $config['tag_format']??'first_field'; if (!array_key_exists('data', $config)) { $config['data']= []; } $config['data']['tag-format'] = esc_attr($tagFormat); $input = sprintf( '

%s

', esc_html($config['label']??'') ); foreach ($config['fields'] as $fieldName => $fieldConfig) { $newName = sprintf('new_%s', $fieldName); if (array_key_exists('required', $fieldConfig)) { $fieldConfig['data']['required'] = true; unset($fieldConfig['required']); } $fieldConfig['data']['ignore'] = true; $input .= static::render($newName, '', $fieldConfig); } $input .= sprintf( '', jvbIcon('plus'), $config['add_label']??'Add' ); //Tag Display $input .= '

'.static::renderTagItems($config['fields'], $value, $name, $tagFormat).'

'; //Template for tags $input .= sprintf( '', uniqid('tagListItem'), static::renderTagItem($config['fields'], [], $name, null, $tagFormat) ); $input .= '

'; unset($config['label']); return static::fieldWrap($name, $input, $config, true); } 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( '

%s', ($index !== null) ? ' data-index="'.$index.'"' : '', $tagText ); foreach ($fields as $fieldName => $fieldConfig) { $value = $values[$fieldName]??''; $fullName = ($index === null) ? $fieldName : sprintf('%s:%s:%s', $name, $index, $fieldName); $out .= sprintf( '', esc_attr($fullName), esc_attr($value), esc_attr($fieldName), esc_attr($fieldConfig['type']), esc_attr($fullName) ); } $out .= sprintf( '', jvbIcon('x') ); $out .='

'; return $out; } protected static function getTagDisplayText(array $fields, mixed $values, string $tagFormat):string { if (empty($values)) { return 'New Item'; } switch ($tagFormat) { case 'first_field': $firstKey = array_key_first($fields); return $values[$firstKey] ?? 'New Item'; case 'all_fields': $values = array_filter(array_values($values)); return implode(', ', $values) ?: 'New Item'; default: if (strpos($tagFormat, '{') !== false) { $text = $tagFormat; foreach ($values as $key => $value) { $text = str_replace('{'.$key.'}', $value, $text); } return $text; } return $values[$tagFormat]??'New Item'; } } protected static function renderRepeater(string $name, mixed $value, array $config): string { $fields = $config['fields'] ?? []; $rows = is_array($value) ? $value : []; if(array_key_exists('add_label', $config)) { $config['data']['label'] = esc_attr($config['add_label']); } $input = sprintf( '

%s

', esc_html($config['label'] ?? '') ); $input .= '

'; $rowTitle = array_key_exists('new_row', $config) ? $config['new_row'] : 'New Item'; if(!empty($rows)) { foreach ($rows as $index=>$row) { $input .= static::renderRepeaterRow($config['fields'], $row, $index, $name, $rowTitle); } } $input .= '

'; $input .= ''; $input .= sprintf( '', jvbIcon('plus', ['title'=>'Add']), 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 { $displayNumber = (is_string($index)) ? $index : ($index +1); $output = sprintf( '

%s #%s %s

', esc_attr($index), jvbIcon('trash'), is_string($index) ? ' open' : '', jvbIcon('dots-six-vertical'), $displayNumber, $rowTitle ); foreach ($fields as $fieldName => $fieldConfig) { $fieldValue = $values[$fieldName] ?? ''; $fullName = ($name === '') ? $fieldName : sprintf('%s:%s:%s', $name, $index, $fieldName); $output .= static::render($fullName, $fieldValue, $fieldConfig); } return $output.'

'; } /** * Group fields are mainly for ease of conditional logic and visual layout * @param string $name * @param mixed $value * @param array $config * @return string */ protected static function renderGroup(string $name, mixed $value, array $config): string { $fields = $config['fields'] ?? []; $values = is_array($value) ? $value : []; $wrapper = (array_key_exists('wrap', $config) && $config['wrap'] === 'details') ? 'details' : 'fieldset'; $legend = (array_key_exists('wrap', $config) && $config['wrap'] === 'details') ? 'summary' : 'legend'; $output = sprintf( '<%s><%s>%s' , esc_attr($wrapper), esc_attr($legend), array_key_exists('label', $config) ? $config['label'] : 'Group', esc_attr($legend) ); foreach ($fields as $fieldName => $fieldConfig) { $fieldValue = $values[$fieldName] ?? ''; $fullName = array_key_exists('wrap', $config) ? $fieldName : "{$name}:{$fieldName}"; $output .= static::render($fullName, $fieldValue, $fieldConfig); } $output .= sprintf('', esc_attr($wrapper)); unset($config['label']); return static::fieldWrap($name, $output, $config); } public static function outputSelectorModal():string { return sprintf(' ', str_replace('class="search-container', 'class="open search-container', static::search('Search terms', 'search-terms')), jvbModalActions(), jvbIcon('plus-square'), jvbIcon('x') ); } public static function search(string $placeholder = 'Search...', string $id = 'search', string $label = '', string $buttonText = '',bool $buttonInside = false, bool $hideSearch = false):string { $id = sanitize_title($id); $label = empty($label) ? '' : sprintf( '

%s

', $label ); $buttonText = empty($buttonText) ? '' : sprintf( '%s', $buttonText ); $hideSearch = $hideSearch ? ' hidden' : ''; return sprintf( '%s

', $label, $buttonInside ? ' insideButton' : '', $id, $placeholder, $hideSearch, jvbIcon('x', ['title' => 'Clear Search']), jvbIcon('magnifying-glass'), $buttonText ); } }

' . esc_html($options['heading']) . '

%s

New %s

%s

%s

%s