Files
powerservice/wp-content/plugins/contact-form-7/includes/swv/swv.php
T
2026-10-19 12:45:45 -06:00

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();
}
}