format('Y-m-d') === $value ? $value : ''; } /** * Normalize a scalar or array of selected values. * * @param mixed $raw_values Raw request value. * @return string[] */ function normalize_values($raw_values) { $raw_values = is_array($raw_values) ? $raw_values : [$raw_values]; $values = []; foreach (array_slice($raw_values, 0, MAX_VALUES_PER_FILTER) as $raw_value) { $value = normalize_text_value($raw_value, MAX_VALUE_LENGTH); if ($value === '' || in_array($value, $values, true)) { continue; } $values[] = $value; } return $values; } /** * Normalize one short scalar request value. * * @param mixed $value Raw request value. * @param int $max_length Maximum length. * @return string */ function normalize_text_value($value, $max_length) { if (!is_scalar($value)) { return ''; } $value = trim(sanitize_text_field((string) $value)); return function_exists('mb_substr') ? mb_substr($value, 0, $max_length) : substr($value, 0, $max_length); } /** Preserve other query instances, pagination, and routing on native GET forms. */ function preserved_request($request, $query_id, $configuration = []) { $request = is_array($request) ? $request : []; if (isset($request[REQUEST_NAMESPACE]) && is_array($request[REQUEST_NAMESPACE])) { unset($request[REQUEST_NAMESPACE][absint($query_id)]); if (!$request[REQUEST_NAMESPACE]) { unset($request[REQUEST_NAMESPACE]); } } else { unset($request[REQUEST_NAMESPACE]); } $prefix = request_prefix($query_id); $owned = array_keys(native_parameter_aliases($configuration)); foreach (array_keys($request) as $key) { if (is_string($key) && (str_starts_with($key, $prefix) || in_array($key, $owned, true))) { unset($request[$key]); } } return $request; } /** Flatten bounded fields for hidden GET inputs; escaping belongs to the view. */ function preserved_fields($request, $query_id, $configuration = []) { $fields = []; $walk = function ($values, $prefix = '', $depth = 0) use (&$walk, &$fields) { if ($depth > 5 || !is_array($values)) { return; } foreach ($values as $key => $value) { if (count($fields) >= 100) { return; } $name = $prefix === '' ? (string) $key : $prefix . '[' . $key . ']'; if (strlen($name) > 240) { continue; } if (is_array($value)) { $walk($value, $name, $depth + 1); } elseif (is_scalar($value)) { $fields[] = ['name' => $name, 'value' => substr((string) $value, 0, 2000)]; } } }; $walk(preserved_request($request, $query_id, $configuration)); return $fields; } /** Build a same-site reset link, also usable without frontend JavaScript. */ function reset_url($request, $query_id, $configuration = []) { $home = wp_parse_url(home_url()); $path = wp_parse_url(sanitize_url(wp_unslash($_SERVER['REQUEST_URI'] ?? '/')), PHP_URL_PATH); $origin = $home['scheme'] . '://' . $home['host'] . (isset($home['port']) ? ':' . $home['port'] : ''); return add_query_arg(preserved_request($request, $query_id, $configuration), $origin . '/' . ltrim($path ?: '/', '/')); } /** Successful fields for one control; range state must not emit scalar aliases. */ function native_parameter_suffixes($control) { if (($control['kind'] ?? '') === 'number') return ['min', 'max']; if (($control['kind'] ?? '') === 'date' && ($control['settings']['selection'] ?? '') === 'range') return ['from', 'to']; return in_array($control['kind'] ?? '', ['apply', 'reset'], true) ? [] : ['value']; } /** Public keys follow core Query's scope; block UUIDs remain internal. */ function native_generated_parameter_names($configuration) { $query_id = absint($configuration['queryId'] ?? 0); if (!$query_id) return []; $proposed = $reserved = []; foreach ($configuration['nativeControls'] ?? [] as $control) { $id = $control['controlId'] ?? ''; if (!is_string($id) || !preg_match('/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/', $id)) continue; $kind = $control['kind'] ?? ''; $source = $control['sourceId'] ?? ''; $base = ''; if (in_array($kind, ['choice', 'number', 'date'], true) && is_string($source) && preg_match('/^(taxonomy|meta|acf):([a-z0-9_-]+)$/', $source, $parts)) { $base = ['taxonomy' => 'taxQuery', 'meta' => 'metaQuery', 'acf' => 'acfQuery'][$parts[1]] . '-' . $parts[2]; } elseif ($kind === 'choice') { $base = ['post:author' => 'author', 'post:post_type' => 'postType'][$source] ?? 'choice'; } elseif ($kind === 'date') { $base = $source === 'post:modified' ? 'dateModified' : 'date'; } elseif (in_array($kind, ['search', 'sort', 'number'], true)) $base = $kind; if ($base === '') continue; $suffixes = native_parameter_suffixes($control); $base = request_prefix($query_id) . $base; $proposed[$id] = ['base' => $base, 'suffixes' => $suffixes]; foreach ($suffixes as $suffix) $reserved[$base . ($suffix === 'value' ? '' : '-' . $suffix)] = true; } $names = $claimed = []; foreach ($proposed as $id => $item) { $number = 1; do { $base = $item['base'] . ($number === 1 ? '' : '-' . $number); $fields = []; foreach ($item['suffixes'] as $suffix) $fields[$suffix] = $base . ($suffix === 'value' ? '' : '-' . $suffix); $collision = false; foreach ($fields as $field) { // Reserve natural source names before assigning duplicate numbers: // category-2 must never be confused with a second category control. if (isset($claimed[$field]) || ($number > 1 && isset($reserved[$field]))) { $collision = true; break; } } $number++; } while ($collision); $names[$id] = $fields; foreach ($fields as $field) $claimed[$field] = true; } return $names; } /** Resolve optional names independently of source and style; unsafe names fall back. */ function native_parameter_names($configuration) { $names = native_generated_parameter_names($configuration); $counts = []; foreach ($configuration['nativeControls'] ?? [] as $control) { $alias = $control['urlParameter'] ?? ''; if (!valid_url_parameter($alias) || empty($names[$control['controlId'] ?? ''])) continue; foreach (array_unique(array_merge([$alias], url_parameter_fields($control))) as $key) $counts[$key] = ($counts[$key] ?? 0) + 1; } foreach ($configuration['nativeControls'] ?? [] as $control) { $id = $control['controlId'] ?? ''; $alias = $control['urlParameter'] ?? ''; if (!valid_url_parameter($alias) || empty($names[$id])) continue; $keys = array_unique(array_merge([$alias], url_parameter_fields($control))); $blocked = false; foreach ($keys as $key) if (!valid_url_parameter($key) || ($counts[$key] ?? 0) > 1 || url_parameter_blocked($key, $configuration['queryId'], $id)) $blocked = true; if ($blocked) continue; foreach (native_parameter_suffixes($control) as $suffix) $names[$id][$suffix] = $alias . ($suffix === 'value' ? '' : '-' . $suffix); } return $names; } /** Canonical custom key => supported generated key, for client ownership/history. */ function native_parameter_aliases($configuration) { $generated = native_generated_parameter_names($configuration); $aliases = []; foreach (native_parameter_names($configuration) as $id => $fields) { foreach ($fields as $suffix => $key) if ($key !== $generated[$id][$suffix]) $aliases[$key] = $generated[$id][$suffix]; } return $aliases; } function native_parameter_name($configuration, $control_id, $suffix = 'value') { return native_parameter_names($configuration)[$control_id][$suffix] ?? ''; }