render($name, $value, $config, $showHidden, true);
}
public function render(string $name, mixed $value, array $config, bool $showHidden = false, bool $return = false): mixed
{
$out = '';
if (jvbCheck('hidden', $config) && !$showHidden) {
return $out;
}
if (!array_key_exists('type', $config)) {
return $out;
}
if (!$value) {
$value = $this->getDefaultValue($config['type']);
}
// Handle hidden display type
if (array_key_exists('display', $config) && $config['display'] === 'hidden') {
$out = '';
if (!$return) {
echo $out;
}
return $out;
}
ob_start();
// Try custom function overrides first
$type = array_map('ucfirst', explode('_', $config['type']));
$type = implode('', $type);
$method = 'render' . $type . 'Field';
$nameTemp = implode('', array_map('ucfirst', explode('_', $name)));
$nameMethod = 'render' . $nameTemp . 'Field';
if (function_exists($nameMethod)) {
call_user_func($nameMethod, $value, $config);
} elseif (function_exists($method)) {
call_user_func($method, $value, $config);
} elseif (method_exists($this, $method)) {
$this->$method($name, $value, $config);
}
$out = ob_get_clean();
do_action('jvbRenderFormField', $name, $config, $value);
$out = apply_filters('jvbFilterRenderFormField', $out, $name, $config, $value);
if (!$return) {
echo $out;
}
return $out;
}
public function getDefaultValue(string $type):mixed {
if (!$this->type_manager) {
$this->type_manager = new MetaTypeManager();
}
return match ($this->type_manager->getMetaType($type)) {
'object', 'array' => [],
'boolean' => false,
'integer' => 0,
default => '',
};
}
/* ========== HELPER METHODS ========== */
/**
* Prepare common field data
*/
protected function prepareFieldData(string $name, mixed $value, array $field): array
{
return [
'name' => array_key_exists('group', $field) ? $field['group'] . '::' . $name : $name,
'value' => isset($field['value']) ? $field['value'] : $value,
'id' => (array_key_exists('base', $field) ? esc_attr($field['base']) : '') . esc_attr($name),
];
}
/**
* Build common HTML attributes for inputs
*/
protected function buildInputAttributes(string $name, array $field): string
{
$attrs = [];
// Conditional rendering
if (array_key_exists('condition', $field)) {
$attrs['conditional'] = $this->handleConditionalField($field);
}
// Accessibility
if (!empty($field['description'])) {
$attrs['aria-describedby'] = $name . '-help';
}
// Common attributes
$common = ['placeholder', 'autocomplete', 'pattern', 'minlength', 'maxlength', 'min', 'max', 'step'];
foreach ($common as $attr) {
if (array_key_exists($attr, $field)) {
$attrs[$attr] = $field[$attr];
}
}
// Required
if (!empty($field['required'])) {
$attrs['required'] = true;
}
// Build attribute string
$attrString = '';
foreach ($attrs as $key => $val) {
if ($key === 'conditional') {
$attrString .= ' ' . $val; // Already formatted
} elseif ($val === true) {
$attrString .= ' ' . $key;
} else {
$attrString .= ' ' . $key . '="' . esc_attr($val) . '"';
}
}
return $attrString;
}
/**
* Build validation data attributes
*/
protected function buildValidationAttributes(array $field): string
{
$attrs = [];
if (!empty($field['pattern'])) {
$attrs['data-pattern'] = $field['pattern'];
}
if (!empty($field['validate'])) {
$attrs['data-validate'] = $field['validate'];
}
if (isset($field['min'])) {
$attrs['data-min'] = $field['min'];
}
if (isset($field['max'])) {
$attrs['data-max'] = $field['max'];
}
if (isset($field['minlength'])) {
$attrs['data-minlength'] = $field['minlength'];
}
if (isset($field['maxlength'])) {
$attrs['data-maxlength'] = $field['maxlength'];
}
if (!empty($field['validation_message'])) {
$attrs['data-validation-message'] = $field['validation_message'];
}
$attrs['data-type'] = $field['type'];
$attrString = '';
foreach ($attrs as $key => $val) {
$attrString .= ' ' . $key . '="' . esc_attr($val) . '"';
}
return $attrString;
}
/* ========== GENERIC FIELD WRAPPER ========== */
/**
* Render a standard input field with validation wrapper
*/
protected function renderStandardInput(string $name, mixed $value, array $field, string $inputType = 'text'): void
{
$data = $this->prepareFieldData($name, $value, $field);
$inputAttrs = $this->buildInputAttributes($name, $field);
$validationAttrs = $this->buildValidationAttributes($field);
$conditional = array_key_exists('condition', $field) ? $this->handleConditionalField($field) : '';
$customData = '';
if (array_key_exists('data', $field) && !empty($field['data'])) {
foreach ($field['data'] as $key => $v) {
$customData .= ($v === '') ? ' data-' . $key : ' data-' . $key . '="' . $v . '"';
}
}
?>
data-field=""
>
renderLabel($name, $field); ?>
>
renderHintAndDescription($field, $name); ?>
renderStandardInput($name, $value, $field, $field['subtype'] ?? 'text');
}
public function renderEmailField(string $name, mixed $value, array $field): void
{
$field['validate'] = 'email'; // Auto-add email validation
$this->renderStandardInput($name, $value, $field, 'email');
}
private function renderUrlField(string $name, mixed $value, array $field): void
{
$field['validate'] = 'url'; // Auto-add URL validation
$this->renderStandardInput($name, $value, $field, 'url');
}
private function renderTelField(string $name, mixed $value, array $field): void
{
$field['validate'] = 'phone'; // Auto-add phone validation
$this->renderStandardInput($name, $value, $field, 'tel');
}
private function renderDateField(string $name, mixed $value, array $field): void
{
$format = !empty($field['format']) ? $field['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
}
}
$this->renderStandardInput($name, $value, $field, 'date');
}
private function renderTimeField(string $name, mixed $value, array $field): void
{
$this->renderStandardInput($name, $value, $field, 'time');
}
private function renderDatetimeField(string $name, mixed $value, array $field): void
{
$this->renderStandardInput($name, $value, $field, 'datetime-local');
}
/* ========== TEXTAREA FIELD ========== */
public function renderTextareaField(string $name, mixed $value, array $field): void
{
$data = $this->prepareFieldData($name, $value, $field);
$inputAttrs = $this->buildInputAttributes($name, $field);
$validationAttrs = $this->buildValidationAttributes($field);
$conditional = array_key_exists('condition', $field) ? $this->handleConditionalField($field) : '';
$rows = isset($field['rows']) ? (int)$field['rows'] : 4;
$quill = (array_key_exists('quill', $field) && $field['quill'] == true) ? ' data-editor="true"' : '';
if ($quill !== '') {
$allowImages = array_key_exists('allowImage', $field);
$quill .= ($allowImages) ? ' data-allowimage="true"' : ' data-allowimage="false"';
}
// Handle array values
if (is_array($value)) {
$value = implode(', ', $value);
}
?>
data-field=""
>
renderLabel($name, $field); ?>
renderHintAndDescription($field, $name); ?>
data-field=""
>
renderLabel($name, $field); ?>
>
>
renderHintAndDescription($field, $name); ?>
data-field=""
>
renderLabel($name, $field); ?>
renderHintAndDescription($field, $name); ?>
data-field=""
>
renderHintAndDescription($field, $name); ?>
prepareFieldData($name, $value, $field);
$validationAttrs = $this->buildValidationAttributes($field);
$conditional = array_key_exists('condition', $field) ? $this->handleConditionalField($field) : '';
if (!is_array($value)) {
$value = !empty($value) ? [$value] : [];
}
?>
data-field=""
>
renderHintAndDescription($field, $name); ?>
prepareFieldData($name, $value, $field);
$validationAttrs = $this->buildValidationAttributes($field);
$conditional = array_key_exists('condition', $field) ? $this->handleConditionalField($field) : '';
$describedBy = (!empty($field['description'])) ? ' aria-describedby="' . $name . '-help"' : '';
?>
data-field=""
>
renderHintAndDescription($field, $name); ?>
>
$row) {
$this->renderRepeaterRow($field['fields'], $row, $index, $name, $rowTitle);
}
}
?>
renderRepeaterRow($field['fields'], array(), '', '', $rowTitle); ?>
renderHint($field['hint']); } ?>
renderDescription($field['description'], $name); } ?>
>
$field) :
if ($base_name === '') {
$field_name = $slug;
} else {
$field_name = sprintf('%s:%s:%s', $base_name, $index, $slug);
}
$field_value = isset($values[$slug]) ? $values[$slug] : '';
$name = $field_name;
$this->render($name, $field_value, $field);
endforeach;
?>
$field) {
if (in_array($field['type'], ['text', 'textarea']) &&
isset($values[$slug]) &&
!empty($values[$slug])) {
return $values[$slug];
}
}
return $rowTitle;
}
/* ========== GROUP FIELD ========== */
protected function renderGroupField(string $name, mixed $value, array $field): void
{
if (!array_key_exists('fields', $field) || empty($field['fields'])) {
error_log('No fields to render');
return;
}
$values = is_array($value) ? $value : [];
$original = $name;
if (array_key_exists('group', $field)) {
$name = $field['group'] . '::' . $name;
}
$hidden = (array_key_exists('mode', $field) && $field['mode'] === 'hidden');
if ($hidden) {
// Simplified render for hidden groups
$this->renderGroupFields($name, $values, $field);
return;
}
// Standard fieldset render
$conditional = $this->handleConditionalField($field);
$validationAttrs = $this->buildValidationAttributes($field);
$describedBy = (!empty($field['description'])) ? ' aria-describedby="' . $name . '-help"' : '';
$fieldset = (array_key_exists('wrap', $field) && $field['wrap'] === 'details') ? 'details' : 'fieldset';
$legend = (array_key_exists('wrap', $field) && $field['wrap'] === 'details') ? 'summary' : 'legend';
?>
< class="field group "
data-field=""
>
<>>
renderHintAndDescription($field, $name); ?>
renderGroupFields($name, $values, $field); ?>
>
$config) {
// Set the group context for proper field naming
$config['group'] = $groupName;
// Get the value for this specific field
$field_value = $values[$field_name] ?? '';
// Handle conditional fields within the group
if (isset($config['condition'])) {
$condition_field = $config['condition']['field'];
if (!str_contains($condition_field, '::')) {
$config['condition']['field'] = $groupName . '::' . $condition_field;
}
}
$this->render($field_name, $field_value, $config);
}
}
/* ========== UPLOAD FIELD ========== */
private function renderGalleryField(string $name, mixed $value, array $field):void
{
$field['multiple'] = true;
$this->renderUploadField($name, $value, $field);
}
private function renderUploadField(string $name, mixed $value, array $field): void
{
$defaultConfig = [
//File Type
'subtype' => 'image', // 'image', 'video', 'document', 'any'
'accepted_types' => null, // null = use subtype defaults, or array of specific MIME types
//Upload Behaviour
'multiple' => false, // Single or multiple uploads
'limit' => 0, // Max number of uploads (0 = unlimited)
'mode' => 'direct', // 'direct' or 'selection'
//Destination
'destination' => 'meta', // 'meta', 'post', 'post_group'
//Processing Options
'max_size' => null, // Override default size limits
'convert' => 'webp', // Image conversion format
'quality' => 80, // Conversion quality
'create_thumbnails' => true,
];
$config = array_merge($defaultConfig, $field);
// 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;
}
// Get accepted types
$acceptedTypes = $this->getAllowedTypes($config);
// Build accept attribute for input
$acceptExtensions = $this->getMimeExtensions($acceptedTypes);
$acceptAttr = implode(',', $acceptExtensions);
// Determine field attributes
$subtype = $config['subtype'] ?? 'image';
$multiple = $config['multiple'] ?? false;
$limit = $config['limit'] ?? 0;
$mode = $config['mode'] ?? 'direct';
$destination = $config['destination'];
// Get existing attachments
$attachmentIds = $this->parseAttachmentIds($value);
// Determine field type for UI
$fieldType = $multiple ? 'gallery' : 'single';
// Build data attributes
$dataAttrs = [
'data-field' => $name,
'data-upload-field' => '',
'data-mode' => $mode,
'data-type' => $fieldType,
'data-subtype' => $subtype,
'data-destination' => $destination,
];
if (!empty($field['content'])) {
$dataAttrs['data-content'] = $field['content'];
}
if ($limit > 0) {
$dataAttrs['data-limit'] = $limit;
}
// Build data attributes
$conditional = $this->handleConditionalField($field);
$describedBy = !empty($field['description']) ? ' aria-describedby="' . esc_attr($name) . '-help"' : '';
if (!empty($field['group'])) {
$name = $field['group'] . '::' . $name;
}
// Convert data attributes to string
$dataAttrString = '';
foreach ($dataAttrs as $attr => $val) {
$dataAttrString .= ' ' . $attr . ($val !== '' ? '="' . esc_attr($val) . '"' : '');
}
?>
>
>
Click to upload or drag and drop
getAcceptedTypesLabel($subtype, $acceptExtensions)) ?>
(max. formatFileSize($this->getMaxFileSize($subtype))) ?>)
You can group images to create separate .
If a has multiple images, you can select the to set an image as the main one.
Processing files...
0/0'); ?>
renderExistingAttachment($attachmentId, $subtype);
}
?>
These will become individual
>
>
Edit Info
[
'type' => 'group',
'wrap' => 'details',
'label' => 'Image Info',
'hint' => 'These will be automatically generated if left blank.',
'fields' => [
'image-title'.$addID => [
'type' => 'text',
'label' => 'Image Title',
'value' => $title,
'data' => $dataID
],
'image-alt-text'.$addID => [
'type' => 'text',
'label' => 'Alt Text',
'value' => $alt,
'hint' => 'Alt text helps the visually impaired, as well as some benefits for SEO.',
'data' => $dataID
],
'image-caption'.$addID => [
'type' => 'textarea',
'value' => $caption,
'label' => 'Image Caption',
'data' => $dataID
]
]
]
], $fields);
$meta = new MetaManager($id);
foreach ($fields as $field => $config) {
$meta->render('form', $field, $config);
}
?>
>
';
Edit Info
[
'type' => 'group',
'wrap' => 'details',
'label' => 'Video Info',
'hint' => 'These will be automatically generated if left blank.',
'fields' => [
'title' => [
'type' => 'text',
'label' => 'Video Title',
'value' => $title,
'data' => $dataID
],
'caption' => [
'type' => 'textarea',
'value' => $caption,
'label' => 'Video Caption',
'data' => $dataID
],
'description' => [
'type' => 'textarea',
'value' => $description,
'label' => 'Video Description',
'data' => $dataID
]
]
]
], $fields);
$this->render('upload_data', null, $fields);
?>
>
';
Edit Info
[
'type' => 'group',
'wrap' => 'details',
'label' => 'File Info',
'hint' => 'These will be automatically generated if left blank.',
'fields' => [
'title' => [
'type' => 'text',
'label' => 'File Title',
'value' => $title,
'data' => $dataID
],
'caption' => [
'type' => 'textarea',
'value' => $caption,
'label' => 'File Caption',
'data' => $dataID
],
'description' => [
'type' => 'textarea',
'value' => $description,
'label' => 'File Description',
'data' => $dataID
]
]
]
], $fields);
$this->render('upload_data', null, $fields);
?>
data-field=""
>
render($selected) ?>
=""
value=""
>
renderHintAndDescription($field, $name); ?>
connect('maps');
if (!$googleMaps->isSetUp()) {
echo 'Google Maps not configured. Please configure in Integrations settings.
>
Current location: '.esc_html($stored_data['street']).'';
echo '
Search below to change:
';
}
?>
renderHint($field['hint']); } ?>
renderDescription($field['description'], $name); } ?>
%s
',
esc_attr($name),
$content
);
}
/* ========== UTILITY METHODS ========== */
private function handleConditionalField(array $field):string
{
if (empty($field['condition'])) {
return '';
}
$condition = $field['condition'];
return sprintf(
'data-depends-on="%s" data-depends-value="%s" data-depends-operator="%s"',
esc_attr($field['condition']['field']),
esc_attr($field['condition']['value']),
esc_attr($field['condition']['operator'] ?? '==')
);
}
protected function getAllowedTypes(array $config): array
{
if (!empty($config['accepted_types'])) {
return $config['accepted_types'];
}
// Default types based on subtype
$defaults = [
'image' => ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],
'video' => ['video/mp4', 'video/webm', 'video/ogg'],
'document' => ['application/pdf', 'application/msword', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'],
'any' => ['image/*', 'video/*', 'application/pdf']
];
return $defaults[$config['subtype']] ?? $defaults['image'];
}
protected function getMimeExtensions(array $mimeTypes): array
{
$extensions = [];
foreach ($mimeTypes as $mime) {
if (str_contains($mime, '*')) {
continue; // Skip wildcards
}
$ext = str_replace(['image/', 'video/', 'application/'], '', $mime);
$extensions[] = '.' . $ext;
}
return $extensions;
}
protected function parseAttachmentIds(mixed $value): array
{
if (empty($value)) {
return [];
}
if (is_array($value)) {
return array_filter($value, 'is_numeric');
}
if (is_string($value)) {
return array_filter(explode(',', $value), 'is_numeric');
}
return is_numeric($value) ? [$value] : [];
}
/**
* Render tag list field - inline tag input interface
*/
protected function renderTagListField(string $name, mixed $value, array $field): void
{
$values = is_array($value) ? $value : [];
$conditional = $this->handleConditionalField($field);
$validationAttrs = $this->buildValidationAttributes($field);
if (array_key_exists('group', $field)) {
$name = $field['group'] . '::' . $name;
}
$describedBy = (!empty($field['description'])) ? ' aria-describedby="' . $name . '-help"' : '';
// Tag display format - defaults to first field value
$tagFormat = $field['tag_format'] ?? 'first_field';
?>
>
$subfield_config): ?>
render($input_name, '', $subfield_config, false, false);
?>
$item_data): ?>
renderTagItem($field['fields'], $item_data, $index, $name, $tagFormat); ?>
renderTagItem($field['fields'], [], '', $name, $tagFormat); ?>
renderHint($field['hint']); ?>
renderDescription($field['description'], $name); ?>
$field_config): ?>
$value) {
$text = str_replace('{' . $key . '}', $value, $text);
}
return $text;
}
// Use specific field name
return $data[$format] ?? 'New Item';
}
}
}