JFIF $ d d 7 * Z qn )ZP 0 !1 A "#a$2Qr D8 a Ri [f \m I ykI w0 c u F c Rı?lO7 к _f˓ [C $殷WF< _W ԣ s Kc ëI zyQy /_LK ℂ ;C",p F A : /] =H ~ , l s / 9 ć: [=/#f ; ) x { ٛE Q )~ = 𘙲r*2~ a _V = ' ku m F D } KYYC )( { * g& f `툪 r y ` = ^ c J. I ]( * `wq 1dđ #̩ ͑ 0 ; H ] u 搂 @:~ ו K L N s h } O I R* 8 :2 ! lD JV o ( 3 = M ( z Ȱ+i *N A r6K n S l ) ! J J Ӂ* % ݉?|D } d5: eP0 R; {$X' x F @ .ÊB {,WJ uQ ɲRI ;9 Q E琯 6 2fT .DU J ;*c P A\IL Nj! J ۱+ O\ ͔ ] ޒ S J ȧ c%A N ol ՎprU L Zԛe r E2= X D Xg VQeӓ k y P7 U* o m Q I s ,K `) 6\G3t?pgjr m ۛجw luGt f h 9uyP 0D;Uڽ"OXl i f $ ) &|ML 0 Z rm1 [ H XP l P R0 'G=i 2N +0 e 2 ]] 9 VT P O 7 h(F * 癈 ' = Q VZD F,d ߬ ~ T X G[ `le 69C R(!S2! P < 0 x < !1AQ "Raq 02Br #S CTb ? Ζ "]mH5WR 7 k.ۛ ! } Q~ + yԏ z |@ T20 S~ K e k *zF f^2X *( @ 8 r ? C I uI|֓>^Ex LgNU Y+{.R Ѫ τV YT D I 6 2 '8Y2 7'\T P.6 d &˦ @V q i |8 -O Ε ] ʔ U= T L 8= ;6c | !qfF3 a ů& ~$ l} 'NW U s$U k^S V : U#6w + +s &r+n ڐ { @ 29gL u " T Ù M=6 (^ "7 r}=6Yݾ lC u hquymp Ǧ G jhs ǜNl ɻ} o 7 #S6 a w 4 ! OS r D 5 7 % | ?x> L | / nD 6?/8 w # [ ) L 7 +6〼T A T g ! %5 Mm Z /c -{1_Je "| ^$ 'O & ޱմ < H vNqϡQ$ < 6 &Nݛ ֨tǻN (9 n ru~'όN sMG& ,uH Kw *Ī 5@ u6 BԒ i YN * f 0 _ GhKW u lT <nj- 0{ M L~ | /a v\ E = ?1 \ɟuq Ђ Y O a K ޡP q $ H8o Q˼EV ~ k 0 h' L Pp M -M" m^ !6l nմ 쮝C U T . ! :vMǨb h ډ Vc r @~p # !1QAa q ? AL0L x LU 4 d ; x " 16ad0 7.\ߋ 0 = P l v/ " c A Ay A|2pO8"d MV #1] = \ " ˡ ] k v I9 d ۓ & q ) ǐq E ꞅ v "P )q X &Q З non]я u ג./ ; gZ$ M QР 2M ]h ni 0 P $ێ 3CɏGjώy : m c # S_ l@ '_ \m|C 2`K _ 1 cIvGc $? PCQ S+D ? K aײ k Fr b 8 ύ NEدg ĝ U 3 6 #Ik+ v { v i ( ވ ? a e) X xy/*@Q Ǽ Ծ ) $ IWO l c G; !i k{ gOŀ L ('x T rb $ w) R $ & N1E td U3Uȉ1p M"N* (DNy d96.(jQ) X 5 c QɎMy W ? Q *!R > 6=7)Xj 5`J ] e 8%t ! + ' ! 1Q 5 !1 AQaq ё #2 "0BRb ? G t^ ## .l lQ T $ v , ,m 㵜5u bV =sY+ @d { N ! dn O < .- B; _w J t 6;Q Jd. Q c%p{ 1 ,sND dF H I0 Гo X ш e黅X ۢ F :)[ F G X ƹ / w _c MeD ,ʡc c . W D tA $ j@ : ) - #u c1< @ۗ9F ) KJ- hpP] _ x [ q B lb p ʖ w q " LFGd ƶ * s +ډ_Zc " ? % t[I P 6 J ]# =ɺ V v v CGs Gh1 > )6 |e y ? L ӣ m,4 G W Ui ` ] uJVo VDG< SB 6ϏQ @ TiU l y O U 0 kfV ~ ~}S Z @ *WU Ui ## ; s /[ = ! 7}" W N ] ' (L ! ~ y5 g9T̅J kbM' +s :S +B) v @ M j e C f j E 0 Y\Qn z G 1 д~ W o{T 9?` Rm yhsy3 !HAD ] m c1 ~ 2 L S u7x T ;j$ `} 4-> L# vzŏ I L S ֭ T { r jGK C ; b pU= - ` Bs K. S F w4 M q] Z dH S 0 ) tLg
<?php
namespace Elementor\Modules\Components\OverridableProps;
use Elementor\Core\Utils\Api\Parse_Result;
use Elementor\Core\Utils\Collection;
use Elementor\Modules\Components\Utils\Parsing_Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Overridable_Groups_Parser {
public static function make(): self {
return new static();
}
public function parse( array $groups ): Parse_Result {
$result = Parse_Result::make();
$structure_validation_result = $this->validate_structure( $groups );
if ( ! $structure_validation_result->is_valid() ) {
return $structure_validation_result;
}
$parsed_groups = $this->parse_groups_items( $groups['items'] );
if ( ! $parsed_groups->is_valid() ) {
$result->errors()->merge( $parsed_groups->errors() );
return $result;
}
$parsed_order = $this->parse_groups_order( $groups['order'] );
if ( ! $parsed_order->is_valid() ) {
$result->errors()->merge( $parsed_order->errors() );
return $result;
}
$validation_result = $this->validate( $parsed_groups->unwrap(), $parsed_order->unwrap() );
if ( ! $validation_result->is_valid() ) {
return $validation_result;
}
$sanitized_groups = $this->sanitize( $parsed_groups->unwrap(), $parsed_order->unwrap() );
return Parse_Result::make()->wrap( $sanitized_groups );
}
private function validate_structure( array $groups ): Parse_Result {
$result = Parse_Result::make();
$inner_fields = [ 'items', 'order' ];
foreach ( $inner_fields as $inner_field ) {
if ( ! isset( $groups[ $inner_field ] ) ) {
$result->errors()->add( "groups.$inner_field", 'missing' );
return $result;
}
if ( ! is_array( $groups[ $inner_field ] ) ) {
$result->errors()->add( "groups.$inner_field", 'invalid_structure' );
return $result;
}
}
foreach ( $groups['items'] as $group_id => $group ) {
if ( ! is_array( $group ) ) {
$result->errors()->add( "groups.items.$group_id", 'invalid_structure' );
continue;
}
$required_fields = [ 'id', 'label', 'props' ];
foreach ( $required_fields as $field ) {
if ( ! isset( $group[ $field ] ) ) {
$result->errors()->add( "groups.items.$group_id.$field", 'missing' );
}
}
if ( isset( $group['props'] ) && ! is_array( $group['props'] ) ) {
$result->errors()->add( "groups.items.$group_id.props", 'invalid_structure' );
}
}
return $result;
}
private function validate( array $items, array $order ): Parse_Result {
$result = Parse_Result::make();
$items_ids_collection = Collection::make( $items )->keys();
$order_collection = Collection::make( $order );
$excess_ids = $order_collection->diff( $items_ids_collection );
$missing_ids = $items_ids_collection->diff( $order_collection );
$excess_ids->each( fn( $id ) => $result->errors()->add( "groups.order.$id", 'excess' ) );
$missing_ids->each( fn( $id ) => $result->errors()->add( "groups.order.$id", 'missing' ) );
return $result;
}
private function parse_groups_items( array $items ): Parse_Result {
$result = Parse_Result::make();
$validate_groups_items_result = $this->validate_groups_items( $items );
if ( ! $validate_groups_items_result->is_valid() ) {
$result->errors()->merge( $validate_groups_items_result->errors() );
return $result;
}
return Parse_Result::make()->wrap( $this->sanitize_groups_items( $items ) );
}
private function validate_groups_items( array $items ): Parse_Result {
$result = Parse_Result::make();
$labels = [];
foreach ( $items as $group_id => $group ) {
if ( $group_id !== $group['id'] ) {
$result->errors()->add( "groups.items.$group_id.id", 'mismatching_value' );
}
$duplicate_props = Parsing_Utils::get_duplicates( $group['props'] );
if ( ! empty( $duplicate_props ) ) {
$result->errors()->add( "groups.items.$group_id.props", 'duplicate_props: ' . implode( ', ', $duplicate_props ) );
}
$labels[] = $group['label'];
}
$duplicate_labels = Parsing_Utils::get_duplicates( $labels );
if ( ! empty( $duplicate_labels ) ) {
$result->errors()->add( 'groups.items', 'duplicate_labels: ' . implode( ', ', $duplicate_labels ) );
}
return $result;
}
private function parse_groups_order( array $order ): Parse_Result {
$result = Parse_Result::make();
$validate_groups_order_result = $this->validate_groups_order( $order );
if ( ! $validate_groups_order_result->is_valid() ) {
return $validate_groups_order_result;
}
return Parse_Result::make()->wrap( $this->sanitize_groups_order( $order ) );
}
private function validate_groups_order( array $order ): Parse_Result {
$result = Parse_Result::make();
$order_collection = Collection::make( $order );
$non_string_items = $order_collection->some( fn( $item ) => ! is_string( $item ) );
if ( $non_string_items ) {
$result->errors()->add( 'groups.order', 'non_string_items' );
return $result;
}
if ( Parsing_Utils::get_duplicates( $order ) ) {
$result->errors()->add( 'groups.order', 'duplicate_ids' );
return $result;
}
return $result;
}
private function sanitize( array $items, array $order ): array {
return [
'items' => $items,
'order' => $order,
];
}
private function sanitize_groups_items( array $items ): array {
$sanitized_items = [];
foreach ( $items as $group_id => $group ) {
$sanitized_group_id = sanitize_key( $group_id );
$sanitized_items[ $sanitized_group_id ] = $this->sanitize_single_group( $group );
}
return $sanitized_items;
}
private function sanitize_single_group( array $group ): array {
return [
'id' => sanitize_key( $group['id'] ),
'label' => sanitize_text_field( $group['label'] ),
'props' => array_map( 'sanitize_key', $group['props'] ),
];
}
private function sanitize_groups_order( array $order ): array {
return Collection::make( $order )
->map( fn( $item ) => sanitize_key( $item ) )
->values();
}
}