209 lines
5.2 KiB
PHP
209 lines
5.2 KiB
PHP
<?php
|
|
/**
|
|
* Schema-Woven Validation API
|
|
*/
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
|
|
|
|
use RockLobsterInc\Swv\{ AbstractRule, CompositeRule };
|
|
use RockLobsterInc\Swv\{ InvalidityException as Invalidity };
|
|
use RockLobsterInc\FormDataTree\{ FormDataTreeInterface as FormDataTree };
|
|
|
|
|
|
/**
|
|
* Returns an associative array of SWV rules.
|
|
*/
|
|
function wpcf7_swv_available_rules() {
|
|
$rules = array(
|
|
'all' => '\RockLobsterInc\Swv\Rules\AllRule',
|
|
'any' => '\RockLobsterInc\Swv\Rules\AnyRule',
|
|
'date' => '\RockLobsterInc\Swv\Rules\DateRule',
|
|
'dayofweek' => '\RockLobsterInc\Swv\Rules\DayofweekRule',
|
|
'email' => '\RockLobsterInc\Swv\Rules\EmailRule',
|
|
'enum' => '\RockLobsterInc\Swv\Rules\EnumRule',
|
|
'file' => '\RockLobsterInc\Swv\Rules\FileRule',
|
|
'maxdate' => '\RockLobsterInc\Swv\Rules\MaxDateRule',
|
|
'maxfilesize' => '\RockLobsterInc\Swv\Rules\MaxFilesizeRule',
|
|
'maxitems' => '\RockLobsterInc\Swv\Rules\MaxItemsRule',
|
|
'maxlength' => '\RockLobsterInc\Swv\Rules\MaxLengthRule',
|
|
'maxnumber' => '\RockLobsterInc\Swv\Rules\MaxNumberRule',
|
|
'mindate' => '\RockLobsterInc\Swv\Rules\MinDateRule',
|
|
'minfilesize' => '\RockLobsterInc\Swv\Rules\MinFilesizeRule',
|
|
'minitems' => '\RockLobsterInc\Swv\Rules\MinItemsRule',
|
|
'minlength' => '\RockLobsterInc\Swv\Rules\MinLengthRule',
|
|
'minnumber' => '\RockLobsterInc\Swv\Rules\MinNumberRule',
|
|
'number' => '\RockLobsterInc\Swv\Rules\NumberRule',
|
|
'required' => '\RockLobsterInc\Swv\Rules\RequiredRule',
|
|
'requiredfile' => '\RockLobsterInc\Swv\Rules\RequiredFileRule',
|
|
'stepnumber' => '\RockLobsterInc\Swv\Rules\StepNumberRule',
|
|
'tel' => '\RockLobsterInc\Swv\Rules\TelRule',
|
|
'time' => '\RockLobsterInc\Swv\Rules\TimeRule',
|
|
'url' => '\RockLobsterInc\Swv\Rules\UrlRule',
|
|
);
|
|
|
|
return apply_filters( 'wpcf7_swv_available_rules', $rules );
|
|
}
|
|
|
|
|
|
/**
|
|
* Creates an SWV rule object.
|
|
*
|
|
* @param string $rule_name Rule name.
|
|
* @param string|array $properties Optional. Rule properties.
|
|
* @return AbstractRule|null The rule object, or null if it failed.
|
|
*/
|
|
function wpcf7_swv_create_rule( $rule_name, $properties = '' ) {
|
|
$properties = wp_parse_args( $properties );
|
|
|
|
$rules = wpcf7_swv_available_rules();
|
|
|
|
if ( isset( $rules[$rule_name] ) and class_exists( $rules[$rule_name] ) ) {
|
|
return new $rules[$rule_name]( $properties );
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns an associative array of JSON Schema for Contact Form 7 SWV.
|
|
*/
|
|
function wpcf7_swv_get_meta_schema() {
|
|
return array(
|
|
'$schema' => 'https://json-schema.org/draft/2020-12/schema',
|
|
'title' => 'Contact Form 7 SWV',
|
|
'description' => 'Contact Form 7 SWV meta-schema',
|
|
'type' => 'object',
|
|
'properties' => array(
|
|
'version' => array(
|
|
'type' => 'string',
|
|
),
|
|
'locale' => array(
|
|
'type' => 'string',
|
|
),
|
|
'rules' => array(
|
|
'type' => 'array',
|
|
'items' => array(
|
|
'type' => 'object',
|
|
'properties' => array(
|
|
'rule' => array(
|
|
'type' => 'string',
|
|
'enum' => array_keys( wpcf7_swv_available_rules() ),
|
|
),
|
|
'field' => array(
|
|
'type' => 'string',
|
|
'pattern' => '^[A-Za-z][-A-Za-z0-9_:]*$',
|
|
),
|
|
'error' => array(
|
|
'type' => 'string',
|
|
),
|
|
'accept' => array(
|
|
'type' => 'array',
|
|
'items' => array(
|
|
'type' => 'string',
|
|
),
|
|
),
|
|
'base' => array(
|
|
'type' => 'string',
|
|
),
|
|
'interval' => array(
|
|
'type' => 'number',
|
|
'minimum' => 0,
|
|
),
|
|
'threshold' => array(
|
|
'type' => 'string',
|
|
),
|
|
),
|
|
'required' => array( 'rule' ),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
}
|
|
|
|
|
|
/**
|
|
* The schema class as a composite rule.
|
|
*/
|
|
final class WPCF7_SWV_Schema extends CompositeRule {
|
|
|
|
/**
|
|
* The human-readable version of the schema.
|
|
*/
|
|
const version = 'SWV Core 2026-09-20';
|
|
|
|
|
|
/**
|
|
* Rule properties.
|
|
*/
|
|
public readonly string $locale;
|
|
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @param array $properties Rule properties.
|
|
*/
|
|
public function __construct( array $properties = [] ) {
|
|
$this->locale = $properties[ 'locale' ] ?? '';
|
|
}
|
|
|
|
|
|
/**
|
|
* Validates the form data according to the logic defined by this rule.
|
|
*
|
|
* @param FormDataTree $form_data Form data.
|
|
* @param array $context Optional context.
|
|
*/
|
|
public function validate( FormDataTree $form_data, array $context = [] ) {
|
|
foreach ( $this->rules() as $rule ) {
|
|
if ( $rule->matches( $context ) ) {
|
|
try {
|
|
$rule->validate( $form_data, $context );
|
|
} catch ( Invalidity $error ) {
|
|
yield new WP_Error( 'swv', $error->getMessage(), $error );
|
|
}
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns an array that represents the rule properties.
|
|
*
|
|
* @return array Array of rule properties.
|
|
*/
|
|
public function toArray(): array {
|
|
$rules_arrays = array_map( static function ( $item ) {
|
|
return $item->toArray();
|
|
}, $this->rules() );
|
|
|
|
return array(
|
|
'version' => self::version,
|
|
'locale' => $this->locale,
|
|
'rules' => $rules_arrays,
|
|
);
|
|
}
|
|
|
|
|
|
/**
|
|
* Wrapper function for addRule.
|
|
*
|
|
* @param AbstractRule $rule Sub-rule to be added.
|
|
*/
|
|
public function add_rule( AbstractRule $rule ) {
|
|
return $this->addRule( $rule );
|
|
}
|
|
|
|
|
|
/**
|
|
* Wrapper function for toArray.
|
|
*
|
|
* @return array Array of rule properties.
|
|
*/
|
|
public function to_array() {
|
|
return $this->toArray();
|
|
}
|
|
|
|
}
|