first commit

This commit is contained in:
2026-03-26 13:48:22 +01:00
commit 6af83e92ed
7795 changed files with 2766332 additions and 0 deletions

View File

@@ -0,0 +1,15 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Base;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base as New_Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
// TODO: Remove this class after 3.36 is released.
/**
* @deprecated 3.34 Use \Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base instead.
*/
abstract class Atomic_Control_Base extends New_Atomic_Control_Base {}

View File

@@ -0,0 +1,15 @@
<?php
namespace Elementor\Modules\AtomicWidgets\CacheValidity;
use Elementor\Modules\AtomicWidgets\Styles\CacheValidity\Cache_Validity_Item as New_Cache_Validity_Item;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
// TODO: Remove this class after 3.37 is released.
/**
* @deprecated 3.35 Use \Elementor\Modules\AtomicWidgets\Styles\CacheValidity\Cache_Validity_Item instead.
*/
class Cache_Validity_Item extends New_Cache_Validity_Item {}

View File

@@ -0,0 +1,15 @@
<?php
namespace Elementor\Modules\AtomicWidgets\CacheValidity;
use Elementor\Modules\AtomicWidgets\Styles\CacheValidity\Cache_Validity as New_Cache_Validity;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
// TODO: Remove this class after 3.37 is released.
/**
* @deprecated 3.35 Use \Elementor\Modules\AtomicWidgets\Styles\CacheValidity\Cache_Validity instead.
*/
class Cache_Validity extends New_Cache_Validity {}

View File

@@ -0,0 +1,64 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Base;
use JsonSerializable;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
abstract class Atomic_Control_Base implements JsonSerializable {
private string $bind;
private $label = null;
private $description = null;
private $meta = null;
abstract public function get_type(): string;
abstract public function get_props(): array;
public static function bind_to( string $prop_name ) {
return new static( $prop_name );
}
protected function __construct( string $prop_name ) {
$this->bind = $prop_name;
}
public function get_bind() {
return $this->bind;
}
public function set_label( string $label ): self {
$this->label = html_entity_decode( $label );
return $this;
}
public function set_description( string $description ): self {
$this->description = html_entity_decode( $description );
return $this;
}
public function set_meta( $meta ): self {
$this->meta = $meta;
return $this;
}
public function jsonSerialize(): array {
return [
'type' => 'control',
'value' => [
'type' => $this->get_type(),
'bind' => $this->get_bind(),
'label' => $this->label,
'description' => $this->description,
'props' => $this->get_props(),
'meta' => $this->meta,
],
];
}
}

View File

@@ -0,0 +1,54 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Base;
use JsonSerializable;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
abstract class Element_Control_Base implements JsonSerializable {
private $label = null;
private $meta = null;
abstract public function get_type(): string;
abstract public function get_props(): array;
public static function make(): self {
return new static();
}
public function set_label( string $label ): self {
$this->label = $label;
return $this;
}
public function get_label(): string {
return $this->label;
}
public function set_meta( $meta ): self {
$this->meta = $meta;
return $this;
}
public function get_meta(): array {
return $this->meta;
}
public function jsonSerialize(): array {
return [
'type' => 'element-control',
'value' => [
'label' => $this->get_label(),
'meta' => $this->get_meta(),
'type' => $this->get_type(),
'props' => $this->get_props(),
],
];
}
}

View File

@@ -0,0 +1,72 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls;
use JsonSerializable;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Section implements JsonSerializable {
private ?string $id = null;
private $label = null;
private $description = null;
private array $items = [];
public static function make(): self {
return new static();
}
public function set_id( string $id ): self {
$this->id = $id;
return $this;
}
public function get_id() {
return $this->id;
}
public function set_label( string $label ): self {
$this->label = html_entity_decode( $label );
return $this;
}
public function get_label(): ?string {
return $this->label;
}
public function set_description( string $description ): self {
$this->description = html_entity_decode( $description );
return $this;
}
public function set_items( array $items ): self {
$this->items = $items;
return $this;
}
public function add_item( $item ): self {
$this->items[] = $item;
return $this;
}
public function get_items() {
return $this->items;
}
public function jsonSerialize(): array {
return [
'type' => 'section',
'value' => [
'label' => $this->label,
'description' => $this->description,
'items' => $this->items,
],
];
}
}

View File

@@ -0,0 +1,18 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Date_Time_Control extends Atomic_Control_Base {
public function get_type(): string {
return 'date-time';
}
public function get_props(): array {
return [];
}
}

View File

@@ -0,0 +1,18 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types\Elements;
use Elementor\Modules\AtomicWidgets\Controls\Base\Element_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Tabs_Control extends Element_Control_Base {
public function get_type(): string {
return 'tabs';
}
public function get_props(): array {
return [];
}
}

View File

@@ -0,0 +1,14 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Html_Tag_Control extends Select_Control {
public function get_type(): string {
return 'html-tag';
}
}

View File

@@ -0,0 +1,21 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
use Elementor\Modules\AtomicWidgets\Utils\Image\Image_Sizes;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Image_Control extends Atomic_Control_Base {
public function get_type(): string {
return 'image';
}
public function get_props(): array {
return [
'sizes' => Image_Sizes::get_all(),
];
}
}

View File

@@ -0,0 +1,28 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Inline_Editing_Control extends Atomic_Control_Base {
private ?string $placeholder = null;
public function get_type(): string {
return 'inline-editing';
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function get_props(): array {
return [
'placeholder' => $this->placeholder,
];
}
}

View File

@@ -0,0 +1,50 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
use Elementor\Modules\AtomicWidgets\Query\Query_Builder_Factory as Query_Builder;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly
}
class Link_Control extends Atomic_Control_Base {
private bool $allow_custom_values = true;
private int $minimum_input_length = 2;
private ?array $query_config = null;
private ?string $placeholder = null;
private ?string $aria_label = null;
public function get_type(): string {
return 'link';
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function set_allow_custom_values( bool $allow_custom_values ): self {
$this->allow_custom_values = $allow_custom_values;
return $this;
}
public function set_query_config( $config ): self {
$this->query_config = $config;
return $this;
}
public function get_props(): array {
return [
'allowCustomValues' => $this->allow_custom_values,
'placeholder' => $this->placeholder,
'queryOptions' => Query_Builder::create( $this->query_config )->build(),
'minInputLength' => $this->minimum_input_length,
'ariaLabel' => 'Link URL',
];
}
}

View File

@@ -0,0 +1,60 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Number_Control extends Atomic_Control_Base {
private ?string $placeholder = null;
private ?int $max = null;
private ?int $min = null;
private ?int $step = null;
private ?bool $should_force_int = null;
public function get_type(): string {
return 'number';
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function set_max( ?int $max ): self {
$this->max = $max;
return $this;
}
public function set_min( ?int $min ): self {
$this->min = $min;
return $this;
}
public function set_step( ?int $step ): self {
$this->step = $step;
return $this;
}
public function set_should_force_int( ?bool $should_force_int ): self {
$this->should_force_int = $should_force_int ?? false;
return $this;
}
public function get_props(): array {
return [
'placeholder' => $this->placeholder,
'max' => $this->max,
'min' => $this->min,
'step' => $this->step,
'shouldForceInt' => $this->should_force_int,
];
}
}

View File

@@ -0,0 +1,48 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
use Elementor\Modules\AtomicWidgets\Query\Query_Builder_Factory as Query_Builder;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly
}
class Query_Control extends Atomic_Control_Base {
private bool $allow_custom_values = true;
private int $minimum_input_length = 2;
private ?array $query_config = null;
private ?string $placeholder = null;
public function get_type(): string {
return 'query';
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function set_allow_custom_values( bool $allow_custom_values ): self {
$this->allow_custom_values = $allow_custom_values;
return $this;
}
public function set_query_config( $config ): self {
$this->query_config = $config;
return $this;
}
public function get_props(): array {
return [
'allowCustomValues' => $this->allow_custom_values,
'placeholder' => $this->placeholder,
'queryOptions' => Query_Builder::create( $this->query_config )->build(),
'minInputLength' => $this->minimum_input_length,
];
}
}

View File

@@ -0,0 +1,93 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Repeatable_Control extends Atomic_Control_Base {
private string $child_control_type;
private object $child_control_props;
private bool $show_duplicate = true;
private bool $show_toggle = true;
private string $repeater_label;
private ?object $initial_values;
private ?string $pattern_label;
private ?string $placeholder;
private ?string $prop_key = '';
public function get_type(): string {
return 'repeatable';
}
public function set_child_control_type( $control_type ): self {
$this->child_control_type = $control_type;
return $this;
}
public function set_child_control_props( $control_props ): self {
$this->child_control_props = (object) $control_props;
return $this;
}
public function hide_duplicate(): self {
$this->show_duplicate = false;
return $this;
}
public function hide_toggle(): self {
$this->show_toggle = false;
return $this;
}
public function set_initialValues( $initial_values ): self {
$this->initial_values = (object) $initial_values;
return $this;
}
public function set_patternLabel( $pattern_label ): self {
$this->pattern_label = $pattern_label;
return $this;
}
public function set_repeaterLabel( string $label ): self {
$this->repeater_label = $label;
return $this;
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function set_prop_key( string $prop_key ): self {
$this->prop_key = $prop_key;
return $this;
}
public function get_props(): array {
return [
'childControlType' => $this->child_control_type,
'childControlProps' => $this->child_control_props,
'showDuplicate' => $this->show_duplicate,
'showToggle' => $this->show_toggle,
'initialValues' => $this->initial_values,
'patternLabel' => $this->pattern_label,
'repeaterLabel' => $this->repeater_label,
'placeholder' => $this->placeholder,
'propKey' => $this->prop_key,
];
}
}

View File

@@ -0,0 +1,56 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Select_Control extends Atomic_Control_Base {
private array $options = [];
private ?array $fallback_labels = null;
private ?string $collection_id = null;
private ?string $placeholder = null;
public function get_type(): string {
return 'select';
}
public function set_options( array $options ): self {
$this->options = $options;
return $this;
}
public function set_collection_id( string $collection_id ): self {
$this->collection_id = $collection_id;
return $this;
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function get_props(): array {
$props = [
'options' => $this->options,
'fallbackLabels' => $this->fallback_labels,
'placeholder' => $this->placeholder,
];
if ( $this->collection_id ) {
$props['collectionId'] = $this->collection_id;
}
return $props;
}
public function set_fallback_labels( array $fallback_labels ): self {
$this->fallback_labels = $fallback_labels;
return $this;
}
}

View File

@@ -0,0 +1,60 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Size_Control extends Atomic_Control_Base {
private ?string $placeholder = null;
private ?string $variant = 'length';
private ?array $units = null;
private ?string $default_unit = null;
private ?bool $disable_custom = false;
public function get_type(): string {
return 'size';
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function set_variant( string $variant ): self {
$this->variant = $variant;
return $this;
}
public function set_units( array $units ): self {
$this->units = $units;
return $this;
}
public function set_default_unit( string $default_unit ): self {
$this->default_unit = $default_unit;
return $this;
}
public function set_disable_custom( bool $disable_custom ): self {
$this->disable_custom = $disable_custom;
return $this;
}
public function get_props(): array {
return [
'placeholder' => $this->placeholder,
'variant' => $this->variant,
'units' => $this->units,
'defaultUnit' => $this->default_unit,
'disableCustom' => $this->disable_custom,
];
}
}

View File

@@ -0,0 +1,22 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
use Elementor\Modules\AtomicWidgets\Utils\Image\Image_Sizes;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Svg_Control extends Atomic_Control_Base {
public function get_type(): string {
return 'svg-media';
}
public function get_props(): array {
return [
'type' => $this->get_type(),
];
}
}

View File

@@ -0,0 +1,18 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Switch_Control extends Atomic_Control_Base {
public function get_type(): string {
return 'switch';
}
public function get_props(): array {
return [];
}
}

View File

@@ -0,0 +1,28 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Text_Control extends Atomic_Control_Base {
private ?string $placeholder = null;
public function get_type(): string {
return 'text';
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = $placeholder;
return $this;
}
public function get_props(): array {
return [
'placeholder' => $this->placeholder,
];
}
}

View File

@@ -0,0 +1,28 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Textarea_Control extends Atomic_Control_Base {
private $placeholder = null;
public function get_type(): string {
return 'textarea';
}
public function set_placeholder( string $placeholder ): self {
$this->placeholder = html_entity_decode( $placeholder );
return $this;
}
public function get_props(): array {
return [
'placeholder' => $this->placeholder,
];
}
}

View File

@@ -0,0 +1,74 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Controls\Types;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Toggle_Control extends Atomic_Control_Base {
private array $options = [];
private bool $full_width = false;
private string $size = 'tiny';
private bool $exclusive = true;
private bool $convert_options = false;
public function get_type(): string {
return 'toggle';
}
public function add_options( array $control_options ): self {
$this->options = [];
foreach ( $control_options as $value => $config ) {
$this->options[] = [
'value' => $value,
'label' => $config['title'] ?? $value,
'icon' => $config['atomic-icon'] ?? null,
'showTooltip' => true,
'exclusive' => false,
];
}
return $this;
}
public function set_size( string $size ): self {
$allowed_sizes = [ 'tiny', 'small', 'medium', 'large' ];
if ( in_array( $size, $allowed_sizes, true ) ) {
$this->size = $size;
}
return $this;
}
public function set_exclusive( bool $exclusive ): self {
$this->exclusive = $exclusive;
return $this;
}
/**
* Whether to convert the v3 options to v4 compatible
*
* @param bool $convert_options
* @return $this
*/
public function set_convert_options( bool $convert_options ): self {
$this->convert_options = $convert_options;
return $this;
}
public function get_props(): array {
return [
'options' => $this->options,
'fullWidth' => $this->full_width,
'size' => $this->size,
'exclusive' => $this->exclusive,
'convertOptions' => $this->convert_options,
];
}
}

View File

@@ -0,0 +1,25 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Database;
use Elementor\Core\Database\Base_Database_Updater;
use Elementor\Modules\AtomicWidgets\Database\Migrations\Add_Capabilities;
class Atomic_Widgets_Database_Updater extends Base_Database_Updater {
const DB_VERSION = 1;
const OPTION_NAME = 'elementor_atomic_widgets_db_version';
protected function get_migrations(): array {
return [
1 => new Add_Capabilities(),
];
}
protected function get_db_version() {
return static::DB_VERSION;
}
protected function get_db_version_option_name(): string {
return static::OPTION_NAME;
}
}

View File

@@ -0,0 +1,27 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Database\Migrations;
use Elementor\Core\Database\Base_Migration;
class Add_Capabilities extends Base_Migration {
const ACCESS_STYLES_TAB = 'elementor_atomic_widgets_access_styles_tab';
const EDIT_LOCAL_CSS_CLASS = 'elementor_atomic_widgets_edit_local_css_class';
public function up() {
$capabilities = [
self::ACCESS_STYLES_TAB => [ 'administrator', 'editor', 'author', 'contributor', 'shop_manager' ],
self::EDIT_LOCAL_CSS_CLASS => [ 'administrator', 'editor', 'author', 'contributor', 'shop_manager' ],
];
foreach ( $capabilities as $cap => $roles ) {
foreach ( $roles as $role_name ) {
$role = get_role( $role_name );
if ( $role ) {
$role->add_cap( $cap );
}
}
}
}
}

View File

@@ -0,0 +1,89 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Plain_Prop_Type;
use Elementor\Modules\AtomicWidgets\Parsers\Props_Parser;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Prop_Type extends Plain_Prop_Type {
const META_KEY = 'dynamic';
/**
* Return a tuple that lets the developer ignore the dynamic prop type in the props schema
* using `Prop_Type::meta()`, e.g. `String_Prop_Type::make()->meta( Dynamic_Prop_Type::ignore() )`.
*/
public static function ignore(): array {
return [ static::META_KEY, false ];
}
public static function get_key(): string {
return 'dynamic';
}
public function categories( array $categories ) {
$this->settings['categories'] = $categories;
return $this;
}
public function get_categories() {
return $this->settings['categories'] ?? [];
}
public static function is_dynamic_prop_value( $value ): bool {
return isset( $value['$$type'] ) && self::get_key() === $value['$$type'];
}
protected function validate_value( $value ): bool {
$is_valid_structure = (
isset( $value['name'] ) &&
is_string( $value['name'] ) &&
isset( $value['group'] ) &&
is_string( $value['group'] ) &&
isset( $value['settings'] ) &&
is_array( $value['settings'] )
);
if ( ! $is_valid_structure ) {
return false;
}
$tag = Dynamic_Tags_Module::instance()->registry->get_tag( $value['name'] );
if ( ! $tag || ! $this->is_tag_in_supported_categories( $tag ) ) {
return false;
}
return Props_Parser::make( $tag['props_schema'] )
->validate( $value['settings'] )
->is_valid();
}
protected function sanitize_value( $value ): array {
$tag = Dynamic_Tags_Module::instance()->registry->get_tag( $value['name'] );
$sanitized = Props_Parser::make( $tag['props_schema'] )
->sanitize( $value['settings'] )
->unwrap();
return [
'name' => $value['name'],
'group' => $value['group'],
'settings' => $sanitized,
];
}
private function is_tag_in_supported_categories( array $tag ): bool {
$intersection = array_intersect(
$tag['categories'],
$this->get_categories()
);
return ! empty( $intersection );
}
}

View File

@@ -0,0 +1,89 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags;
use Elementor\Modules\AtomicWidgets\PropTypes\Utils\Prop_Types_Schema_Extender;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Transformable_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Html_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Image_Src_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Color_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Url_Prop_Type;
use Elementor\Modules\DynamicTags\Module as V1_Dynamic_Tags_Module;
use Elementor\Modules\AtomicWidgets\PropTypes\Union_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Prop_Types_Mapping extends Prop_Types_Schema_Extender {
public static function make(): self {
return new static();
}
/**
* Get the dynamic prop type to add to the prop type
*
* @param Prop_Type $prop_type
*/
protected function get_prop_types_to_add( Prop_Type $prop_type ): array {
$categories = [];
$transformable_prop_types = $prop_type instanceof Union_Prop_Type ?
$prop_type->get_prop_types() :
[ $prop_type ];
foreach ( $transformable_prop_types as $transformable_prop_type ) {
if ( $transformable_prop_type instanceof Transformable_Prop_Type ) {
// When the prop type is originally a union, we need to merge all the categories
// of each prop type in the union and create one dynamic prop type with all the categories.
$categories = array_merge( $categories, $this->get_related_categories( $transformable_prop_type ) );
}
}
if ( empty( $categories ) ) {
return [];
}
return [ Dynamic_Prop_Type::make()->categories( $categories ) ];
}
private function get_related_categories( Transformable_Prop_Type $prop_type ): array {
if ( ! $prop_type->get_meta_item( Dynamic_Prop_Type::META_KEY, true ) ) {
return [];
}
if ( $prop_type instanceof Number_Prop_Type ) {
return [ V1_Dynamic_Tags_Module::NUMBER_CATEGORY ];
}
if ( $prop_type->get_meta_item( 'is_svg', false ) ) {
return [ V1_Dynamic_Tags_Module::SVG_CATEGORY ];
}
if ( $prop_type instanceof Image_Src_Prop_Type ) {
return [ V1_Dynamic_Tags_Module::IMAGE_CATEGORY ];
}
if ( $prop_type instanceof Url_Prop_Type ) {
return [ V1_Dynamic_Tags_Module::URL_CATEGORY ];
}
if ( $prop_type instanceof Html_Prop_Type ) {
return [ V1_Dynamic_Tags_Module::TEXT_CATEGORY ];
}
if ( $prop_type instanceof Color_Prop_Type ) {
return [ V1_Dynamic_Tags_Module::COLOR_CATEGORY ];
}
if ( $prop_type instanceof String_Prop_Type && empty( $prop_type->get_enum() ) ) {
return [ V1_Dynamic_Tags_Module::TEXT_CATEGORY ];
}
return [];
}
}

View File

@@ -0,0 +1,132 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags;
use Elementor\Modules\AtomicWidgets\Utils\Image\Placeholder_Image;
use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Plain_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Date_Time_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Image_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Boolean_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Query_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Tags_Converter {
/**
* @param array $control
* @return Plain_Prop_Type|Object_Prop_Type|null
*/
public static function convert_control_to_prop_type( array $control ) {
$control_type = $control['type'];
switch ( $control_type ) {
case 'text':
case 'textarea':
$prop_type = String_Prop_Type::make()
->default( $control['default'] ?? null );
break;
case 'select':
$prop_type = String_Prop_Type::make()
->default( $control['default'] ?? null );
if ( ! isset( $control['collection_id'] ) || empty( $control['collection_id'] ) ) {
$prop_type->enum( array_keys( $control['options'] ?? [] ) );
}
break;
case 'date_time':
$prop_type = Date_Time_Prop_Type::make()
->default( $control['default'] ?? null );
break;
case 'number':
$prop_type = Number_Prop_Type::make()
->set_required( $control['required'] ?? false )
->default( $control['default'] ?? null );
break;
case 'switcher':
$default = $control['default'];
$prop_type = Boolean_Prop_Type::make()
->default( 'yes' === $default || true === $default );
break;
case 'choose':
$prop_type = String_Prop_Type::make()
->default( $control['default'] ?? null )
->enum( array_keys( $control['options'] ?? [] ) );
break;
case 'query':
$prop_type = Query_Prop_Type::make()
->set_required( $control['required'] ?? false )
->default( $control['default'] ?? null );
break;
case 'media':
$prop_type = Image_Prop_Type::make()
->default_url( Placeholder_Image::get_placeholder_image() )
->default_size( 'full' )
->set_shape_meta( 'src', [ 'isDynamic' => true ] );
break;
default:
return null;
}
$prop_type->set_dependencies( self::create_dependencies_from_condition( $control['condition'] ?? null ) );
return $prop_type;
}
private static function create_dependencies_from_condition( $condition ): ?array {
if ( ! is_array( $condition ) || empty( $condition ) ) {
return null;
}
$manager = Dependency_Manager::make( Dependency_Manager::RELATION_AND );
foreach ( $condition as $raw_key => $value ) {
$is_negated = false !== strpos( (string) $raw_key, '!' );
$key = rtrim( (string) $raw_key, '!' );
$path = self::parse_condition_path( $key );
if ( is_array( $value ) ) {
$manager->where( [
'operator' => $is_negated ? 'nin' : 'in',
'path' => $path,
'value' => $value,
] );
continue;
}
$manager->where( [
'operator' => $is_negated ? 'ne' : 'eq',
'path' => $path,
'value' => $value,
] );
}
return $manager->get();
}
private static function parse_condition_path( string $key ): array {
if ( false === strpos( $key, '[' ) ) {
return [ $key ];
}
$key = str_replace( ']', '', $key );
$tokens = explode( '[', $key );
return array_values( array_filter( $tokens, static fn( $t ) => '' !== $t ) );
}
}

View File

@@ -0,0 +1,389 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Date_Time_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Image_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Toggle_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Query_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Select_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Switch_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Number_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Textarea_Control;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Transformable_Prop_Type;
use Elementor\Modules\AtomicWidgets\Query\Query_Builder;
use Elementor\Modules\AtomicWidgets\Query\Query_Builder_Factory;
use Elementor\Modules\WpRest\Base\Query as Query_Base;
use Elementor\Modules\WpRest\Classes\Post_Query;
use Elementor\Modules\WpRest\Classes\Term_Query;
use Elementor\Modules\WpRest\Classes\User_Query;
use Elementor\TemplateLibrary\Source_Local;
use Elementor\Plugin;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Tags_Editor_Config {
private Dynamic_Tags_Schemas $schemas;
private ?array $tags = null;
public function __construct( Dynamic_Tags_Schemas $schemas ) {
$this->schemas = $schemas;
}
public function get_tags(): array {
if ( null !== $this->tags ) {
return $this->tags;
}
$atomic_tags = [];
$dynamic_tags = Plugin::$instance->dynamic_tags->get_tags_config();
foreach ( $dynamic_tags as $name => $tag ) {
$atomic_tag = $this->convert_dynamic_tag_to_atomic( $tag );
if ( $atomic_tag ) {
$atomic_tags[ $name ] = $atomic_tag;
}
}
$this->tags = $atomic_tags;
return $this->tags;
}
/**
* @param string $name
*
* @return null|array{
* name: string,
* categories: string[],
* label: string,
* group: string,
* atomic_controls: array,
* props_schema: array<string, Transformable_Prop_Type>
* }
*/
public function get_tag( string $name ): ?array {
$tags = $this->get_tags();
return $tags[ $name ] ?? null;
}
private function convert_dynamic_tag_to_atomic( $tag ) {
if ( empty( $tag['name'] ) || empty( $tag['categories'] ) ) {
return null;
}
$converted_tag = [
'name' => $tag['name'],
'categories' => $tag['categories'],
'label' => $tag['title'] ?? '',
'group' => $tag['atomic_group'] ?? $tag['group'] ?? '',
'atomic_controls' => [],
'props_schema' => $this->schemas->get( $tag['name'] ),
];
if ( ! isset( $tag['controls'] ) ) {
return $converted_tag;
}
try {
$atomic_controls = $this->convert_controls_to_atomic( $tag );
} catch ( \Exception $e ) {
return null;
}
if ( null === $atomic_controls ) {
return null;
}
$converted_tag['atomic_controls'] = $atomic_controls;
return $converted_tag;
}
private function convert_controls_to_atomic( $tag ) {
$atomic_controls = [];
$controls = $tag['controls'] ?? null;
$force = $tag['force_convert_to_atomic'] ?? false;
if ( ! is_array( $controls ) ) {
return null;
}
foreach ( $controls as $control ) {
if ( 'section' === $control['type'] ) {
continue;
}
$atomic_control = $this->convert_control_to_atomic( $control, $tag );
if ( ! $atomic_control ) {
if ( $force ) {
continue;
}
return null;
}
$section_name = $control['section'];
if ( ! isset( $atomic_controls[ $section_name ] ) ) {
$atomic_controls[ $section_name ] = Section::make()
->set_label( $controls[ $section_name ]['label'] );
}
$atomic_controls[ $section_name ] = $atomic_controls[ $section_name ]->add_item( $atomic_control );
}
return array_values( $atomic_controls );
}
private function convert_control_to_atomic( $control, $tag = [] ) {
$map = [
'select' => fn( $control ) => $this->convert_select_control_to_atomic( $control, $tag ),
'text' => fn( $control ) => $this->convert_text_control_to_atomic( $control ),
'textarea' => fn( $control ) => $this->convert_textarea_control_to_atomic( $control ),
'switcher' => fn( $control ) => $this->convert_switch_control_to_atomic( $control ),
'number' => fn( $control ) => $this->convert_number_control_to_atomic( $control ),
'query' => fn( $control ) => $this->convert_autocomplete_control_to_atomic( $control ),
'choose' => fn( $control ) => $this->convert_choose_control_to_atomic( $control ),
'media' => fn( $control ) => $this->convert_media_control_to_atomic( $control ),
'date_time' => fn( $control ) => $this->convert_date_time_control_to_atomic( $control ),
];
if ( ! isset( $map[ $control['type'] ] ) ) {
return null;
}
$is_convertable = ! isset( $control['name'], $control['section'], $control['label'], $control['default'] );
if ( $is_convertable ) {
throw new \Exception( 'Control must have name, section, label, and default' );
}
return $map[ $control['type'] ]( $control );
}
/**
* @param $control
*
* @return Select_Control
* @throws \Exception If control is missing options.
*/
private function convert_select_control_to_atomic( $control, $tag = [] ) {
$options = $this->extract_select_options_from_control( $control );
if ( empty( $options ) ) {
throw new \Exception( 'Select control must have options' );
}
$options = apply_filters( 'elementor/atomic/dynamic_tags/select_control_options', $options, $control, $tag );
$options = array_map(
fn( $key, $value ) => [
'value' => $key,
'label' => $value,
],
array_keys( $options ),
$options
);
$select_control = Select_Control::bind_to( $control['name'] )
->set_placeholder( $control['placeholder'] ?? '' )
->set_options( $options )
->set_label( $control['atomic_label'] ?? $control['label'] );
if ( isset( $control['collection_id'] ) ) {
$select_control->set_collection_id( $control['collection_id'] );
}
return $select_control;
}
private function extract_select_options_from_control( $control ): array {
$options = $control['options'] ?? [];
if ( ! empty( $options ) ) {
return $options;
}
if ( empty( $control['groups'] ) || ! is_array( $control['groups'] ) ) {
return $options;
}
foreach ( $control['groups'] as $group ) {
if ( empty( $group['options'] ) || ! is_array( $group['options'] ) ) {
continue;
}
$filtered = array_filter(
$group['options'],
static function ( $label, $key ) {
return is_string( $key );
},
ARRAY_FILTER_USE_BOTH
);
$options = array_merge( $options, $filtered );
}
return $options;
}
/**
* @param $control
*
* @return Text_Control
*/
private function convert_text_control_to_atomic( $control ) {
return Text_Control::bind_to( $control['name'] )
->set_label( $control['label'] );
}
private function convert_date_time_control_to_atomic( $control ) {
return Date_Time_Control::bind_to( $control['name'] )
->set_label( $control['label'] );
}
/**
* @param $control
*
* @return Switch_Control
*/
private function convert_switch_control_to_atomic( $control ) {
return Switch_Control::bind_to( $control['name'] )
->set_label( $control['atomic_label'] ?? $control['label'] );
}
/**
* @param $control
*
* @return Number_Control
*/
private function convert_number_control_to_atomic( $control ) {
return Number_Control::bind_to( $control['name'] )
->set_placeholder( $control['placeholder'] ?? '' )
->set_max( $control['max'] ?? null )
->set_min( $control['min'] ?? null )
->set_step( $control['step'] ?? null )
->set_should_force_int( $control['should_force_int'] ?? false )
->set_label( $control['label'] );
}
private function convert_textarea_control_to_atomic( $control ) {
return Textarea_Control::bind_to( $control['name'] )
->set_placeholder( $control['placeholder'] ?? '' )
->set_label( $control['label'] );
}
private function convert_autocomplete_control_to_atomic( $control ) {
$query_config = [];
$query_type = Post_Query::ENDPOINT;
switch ( true ) {
case $this->is_querying_wp_terms( $control ):
$query_type = Term_Query::ENDPOINT;
$included_types = null;
$excluded_types = null;
break;
case $this->is_control_elementor_query( $control ):
$included_types = [ Source_Local::CPT ];
$excluded_types = [];
break;
case $this->is_querying_wp_media( $control ):
$included_types = [ 'attachment' ];
$excluded_types = [];
$query_config[ Query_Base::IS_PUBLIC_KEY ] = false;
break;
case $this->is_querying_wp_users( $control ):
$included_types = [ $control['autocomplete']['object'] ];
$excluded_types = null;
$query_type = User_Query::ENDPOINT;
break;
default:
$included_types = isset( $control['autocomplete']['query']['post_type'] ) ? $control['autocomplete']['query']['post_type'] : [];
$included_types = ! empty( $included_types ) && 'any' !== $included_types ? $included_types : null;
$excluded_types = null;
}
$query_config[ Query_Base::ITEMS_COUNT_KEY ] = $this->extract_item_count_from_control( $control );
$post_status[ Query_Base::IS_PUBLIC_KEY ] = $this->extract_post_status_from_control( $control );
$query_config[ Query_Base::INCLUDED_TYPE_KEY ] = $included_types;
$query_config[ Query_Base::EXCLUDED_TYPE_KEY ] = $excluded_types;
$query_config[ Query_Builder_Factory::ENDPOINT_KEY ] = $query_type;
$query_config[ Query_Base::META_QUERY_KEY ] = $this->extract_meta_query_from_control( $control );
$query_control = Query_Control::bind_to( $control['name'] );
$query_control->set_query_config( $query_config );
$query_control->set_placeholder( $control['placeholder'] ?? '' );
$query_control->set_label( $control['label'] );
$query_control->set_allow_custom_values( false );
return $query_control;
}
private function is_control_elementor_query( $control ): bool {
return isset( $control['autocomplete']['object'] ) && 'library_template' === $control['autocomplete']['object'];
}
private function is_querying_wp_terms( $control ): bool {
return isset( $control['autocomplete']['object'] ) && in_array( $control['autocomplete']['object'], [ 'tax', 'taxonomy', 'term' ], true );
}
private function is_querying_wp_media( $control ): bool {
return isset( $control['autocomplete']['object'] ) && 'attachment' === $control['autocomplete']['object'];
}
private function is_querying_wp_users( $control ): bool {
global $wp_roles;
$roles = array_keys( $wp_roles->roles );
return isset( $control['autocomplete']['object'] ) && in_array( $control['autocomplete']['object'], $roles, true );
}
private function convert_choose_control_to_atomic( $control ) {
return Toggle_Control::bind_to( $control['name'] )
->set_label( $control['atomic_label'] ?? $control['label'] )
->add_options( $control['options'] )
->set_size( 'tiny' )
->set_exclusive( true )
->set_convert_options( true );
}
private function convert_media_control_to_atomic( $control ) {
return Image_Control::bind_to( $control['name'] )
->set_label( $control['label'] );
}
private function extract_post_status_from_control( $control ): ?bool {
$status = $control['autocomplete']['query']['post_status'] ?? null;
return isset( $status ) && in_array( 'private', $status )
? false
: null;
}
private function extract_item_count_from_control( $control ): ?int {
$count = $control['autocomplete']['query']['posts_per_page'] ?? null;
return isset( $count ) && is_numeric( $count )
? $count
: null;
}
private function extract_meta_query_from_control( $control ): ?array {
return $control['autocomplete']['query']['meta_query'] ?? null;
}
}

View File

@@ -0,0 +1,110 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags;
use Elementor\Modules\AtomicWidgets\DynamicTags\ImportExport\Dynamic_Transformer as Import_Export_Dynamic_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Render_Props_Resolver;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers_Registry;
use Elementor\Plugin;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Tags_Module {
private static ?self $instance = null;
public Dynamic_Tags_Editor_Config $registry;
private Dynamic_Tags_Schemas $schemas;
private function __construct() {
$this->schemas = new Dynamic_Tags_Schemas();
$this->registry = new Dynamic_Tags_Editor_Config( $this->schemas );
}
public static function instance( $fresh = false ): self {
if ( null === static::$instance || $fresh ) {
static::$instance = new static();
}
return static::$instance;
}
public static function fresh(): self {
return static::instance( true );
}
public function register_hooks() {
add_filter(
'elementor/editor/localize_settings',
fn( array $settings ) => $this->add_atomic_dynamic_tags_to_editor_settings( $settings )
);
add_filter(
'elementor/atomic-widgets/props-schema',
fn( array $schema ) => Dynamic_Prop_Types_Mapping::make()->get_extended_schema( $schema )
);
add_filter(
'elementor/atomic-widgets/styles/schema',
fn( array $schema ) => Dynamic_Prop_Types_Mapping::make()->get_extended_style_schema( $schema ),
8,
2
);
add_action(
'elementor/atomic-widgets/settings/transformers/register',
fn ( $transformers, $prop_resolver ) => $this->register_transformers( $transformers, $prop_resolver ),
10,
2
);
add_action(
'elementor/atomic-widgets/styles/transformers/register',
fn ( $transformers, $prop_resolver ) => $this->register_transformers( $transformers, $prop_resolver ),
10,
2
);
add_action(
'elementor/atomic-widgets/import/transformers/register',
fn ( $transformers ) => $this->register_import_export_transformer( $transformers )
);
add_action(
'elementor/atomic-widgets/export/transformers/register',
fn ( $transformers ) => $this->register_import_export_transformer( $transformers )
);
}
private function add_atomic_dynamic_tags_to_editor_settings( $settings ) {
if ( isset( $settings['dynamicTags']['tags'] ) ) {
$settings['atomicDynamicTags'] = [
'tags' => $this->registry->get_tags(),
'groups' => Plugin::$instance->dynamic_tags->get_config()['groups'],
];
}
return $settings;
}
private function register_transformers( Transformers_Registry $transformers, Render_Props_Resolver $props_resolver ) {
$transformers->register(
Dynamic_Prop_Type::get_key(),
new Dynamic_Transformer(
Plugin::$instance->dynamic_tags,
$this->schemas,
$props_resolver
)
);
}
private function register_import_export_transformer( Transformers_Registry $transformers ) {
$transformers->register(
Dynamic_Prop_Type::get_key(),
new Import_Export_Dynamic_Transformer()
);
}
}

View File

@@ -0,0 +1,61 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags;
use Elementor\Core\DynamicTags\Base_Tag;
use Elementor\Modules\AtomicWidgets\Utils\Image\Placeholder_Image;
use Elementor\Modules\AtomicWidgets\PropTypes\Image_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Boolean_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Query_Prop_Type;
use Elementor\Plugin;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Tags_Schemas {
private array $tags_schemas = [];
public function get( string $tag_name ) {
if ( isset( $this->tags_schemas[ $tag_name ] ) ) {
return $this->tags_schemas[ $tag_name ];
}
$tag = $this->get_tag( $tag_name );
$this->tags_schemas[ $tag_name ] = [];
foreach ( $tag->get_controls() as $control ) {
if ( ! isset( $control['type'] ) || 'section' === $control['type'] ) {
continue;
}
$prop_type = Dynamic_Tags_Converter::convert_control_to_prop_type( $control );
if ( ! $prop_type ) {
continue;
}
$this->tags_schemas[ $tag_name ][ $control['name'] ] = $prop_type;
}
return $this->tags_schemas[ $tag_name ];
}
private function get_tag( string $tag_name ): Base_Tag {
$tag_info = Plugin::$instance->dynamic_tags->get_tag_info( $tag_name );
if ( ! $tag_info || empty( $tag_info['instance'] ) ) {
throw new \Exception( 'Tag not found' );
}
if ( ! $tag_info['instance'] instanceof Base_Tag ) {
throw new \Exception( 'Tag is not an instance of Tag' );
}
return $tag_info['instance'];
}
}

View File

@@ -0,0 +1,46 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags;
use Elementor\Core\DynamicTags\Manager as Dynamic_Tags_Manager;
use Elementor\Modules\AtomicWidgets\PropsResolver\Render_Props_Resolver;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformer_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Transformer extends Transformer_Base {
private Dynamic_Tags_Manager $dynamic_tags_manager;
private Dynamic_Tags_Schemas $dynamic_tags_schemas;
private Render_Props_Resolver $props_resolver;
public function __construct(
Dynamic_Tags_Manager $dynamic_tags_manager,
Dynamic_Tags_Schemas $dynamic_tags_schemas,
Render_Props_Resolver $props_resolver
) {
$this->dynamic_tags_manager = $dynamic_tags_manager;
$this->dynamic_tags_schemas = $dynamic_tags_schemas;
$this->props_resolver = $props_resolver;
}
public function transform( $value, $key ) {
if ( ! isset( $value['name'] ) || ! is_string( $value['name'] ) ) {
throw new \Exception( 'Dynamic tag name must be a string' );
}
if ( isset( $value['settings'] ) && ! is_array( $value['settings'] ) ) {
throw new \Exception( 'Dynamic tag settings must be an array' );
}
$schema = $this->dynamic_tags_schemas->get( $value['name'] );
$settings = $this->props_resolver->resolve(
$schema,
$value['settings'] ?? []
);
return $this->dynamic_tags_manager->get_tag_data_content( null, $value['name'], $settings );
}
}

View File

@@ -0,0 +1,34 @@
<?php
namespace Elementor\Modules\AtomicWidgets\DynamicTags\ImportExport;
use Elementor\Modules\AtomicWidgets\DynamicTags\Dynamic_Prop_Type;
use Elementor\Modules\AtomicWidgets\DynamicTags\Dynamic_Tags_Module;
use Elementor\Modules\AtomicWidgets\PropsResolver\Props_Resolver_Context;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformer_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Dynamic_Transformer extends Transformer_Base {
public function transform( $value, Props_Resolver_Context $context ): ?array {
if ( empty( $value['name'] ) || ! is_string( $value['name'] ) ) {
return null;
}
$tag = Dynamic_Tags_Module::instance()->registry->get_tag( $value['name'] );
if ( ! $tag ) {
return null;
}
$group = $value['group'] ?? $tag['group'] ?? '';
return Dynamic_Prop_Type::generate( [
'name' => $value['name'],
'group' => $group,
'settings' => $value['settings'] ?? [],
], $context->is_disabled() );
}
}

View File

@@ -0,0 +1,21 @@
{% if settings.text is not empty %}
{% set classes = settings.classes | merge( [ base_styles.base ] ) | join(' ') %}
{% set id_attribute = settings._cssid is not empty ? 'id=' ~ settings._cssid | e('html_attr') : '' %}
{% if settings.link.href %}
<{{ settings.link.tag | e('html_tag') }}
{% set linkAttr = settings.link.tag == 'a' ? 'href' : 'data-action-link' %}
{{ linkAttr }}="{{ settings.link.href | raw }}"
target="{{ settings.link.target }}"
class="{{ classes }}"
data-interaction-id="{{ id }}"
data-interactions="{{ interactions | json_encode | e('html_attr') }}"
{{ id_attribute }} {{ settings.attributes | raw }}
>
{{ settings.text }}
</{{ settings.link.tag | e('html_tag') }}>
{% else %}
<button class="{{ classes }}" data-interaction-id="{{ id }}" data-interactions="{{ interactions | json_encode | e('html_attr') }}" {{ id_attribute }} {{ settings.attributes | raw }}>
{{ settings.text }}
</button>
{% endif %}
{% endif %}

View File

@@ -0,0 +1,141 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Button;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Color_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Dimensions_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Atomic_Button extends Atomic_Widget_Base {
use Has_Template;
public static function get_element_type(): string {
return 'e-button';
}
public function get_title() {
return esc_html__( 'Button', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-e-button';
}
protected static function define_props_schema(): array {
$props = [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'text' => String_Prop_Type::make()
->default( __( 'Click here', 'elementor' ) )
->description( 'The text displayed on the button.' ),
'link' => Link_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
return $props;
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Content', 'elementor' ) )
->set_items( [
Text_Control::bind_to( 'text' )
->set_placeholder( __( 'Type your button text here', 'elementor' ) )
->set_label( __( 'Button text', 'elementor' ) ),
] ),
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( $this->get_settings_controls() ),
];
}
protected function get_settings_controls(): array {
return [
Link_Control::bind_to( 'link' )
->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
->set_label( __( 'Link', 'elementor' ) ),
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
];
}
protected function define_base_styles(): array {
$background_color_value = Background_Prop_Type::generate( [
'color' => Color_Prop_Type::generate( '#375EFB' ),
] );
$display_value = String_Prop_Type::generate( 'inline-block' );
$padding_value = Dimensions_Prop_Type::generate( [
'block-start' => Size_Prop_Type::generate( [
'size' => 12,
'unit' => 'px',
]),
'inline-end' => Size_Prop_Type::generate( [
'size' => 24,
'unit' => 'px',
]),
'block-end' => Size_Prop_Type::generate( [
'size' => 12,
'unit' => 'px',
]),
'inline-start' => Size_Prop_Type::generate( [
'size' => 24,
'unit' => 'px',
]),
]);
$border_radius_value = Size_Prop_Type::generate( [
'size' => 2,
'unit' => 'px',
] );
$border_width_value = Size_Prop_Type::generate( [
'size' => 0,
'unit' => 'px',
] );
$align_text_value = String_Prop_Type::generate( 'center' );
return [
'base' => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'background', $background_color_value )
->add_prop( 'display', $display_value )
->add_prop( 'padding', $padding_value )
->add_prop( 'border-radius', $border_radius_value )
->add_prop( 'border-width', $border_width_value )
->add_prop( 'text-align', $align_text_value )
),
];
}
protected function get_templates(): array {
return [
'elementor/elements/atomic-button' => __DIR__ . '/atomic-button.html.twig',
];
}
}

View File

@@ -0,0 +1,4 @@
{% set classes = settings.classes | merge( [ base_styles.base ] ) | join(' ') %}
{% set id_attribute = settings._cssid is not empty ? 'id=' ~ settings._cssid | e('html_attr') : '' %}
<hr class="{{ classes }}" data-interaction-id="{{ id }}" data-interactions="{{ interactions | json_encode | e('html_attr') }}" {{ id_attribute }} {{ settings.attributes | raw }} />

View File

@@ -0,0 +1,108 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Divider;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Color_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Atomic_Divider extends Atomic_Widget_Base {
use Has_Template;
protected function get_css_id_control_meta(): array {
return [
'layout' => 'two-columns',
'topDivider' => false,
];
}
public static function get_element_type(): string {
return 'e-divider';
}
public function get_title() {
return esc_html__( 'Divider', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic', 'divider', 'hr', 'line', 'border', 'separator' ];
}
public function get_icon() {
return 'eicon-e-divider';
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( $this->get_settings_controls() ),
];
}
protected function get_settings_controls(): array {
return [
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
];
}
protected function define_base_styles(): array {
$border_width_value = Size_Prop_Type::generate([
'size' => 0,
'unit' => 'px',
]);
$height_value = Size_Prop_Type::generate([
'size' => 1,
'unit' => 'px',
]);
$background_value = Background_Prop_Type::generate([
'color' => Color_Prop_Type::generate( '#000' ),
]);
return [
'base' => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'border-width', $border_width_value )
->add_prop( 'border-color', 'transparent' )
->add_prop( 'border-style', 'none' )
->add_prop( 'background', $background_value )
->add_prop( 'height', $height_value )
),
];
}
protected function get_templates(): array {
return [
'elementor/elements/atomic-divider' => __DIR__ . '/atomic-divider.html.twig',
];
}
}

View File

@@ -0,0 +1,26 @@
{% if settings.title is not empty %}
{% set id_attribute = settings._cssid is not empty ? 'id=' ~ settings._cssid | e('html_attr') : '' %}
<{{ settings.tag | e('html_tag') }}
data-interaction-id="{{ id }}"
class="{{ settings.classes | merge( [ base_styles.base ] ) | join(' ') }}"
{{ id_attribute }}
{{ settings.attributes | raw }}
{% if interactions and interactions is not empty %}
data-interactions="{{ interactions | json_encode | e('html_attr') }}"
{% endif %}
>
{% set allowed_tags = '<b><strong><sup><sub><s><em><i><u><a><del><span><br>' %}
{% if settings.link.href %}
<{{ settings.link.tag | e('html_tag') }}
{% set linkAttr = settings.link.tag == 'a' ? 'href' : 'data-action-link' %}
{{ linkAttr }}="{{ settings.link.href | raw }}"
target="{{ settings.link.target }}"
class="{{ base_styles['link-base'] }}">
{{ settings.title | striptags(allowed_tags) | raw }}
</{{ settings.link.tag | e('html_tag') }}>
{% else %}
{{ settings.title | striptags(allowed_tags) | raw }}
{% endif %}
</{{ settings.tag | e('html_tag') }}>
{% endif %}

View File

@@ -0,0 +1,154 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Heading;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Inline_Editing_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Select_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Html_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Heading extends Atomic_Widget_Base {
use Has_Template;
const LINK_BASE_STYLE_KEY = 'link-base';
public static $widget_description = 'Display a heading with customizable tag, styles, and link options.';
public static function get_element_type(): string {
return 'e-heading';
}
public function get_title() {
return esc_html__( 'Heading', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-e-heading';
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'tag' => String_Prop_Type::make()
->enum( [ 'h1', 'h2', 'h3', 'h4', 'h5', 'h6' ] )
->default( 'h2' )
->description( 'The HTML tag for the heading element. Could be h1, h2, up to h6' ),
'title' => Html_Prop_Type::make()
->default( __( 'This is a title', 'elementor' ) )
->description( 'The text content of the heading.' ),
'link' => Link_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
$content_section = Section::make()
->set_label( __( 'Content', 'elementor' ) )
->set_items( [
Inline_Editing_Control::bind_to( 'title' )
->set_placeholder( __( 'Type your title here', 'elementor' ) )
->set_label( __( 'Title', 'elementor' ) ),
] );
return [
$content_section,
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( $this->get_settings_controls() ),
];
}
protected function get_settings_controls(): array {
return [
Select_Control::bind_to( 'tag' )
->set_options([
[
'value' => 'h1',
'label' => 'H1',
],
[
'value' => 'h2',
'label' => 'H2',
],
[
'value' => 'h3',
'label' => 'H3',
],
[
'value' => 'h4',
'label' => 'H4',
],
[
'value' => 'h5',
'label' => 'H5',
],
[
'value' => 'h6',
'label' => 'H6',
],
])
->set_label( __( 'Tag', 'elementor' ) ),
Link_Control::bind_to( 'link' )
->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
->set_label( __( 'Link', 'elementor' ) )
->set_meta( [
'topDivider' => true,
] ),
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
];
}
protected function define_base_styles(): array {
$margin_value = Size_Prop_Type::generate( [
'unit' => 'px',
'size' => 0 ,
] );
return [
'base' => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'margin', $margin_value )
),
self::LINK_BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'all', 'unset' )
->add_prop( 'cursor', 'pointer' )
),
];
}
protected function get_templates(): array {
return [
'elementor/elements/atomic-heading' => __DIR__ . '/atomic-heading.html.twig',
];
}
}

View File

@@ -0,0 +1,30 @@
{% if settings.image.src is not empty %}
{% set id_attribute = settings._cssid is not empty ? 'id=' ~ settings._cssid | e('html_attr') : '' %}
{% if settings.link.href %}
<{{ settings.link.tag | e('html_tag') }}
{% set linkAttr = settings.link.tag == 'a' ? 'href' : 'data-action-link' %}
{{ linkAttr }}="{{ settings.link.href | raw }}"
class="{{ base_styles['link-base'] }}"
target="{{ settings.link.target }}"
data-interaction-id="{{ id }}"
data-interactions="{{ interactions | json_encode | e('html_attr') }}"
>
{% endif %}
<img class="{{ base_styles['base'] }} {{ settings.classes | join(' ') }}"
{% if not settings.link.href %}
data-interaction-id="{{ id }}"
data-interactions="{{ interactions | json_encode | e('html_attr') }}"
{% endif %}
{{ id_attribute }} {{ settings.attributes | raw }}
{% for attr, value in settings.image %}
{% if attr == 'src' %}
src="{{ value | e('full_url') }}"
{% else %}
{{ attr | e('html_attr') }}="{{ value }}"
{% endif %}
{% endfor %}
/>
{% if settings.link.href %}
</{{ settings.link.tag | e('html_tag') }}>
{% endif %}
{% endif %}

View File

@@ -0,0 +1,111 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Image;
use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Image_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\Controls\Types\Image_Control;
use Elementor\Modules\AtomicWidgets\Utils\Image\Placeholder_Image;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Image extends Atomic_Widget_Base {
use Has_Template;
public static $widget_description = 'Display an image with customizable styles and link options.';
const LINK_BASE_STYLE_KEY = 'link-base';
const BASE_STYLE_KEY = 'base';
public static function get_element_type(): string {
return 'e-image';
}
public function get_title() {
return esc_html__( 'Image', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-e-image';
}
protected static function define_props_schema(): array {
$props = [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'image' => Image_Prop_Type::make()
->default_url( Placeholder_Image::get_placeholder_image() )
->default_size( 'full' ),
'link' => Link_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
return $props;
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( esc_html__( 'Content', 'elementor' ) )
->set_items( [
Image_Control::bind_to( 'image' )
->set_label( __( 'Image', 'elementor' ) ),
] ),
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( $this->get_settings_controls() ),
];
}
protected function get_settings_controls(): array {
return [
Link_Control::bind_to( 'link' )
->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
->set_label( __( 'Link', 'elementor' ) ),
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
];
}
protected function define_base_styles(): array {
return [
self::LINK_BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'display', 'inherit' )
->add_prop( 'width', 'fit-content' )
),
self::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'display', 'block' )
),
];
}
protected function get_templates(): array {
return [
'elementor/elements/atomic-image' => __DIR__ . '/atomic-image.html.twig',
];
}
}

View File

@@ -0,0 +1,17 @@
{% if settings.paragraph is not empty %}
{% set id_attribute = settings._cssid is not empty ? 'id=' ~ settings._cssid | e('html_attr') : '' %}
<{{ settings.tag | e('html_tag') }} class="{{ settings.classes | merge( [ base_styles.base ] ) | join(' ') }}" data-interaction-id="{{ id }}" data-interactions="{{ interactions | json_encode | e('html_attr') }}" {{ id_attribute }} {{ settings.attributes | raw }}>
{% if settings.link.href %}
<{{ settings.link.tag | e('html_tag') }}
{% set linkAttr = settings.link.tag == 'a' ? 'href' : 'data-action-link' %}
{{ linkAttr }}="{{ settings.link.href | raw }}"
target="{{ settings.link.target }}"
class="{{ base_styles['link-base'] }}"
>
{{ settings.paragraph | striptags(allowed_tags) | raw }}
</{{ settings.link.tag | e('html_tag') }}>
{% else %}
{{ settings.paragraph | striptags('<b><strong><sup><sub><s><em><u><ul><ol><li><blockquote><a><del><span><br>') | raw }}
{% endif %}
</{{ settings.tag | e('html_tag') }}>
{% endif %}

View File

@@ -0,0 +1,136 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Paragraph;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Select_Control;
use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Html_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Inline_Editing_Control;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Atomic_Paragraph extends Atomic_Widget_Base {
use Has_Template;
const LINK_BASE_STYLE_KEY = 'link-base';
public static $widget_description = 'Display a paragraph with customizable tag, styles, and link options.';
public static function get_element_type(): string {
return 'e-paragraph';
}
public function get_title() {
return esc_html__( 'Paragraph', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-paragraph';
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'paragraph' => Html_Prop_Type::make()
->default( __( 'Type your paragraph here', 'elementor' ) )
->description( 'The text content of the paragraph.' ),
'tag' => String_Prop_Type::make()
->enum( [ 'p', 'span' ] )
->default( 'p' ),
'link' => Link_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Content', 'elementor' ) )
->set_items( [
Inline_Editing_Control::bind_to( 'paragraph' )
->set_placeholder( __( 'Type your paragraph here', 'elementor' ) )
->set_label( __( 'Paragraph', 'elementor' ) ),
] ),
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( $this->get_settings_controls() ),
];
}
protected function get_settings_controls(): array {
return [
Select_Control::bind_to( 'tag' )
->set_options([
[
'value' => 'p',
'label' => 'p',
],
[
'value' => 'span',
'label' => 'span',
],
])
->set_label( __( 'Tag', 'elementor' ) ),
Link_Control::bind_to( 'link' )
->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
->set_label( __( 'Link', 'elementor' ) )
->set_meta( [
'topDivider' => true,
] ),
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
];
}
protected function define_base_styles(): array {
$margin_value = Size_Prop_Type::generate( [
'unit' => 'px',
'size' => 0 ,
] );
return [
'base' => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'margin', $margin_value )
),
self::LINK_BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'all', 'unset' )
->add_prop( 'cursor', 'pointer' )
),
];
}
protected function get_templates(): array {
return [
'elementor/elements/atomic-paragraph' => __DIR__ . '/atomic-paragraph.html.twig',
];
}
}

View File

@@ -0,0 +1,240 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Svg;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Core\Utils\Svg\Svg_Sanitizer;
use Elementor\Modules\AtomicWidgets\Controls\Types\Svg_Control;
use Elementor\Modules\AtomicWidgets\PropTypes\Image_Src_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Svg extends Atomic_Widget_Base {
const BASE_STYLE_KEY = 'base';
const DEFAULT_SVG = 'images/default-svg.svg';
const DEFAULT_SVG_PATH = ELEMENTOR_ASSETS_PATH . self::DEFAULT_SVG;
const DEFAULT_SVG_URL = ELEMENTOR_ASSETS_URL . self::DEFAULT_SVG;
public static $widget_description = 'Display an SVG image with customizable styles and link options.';
public static function get_element_type(): string {
return 'e-svg';
}
public function get_title() {
return esc_html__( 'SVG', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-svg';
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()->default( [] ),
'svg' => Image_Src_Prop_Type::make()
->default_url( static::DEFAULT_SVG_URL )
->meta( 'is_svg', true ),
'link' => Link_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( esc_html__( 'Content', 'elementor' ) )
->set_items( [
Svg_Control::bind_to( 'svg' )
->set_label( __( 'SVG', 'elementor' ) ),
] ),
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( $this->get_settings_controls() ),
];
}
protected function get_settings_controls(): array {
return [
Link_Control::bind_to( 'link' )
->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
->set_label( __( 'Link', 'elementor' ) ),
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
];
}
protected function define_base_styles(): array {
$display_value = String_Prop_Type::generate( 'inline-block' );
$size = Size_Prop_Type::generate( [
'size' => 65,
'unit' => 'px',
] );
return [
self::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'display', $display_value )
->add_prop( 'width', $size )
->add_prop( 'height', $size )
),
];
}
protected function render() {
$settings = $this->get_atomic_settings();
$svg = $this->get_svg_content( $settings );
if ( ! $svg ) {
return;
}
$svg = new \WP_HTML_Tag_Processor( $svg );
if ( ! $svg->next_tag( 'svg' ) ) {
return;
}
$svg->set_attribute( 'fill', 'currentColor' );
$svg->set_attribute( 'data-interaction-id', $this->get_id() );
$interaction_ids = $this->get_interactions_ids();
if ( ! empty( $interaction_ids ) ) {
$svg->set_attribute( 'data-interactions', wp_json_encode( $interaction_ids ) );
}
$this->add_svg_style( $svg, 'width: 100%; height: 100%; overflow: unset;' );
$svg_html = ( new Svg_Sanitizer() )->sanitize( $svg->get_updated_html() );
$classes = array_filter( array_merge(
[ self::BASE_STYLE_KEY => $this->get_base_styles_dictionary()[ self::BASE_STYLE_KEY ] ],
$settings['classes']
) );
$classes_string = implode( ' ', $classes );
$cssid_attribute = ! empty( $settings['_cssid'] ) ? 'id="' . esc_attr( $settings['_cssid'] ) . '"' : '';
$all_attributes = trim( $cssid_attribute . ' ' . $settings['attributes'] );
$data_attributes_string = '';
if ( ! empty( $interaction_ids ) ) {
$data_attributes_string = sprintf(
'data-interaction-id="%s" data-interactions="%s"',
esc_attr( $this->get_id() ),
esc_attr( wp_json_encode( $interaction_ids ) )
);
}
$attributes_string = trim( $data_attributes_string . ' ' . $all_attributes );
if ( isset( $settings['link'] ) && ! empty( $settings['link']['href'] ) ) {
$html_tag = Utils::validate_html_tag( $settings['link']['tag'] ?? 'a' );
$link_attributes = $this->get_link_attributes( $settings['link'], true );
$link_attribute_key = $link_attributes['key'];
$link_destination = $link_attributes[ $link_attribute_key ];
$svg_html = sprintf(
'<%s %s="%s" target="%s" class="%s" %s>%s</%s>',
$html_tag,
$link_attribute_key,
$link_destination,
esc_attr( $settings['link']['target'] ),
esc_attr( $classes_string ),
$attributes_string,
$svg_html,
$html_tag
);
} else {
$svg_html = sprintf( '<div class="%s" %s>%s</div>', esc_attr( $classes_string ), $attributes_string, $svg_html );
}
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo $svg_html;
}
private function get_svg_content( $settings ) {
$svg_data = $settings['svg'] ?? null;
if ( ! $svg_data ) {
return $this->get_default_svg_content();
}
if ( is_string( $svg_data ) ) {
return $this->fetch_svg_from_url( $svg_data );
}
if ( isset( $svg_data['id'] ) ) {
$content = Utils::file_get_contents(
get_attached_file( $svg_data['id'] )
);
if ( $content ) {
return $content;
}
}
if ( isset( $svg_data['url'] ) && static::DEFAULT_SVG_URL !== $svg_data['url'] ) {
return $this->fetch_svg_from_url( $svg_data['url'] );
}
return $this->get_default_svg_content();
}
private function fetch_svg_from_url( string $url ) {
if ( empty( $url ) || static::DEFAULT_SVG_URL === $url ) {
return $this->get_default_svg_content();
}
$content = wp_safe_remote_get( $url );
if ( ! is_wp_error( $content ) ) {
return $content['body'];
}
return $this->get_default_svg_content();
}
private function get_default_svg_content() {
$content = Utils::file_get_contents( static::DEFAULT_SVG_PATH );
return $content ? $content : null;
}
private function add_svg_style( &$svg, $new_style ) {
$svg_style = $svg->get_attribute( 'style' );
$svg_style = trim( (string) $svg_style );
if ( empty( $svg_style ) ) {
$svg_style = $new_style;
} else {
$svg_style = rtrim( $svg_style, ';' ) . '; ' . $new_style;
}
$svg->set_attribute( 'style', $svg_style );
}
}

View File

@@ -0,0 +1,142 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Styles\Style_States;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\Elements\Base\Render_Context;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Tab_Content extends Atomic_Element_Base {
const BASE_STYLE_KEY = 'base';
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->meta( 'llm_support', false );
}
public static function get_type() {
return 'e-tab-content';
}
public static function get_element_type(): string {
return 'e-tab-content';
}
public function get_title() {
return esc_html__( 'Tab content', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic', 'tab', 'content', 'tabs' ];
}
public function get_icon() {
return 'eicon-layout';
}
public function should_show_in_panel() {
return false;
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'tab-id' => String_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( [] ),
];
}
protected function define_atomic_style_states(): array {
$selected_state = Style_States::get_class_states_map()['selected'];
return [ $selected_state ];
}
protected function define_base_styles(): array {
$styles = [
'display' => String_Prop_Type::generate( 'block' ),
'padding' => Size_Prop_Type::generate( [
'size' => 10,
'unit' => 'px',
] ),
'min-width' => Size_Prop_Type::generate( [
'size' => 30,
'unit' => 'px',
] ),
];
return [
static::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_props( $styles )
),
];
}
protected function define_initial_attributes() {
return [
'role' => 'tabpanel',
];
}
protected function add_render_attributes() {
parent::add_render_attributes();
$settings = $this->get_atomic_settings();
$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
$initial_attributes = $this->define_initial_attributes();
$tabs_context = Render_Context::get( Atomic_Tabs::class );
$default_active_tab = $tabs_context['default-active-tab'];
$get_tab_content_index = $tabs_context['get-tab-content-index'];
$tabs_id = $tabs_context['tabs-id'];
$index = $get_tab_content_index( $this->get_id() );
$is_active = $default_active_tab === $index;
$attributes = [
'class' => [
'e-con',
'e-atomic-element',
$base_style_class,
...( $settings['classes'] ?? [] ),
],
'x-bind' => 'tabContent',
'id' => Atomic_Tabs::get_tab_content_id( $tabs_id, $index ),
'aria-labelledby' => Atomic_Tabs::get_tab_id( $tabs_id, $index ),
];
if ( ! $is_active ) {
$attributes['hidden'] = 'true';
$attributes['style'] = 'display: none;';
}
if ( ! empty( $settings['_cssid'] ) ) {
$attributes['id'] = esc_attr( $settings['_cssid'] );
}
$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
}
}

View File

@@ -0,0 +1,198 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Styles\Style_States;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Html_Prop_Type;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Paragraph\Atomic_Paragraph;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Color_Prop_Type;
use Elementor\Modules\AtomicWidgets\Elements\Base\Render_Context;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Prop_Type;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Tab extends Atomic_Element_Base {
const BASE_STYLE_KEY = 'base';
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->meta( 'llm_support', false );
}
public static function get_type() {
return 'e-tab';
}
public static function get_element_type(): string {
return 'e-tab';
}
public function get_title() {
return esc_html__( 'Tab trigger', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-layout';
}
public function should_show_in_panel() {
return false;
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( [] ),
];
}
protected function define_atomic_style_states(): array {
$selected_state = Style_States::get_class_states_map()['selected'];
return [ $selected_state ];
}
protected function define_base_styles(): array {
$styles = [
'display' => String_Prop_Type::generate( 'block' ),
'cursor' => String_Prop_Type::generate( 'pointer' ),
'color' => Color_Prop_Type::generate( '#0C0D0E' ),
'border-style' => String_Prop_Type::generate( 'solid' ),
'border-color' => Color_Prop_Type::generate( '#E0E0E0' ),
'border-width' => Size_Prop_Type::generate( [
'size' => 2,
'unit' => 'px',
]),
'padding' => Size_Prop_Type::generate( [
'size' => 8,
'unit' => 'px',
]),
'width' => Size_Prop_Type::generate( [
'size' => 160,
'unit' => 'px',
]),
'background' => Background_Prop_Type::generate( [
'color' => Color_Prop_Type::generate( '#FFFFFF' ),
]),
];
$selected_styles = [
'outline-width' => Size_Prop_Type::generate( [
'size' => 0,
'unit' => 'px',
]),
'border-color' => Color_Prop_Type::generate( '#0C0D0E' ),
];
$hover_styles = [
'background' => Background_Prop_Type::generate( [
'color' => Color_Prop_Type::generate( '#E0E0E0' ),
]),
];
return [
static::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_props( $styles )
)
->add_variant(
Style_Variant::make()
->set_state( Style_States::SELECTED )
->add_props( $selected_styles )
)
->add_variant(
Style_Variant::make()
->set_state( Style_States::FOCUS )
->add_props( $selected_styles )
)
->add_variant(
Style_Variant::make()
->set_state( Style_States::HOVER )
->add_props( $hover_styles )
),
];
}
protected function define_initial_attributes() {
return [
'role' => 'tab',
'tabindex' => '-1',
];
}
protected function define_default_html_tag() {
return 'button';
}
protected function define_default_children() {
return [
Atomic_Paragraph::generate()
->settings( [
'paragraph' => Html_Prop_Type::generate( 'Tab' ),
'tag' => String_Prop_Type::generate( 'span' ),
] )
->build(),
];
}
protected function add_render_attributes() {
parent::add_render_attributes();
$settings = $this->get_atomic_settings();
$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
$initial_attributes = $this->define_initial_attributes();
$tabs_context = Render_Context::get( Atomic_Tabs::class );
$default_active_tab = $tabs_context['default-active-tab'];
$get_tab_index = $tabs_context['get-tab-index'];
$tabs_id = $tabs_context['tabs-id'];
$index = $get_tab_index( $this->get_id() );
$is_active = $default_active_tab === $index;
$attributes = [
'class' => [
'e-con',
'e-atomic-element',
$base_style_class,
...( $settings['classes'] ?? [] ),
],
'tabindex' => $is_active ? '0' : '-1',
'aria-selected' => $is_active ? 'true' : 'false',
'x-bind' => 'tab',
'x-ref' => $this->get_id(),
'id' => Atomic_Tabs::get_tab_id( $tabs_id, $index ),
'aria-controls' => Atomic_Tabs::get_tab_content_id( $tabs_id, $index ),
];
if ( ! empty( $settings['_cssid'] ) ) {
$attributes['id'] = esc_attr( $settings['_cssid'] );
}
$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
}
}

View File

@@ -0,0 +1,110 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Boolean_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Tabs_Content_Area extends Atomic_Element_Base {
const BASE_STYLE_KEY = 'base';
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->meta( 'llm_support', false );
}
public static function get_type() {
return 'e-tabs-content-area';
}
public static function get_element_type(): string {
return 'e-tabs-content-area';
}
public function get_title() {
return esc_html__( 'Tabs content area', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-tab-content';
}
public function should_show_in_panel() {
return false;
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( [
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( [
'layout' => 'two-columns',
] ),
] ),
];
}
protected function define_base_styles(): array {
$styles = [
'display' => String_Prop_Type::generate( 'block' ),
];
return [
static::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_props( $styles )
),
];
}
protected function add_render_attributes() {
parent::add_render_attributes();
$settings = $this->get_atomic_settings();
$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
$initial_attributes = $this->define_initial_attributes();
$attributes = [
'class' => [
'e-con',
'e-atomic-element',
$base_style_class,
...( $settings['classes'] ?? [] ),
],
];
if ( ! empty( $settings['_cssid'] ) ) {
$attributes['id'] = esc_attr( $settings['_cssid'] );
}
$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
}
}

View File

@@ -0,0 +1,115 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Tabs_Menu extends Atomic_Element_Base {
const BASE_STYLE_KEY = 'base';
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->meta( 'llm_support', false );
}
public static function get_type() {
return 'e-tabs-menu';
}
public static function get_element_type(): string {
return 'e-tabs-menu';
}
public function get_title() {
return esc_html__( 'Tabs menu', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-tab-menu';
}
public function should_show_in_panel() {
return false;
}
public function define_initial_attributes(): array {
return [
'role' => 'tablist',
];
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( [
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( [
'layout' => 'two-columns',
] ),
] ),
];
}
protected function define_base_styles(): array {
$styles = [
'display' => String_Prop_Type::generate( 'flex' ),
'justify-content' => String_Prop_Type::generate( 'center' ),
];
return [
static::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_props( $styles )
),
];
}
protected function add_render_attributes() {
parent::add_render_attributes();
$settings = $this->get_atomic_settings();
$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
$initial_attributes = $this->define_initial_attributes();
$attributes = [
'class' => [
'e-con',
'e-atomic-element',
$base_style_class,
...( $settings['classes'] ?? [] ),
],
];
if ( ! empty( $settings['_cssid'] ) ) {
$attributes['id'] = esc_attr( $settings['_cssid'] );
}
$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
}
}

View File

@@ -0,0 +1,268 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Dimensions_Prop_Type;
use Elementor\Modules\AtomicWidgets\Controls\Types\Elements\Tabs_Control;
use Elementor\Modules\AtomicWidgets\Elements\Loader\Frontend_Assets_Loader;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
use Elementor\Core\Utils\Collection;
use Elementor\Utils;
use Elementor\Plugin;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Tabs extends Atomic_Element_Base {
const BASE_STYLE_KEY = 'base';
const ELEMENT_TYPE_TABS_MENU = 'e-tabs-menu';
const ELEMENT_TYPE_TABS_CONTENT_AREA = 'e-tabs-content-area';
const ELEMENT_TYPE_TAB = 'e-tab';
const ELEMENT_TYPE_TAB_CONTENT = 'e-tab-content';
public static $widget_description = 'Create a tabbed interface with customizable tabs and content areas. LLM support: Each child element will be represented as a tab, the menu auto-generates based on the children';
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->meta( 'is_container', true );
}
public static function get_type() {
return 'e-tabs';
}
public static function get_element_type(): string {
return 'e-tabs';
}
public function get_title() {
return esc_html__( 'Tabs', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-tabs';
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'default-active-tab' => Number_Prop_Type::make()
->default( 0 )
->meta( Overridable_Prop_Type::ignore() ),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Content', 'elementor' ) )
->set_id( 'content' )
->set_items( [
Tabs_Control::make()
->set_label( __( 'Menu items', 'elementor' ) )
->set_meta( [
'layout' => 'custom',
] ),
] ),
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( [
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( [
'layout' => 'two-columns',
] ),
] ),
];
}
protected function define_base_styles(): array {
$styles = [
'display' => String_Prop_Type::generate( 'flex' ),
'flex-direction' => String_Prop_Type::generate( 'column' ),
'gap' => Size_Prop_Type::generate( [
'size' => 30,
'unit' => 'px',
]),
'padding' => Dimensions_Prop_Type::generate( [
'block-start' => Size_Prop_Type::generate( [
'size' => 0,
'unit' => 'px',
]),
] ),
];
return [
static::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_props( $styles )
),
];
}
protected function define_default_children() {
$default_tab_count = 3;
$tab_elements = [];
$tab_content_elements = [];
foreach ( range( 1, $default_tab_count ) as $i ) {
$tab_elements[] = Atomic_Tab::generate()
->editor_settings( [
'title' => "Tab {$i} trigger",
'initial_position' => $i,
] )
->is_locked( true )
->build();
$tab_content_elements[] = Atomic_Tab_Content::generate()
->is_locked( true )
->editor_settings( [
'title' => "Tab {$i} content",
'initial_position' => $i,
] )
->build();
}
$tabs_menu = Atomic_Tabs_Menu::generate()
->children( $tab_elements )
->is_locked( true )
->build();
$tabs_content_area = Atomic_Tabs_Content_Area::generate()
->children( $tab_content_elements )
->is_locked( true )
->build();
return [
$tabs_menu,
$tabs_content_area,
];
}
public function get_script_depends() {
$global_depends = parent::get_script_depends();
if ( Plugin::$instance->preview->is_preview_mode() ) {
return array_merge( $global_depends, [ 'elementor-tabs-handler', 'elementor-tabs-preview-handler' ] );
}
return array_merge( $global_depends, [ 'elementor-tabs-handler' ] );
}
public function register_frontend_handlers() {
$assets_url = ELEMENTOR_ASSETS_URL;
$min_suffix = ( Utils::is_script_debug() || Utils::is_elementor_tests() ) ? '' : '.min';
wp_register_script(
'elementor-tabs-handler',
"{$assets_url}js/tabs-handler{$min_suffix}.js",
[ Frontend_Assets_Loader::FRONTEND_HANDLERS_HANDLE, Frontend_Assets_Loader::ALPINEJS_HANDLE ],
ELEMENTOR_VERSION,
true
);
wp_register_script(
'elementor-tabs-preview-handler',
"{$assets_url}js/tabs-preview-handler{$min_suffix}.js",
[ Frontend_Assets_Loader::FRONTEND_HANDLERS_HANDLE, Frontend_Assets_Loader::ALPINEJS_HANDLE ],
ELEMENTOR_VERSION,
true
);
}
private function get_filtered_children_ids( $parent_element, $child_type ) {
if ( ! $parent_element ) {
return [];
}
return Collection::make( $parent_element->get_children() )
->filter( fn( $element ) => $element->get_type() === $child_type )
->map( fn( $element ) => $element->get_id() )
->flip()
->all();
}
private function get_tab_index( $tab_id ) {
$direct_children = Collection::make( $this->get_children() );
$tabs_menu = $direct_children->filter( fn( $child ) => $child->get_type() === self::ELEMENT_TYPE_TABS_MENU )->first();
$tab_ids = $this->get_filtered_children_ids( $tabs_menu, self::ELEMENT_TYPE_TAB );
return $tab_ids[ $tab_id ];
}
private function get_tab_content_index( $tab_content_id ) {
$direct_children = Collection::make( $this->get_children() );
$tabs_content_area = $direct_children->filter( fn( $child ) => $child->get_type() === self::ELEMENT_TYPE_TABS_CONTENT_AREA )->first();
$tab_content_ids = $this->get_filtered_children_ids( $tabs_content_area, self::ELEMENT_TYPE_TAB_CONTENT );
return $tab_content_ids[ $tab_content_id ];
}
protected function define_render_context(): array {
$default_active_tab = $this->get_atomic_setting( 'default-active-tab' );
return [
'context' => [
'default-active-tab' => $default_active_tab,
'get-tab-index' => fn( $tab_id ) => $this->get_tab_index( $tab_id ),
'get-tab-content-index' => fn( $tab_content_id ) => $this->get_tab_content_index( $tab_content_id ),
'tabs-id' => $this->get_id(),
],
];
}
protected function add_render_attributes() {
parent::add_render_attributes();
$settings = $this->get_atomic_settings();
$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
$initial_attributes = $this->define_initial_attributes();
$default_active_tab = $settings['default-active-tab'] ?? 0;
$default_active_tab_id = static::get_tab_id( $this->get_id(), $default_active_tab );
$attributes = [
'class' => [
'e-con',
'e-atomic-element',
$base_style_class,
...( $settings['classes'] ?? [] ),
],
'x-data' => 'eTabs' . $this->get_id(),
'data-e-settings' => json_encode( [ 'default-active-tab' => esc_js( $default_active_tab_id ) ] ),
];
if ( ! empty( $settings['_cssid'] ) ) {
$attributes['id'] = esc_attr( $settings['_cssid'] );
}
$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
}
public static function get_tab_id( $tabs_id, $index ) {
return "{$tabs_id}-tab-{$index}";
}
public static function get_tab_content_id( $tabs_id, $index ) {
return "{$tabs_id}-tab-content-{$index}";
}
}

View File

@@ -0,0 +1,87 @@
import { register } from '@elementor/frontend-handlers';
import { Alpine } from '@elementor/alpinejs';
import { TAB_ELEMENT_TYPE, TAB_CONTENT_ELEMENT_TYPE, getTabId, getTabContentId, getIndex, getNextTab } from './utils';
const SELECTED_CLASS = 'e--selected';
register( {
elementType: 'e-tabs',
id: 'e-tabs-handler',
callback: ( { element, settings } ) => {
const tabsId = element.dataset.id;
Alpine.data( `eTabs${ tabsId }`, () => ( {
activeTab: settings[ 'default-active-tab' ],
navigateTabs( { key, target: tab } ) {
const nextTab = getNextTab( key, tab );
nextTab.focus();
},
tab: {
':id'() {
const index = getIndex( this.$el, TAB_ELEMENT_TYPE );
return getTabId( tabsId, index );
},
'@click'() {
const id = this.$el.id;
this.activeTab = id;
},
'@keydown.arrow-right.prevent'( event ) {
this.navigateTabs( event );
},
'@keydown.arrow-left.prevent'( event ) {
this.navigateTabs( event );
},
':class'() {
const id = this.$el.id;
return this.activeTab === id ? SELECTED_CLASS : '';
},
':aria-selected'() {
const id = this.$el.id;
return this.activeTab === id ? 'true' : 'false';
},
':tabindex'() {
const id = this.$el.id;
return this.activeTab === id ? '0' : '-1';
},
':aria-controls'() {
const index = getIndex( this.$el, TAB_ELEMENT_TYPE );
return getTabContentId( tabsId, index );
},
},
tabContent: {
':aria-labelledby'() {
const index = getIndex( this.$el, TAB_CONTENT_ELEMENT_TYPE );
return getTabId( tabsId, index );
},
'x-show'() {
const index = getIndex( this.$el, TAB_CONTENT_ELEMENT_TYPE );
const tabId = getTabId( tabsId, index );
const isActive = this.activeTab === tabId;
this.$nextTick( () => {
this.$el.classList.toggle( SELECTED_CLASS, isActive );
} );
return isActive;
},
':id'() {
const index = getIndex( this.$el, TAB_CONTENT_ELEMENT_TYPE );
return getTabContentId( tabsId, index );
},
},
} ) );
},
} );

View File

@@ -0,0 +1,30 @@
import { register } from '@elementor/frontend-handlers';
import { Alpine, refreshTree } from '@elementor/alpinejs';
import { TAB_ELEMENT_TYPE, TAB_CONTENT_ELEMENT_TYPE, getTabId, getIndex } from './utils';
register( {
elementType: 'e-tabs',
id: 'e-tabs-preview-handler',
callback: ( { element, signal, listenToChildren } ) => {
window?.parent.addEventListener( 'elementor/navigator/item/click', ( event ) => {
const { id, type } = event.detail;
if ( type !== TAB_ELEMENT_TYPE && type !== TAB_CONTENT_ELEMENT_TYPE ) {
return;
}
const targetElement = Alpine.$data( element ).$refs[ id ];
if ( ! targetElement ) {
return;
}
const targetIndex = getIndex( targetElement, type );
Alpine.$data( element ).activeTab = getTabId( element.dataset.id, targetIndex );
}, { signal } );
// Re-initialize Alpine to sync with editor DOM manipulations that bypass Alpine's reactivity.
listenToChildren( [ TAB_ELEMENT_TYPE, TAB_CONTENT_ELEMENT_TYPE ] )
.render( () => refreshTree( element ) );
},
} );

View File

@@ -0,0 +1,44 @@
export const TAB_ELEMENT_TYPE = 'e-tab';
export const TAB_CONTENT_ELEMENT_TYPE = 'e-tab-content';
export const TABS_CONTENT_AREA_ELEMENT_TYPE = 'e-tabs-content-area';
export const TABS_MENU_ELEMENT_TYPE = 'e-tabs-menu';
const NAVIGATE_UP_KEYS = [ 'ArrowUp', 'ArrowLeft' ];
const NAVIGATE_DOWN_KEYS = [ 'ArrowDown', 'ArrowRight' ];
export const getTabId = ( tabsId, tabIndex ) => {
return `${ tabsId }-tab-${ tabIndex }`;
};
export const getTabContentId = ( tabsId, tabIndex ) => {
return `${ tabsId }-tab-content-${ tabIndex }`;
};
export const getChildren = ( el, elementType ) => {
const parent = el.parentElement;
return Array.from( parent.children ).filter( ( child ) => {
return child.dataset.element_type === elementType;
} );
};
export const getIndex = ( el, elementType ) => {
const children = getChildren( el, elementType );
return children.indexOf( el );
};
export const getNextTab = ( key, tab ) => {
const tabs = getChildren( tab, TAB_ELEMENT_TYPE );
const tabsLength = tabs.length;
const currentIndex = getIndex( tab, TAB_ELEMENT_TYPE );
if ( NAVIGATE_DOWN_KEYS.includes( key ) ) {
return tabs[ ( currentIndex + 1 ) % tabsLength ];
}
if ( NAVIGATE_UP_KEYS.includes( key ) ) {
return tabs[ ( currentIndex - 1 + tabsLength ) % tabsLength ];
}
};

View File

@@ -0,0 +1,18 @@
{% if settings.source is not empty %}
{% set id_attribute = settings._cssid is not empty ? 'id=' ~ settings._cssid | e('html_attr') : '' %}
{% set classes = settings.classes | merge( [ base_styles.base ] ) | join(' ') %}
{% set data_settings = {
'source': settings.source,
'autoplay': settings.autoplay,
'mute': settings.mute,
'controls': settings.player_controls,
'cc_load_policy': settings.captions,
'loop': settings.loop,
'rel': settings.rel,
'start': settings.start,
'end': settings.end,
'privacy': settings.privacy_mode,
'lazyload': settings.lazyload,
} %}
<div data-id="{{ id }}" data-interaction-id="{{ id }}" data-e-type="{{ type }}" data-interactions="{{ interactions | json_encode | e('html_attr') }}" {{ id_attribute }} class="{{ classes }}" {{ settings.attributes | raw }} data-settings="{{ data_settings|json_encode|e('html_attr') }}"></div>
{% endif %}

View File

@@ -0,0 +1,144 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Youtube;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Switch_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\DynamicTags\Dynamic_Prop_Type;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Boolean_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Elements\Loader\Frontend_Assets_Loader;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Youtube extends Atomic_Widget_Base {
use Has_Template;
protected function get_css_id_control_meta(): array {
return [
'layout' => 'two-columns',
'topDivider' => false,
];
}
public static function get_element_type(): string {
return 'e-youtube';
}
public function get_title() {
return esc_html__( 'YouTube', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-e-youtube';
}
protected static function define_props_schema(): array {
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'source' => String_Prop_Type::make()
->default( 'https://www.youtube.com/watch?v=XHOmBV4js_E' ),
'start' => String_Prop_Type::make()->meta( Dynamic_Prop_Type::ignore() ),
'end' => String_Prop_Type::make()->meta( Dynamic_Prop_Type::ignore() ),
'autoplay' => Boolean_Prop_Type::make()->default( false ),
'mute' => Boolean_Prop_Type::make()->default( false ),
'loop' => Boolean_Prop_Type::make()->default( false ),
'lazyload' => Boolean_Prop_Type::make()->default( false ),
'player_controls' => Boolean_Prop_Type::make()->default( true ),
'captions' => Boolean_Prop_Type::make()->default( false ),
'privacy_mode' => Boolean_Prop_Type::make()->default( false ),
'rel' => Boolean_Prop_Type::make()->default( true ),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Content', 'elementor' ) )
->set_items( [
Text_Control::bind_to( 'source' )
->set_placeholder( esc_html__( 'Type or paste your URL', 'elementor' ) )
->set_label( esc_html__( 'YouTube URL', 'elementor' ) ),
Text_Control::bind_to( 'start' )->set_label( esc_html__( 'Start time', 'elementor' ) ),
Text_Control::bind_to( 'end' )->set_label( esc_html__( 'End time', 'elementor' ) ),
Switch_Control::bind_to( 'autoplay' )->set_label( esc_html__( 'Autoplay', 'elementor' ) ),
Switch_Control::bind_to( 'mute' )->set_label( esc_html__( 'Mute', 'elementor' ) ),
Switch_Control::bind_to( 'loop' )->set_label( esc_html__( 'Loop', 'elementor' ) ),
Switch_Control::bind_to( 'lazyload' )->set_label( esc_html__( 'Lazy load', 'elementor' ) ),
Switch_Control::bind_to( 'player_controls' )->set_label( esc_html__( 'Player controls', 'elementor' ) ),
Switch_Control::bind_to( 'captions' )->set_label( esc_html__( 'Captions', 'elementor' ) ),
Switch_Control::bind_to( 'privacy_mode' )->set_label( esc_html__( 'Privacy mode', 'elementor' ) ),
Switch_Control::bind_to( 'rel' )->set_label( esc_html__( 'Related videos', 'elementor' ) ),
] ),
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( $this->get_settings_controls() ),
];
}
protected function get_settings_controls(): array {
return [
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
];
}
protected function define_base_styles(): array {
return [
'base' => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'aspect-ratio', String_Prop_Type::generate( '16/9' ) )
->add_prop( 'overflow', String_Prop_Type::generate( 'hidden' ) )
),
];
}
public function get_script_depends() {
return array_merge(
parent::get_script_depends(),
[ 'elementor-youtube-handler' ],
);
}
public function register_frontend_handlers() {
$assets_url = ELEMENTOR_ASSETS_URL;
$min_suffix = ( Utils::is_script_debug() || Utils::is_elementor_tests() ) ? '' : '.min';
wp_register_script(
'elementor-youtube-handler',
"{$assets_url}js/youtube-handler{$min_suffix}.js",
[ Frontend_Assets_Loader::FRONTEND_HANDLERS_HANDLE ],
ELEMENTOR_VERSION,
true
);
}
protected function get_templates(): array {
return [
'elementor/elements/atomic-youtube' => __DIR__ . '/atomic-youtube.html.twig',
];
}
}

View File

@@ -0,0 +1,126 @@
import { register } from '@elementor/frontend-handlers';
const getYoutubeVideoIdFromUrl = ( url ) => {
const regex = /^(?:https?:\/\/)?(?:www\.)?(?:m\.)?(?:youtu\.be\/|youtube\.com\/(?:(?:watch)?\?(?:.*&)?vi?=|(?:embed|v|vi|user|shorts)\/))([^?&"'>]+)/;
const match = url.match( regex );
return match ? match[ 1 ] : null;
};
const loadYouTubeAPI = () => {
return new Promise( ( resolve ) => {
if ( window.YT && window.YT.loaded ) {
resolve( window.YT );
return;
}
const YOUTUBE_IFRAME_API_URL = 'https://www.youtube.com/iframe_api';
if ( ! document.querySelector( `script[src="${ YOUTUBE_IFRAME_API_URL }"]` ) ) {
const tag = document.createElement( 'script' );
tag.src = YOUTUBE_IFRAME_API_URL;
const firstScriptTag = document.getElementsByTagName( 'script' )[ 0 ];
firstScriptTag.parentNode.insertBefore( tag, firstScriptTag );
}
const checkYT = () => {
if ( window.YT && window.YT.loaded ) {
resolve( window.YT );
} else {
setTimeout( checkYT, 350 );
}
};
checkYT();
} );
};
register( {
elementType: 'e-youtube',
id: 'e-youtube-handler',
callback: ( { element } ) => {
const youtubeElement = document.createElement( 'div' );
youtubeElement.style.height = '100%';
element.appendChild( youtubeElement );
const settingsAttr = element.getAttribute( 'data-settings' );
const parsedSettings = settingsAttr ? JSON.parse( settingsAttr ) : {};
const videoId = getYoutubeVideoIdFromUrl( parsedSettings.source );
if ( ! videoId ) {
return;
}
let player;
let observer;
const prepareYTVideo = ( YT ) => {
const playerOptions = {
videoId,
events: {
onReady: () => {
if ( parsedSettings.mute ) {
player.mute();
}
if ( parsedSettings.autoplay ) {
player.playVideo();
}
},
onStateChange: ( event ) => {
if ( event.data === YT.PlayerState.ENDED && parsedSettings.loop ) {
player.seekTo( parsedSettings.start || 0 );
}
},
},
playerVars: {
controls: parsedSettings.controls ? 1 : 0,
rel: parsedSettings.rel ? 0 : 1,
cc_load_policy: parsedSettings.cc_load_policy ? 1 : 0,
autoplay: parsedSettings.autoplay ? 1 : 0,
start: parsedSettings.start,
end: parsedSettings.end,
},
};
// To handle CORS issues, when the default host is changed, the origin parameter has to be set.
if ( parsedSettings.privacy ) {
playerOptions.host = 'https://www.youtube-nocookie.com';
playerOptions.origin = window.location.hostname;
}
player = new YT.Player( youtubeElement, playerOptions );
return player;
};
if ( parsedSettings.lazyload ) {
observer = new IntersectionObserver(
( entries ) => {
if ( entries[ 0 ].isIntersecting ) {
loadYouTubeAPI().then( ( apiObject ) => prepareYTVideo( apiObject ) );
observer.unobserve( element );
}
},
);
observer.observe( element );
} else {
loadYouTubeAPI().then( ( apiObject ) => prepareYTVideo( apiObject ) );
}
return () => {
if ( player && 'function' === typeof player.destroy ) {
player.destroy();
player = null;
}
if ( element.contains( youtubeElement ) ) {
element.removeChild( youtubeElement );
}
if ( observer && 'function' === typeof observer.disconnect ) {
observer.disconnect();
observer = null;
}
};
},
} );

View File

@@ -0,0 +1,253 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
use Elementor\Element_Base;
use Elementor\Modules\AtomicWidgets\Elements\Loader\Frontend_Assets_Loader;
use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Concerns\Has_Meta;
use Elementor\Plugin;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
abstract class Atomic_Element_Base extends Element_Base {
use Has_Atomic_Base;
use Has_Meta;
protected $version = '0.0';
protected $styles = [];
protected $interactions = [];
protected $editor_settings = [];
public static $widget_description = null;
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->version = $data['version'] ?? '0.0';
$this->styles = $data['styles'] ?? [];
$this->interactions = $this->parse_atomic_interactions( $data['interactions'] ?? [] );
$this->editor_settings = $data['editor_settings'] ?? [];
$this->add_script_depends( Frontend_Assets_Loader::ATOMIC_WIDGETS_HANDLER );
if ( static::$widget_description ) {
$this->description( static::$widget_description );
}
}
private function parse_atomic_interactions( $interactions ) {
if ( empty( $interactions ) ) {
return [];
}
if ( is_string( $interactions ) ) {
$decoded = json_decode( $interactions, true );
if ( json_last_error() === JSON_ERROR_NONE && is_array( $decoded ) ) {
$interactions = $decoded;
}
}
if ( ! is_array( $interactions ) ) {
return [];
}
return $interactions;
}
private function convert_prop_type_interactions_to_legacy_for_runtime( $interactions ) {
$legacy_items = [];
foreach ( $interactions['items'] as $item ) {
if ( isset( $item['$$type'] ) && 'interaction-item' === $item['$$type'] ) {
$legacy_item = $this->extract_legacy_interaction_from_prop_type( $item );
if ( $legacy_item ) {
$legacy_items[] = $legacy_item;
}
} else {
$legacy_items[] = $item;
}
}
return [
'version' => $interactions['version'] ?? 1,
'items' => $legacy_items,
];
}
abstract protected function define_atomic_controls(): array;
protected function define_atomic_style_states(): array {
return [];
}
public function get_global_scripts() {
return [];
}
final public function get_initial_config() {
$config = parent::get_initial_config();
$props_schema = static::get_props_schema();
$config['atomic_controls'] = $this->get_atomic_controls();
$config['atomic_props_schema'] = $props_schema;
$config['atomic_style_states'] = $this->define_atomic_style_states();
$config['dependencies_per_target_mapping'] = Dependency_Manager::get_source_to_dependents( $props_schema );
$config['base_styles'] = $this->get_base_styles();
$config['version'] = $this->version;
$config['show_in_panel'] = $this->should_show_in_panel();
$config['categories'] = [ 'v4-elements' ];
$config['hide_on_search'] = false;
$config['controls'] = [];
$config['keywords'] = $this->get_keywords();
$config['default_children'] = $this->define_default_children();
$config['initial_attributes'] = $this->define_initial_attributes();
$config['include_in_widgets_config'] = true;
$config['default_html_tag'] = $this->define_default_html_tag();
$config['meta'] = $this->get_meta();
return $config;
}
protected function should_show_in_panel() {
return true;
}
protected function define_default_children() {
return [];
}
protected function define_default_html_tag() {
return 'div';
}
protected function define_initial_attributes() {
return [];
}
protected function add_render_attributes() {
parent::add_render_attributes();
$interaction_ids = $this->get_interactions_ids();
if ( ! empty( $interaction_ids ) ) {
$this->add_render_attribute( '_wrapper', 'data-interaction-id', $this->get_id() );
$this->add_render_attribute( '_wrapper', 'data-interactions', json_encode( $interaction_ids ) );
}
}
/**
* Get Element keywords.
*
* Retrieve the element keywords.
*
* @since 3.29
* @access public
*
* @return array Element keywords.
*/
public function get_keywords() {
return [];
}
/**
* @return array<string, Prop_Type>
*/
abstract protected static function define_props_schema(): array;
/**
* Get the HTML tag for rendering.
*
* @return string
*/
protected function get_html_tag(): string {
$settings = $this->get_atomic_settings();
$default_html_tag = $this->define_default_html_tag();
return ! empty( $settings['link']['href'] ) ? $settings['link']['tag'] : ( $settings['tag'] ?? $default_html_tag );
}
/**
* Print safe HTML tag for the element based on the element settings.
*
* @return void
*/
protected function print_html_tag() {
$html_tag = $this->get_html_tag();
Utils::print_validated_html_tag( $html_tag );
}
/**
* Print custom attributes if they exist.
*
* @return void
*/
protected function print_custom_attributes() {
$settings = $this->get_atomic_settings();
$attributes = $settings['attributes'] ?? '';
if ( ! empty( $attributes ) && is_string( $attributes ) ) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo ' ' . $attributes;
}
}
/**
* Get default child type for container elements.
*
* @param array $element_data
* @return mixed
*/
protected function _get_default_child_type( array $element_data ) {
$el_types = array_keys( Plugin::$instance->elements_manager->get_element_types() );
if ( in_array( $element_data['elType'], $el_types, true ) ) {
return Plugin::$instance->elements_manager->get_element_types( $element_data['elType'] );
}
if ( ! isset( $element_data['widgetType'] ) ) {
return null;
}
return Plugin::$instance->widgets_manager->get_widget_types( $element_data['widgetType'] );
}
/**
* Default before render for container elements.
*
* @return void
*/
public function before_render() {
?>
<<?php $this->print_html_tag(); ?> <?php $this->print_render_attribute_string( '_wrapper' );
$this->print_custom_attributes(); ?>>
<?php
}
/**
* Default after render for container elements.
*
* @return void
*/
public function after_render() {
?>
</<?php $this->print_html_tag(); ?>>
<?php
}
/**
* Default content template - can be overridden by elements that need custom templates.
*
* @return void
*/
protected function content_template() {
?>
<?php
}
public static function generate() {
return Element_Builder::make( static::get_type() );
}
}

View File

@@ -0,0 +1,115 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
use Elementor\Modules\AtomicWidgets\Elements\Loader\Frontend_Assets_Loader;
use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
use Elementor\Modules\AtomicWidgets\PropTypes\Concerns\Has_Meta;
use Elementor\Widget_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
abstract class Atomic_Widget_Base extends Widget_Base {
use Has_Atomic_Base;
use Has_Meta;
public static $widget_description = null;
protected $version = '0.0';
protected $styles = [];
protected $interactions = [];
protected $editor_settings = [];
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->version = $data['version'] ?? '0.0';
$this->styles = $data['styles'] ?? [];
$this->interactions = $this->parse_atomic_interactions( $data['interactions'] ?? [] );
$this->editor_settings = $data['editor_settings'] ?? [];
if ( static::$widget_description ) {
$this->description( static::$widget_description );
}
}
private function parse_atomic_interactions( $interactions ) {
if ( empty( $interactions ) ) {
return [];
}
if ( is_string( $interactions ) ) {
$decoded = json_decode( $interactions, true );
if ( json_last_error() === JSON_ERROR_NONE && is_array( $decoded ) ) {
$interactions = $decoded;
}
}
if ( ! is_array( $interactions ) ) {
return [];
}
return $interactions;
}
private function convert_prop_type_interactions_to_legacy_for_runtime( $interactions ) {
$legacy_items = [];
foreach ( $interactions['items'] as $item ) {
if ( isset( $item['$$type'] ) && 'interaction-item' === $item['$$type'] ) {
$legacy_item = $this->extract_legacy_interaction_from_prop_type( $item );
if ( $legacy_item ) {
$legacy_items[] = $legacy_item;
}
} else {
$legacy_items[] = $item;
}
}
return [
'version' => $interactions['version'] ?? 1,
'items' => $legacy_items,
];
}
abstract protected function define_atomic_controls(): array;
public function get_global_scripts() {
return [];
}
public function get_initial_config() {
$config = parent::get_initial_config();
$props_schema = static::get_props_schema();
$config['atomic'] = true;
$config['atomic_controls'] = $this->get_atomic_controls();
$config['base_styles'] = $this->get_base_styles();
$config['base_styles_dictionary'] = $this->get_base_styles_dictionary();
$config['atomic_props_schema'] = $props_schema;
$config['dependencies_per_target_mapping'] = Dependency_Manager::get_source_to_dependents( $props_schema );
$config['version'] = $this->version;
$config['meta'] = $this->get_meta();
return $config;
}
public function get_categories(): array {
return [ 'v4-elements' ];
}
public function before_render() {}
public function after_render() {}
abstract protected static function define_props_schema(): array;
public static function generate() {
return Widget_Builder::make( static::get_element_type() );
}
public function get_script_depends() {
return [ Frontend_Assets_Loader::ATOMIC_WIDGETS_HANDLER ];
}
}

View File

@@ -0,0 +1,51 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
class Element_Builder {
protected $element_type;
protected $settings = [];
protected $is_locked = false;
protected $children = [];
protected $editor_settings = [];
public static function make( string $element_type ) {
return new self( $element_type );
}
private function __construct( string $element_type ) {
$this->element_type = $element_type;
}
public function settings( array $settings ) {
$this->settings = $settings;
return $this;
}
public function is_locked( $is_locked ) {
$this->is_locked = $is_locked;
return $this;
}
public function editor_settings( array $editor_settings ) {
$this->editor_settings = $editor_settings;
return $this;
}
public function children( array $children ) {
$this->children = $children;
return $this;
}
public function build() {
$element_data = [
'elType' => $this->element_type,
'settings' => $this->settings,
'isLocked' => $this->is_locked,
'editor_settings' => $this->editor_settings,
'elements' => $this->children,
];
return $element_data;
}
}

View File

@@ -0,0 +1,483 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
use Elementor\Element_Base;
use Elementor\Modules\AtomicWidgets\Controls\Base\Atomic_Control_Base;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\PropsResolver\Render_Props_Resolver;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Schema;
use Elementor\Modules\AtomicWidgets\Parsers\Props_Parser;
use Elementor\Modules\AtomicWidgets\Parsers\Style_Parser;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Key_Value_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Utils;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Atomic_Widget_Styles;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* @mixin Element_Base
*/
trait Has_Atomic_Base {
use Has_Base_Styles;
public function has_widget_inner_wrapper(): bool {
return false;
}
abstract public static function get_element_type(): string;
final public function get_name() {
return static::get_element_type();
}
private function get_valid_controls( array $schema, array $controls ): array {
$valid_controls = [];
foreach ( $controls as $control ) {
if ( $control instanceof Section ) {
$cloned_section = clone $control;
$cloned_section->set_items(
$this->get_valid_controls( $schema, $control->get_items() )
);
$valid_controls[] = $cloned_section;
continue;
}
if ( ( $control instanceof Atomic_Control_Base ) ) {
$prop_name = $control->get_bind();
if ( ! $prop_name ) {
Utils::safe_throw( 'Control is missing a bound prop from the schema.' );
continue;
}
if ( ! array_key_exists( $prop_name, $schema ) ) {
Utils::safe_throw( "Prop `{$prop_name}` is not defined in the schema of `{$this->get_name()}`." );
continue;
}
}
$valid_controls[] = $control;
}
return $valid_controls;
}
private static function validate_schema( array $schema ) {
$widget_name = static::class;
foreach ( $schema as $key => $prop ) {
if ( ! ( $prop instanceof Prop_Type ) ) {
Utils::safe_throw( "Prop `$key` must be an instance of `Prop_Type` in `{$widget_name}`." );
}
}
}
private function parse_atomic_styles( array $data ): array {
$styles = $data['styles'] ?? [];
$style_parser = Style_Parser::make( Style_Schema::get() );
foreach ( $styles as $style_id => $style ) {
$result = $style_parser->parse( $style );
if ( ! $result->is_valid() ) {
$widget_id = $data['id'] ?? 'unknown';
throw new \Exception( esc_html( "Styles validation failed for style `$style_id`. Widget ID: `$widget_id`. " . $result->errors()->to_string() ) );
}
$styles[ $style_id ] = $result->unwrap();
}
return $styles;
}
private function parse_atomic_settings( array $settings ): array {
$schema = static::get_props_schema();
$props_parser = Props_Parser::make( $schema );
$result = $props_parser->parse( $settings );
if ( ! $result->is_valid() ) {
throw new \Exception( esc_html( 'Settings validation failed. ' . $result->errors()->to_string() ) );
}
return $result->unwrap();
}
private function parse_atomic_interactions( $interactions ) {
if ( empty( $interactions ) ) {
return [];
}
if ( is_string( $interactions ) ) {
$decoded = json_decode( $interactions, true );
if ( json_last_error() === JSON_ERROR_NONE && is_array( $decoded ) ) {
return $decoded;
}
}
if ( is_array( $interactions ) ) {
return $interactions;
}
return [];
}
private function convert_prop_type_interactions_to_legacy( $interactions ) {
$legacy_items = [];
foreach ( $interactions['items'] as $item ) {
if ( isset( $item['$$type'] ) && 'interaction-item' === $item['$$type'] ) {
$legacy_item = $this->extract_legacy_interaction_from_prop_type( $item );
if ( $legacy_item ) {
$legacy_items[] = $legacy_item;
}
} else {
$legacy_items[] = $item;
}
}
return [
'version' => $interactions['version'] ?? 1,
'items' => $legacy_items,
];
}
private function extract_legacy_interaction_from_prop_type( $item ) {
if ( ! isset( $item['value'] ) || ! is_array( $item['value'] ) ) {
return null;
}
$item_value = $item['value'];
$interaction_id = $this->extract_prop_value( $item_value, 'interaction_id' );
$trigger = $this->extract_prop_value( $item_value, 'trigger' );
$animation = $this->extract_prop_value( $item_value, 'animation' );
if ( ! is_array( $animation ) ) {
return null;
}
$effect = $this->extract_prop_value( $animation, 'effect' );
$type = $this->extract_prop_value( $animation, 'type' );
$direction = $this->extract_prop_value( $animation, 'direction' );
$timing_config = $this->extract_prop_value( $animation, 'timing_config' );
$duration = 300;
$delay = 0;
if ( is_array( $timing_config ) ) {
$duration = $this->extract_prop_value( $timing_config, 'duration', 300 );
$delay = $this->extract_prop_value( $timing_config, 'delay', 0 );
}
$animation_id = implode( '-', [ $trigger, $effect, $type, $direction, $duration, $delay ] );
return [
'interaction_id' => $interaction_id,
'animation' => [
'animation_id' => $animation_id,
'animation_type' => 'full-preset',
],
];
}
private function extract_prop_value( $data, $key, $default = '' ) {
if ( ! is_array( $data ) || ! isset( $data[ $key ] ) ) {
return $default;
}
$value = $data[ $key ];
if ( is_array( $value ) && isset( $value['$$type'] ) && isset( $value['value'] ) ) {
return $value['value'];
}
return null !== $value ? $value : $default;
}
public function get_atomic_controls() {
$controls = apply_filters(
'elementor/atomic-widgets/controls',
$this->define_atomic_controls(),
$this
);
$schema = static::get_props_schema();
// Validate the schema only in the Editor.
static::validate_schema( $schema );
return $this->get_valid_controls( $schema, $controls );
}
protected function get_css_id_control_meta(): array {
return [
'layout' => 'two-columns',
'topDivider' => true,
];
}
final public function get_controls( $control_id = null ) {
if ( ! empty( $control_id ) ) {
return null;
}
return [];
}
final public function get_data_for_save() {
$data = parent::get_data_for_save();
$data['version'] = $this->version;
$data['settings'] = $this->parse_atomic_settings( $data['settings'] );
$data['styles'] = $this->parse_atomic_styles( $data );
$data['editor_settings'] = $this->parse_editor_settings( $data['editor_settings'] );
if ( isset( $data['interactions'] ) && ! empty( $data['interactions'] ) ) {
$data['interactions'] = $this->transform_interactions_for_save( $data['interactions'] );
} else {
$data['interactions'] = [];
}
return $data;
}
private function transform_interactions_for_save( $interactions ) {
$decoded = $this->decode_interactions_data( $interactions );
if ( empty( $decoded['items'] ) ) {
return [];
}
return $decoded;
}
private function decode_interactions_data( $interactions ) {
if ( is_array( $interactions ) ) {
return $interactions;
}
if ( is_string( $interactions ) ) {
$decoded = json_decode( $interactions, true );
if ( json_last_error() === JSON_ERROR_NONE && is_array( $decoded ) ) {
return $decoded;
}
}
return [
'items' => [],
'version' => 1,
];
}
final public function get_raw_data( $with_html_content = false ) {
$raw_data = parent::get_raw_data( $with_html_content );
$raw_data['styles'] = Atomic_Widget_Styles::get_license_based_filtered_styles( $this->styles ?? [] );
$raw_data['interactions'] = $this->interactions ?? [];
$raw_data['editor_settings'] = $this->editor_settings;
return $raw_data;
}
final public function get_stack( $with_common_controls = true ) {
return [
'controls' => [],
'tabs' => [],
];
}
public function get_atomic_settings(): array {
$schema = static::get_props_schema();
$props = $this->get_settings();
$initial_attributes = $this->get_initial_attributes();
$props['attributes'] = Attributes_Prop_Type::generate( array_merge(
$initial_attributes['value'] ?? [],
$props['attributes']['value'] ?? []
) );
return Render_Props_Resolver::for_settings()->resolve( $schema, $props );
}
protected function get_initial_attributes() {
return Attributes_Prop_Type::generate( [
Key_Value_Prop_Type::generate( [
'key' => String_Prop_Type::generate( 'data-e-type' ),
'value' => $this->get_type(),
] ),
Key_Value_Prop_Type::generate( [
'key' => String_Prop_Type::generate( 'data-id' ),
'value' => $this->get_id(),
] ),
] );
}
public function get_atomic_setting( string $key ) {
$schema = static::get_props_schema();
if ( ! isset( $schema[ $key ] ) ) {
return null;
}
$props = $this->get_settings();
$prop_value = $props[ $key ] ?? null;
$single_schema = [ $key => $schema[ $key ] ];
$single_props = [ $key => $prop_value ];
$resolved = Render_Props_Resolver::for_settings()->resolve( $single_schema, $single_props );
return $resolved[ $key ] ?? null;
}
protected function parse_editor_settings( array $data ): array {
$editor_data = [];
if ( isset( $data['title'] ) && is_string( $data['title'] ) ) {
$editor_data['title'] = sanitize_text_field( $data['title'] );
}
return $editor_data;
}
public static function get_props_schema(): array {
$schema = static::define_props_schema();
$schema['_cssid'] = String_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() );
return apply_filters(
'elementor/atomic-widgets/props-schema',
$schema
);
}
public function get_interactions_ids() {
$animation_ids = [];
$list_of_interactions = ( is_array( $this->interactions ) && isset( $this->interactions['items'] ) )
? $this->interactions['items']
: [];
foreach ( $list_of_interactions as $interaction ) {
if ( isset( $interaction['$$type'] ) && 'interaction-item' === $interaction['$$type'] ) {
$animation_id = $this->extract_animation_id_from_prop_type( $interaction );
if ( $animation_id ) {
$animation_ids[] = $animation_id;
}
} elseif ( isset( $interaction['animation']['animation_id'] ) ) {
$animation_ids[] = $interaction['animation']['animation_id'];
}
}
return $animation_ids;
}
private function extract_animation_id_from_prop_type( $item ) {
if ( ! isset( $item['value'] ) || ! is_array( $item['value'] ) ) {
return null;
}
$item_value = $item['value'];
$trigger = $this->extract_prop_value( $item_value, 'trigger' );
$animation = $this->extract_prop_value( $item_value, 'animation' );
if ( ! is_array( $animation ) ) {
return null;
}
$effect = $this->extract_prop_value( $animation, 'effect' );
$type = $this->extract_prop_value( $animation, 'type' );
$direction = $this->extract_prop_value( $animation, 'direction' );
$timing_config = $this->extract_prop_value( $animation, 'timing_config' );
$config = $this->extract_prop_value( $animation, 'config' );
$duration = 300;
$delay = 0;
$replay = 0;
$relative_to = 'viewport';
$offset_top = 15;
$offset_bottom = 85;
if ( is_array( $timing_config ) ) {
$duration = $this->extract_prop_value( $timing_config, 'duration', 300 );
$delay = $this->extract_prop_value( $timing_config, 'delay', 0 );
}
if ( is_array( $config ) ) {
$relative_to = $this->extract_prop_value( $config, 'relative_to', 'viewport' );
$offset_top = $this->extract_prop_value( $config, 'offset_top', 15 );
$offset_bottom = $this->extract_prop_value( $config, 'offset_bottom', 85 );
$replay = $this->extract_prop_value( $config, 'replay', 0 );
if ( empty( $replay ) && 0 !== $replay && '0' !== $replay ) {
$replay = 0;
}
} else {
$replay = 0;
}
return implode( '-', [ $trigger, $effect, $type, $direction, $duration, $delay, $replay, $relative_to, $offset_top, $offset_bottom ] );
}
public function print_content() {
$defined_context = $this->define_render_context();
$context_key = $defined_context['context_key'] ?? static::class;
$element_context = $defined_context['context'] ?? [];
$has_context = ! empty( $element_context );
if ( ! $has_context ) {
return parent::print_content();
}
Render_Context::push( $context_key, $element_context );
parent::print_content();
Render_Context::pop( $context_key );
}
/**
* Define the context for element's Render_Context.
*
* @return array{context_key: ?string, context: array}
*/
protected function define_render_context(): array {
return [
'context_key' => null,
'context' => [],
];
}
protected function get_link_attributes( $link_settings, $add_key_to_result = false ) {
$tag = $link_settings['tag'] ?? Link_Prop_Type::DEFAULT_TAG;
$href = $link_settings['href'];
$target = $link_settings['target'] ?? '_self';
$is_button = 'button' === $tag;
$href_attribute_key = $is_button ? 'data-action-link' : 'href';
$result = [
$href_attribute_key => $href,
'target' => $target,
];
if ( $add_key_to_result ) {
$result['key'] = $href_attribute_key;
}
return $result;
}
}

View File

@@ -0,0 +1,51 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
use Elementor\Core\Utils\Collection;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* @mixin Has_Atomic_Base
*/
trait Has_Base_Styles {
public function get_base_styles() {
$base_styles = $this->define_base_styles();
$style_definitions = [];
foreach ( $base_styles as $key => $style ) {
$id = $this->generate_base_style_id( $key );
$style_definitions[ $id ] = $style->build( $id );
}
return $style_definitions;
}
public function get_base_styles_dictionary() {
$result = [];
$base_styles = array_keys( $this->define_base_styles() );
foreach ( $base_styles as $key ) {
$result[ $key ] = $this->generate_base_style_id( $key );
}
return $result;
}
private function generate_base_style_id( string $key ): string {
return static::get_element_type() . '-' . $key;
}
/**
* @return array<string, Style_Definition>
*/
protected function define_base_styles(): array {
return [];
}
}

View File

@@ -0,0 +1,161 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
use Elementor\Modules\AtomicWidgets\Elements\TemplateRenderer\Template_Renderer;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* @mixin Has_Atomic_Base
*/
trait Has_Template {
public function get_initial_config() {
$config = parent::get_initial_config();
$config['twig_main_template'] = $this->get_main_template();
$config['twig_templates'] = $this->get_templates_contents();
return $config;
}
protected function render() {
try {
$renderer = Template_Renderer::instance();
foreach ( $this->get_templates() as $name => $path ) {
if ( $renderer->is_registered( $name ) ) {
continue;
}
$renderer->register( $name, $path );
}
$context = [
'id' => $this->get_id(),
'type' => $this->get_name(),
'settings' => $this->get_atomic_settings(),
'base_styles' => $this->get_base_styles_dictionary(),
'interactions' => $this->get_interactions_ids(),
];
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo $renderer->render( $this->get_main_template(), $context );
} catch ( \Exception $e ) {
if ( Utils::is_elementor_debug() ) {
throw $e;
}
}
}
public function get_interactions_ids() {
$animation_ids = [];
$list_of_interactions = ( is_array( $this->interactions ) && isset( $this->interactions['items'] ) )
? $this->interactions['items']
: [];
foreach ( $list_of_interactions as $interaction ) {
if ( isset( $interaction['$$type'] ) && 'interaction-item' === $interaction['$$type'] ) {
$animation_id = $this->extract_animation_id_from_prop_type( $interaction );
if ( $animation_id ) {
$animation_ids[] = $animation_id;
}
} elseif ( isset( $interaction['animation']['animation_id'] ) ) {
$animation_ids[] = $interaction['animation']['animation_id'];
}
}
return $animation_ids;
}
private function extract_animation_id_from_prop_type( $item ) {
if ( ! isset( $item['value'] ) || ! is_array( $item['value'] ) ) {
return null;
}
$item_value = $item['value'];
$trigger = $this->extract_prop_value_simple( $item_value, 'trigger' );
$animation = $this->extract_prop_value_simple( $item_value, 'animation' );
if ( ! is_array( $animation ) ) {
return null;
}
$effect = $this->extract_prop_value_simple( $animation, 'effect' );
$type = $this->extract_prop_value_simple( $animation, 'type' );
$direction = $this->extract_prop_value_simple( $animation, 'direction' );
$timing_config = $this->extract_prop_value_simple( $animation, 'timing_config' );
$config = $this->extract_prop_value_simple( $animation, 'config' );
$duration = 300;
$delay = 0;
$replay = 0;
$relative_to = 'viewport';
$offset_top = 15;
$offset_bottom = 85;
if ( is_array( $timing_config ) ) {
$duration = $this->extract_prop_value_simple( $timing_config, 'duration', 300 );
$delay = $this->extract_prop_value_simple( $timing_config, 'delay', 0 );
}
if ( is_array( $config ) ) {
$relative_to = $this->extract_prop_value_simple( $config, 'relative_to', 'viewport' );
$offset_top = $this->extract_prop_value_simple( $config, 'offset_top', 15 );
$offset_bottom = $this->extract_prop_value_simple( $config, 'offset_bottom', 85 );
$replay = $this->extract_prop_value_simple( $config, 'replay', 0 );
if ( empty( $replay ) && 0 !== $replay && '0' !== $replay ) {
$replay = 0;
}
} else {
$replay = 0;
}
return implode( '-', [ $trigger, $effect, $type, $direction, $duration, $delay, $replay, $relative_to, $offset_top, $offset_bottom ] );
}
private function extract_prop_value_simple( $data, $key, $default = '' ) {
if ( ! is_array( $data ) || ! isset( $data[ $key ] ) ) {
return $default;
}
$value = $data[ $key ];
if ( is_array( $value ) && isset( $value['$$type'] ) && isset( $value['value'] ) ) {
return $value['value'];
}
return null !== $value ? $value : $default;
}
protected function get_templates_contents() {
return array_map(
fn ( $path ) => Utils::file_get_contents( $path ),
$this->get_templates()
);
}
protected function get_main_template() {
$templates = $this->get_templates();
if ( count( $templates ) > 1 ) {
Utils::safe_throw( 'When having more than one template, you should override this method to return the main template.' );
return null;
}
foreach ( $templates as $key => $path ) {
// Returns first key in the array.
return $key;
}
return null;
}
abstract protected function get_templates(): array;
}

View File

@@ -0,0 +1,38 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Render_Context {
private static $context_stack = [];
public static function push( string $key, array $context ): void {
if ( ! self::get( $key ) ) {
self::$context_stack[ $key ] = [];
}
self::$context_stack[ $key ][] = $context;
}
public static function pop( string $key ): void {
if ( isset( self::$context_stack[ $key ] ) && ! empty( self::$context_stack[ $key ] ) ) {
array_pop( self::$context_stack[ $key ] );
}
}
public static function get( string $key ): array {
if ( ! isset( self::$context_stack[ $key ] ) || empty( self::$context_stack[ $key ] ) ) {
return [];
}
$last_key = array_key_last( self::$context_stack[ $key ] );
return self::$context_stack[ $key ][ $last_key ];
}
public static function clear(): void {
self::$context_stack = [];
}
}

View File

@@ -0,0 +1,45 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Base;
class Widget_Builder {
protected $widget_type;
protected $settings = [];
protected $is_locked = false;
protected $editor_settings = [];
public static function make( string $widget_type ) {
return new self( $widget_type );
}
private function __construct( string $widget_type ) {
$this->widget_type = $widget_type;
}
public function settings( array $settings ) {
$this->settings = $settings;
return $this;
}
public function is_locked( $is_locked ) {
$this->is_locked = $is_locked;
return $this;
}
public function editor_settings( array $editor_settings ) {
$this->editor_settings = $editor_settings;
return $this;
}
public function build() {
$widget_data = [
'elType' => 'widget',
'widgetType' => $this->widget_type,
'settings' => $this->settings,
'isLocked' => $this->is_locked,
'editor_settings' => $this->editor_settings,
];
return $widget_data;
}
}

View File

@@ -0,0 +1,187 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Div_Block;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Html_Tag_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Div_Block extends Atomic_Element_Base {
const BASE_STYLE_KEY = 'base';
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->meta( 'is_container', true );
}
public static function get_type() {
return 'e-div-block';
}
public static function get_element_type(): string {
return 'e-div-block';
}
public function get_title() {
return esc_html__( 'Div block', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-div-block';
}
protected static function define_props_schema(): array {
$tag_dependencies = Dependency_Manager::make( Dependency_Manager::RELATION_AND )
->where( [
'operator' => 'ne',
'path' => [ 'link', 'destination' ],
'nestedPath' => [ 'group' ],
'value' => 'action',
'newValue' => [
'$$type' => 'string',
'value' => 'button',
],
] )->where( [
'operator' => 'not_exist',
'path' => [ 'link', 'destination' ],
'newValue' => [
'$$type' => 'string',
'value' => 'a',
],
] )->get();
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'tag' => String_Prop_Type::make()
->enum( [ 'div', 'header', 'section', 'article', 'aside', 'footer', 'a', 'button' ] )
->default( 'div' )
->set_dependencies( $tag_dependencies ),
'link' => Link_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( [
Html_Tag_Control::bind_to( 'tag' )
->set_options( [
[
'value' => 'div',
'label' => 'Div',
],
[
'value' => 'header',
'label' => 'Header',
],
[
'value' => 'section',
'label' => 'Section',
],
[
'value' => 'article',
'label' => 'Article',
],
[
'value' => 'aside',
'label' => 'Aside',
],
[
'value' => 'footer',
'label' => 'Footer',
],
])
->set_fallback_labels( [
'a' => 'a (link)',
] )
->set_label( esc_html__( 'HTML Tag', 'elementor' ) ),
Link_Control::bind_to( 'link' )
->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
->set_label( __( 'Link', 'elementor' ) )
->set_meta( [
'topDivider' => true,
] ),
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
] ),
];
}
protected function define_base_styles(): array {
$display = String_Prop_Type::generate( 'block' );
return [
static::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'display', $display )
->add_prop( 'padding', $this->get_base_padding() )
->add_prop( 'min-width', $this->get_base_min_width() )
),
];
}
protected function get_base_padding(): array {
return Size_Prop_Type::generate( [
'size' => 10,
'unit' => 'px',
] );
}
protected function get_base_min_width(): array {
return Size_Prop_Type::generate( [
'size' => 30,
'unit' => 'px',
] );
}
protected function add_render_attributes() {
parent::add_render_attributes();
$settings = $this->get_atomic_settings();
$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
$initial_attributes = $this->define_initial_attributes();
$attributes = [
'class' => [
'e-con',
'e-atomic-element',
$base_style_class,
...( $settings['classes'] ?? [] ),
],
];
if ( ! empty( $settings['_cssid'] ) ) {
$attributes['id'] = esc_attr( $settings['_cssid'] );
}
if ( ! empty( $settings['link']['href'] ) ) {
$link_attributes = $this->get_link_attributes( $settings['link'] );
$attributes = array_merge( $attributes, $link_attributes );
}
$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
}
}

View File

@@ -0,0 +1,184 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Flexbox;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
use Elementor\Modules\AtomicWidgets\Controls\Section;
use Elementor\Modules\AtomicWidgets\Controls\Types\Html_Tag_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Flexbox extends Atomic_Element_Base {
const BASE_STYLE_KEY = 'base';
public function __construct( $data = [], $args = null ) {
parent::__construct( $data, $args );
$this->meta( 'is_container', true );
}
public static function get_type() {
return 'e-flexbox';
}
public static function get_element_type(): string {
return 'e-flexbox';
}
public function get_title() {
return esc_html__( 'Flexbox', 'elementor' );
}
public function get_keywords() {
return [ 'ato', 'atom', 'atoms', 'atomic' ];
}
public function get_icon() {
return 'eicon-flexbox';
}
protected static function define_props_schema(): array {
$tag_dependencies = Dependency_Manager::make( Dependency_Manager::RELATION_AND )
->where( [
'operator' => 'ne',
'path' => [ 'link', 'destination' ],
'nestedPath' => [ 'group' ],
'value' => 'action',
'newValue' => [
'$$type' => 'string',
'value' => 'button',
],
] )->where( [
'operator' => 'not_exist',
'path' => [ 'link', 'destination' ],
'newValue' => [
'$$type' => 'string',
'value' => 'a',
],
] )->get();
return [
'classes' => Classes_Prop_Type::make()
->default( [] ),
'tag' => String_Prop_Type::make()
->enum( [ 'div', 'header', 'section', 'article', 'aside', 'footer', 'a', 'button' ] )
->default( 'div' )
->description( 'The HTML tag for the flexbox container. Could be div, header, section, article, aside, footer, or a (link).' )
->set_dependencies( $tag_dependencies ),
'link' => Link_Prop_Type::make(),
'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
];
return $schema;
}
protected function define_atomic_controls(): array {
return [
Section::make()
->set_label( __( 'Settings', 'elementor' ) )
->set_id( 'settings' )
->set_items( [
Html_Tag_Control::bind_to( 'tag' )
->set_options( [
[
'value' => 'div',
'label' => 'Div',
],
[
'value' => 'header',
'label' => 'Header',
],
[
'value' => 'section',
'label' => 'Section',
],
[
'value' => 'article',
'label' => 'Article',
],
[
'value' => 'aside',
'label' => 'Aside',
],
[
'value' => 'footer',
'label' => 'Footer',
],
])
->set_label( esc_html__( 'HTML Tag', 'elementor' ) )
->set_fallback_labels( [
'a' => 'a (link)',
] ),
Link_Control::bind_to( 'link' )
->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
->set_label( __( 'Link', 'elementor' ) )
->set_meta( [
'topDivider' => true,
] ),
Text_Control::bind_to( '_cssid' )
->set_label( __( 'ID', 'elementor' ) )
->set_meta( $this->get_css_id_control_meta() ),
] ),
];
}
protected function define_base_styles(): array {
$display = String_Prop_Type::generate( 'flex' );
$flex_direction = String_Prop_Type::generate( 'row' );
return [
static::BASE_STYLE_KEY => Style_Definition::make()
->add_variant(
Style_Variant::make()
->add_prop( 'display', $display )
->add_prop( 'flex-direction', $flex_direction )
->add_prop( 'padding', $this->get_base_padding() )
),
];
}
protected function get_base_padding(): array {
return Size_Prop_Type::generate( [
'size' => 10,
'unit' => 'px',
] );
}
protected function add_render_attributes() {
parent::add_render_attributes();
$settings = $this->get_atomic_settings();
$base_style_class = $this->get_base_styles_dictionary()[ static::BASE_STYLE_KEY ];
$initial_attributes = $this->define_initial_attributes();
$attributes = [
'class' => [
'e-con',
'e-atomic-element',
$base_style_class,
...( $settings['classes'] ?? [] ),
],
];
if ( ! empty( $settings['_cssid'] ) ) {
$attributes['id'] = esc_attr( $settings['_cssid'] );
}
if ( ! empty( $settings['link']['href'] ) ) {
$link_attributes = $this->get_link_attributes( $settings['link'] );
$attributes = array_merge( $attributes, $link_attributes );
}
$this->add_render_attribute( '_wrapper', array_merge( $initial_attributes, $attributes ) );
}
}

View File

@@ -0,0 +1,52 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\Loader;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Frontend_Assets_Loader {
const ALPINEJS_HANDLE = 'elementor-v2-alpinejs';
const FRONTEND_HANDLERS_HANDLE = 'elementor-v2-frontend-handlers';
const ATOMIC_WIDGETS_HANDLER = 'elementor-v2-widgets-frontend';
/**
* @return void
*/
public function register_scripts() {
$this->register_package_scripts();
do_action( 'elementor/atomic-widgets/frontend/loader/scripts/register', $this );
}
private function register_package_scripts() {
$assets_url = ELEMENTOR_ASSETS_URL;
$min_suffix = ( Utils::is_script_debug() || Utils::is_elementor_tests() ) ? '' : '.min';
wp_register_script(
self::FRONTEND_HANDLERS_HANDLE,
"{$assets_url}js/packages/frontend-handlers/frontend-handlers{$min_suffix}.js",
[ 'jquery' ],
ELEMENTOR_VERSION,
true
);
wp_register_script(
self::ALPINEJS_HANDLE,
"{$assets_url}js/packages/alpinejs/alpinejs{$min_suffix}.js",
[],
ELEMENTOR_VERSION,
true
);
wp_register_script(
self::ATOMIC_WIDGETS_HANDLER,
"{$assets_url}js/atomic-widgets-frontend-handler{$min_suffix}.js",
[ self::FRONTEND_HANDLERS_HANDLE ],
ELEMENTOR_VERSION,
true
);
}
}

View File

@@ -0,0 +1,90 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\TemplateRenderer;
use ElementorDeps\Twig\Error\LoaderError;
use ElementorDeps\Twig\Loader\LoaderInterface;
use ElementorDeps\Twig\Source;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Single_File_Loader implements LoaderInterface {
private $templates = [];
private $validity_cache = [];
public function getSourceContext( string $name ): Source {
$path = $this->get_template_path( $name );
return new Source(
// This is safe to use because we're validating the file path inside `get_template_path`.
// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
file_get_contents( $path ),
$name,
$path
);
}
public function getCacheKey( string $name ): string {
return $this->get_template_path( $name );
}
public function isFresh( string $name, int $time ): bool {
$path = $this->get_template_path( $name );
return filemtime( $path ) < $time;
}
public function exists( string $name ) {
$path = $this->templates[ $name ] ?? null;
return $this->is_valid_file( $path );
}
public function is_registered( string $name ): bool {
return isset( $this->templates[ $name ] );
}
public function register( string $name, string $path ): self {
if ( ! $this->is_valid_file( $path ) ) {
throw new LoaderError( esc_html( "Invalid template '{$name}': {$path}" ) );
}
$this->templates[ $name ] = $path;
return $this;
}
private function get_template_path( string $name ): string {
$path = $this->templates[ $name ] ?? null;
if ( ! $this->is_valid_file( $path ) ) {
throw new LoaderError( esc_html( "Invalid template '{$name}': {$path}" ) );
}
return $path;
}
private function is_valid_file( $path ): bool {
if ( ! $path ) {
return false;
}
if ( isset( $this->validity_cache[ $path ] ) ) {
return $this->validity_cache[ $path ];
}
// Ref: https://github.com/twigphp/Twig/blob/8432946eeeca009d75fc7fc568f3c3f4650f5a0f/src/Loader/FilesystemLoader.php#L260
if ( str_contains( $path, "\0" ) ) {
throw new LoaderError( 'A template name cannot contain NULL bytes.' );
}
$is_valid = is_file( $path ) && is_readable( $path );
$this->validity_cache[ $path ] = $is_valid;
return $is_valid;
}
}

View File

@@ -0,0 +1,62 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Elements\TemplateRenderer;
use Elementor\Utils;
use ElementorDeps\Twig\Environment;
use ElementorDeps\Twig\Runtime\EscaperRuntime;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Template_Renderer {
private static ?self $instance = null;
private Single_File_Loader $loader;
private Environment $env;
private function __construct() {
$this->loader = new Single_File_Loader();
$this->env = new Environment(
$this->loader,
[
'debug' => Utils::is_elementor_debug(),
'autoescape' => 'name',
]
);
$escaper = $this->env->getRuntime( EscaperRuntime::class );
$escaper->setEscaper( 'full_url', 'esc_url' );
$escaper->setEscaper( 'html_tag', [ Utils::class, 'validate_html_tag' ] );
}
public static function instance(): self {
if ( null === self::$instance ) {
self::$instance = new self();
}
return self::$instance;
}
public static function reset() {
self::$instance = null;
}
public function is_registered( string $name ): bool {
return $this->loader->is_registered( $name );
}
public function register( string $name, string $path ): self {
$this->loader->register( $name, $path );
return $this;
}
public function render( string $name, array $context = [] ): string {
return $this->env->render( $name, $context );
}
}

View File

@@ -0,0 +1,82 @@
<?php
namespace Elementor\Modules\AtomicWidgets\ImportExport;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
use Elementor\Modules\AtomicWidgets\ImportExport\Modifiers\Settings_Props_Modifier;
use Elementor\Modules\AtomicWidgets\ImportExport\Modifiers\Styles_Ids_Modifier;
use Elementor\Modules\AtomicWidgets\ImportExport\Modifiers\Styles_Props_Modifier;
use Elementor\Modules\AtomicWidgets\PropsResolver\Import_Export_Props_Resolver;
use Elementor\Modules\AtomicWidgets\Styles\Style_Schema;
use Elementor\Modules\AtomicWidgets\Utils\Utils;
use Elementor\Plugin;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Atomic_Import_Export {
public function register_hooks() {
add_filter(
'elementor/template_library/sources/local/import/elements',
fn( $elements ) => $this->run( $elements, Import_Export_Props_Resolver::for_import() )
);
add_filter(
'elementor/template_library/sources/cloud/import/elements',
fn( $elements ) => $this->run( $elements, Import_Export_Props_Resolver::for_import() )
);
add_filter(
'elementor/template_library/sources/local/export/elements',
fn( $elements ) => $this->run( $elements, Import_Export_Props_Resolver::for_export() )
);
add_filter(
'elementor/document/element/replace_id',
fn( $element ) => $this->replace_styles_ids( $element )
);
}
private function run( $elements, Import_Export_Props_Resolver $props_resolver ) {
if ( empty( $elements ) || ! is_array( $elements ) ) {
return $elements;
}
return Plugin::$instance->db->iterate_data( $elements, function ( $element ) use ( $props_resolver ) {
$element_instance = Plugin::$instance->elements_manager->create_element_instance( $element );
/** @var Atomic_Element_Base | Atomic_Widget_Base $element_instance */
if ( ! Utils::is_atomic( $element_instance ) ) {
return $element;
}
$runners = [
Settings_Props_Modifier::make( $props_resolver, $element_instance::get_props_schema() ),
Styles_Props_Modifier::make( $props_resolver, Style_Schema::get() ),
];
foreach ( $runners as $runner ) {
$element = $runner->run( $element );
}
return $element;
} );
}
private function replace_styles_ids( $element ) {
if ( empty( $element ) || ! is_array( $element ) ) {
return $element;
}
$element_instance = Plugin::$instance->elements_manager->create_element_instance( $element );
/** @var Atomic_Element_Base | Atomic_Widget_Base $element_instance */
if ( ! Utils::is_atomic( $element_instance ) ) {
return $element;
}
return Styles_Ids_Modifier::make()->run( $element );
}
}

View File

@@ -0,0 +1,37 @@
<?php
namespace Elementor\Modules\AtomicWidgets\ImportExport\Modifiers;
use Elementor\Modules\AtomicWidgets\PropsResolver\Import_Export_Props_Resolver;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Settings_Props_Modifier {
private Import_Export_Props_Resolver $props_resolver;
private array $schema;
public function __construct( Import_Export_Props_Resolver $props_resolver, array $schema ) {
$this->props_resolver = $props_resolver;
$this->schema = $schema;
}
public static function make( Import_Export_Props_Resolver $props_resolver, array $schema ) {
return new self( $props_resolver, $schema );
}
public function run( array $element ) {
if ( empty( $element['settings'] ) || ! is_array( $element['settings'] ) ) {
return $element;
}
$element['settings'] = $this->props_resolver->resolve(
$this->schema,
$element['settings']
);
return $element;
}
}

View File

@@ -0,0 +1,72 @@
<?php
namespace Elementor\Modules\AtomicWidgets\ImportExport\Modifiers;
use Elementor\Core\Utils\Collection;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\Utils\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Styles_Ids_Modifier {
private Collection $old_to_new_ids;
public static function make() {
return new self();
}
public function run( array $element ) {
$this->old_to_new_ids = Collection::make();
$element = $this->replace_styles_ids( $element );
$element = $this->replace_references( $element );
return $element;
}
private function replace_styles_ids( array $element ) {
if ( empty( $element['styles'] ) || empty( $element['id'] ) ) {
return $element;
}
$styles = Collection::make( $element['styles'] )->map_with_keys( function ( $style, $id ) use ( $element ) {
$style['id'] = $this->generate_id( $element['id'], $id );
return [ $style['id'] => $style ];
} )->all();
$element['styles'] = $styles;
return $element;
}
private function replace_references( array $element ) {
if ( empty( $element['settings'] ) ) {
return $element;
}
$element['settings'] = Collection::make( $element['settings'] )->map( function ( $setting ) {
if ( ! $setting || ! Classes_Prop_Type::make()->validate( $setting ) ) {
return $setting;
}
$setting['value'] = Collection::make( $setting['value'] )
->map( fn( $style_id ) => $this->old_to_new_ids->get( $style_id ) ?? $style_id )
->all();
return $setting;
} )->all();
return $element;
}
private function generate_id( $element_id, $old_id ): string {
$id = Utils::generate_id( "e-{$element_id}-", $this->old_to_new_ids->values() );
$this->old_to_new_ids[ $old_id ] = $id;
return $id;
}
}

View File

@@ -0,0 +1,49 @@
<?php
namespace Elementor\Modules\AtomicWidgets\ImportExport\Modifiers;
use Elementor\Modules\AtomicWidgets\PropsResolver\Import_Export_Props_Resolver;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Styles_Props_Modifier {
private Import_Export_Props_Resolver $props_resolver;
private array $schema;
public function __construct( Import_Export_Props_Resolver $props_resolver, array $schema ) {
$this->props_resolver = $props_resolver;
$this->schema = $schema;
}
public static function make( Import_Export_Props_Resolver $props_resolver, array $schema ) {
return new self( $props_resolver, $schema );
}
public function run( array $element ) {
if ( empty( $element['styles'] ) && ! is_array( $element['styles'] ) ) {
return $element;
}
foreach ( $element['styles'] as $style_key => $style ) {
if ( empty( $style['variants'] ) || ! is_array( $style['variants'] ) ) {
continue;
}
foreach ( $style['variants'] as $variant_key => $variant ) {
if ( empty( $variant['props'] ) || ! is_array( $variant['props'] ) ) {
continue;
}
$element['styles'][ $style_key ]['variants'][ $variant_key ]['props'] = $this->props_resolver->resolve(
$this->schema,
$variant['props']
);
}
}
return $element;
}
}

View File

@@ -0,0 +1,17 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Library;
use Elementor\Plugin;
class Atomic_Widgets_Library {
public function register_hooks() {
add_action( 'elementor/documents/register', fn() => $this->register_documents() );
}
public function register_documents() {
Plugin::$instance->documents
->register_document_type( 'e-div-block', Div_Block::get_class_full_name() )
->register_document_type( 'e-flexbox', Flexbox::get_class_full_name() );
}
}

View File

@@ -0,0 +1,67 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Library;
use Elementor\Modules\Library\Documents\Library_Document;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Elementor Div_Block library document.
*
* Elementor div block library document handler class is responsible for
* handling a document of a div block type.
*
* @since 3.29.0
*/
class Div_Block extends Library_Document {
public static function get_properties() {
$properties = parent::get_properties();
$properties['support_kit'] = true;
return $properties;
}
/**
* Get document name.
*
* Retrieve the document name.
*
* @since 2.0.0
* @access public
*
* @return string Document name.
*/
public function get_name() {
return 'e-div-block';
}
/**
* Get document title.
*
* Retrieve the document title.
*
* @since 2.0.0
* @access public
* @static
*
* @return string Document title.
*/
public static function get_title() {
return esc_html__( 'Div Block', 'elementor' );
}
/**
* Get Type
*
* Return the div block document type.
*
* @return string
*/
public static function get_type() {
return 'e-div-block';
}
}

View File

@@ -0,0 +1,67 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Library;
use Elementor\Modules\Library\Documents\Library_Document;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Elementor Flexbox library document.
*
* Elementor flexbox library document handler class is responsible for
* handling a document of a flexbox type.
*
* @since 3.29.0
*/
class Flexbox extends Library_Document {
public static function get_properties() {
$properties = parent::get_properties();
$properties['support_kit'] = true;
return $properties;
}
/**
* Get document name.
*
* Retrieve the document name.
*
* @since 2.0.0
* @access public
*
* @return string Document name.
*/
public function get_name() {
return 'e-flexbox';
}
/**
* Get document title.
*
* Retrieve the document title.
*
* @since 2.0.0
* @access public
* @static
*
* @return string Document title.
*/
public static function get_title() {
return esc_html__( 'Flexbox', 'elementor' );
}
/**
* Get Type
*
* Return the flexbox document type.
*
* @return string
*/
public static function get_type() {
return 'e-flexbox';
}
}

View File

@@ -0,0 +1,90 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Logger;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
/**
* Simple logger for Atomic Widgets that writes to wp-content/debug.log (if WP_DEBUG_LOG enabled
* and WP_DEBUG_DISPLAY disabled) or optionally to Elementor's DB logger.
* Never displays errors on screen.
*/
class Logger {
public static function info( string $message, array $context = [], bool $use_elementor_logger = false ): void {
self::log_message( $message, $context, $use_elementor_logger, 'info' );
}
public static function warning( string $message, array $context = [], bool $use_elementor_logger = false ): void {
self::log_message( $message, $context, $use_elementor_logger, 'warning' );
}
public static function error( string $message, array $context = [], bool $use_elementor_logger = false ): void {
self::log_message( $message, $context, $use_elementor_logger, 'error' );
}
private static function log_message( string $message, array $context, bool $use_elementor_logger, string $level ): void {
if ( $use_elementor_logger ) {
self::log_to_elementor_db( $message, $context, $level );
return;
}
self::log_to_wp_debug_file( $message, $context, $level );
}
private static function log_to_wp_debug_file( string $message, array $context, string $level ): void {
if ( ! self::should_log_to_file() ) {
return;
}
$formatted_message = self::format_message( $message, $context, $level );
error_log( $formatted_message );
}
private static function log_to_elementor_db( string $message, array $context, string $level ): void {
if ( ! isset( \Elementor\Plugin::$instance->logger ) ) {
return;
}
try {
$logger = \Elementor\Plugin::$instance->logger;
switch ( $level ) {
case 'error':
$logger->error( $message, $context );
break;
case 'warning':
$logger->warning( $message, $context );
break;
default:
$logger->info( $message, $context );
break;
}
} catch ( \Exception $e ) { // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedCatch -- Logger must not throw exceptions
}
}
private static function should_log_to_file(): bool {
$debug_log_enabled = defined( 'WP_DEBUG_LOG' ) && WP_DEBUG_LOG;
$debug_display_disabled = ! defined( 'WP_DEBUG_DISPLAY' ) || ! WP_DEBUG_DISPLAY;
return $debug_log_enabled && $debug_display_disabled;
}
private static function format_message( string $message, array $context, string $level ): string {
$level_prefix = strtoupper( $level );
$formatted = "[Elementor Atomic Widgets] [{$level_prefix}] " . $message;
if ( ! empty( $context ) ) {
$context_json = wp_json_encode( $context, JSON_UNESCAPED_SLASHES );
if ( false !== $context_json ) {
$formatted .= ' | Context: ' . $context_json;
}
}
return $formatted;
}
}

View File

@@ -0,0 +1,423 @@
<?php
namespace Elementor\Modules\AtomicWidgets;
use Elementor\Core\Base\Module as BaseModule;
use Elementor\Core\Experiments\Manager as Experiments_Manager;
use Elementor\Elements_Manager;
use Elementor\Modules\AtomicWidgets\DynamicTags\Dynamic_Tags_Module;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Youtube\Atomic_Youtube;
use Elementor\Modules\AtomicWidgets\Elements\Div_Block\Div_Block;
use Elementor\Modules\AtomicWidgets\Elements\Flexbox\Flexbox;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Heading\Atomic_Heading;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Image\Atomic_Image;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Paragraph\Atomic_Paragraph;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Button\Atomic_Button;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Divider\Atomic_Divider;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Svg\Atomic_Svg;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs\Atomic_Tabs;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs\Atomic_Tabs_Menu;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs\Atomic_Tab;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs\Atomic_Tabs_Content_Area;
use Elementor\Modules\AtomicWidgets\ImportExport\Atomic_Import_Export;
use Elementor\Modules\AtomicWidgets\Elements\Loader\Frontend_Assets_Loader;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Combine_Array_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Export\Image_Src_Export_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Image_Src_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Image_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Import\Image_Src_Import_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Import_Export_Plain_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Settings\Classes_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Settings\Date_Time_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Settings\Link_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Plain_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Background_Color_Overlay_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Background_Gradient_Overlay_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Background_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Color_Stop_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Multi_Props_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Position_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Shadow_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Size_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Stroke_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Background_Image_Overlay_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Background_Image_Overlay_Size_Scale_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Background_Overlay_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Filter_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Transform_Origin_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Transition_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Transform_Rotate_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Transform_Skew_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Transform_Functions_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Transform_Move_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Flex_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Transform_Scale_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Settings\Attributes_Transformer;
use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers_Registry;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Color_Overlay_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Gradient_Overlay_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Image_Overlay_Size_Scale_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Image_Overlay_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Image_Position_Offset_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Overlay_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Background_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Box_Shadow_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Border_Radius_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Border_Width_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Color_Stop_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Date_Time_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Filters\Backdrop_Filter_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Filters\Filter_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Gradient_Color_Stop_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Layout_Direction_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Flex_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Image_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Image_Src_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Dimensions_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Position_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Shadow_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Stroke_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Functions\Transform_Move_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Transform_Functions_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Transform_Origin_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Functions\Transform_Scale_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Transform_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Functions\Transform_Rotate_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Functions\Transform_Skew_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transition_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Atomic_Styles_Manager;
use Elementor\Modules\AtomicWidgets\Styles\Atomic_Widget_Base_Styles;
use Elementor\Modules\AtomicWidgets\Styles\Atomic_Widget_Styles;
use Elementor\Modules\AtomicWidgets\Styles\Size_Constants;
use Elementor\Modules\AtomicWidgets\Styles\Style_Schema;
use Elementor\Modules\AtomicWidgets\Database\Atomic_Widgets_Database_Updater;
use Elementor\Modules\AtomicWidgets\Elements\Atomic_Tabs\Atomic_Tab_Content;
use Elementor\Modules\AtomicWidgets\PropTypeMigrations\Migrations_Orchestrator;
use Elementor\Plugin;
use Elementor\Widgets_Manager;
use Elementor\Modules\AtomicWidgets\Library\Atomic_Widgets_Library;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Settings\Query_Transformer;
use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers\Styles\Perspective_Origin_Transformer;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Query_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Transform\Perspective_Origin_Prop_Type;
use Elementor\Modules\AtomicWidgets\Utils\Utils;
use Elementor\Core\Base\Document;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Module extends BaseModule {
const EXPERIMENT_NAME = 'e_atomic_elements';
const ENFORCE_CAPABILITIES_EXPERIMENT = 'atomic_widgets_should_enforce_capabilities';
const EXPERIMENT_EDITOR_MCP = 'editor_mcp';
const EXPERIMENT_BC_MIGRATIONS = 'e_bc_migrations';
const PACKAGES = [
'editor-canvas',
'editor-controls', // TODO: Need to be registered and not enqueued.
'editor-editing-panel',
'editor-elements', // TODO: Need to be registered and not enqueued.
'editor-props', // TODO: Need to be registered and not enqueued.
'editor-styles', // TODO: Need to be registered and not enqueued.
'editor-styles-repository',
'editor-interactions',
'editor-templates',
];
public function get_name() {
return 'atomic-widgets';
}
public function __construct() {
parent::__construct();
if ( self::is_active() ) {
$this->register_experimental_features();
Migrations_Orchestrator::register_feature_flag_hooks();
}
if ( Plugin::$instance->experiments->is_feature_active( self::EXPERIMENT_NAME ) ) {
Dynamic_Tags_Module::instance()->register_hooks();
( new Atomic_Widget_Styles() )->register_hooks();
( new Atomic_Widget_Base_Styles() )->register_hooks();
( new Atomic_Widgets_Library() )->register_hooks();
Atomic_Styles_Manager::instance()->register_hooks();
( new Atomic_Import_Export() )->register_hooks();
( new Atomic_Widgets_Database_Updater() )->register();
add_filter( 'elementor/editor/v2/packages', fn ( $packages ) => $this->add_packages( $packages ) );
add_filter( 'elementor/editor/localize_settings', fn ( $settings ) => $this->add_styles_schema( $settings ) );
add_filter( 'elementor/editor/localize_settings', fn ( $settings ) => $this->add_supported_units( $settings ) );
add_filter( 'elementor/widgets/register', fn ( Widgets_Manager $widgets_manager ) => $this->register_widgets( $widgets_manager ) );
add_filter( 'elementor/usage/elements/element_title', fn ( $title, $type ) => $this->get_element_usage_name( $title, $type ), 10, 2 );
add_filter( 'elementor/document/load/data', fn ( $data, $document ) => $this->backward_compatibility_migrations( $data, $document ), 10, 2 );
add_action( 'elementor/elements/elements_registered', fn ( $elements_manager ) => $this->register_elements( $elements_manager ) );
add_action( 'elementor/editor/after_enqueue_scripts', fn () => $this->enqueue_scripts() );
add_action( 'elementor/frontend/before_register_scripts', fn () => $this->register_frontend_scripts() );
add_action( 'elementor/frontend/after_enqueue_styles', fn () => $this->add_inline_styles() );
add_action( 'elementor/atomic-widgets/settings/transformers/register', fn ( $transformers ) => $this->register_settings_transformers( $transformers ) );
add_action( 'elementor/atomic-widgets/styles/transformers/register', fn ( $transformers ) => $this->register_styles_transformers( $transformers ) );
add_action( 'elementor/atomic-widgets/import/transformers/register', fn ( $transformers ) => $this->register_import_transformers( $transformers ) );
add_action( 'elementor/atomic-widgets/export/transformers/register', fn ( $transformers ) => $this->register_export_transformers( $transformers ) );
add_action( 'elementor/editor/templates/panel/category', fn () => $this->render_panel_category_chip() );
}
}
public static function get_experimental_data() {
return [
'name' => self::EXPERIMENT_NAME,
'title' => esc_html__( 'Atomic Widgets', 'elementor' ),
'description' => esc_html__( 'Enable atomic widgets.', 'elementor' ),
'hidden' => true,
'default' => Experiments_Manager::STATE_INACTIVE,
'release_status' => Experiments_Manager::RELEASE_STATUS_ALPHA,
];
}
private function register_experimental_features() {
Plugin::$instance->experiments->add_feature( [
'name' => 'e_indications_popover',
'title' => esc_html__( 'V4 Indications Popover', 'elementor' ),
'description' => esc_html__( 'Enable V4 Indication Popovers', 'elementor' ),
'hidden' => true,
'default' => Experiments_Manager::STATE_INACTIVE,
] );
Plugin::$instance->experiments->add_feature( [
'name' => self::ENFORCE_CAPABILITIES_EXPERIMENT,
'title' => esc_html__( 'Enforce atomic widgets capabilities', 'elementor' ),
'description' => esc_html__( 'Enforce atomic widgets capabilities.', 'elementor' ),
'hidden' => true,
'default' => Experiments_Manager::STATE_ACTIVE,
'release_status' => Experiments_Manager::RELEASE_STATUS_DEV,
] );
Plugin::$instance->experiments->add_feature([
'name' => self::EXPERIMENT_EDITOR_MCP,
'title' => esc_html__( 'Editor MCP for atomic widgets', 'elementor' ),
'description' => esc_html__( 'Editor MCP for atomic widgets.', 'elementor' ),
'hidden' => true,
'default' => Experiments_Manager::STATE_ACTIVE,
'release_status' => Experiments_Manager::RELEASE_STATUS_DEV,
]);
Plugin::$instance->experiments->add_feature([
'name' => self::EXPERIMENT_BC_MIGRATIONS,
'title' => esc_html__( 'Backward compatibility migrations', 'elementor' ),
'description' => esc_html__( 'Enable automatic prop type migrations for atomic widgets', 'elementor' ),
'hidden' => true,
'default' => Experiments_Manager::STATE_ACTIVE,
'release_status' => Experiments_Manager::RELEASE_STATUS_DEV,
]);
}
private function add_packages( $packages ) {
return array_merge( $packages, self::PACKAGES );
}
private function add_styles_schema( $settings ) {
if ( ! isset( $settings['atomic'] ) ) {
$settings['atomic'] = [];
}
$settings['atomic']['styles_schema'] = Style_Schema::get();
return $settings;
}
private function add_supported_units( $settings ) {
$settings['supported_size_units'] = Size_Constants::all_supported_units();
return $settings;
}
private function register_widgets( Widgets_Manager $widgets_manager ) {
$widgets_manager->register( new Atomic_Heading() );
$widgets_manager->register( new Atomic_Image() );
$widgets_manager->register( new Atomic_Paragraph() );
$widgets_manager->register( new Atomic_Svg() );
$widgets_manager->register( new Atomic_Button() );
$widgets_manager->register( new Atomic_Youtube() );
$widgets_manager->register( new Atomic_Divider() );
}
private function register_elements( Elements_Manager $elements_manager ) {
$elements_manager->register_element_type( new Div_Block() );
$elements_manager->register_element_type( new Flexbox() );
$elements_manager->register_element_type( new Atomic_Tabs() );
$elements_manager->register_element_type( new Atomic_Tabs_Menu() );
$elements_manager->register_element_type( new Atomic_Tab() );
$elements_manager->register_element_type( new Atomic_Tabs_Content_Area() );
$elements_manager->register_element_type( new Atomic_Tab_Content() );
}
private function register_settings_transformers( Transformers_Registry $transformers ) {
$transformers->register_fallback( new Plain_Transformer() );
$transformers->register( Classes_Prop_Type::get_key(), new Classes_Transformer() );
$transformers->register( Image_Prop_Type::get_key(), new Image_Transformer() );
$transformers->register( Image_Src_Prop_Type::get_key(), new Image_Src_Transformer() );
$transformers->register( Link_Prop_Type::get_key(), new Link_Transformer() );
$transformers->register( Query_Prop_Type::get_key(), new Query_Transformer() );
$transformers->register( Attributes_Prop_Type::get_key(), new Attributes_Transformer() );
$transformers->register( Date_Time_Prop_Type::get_key(), new Date_Time_Transformer() );
}
private function register_styles_transformers( Transformers_Registry $transformers ) {
$transformers->register_fallback( new Plain_Transformer() );
$transformers->register( Size_Prop_Type::get_key(), new Size_Transformer() );
$transformers->register( Box_Shadow_Prop_Type::get_key(), new Combine_Array_Transformer( ',' ) );
$transformers->register( Shadow_Prop_Type::get_key(), new Shadow_Transformer() );
$transformers->register( Flex_Prop_Type::get_key(), new Flex_Transformer() );
$transformers->register( Stroke_Prop_Type::get_key(), new Stroke_Transformer() );
$transformers->register( Image_Prop_Type::get_key(), new Image_Transformer() );
$transformers->register( Image_Src_Prop_Type::get_key(), new Image_Src_Transformer() );
$transformers->register( Background_Image_Overlay_Prop_Type::get_key(), new Background_Image_Overlay_Transformer() );
$transformers->register( Background_Image_Overlay_Size_Scale_Prop_Type::get_key(), new Background_Image_Overlay_Size_Scale_Transformer() );
$transformers->register( Background_Image_Position_Offset_Prop_Type::get_key(), new Position_Transformer() );
$transformers->register( Background_Color_Overlay_Prop_Type::get_key(), new Background_Color_Overlay_Transformer() );
$transformers->register( Background_Overlay_Prop_Type::get_key(), new Background_Overlay_Transformer() );
$transformers->register( Background_Prop_Type::get_key(), new Background_Transformer() );
$transformers->register( Background_Gradient_Overlay_Prop_Type::get_key(), new Background_Gradient_Overlay_Transformer() );
$transformers->register( Filter_Prop_Type::get_key(), new Filter_Transformer() );
$transformers->register( Backdrop_Filter_Prop_Type::get_key(), new Filter_Transformer() );
$transformers->register( Transition_Prop_Type::get_key(), new Transition_Transformer() );
$transformers->register( Color_Stop_Prop_Type::get_key(), new Color_Stop_Transformer() );
$transformers->register( Gradient_Color_Stop_Prop_Type::get_key(), new Combine_Array_Transformer( ',' ) );
$transformers->register( Position_Prop_Type::get_key(), new Position_Transformer() );
$transformers->register( Transform_Move_Prop_Type::get_key(), new Transform_Move_Transformer() );
$transformers->register( Transform_Scale_Prop_Type::get_key(), new Transform_Scale_Transformer() );
$transformers->register( Transform_Rotate_Prop_Type::get_key(), new Transform_Rotate_Transformer() );
$transformers->register( Transform_Skew_Prop_Type::get_key(), new Transform_Skew_Transformer() );
$transformers->register( Transform_Functions_Prop_Type::get_key(), new Transform_Functions_Transformer() );
$transformers->register( Transform_Origin_Prop_Type::get_key(), new Transform_Origin_Transformer() );
$transformers->register( Perspective_Origin_Prop_Type::get_key(), new Perspective_Origin_Transformer() );
$transformers->register(
Transform_Prop_Type::get_key(),
new Multi_Props_Transformer(
[ 'transform-functions', 'transform-origin', 'perspective', 'perspective-origin' ],
fn( $_, $key ) => 'transform-functions' === $key ? 'transform' : $key
)
);
$transformers->register(
Border_Radius_Prop_Type::get_key(),
new Multi_Props_Transformer( [ 'start-start', 'start-end', 'end-start', 'end-end' ], fn ( $_, $key ) => "border-{$key}-radius" )
);
$transformers->register(
Border_Width_Prop_Type::get_key(),
new Multi_Props_Transformer( [ 'block-start', 'block-end', 'inline-start', 'inline-end' ], fn ( $_, $key ) => "border-{$key}-width" )
);
$transformers->register(
Layout_Direction_Prop_Type::get_key(),
new Multi_Props_Transformer( [ 'column', 'row' ], fn ( $prop_key, $key ) => "{$key}-{$prop_key}" )
);
$transformers->register(
Dimensions_Prop_Type::get_key(),
new Multi_Props_Transformer( [ 'block-start', 'block-end', 'inline-start', 'inline-end' ], fn ( $prop_key, $key ) => "{$prop_key}-{$key}" )
);
}
public function register_import_transformers( Transformers_Registry $transformers ) {
$transformers->register_fallback( new Import_Export_Plain_Transformer() );
$transformers->register( Image_Src_Prop_Type::get_key(), new Image_Src_Import_Transformer() );
}
public function register_export_transformers( Transformers_Registry $transformers ) {
$transformers->register_fallback( new Import_Export_Plain_Transformer() );
$transformers->register( Image_Src_Prop_Type::get_key(), new Image_Src_Export_Transformer() );
}
public static function is_active(): bool {
return Plugin::$instance->experiments->is_feature_active( self::EXPERIMENT_NAME );
}
private function get_element_usage_name( $title, $type ) {
$element_instance = Plugin::$instance->elements_manager->get_element_types( $type );
$widget_instance = Plugin::$instance->widgets_manager->get_widget_types( $type );
if ( Utils::is_atomic( $element_instance ) || Utils::is_atomic( $widget_instance ) ) {
return $type;
}
return $title;
}
/**
* Enqueue the module scripts.
*
* @return void
*/
private function enqueue_scripts() {
wp_enqueue_script(
'elementor-atomic-widgets-editor',
$this->get_js_assets_url( 'atomic-widgets-editor' ),
[ 'elementor-editor' ],
ELEMENTOR_VERSION,
true
);
}
private function render_panel_category_chip() {
?><# if ( 'v4-elements' === name ) { #>
<span class="elementor-panel-heading-category-chip">
<?php echo esc_html__( 'Beta', 'elementor' ); ?><i class="eicon-info"></i>
<span class="e-promotion-react-wrapper" data-promotion="v4_chip"></span>
</span>
<# } #><?php
}
private function register_frontend_scripts() {
$loader = new Frontend_Assets_Loader();
$loader->register_scripts();
}
private function add_inline_styles() {
$inline_css = '.e-heading-base a, .e-paragraph-base a { all: unset; cursor: pointer; }';
wp_add_inline_style( 'elementor-frontend', $inline_css );
}
private function backward_compatibility_migrations( array $data, $document ): array {
if ( ! Plugin::$instance->experiments->is_feature_active( self::EXPERIMENT_BC_MIGRATIONS ) ) {
return $data;
}
$orchestrator = Migrations_Orchestrator::make( $this->get_migrations_base_path() );
$orchestrator->migrate_document(
$data,
$document->get_post()->ID,
function( $migrated_data ) use ( $document ) {
$document->update_json_meta(
Document::ELEMENTOR_DATA_META_KEY,
$migrated_data
);
}
);
return $data;
}
private function get_migrations_base_path(): string {
// define this in wp-config.php to use local migrations i.e. __DIR__ . '/wp-content/plugins/elementor/migrations/'
if ( defined( 'ELEMENTOR_MIGRATIONS_PATH' ) ) {
return ELEMENTOR_MIGRATIONS_PATH;
}
return 'https://migrations.elementor.com/';
}
}

View File

@@ -0,0 +1,86 @@
<?php
namespace Elementor\Modules\AtomicWidgets\OptIn;
use Elementor\Core\Common\Modules\Ajax\Module as Ajax;
use Elementor\Core\Experiments\Manager as Experiments_Manager;
use Elementor\Modules\GlobalClasses\Module as GlobalClassesModule;
use Elementor\Modules\NestedElements\Module as NestedElementsModule;
use Elementor\Modules\AtomicWidgets\Module as AtomicWidgetsModule;
use Elementor\Modules\Variables\Module as VariablesModule;
use Elementor\Modules\Components\Module as ComponentsModule;
use Elementor\Plugin;
class Opt_In {
const EXPERIMENT_NAME = 'e_opt_in_v4';
const OPT_OUT_FEATURES = [
self::EXPERIMENT_NAME,
AtomicWidgetsModule::EXPERIMENT_NAME,
GlobalClassesModule::NAME,
VariablesModule::EXPERIMENT_NAME,
ComponentsModule::EXPERIMENT_NAME,
];
const OPT_IN_FEATURES = [
self::EXPERIMENT_NAME,
'container',
NestedElementsModule::EXPERIMENT_NAME,
AtomicWidgetsModule::EXPERIMENT_NAME,
GlobalClassesModule::NAME,
VariablesModule::EXPERIMENT_NAME,
ComponentsModule::EXPERIMENT_NAME,
];
public function init() {
$this->register_feature();
add_action( 'elementor/ajax/register_actions', fn( Ajax $ajax ) => $this->add_ajax_actions( $ajax ) );
}
private function register_feature() {
Plugin::$instance->experiments->add_feature([
'name' => self::EXPERIMENT_NAME,
'title' => esc_html__( 'Editor V4', 'elementor' ),
'description' => esc_html__( 'Enable Editor V4.', 'elementor' ),
'hidden' => true,
'default' => Experiments_Manager::STATE_INACTIVE,
'release_status' => Experiments_Manager::RELEASE_STATUS_ALPHA,
]);
}
private function opt_out_v4() {
foreach ( self::OPT_OUT_FEATURES as $feature ) {
$feature_key = Plugin::$instance->experiments->get_feature_option_key( $feature );
update_option( $feature_key, Experiments_Manager::STATE_INACTIVE );
}
}
private function opt_in_v4() {
foreach ( self::OPT_IN_FEATURES as $feature ) {
$feature_key = Plugin::$instance->experiments->get_feature_option_key( $feature );
update_option( $feature_key, Experiments_Manager::STATE_ACTIVE );
}
}
public function ajax_opt_out_v4() {
if ( ! current_user_can( 'manage_options' ) ) {
throw new \Exception( 'Permission denied' );
}
$this->opt_out_v4();
}
public function ajax_opt_in_v4() {
if ( ! current_user_can( 'manage_options' ) ) {
throw new \Exception( 'Permission denied' );
}
$this->opt_in_v4();
}
private function add_ajax_actions( Ajax $ajax ) {
$ajax->register_ajax_action( 'editor_v4_opt_in', fn() => $this->ajax_opt_in_v4() );
$ajax->register_ajax_action( 'editor_v4_opt_out', fn() => $this->ajax_opt_out_v4() );
}
}

View File

@@ -0,0 +1,90 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Parsers;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
use Elementor\Core\Utils\Api\Parse_Result;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Props_Parser {
private array $schema;
public function __construct( array $schema ) {
$this->schema = $schema;
}
public static function make( array $schema ): self {
return new static( $schema );
}
/**
* @param array $props
* The key of each item represents the prop name (should match the schema),
* and the value is the prop value to validate
*/
public function validate( array $props ): Parse_Result {
$result = Parse_Result::make();
$validated = [];
foreach ( $this->schema as $key => $prop_type ) {
if ( ! ( $prop_type instanceof Prop_Type ) ) {
continue;
}
$value = $props[ $key ] ?? null;
$is_valid = $prop_type->validate( $value ?? $prop_type->get_default() );
if ( ! $is_valid ) {
$result->errors()->add( $key, 'invalid_value' );
continue;
}
if ( ! is_null( $value ) ) {
$validated[ $key ] = $value;
}
}
return $result->wrap( $validated );
}
/**
* @param array $props
* The key of each item represents the prop name (should match the schema),
* and the value is the prop value to sanitize
*/
public function sanitize( array $props ): Parse_Result {
$sanitized = [];
foreach ( $this->schema as $key => $prop_type ) {
if ( ! isset( $props[ $key ] ) ) {
continue;
}
$sanitized[ $key ] = $prop_type->sanitize( $props[ $key ] );
}
return Parse_Result::make()->wrap( $sanitized );
}
/**
* @param array $props
* The key of each item represents the prop name (should match the schema),
* and the value is the prop value to parse
*/
public function parse( array $props ): Parse_Result {
$validate_result = $this->validate( $props );
$sanitize_result = $this->sanitize( $validate_result->unwrap() );
$sanitize_result->errors()->merge( $validate_result->errors() );
return $sanitize_result;
}
}

View File

@@ -0,0 +1,259 @@
<?php
namespace Elementor\Modules\AtomicWidgets\Parsers;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
use Elementor\Modules\AtomicWidgets\OptIn\Opt_In;
use Elementor\Plugin;
use Elementor\Utils;
use Elementor\Core\Utils\Api\Parse_Result;
use Elementor\Modules\AtomicWidgets\Styles\Style_States;
class Style_Parser {
const VALID_TYPES = [
'class',
];
private array $schema;
public function __construct( array $schema ) {
$this->schema = $schema;
}
public static function make( array $schema ): self {
return new static( $schema );
}
/**
* @param array $style
* the style object to validate
*/
private function validate( array $style ): Parse_Result {
$validated_style = $style;
$result = Parse_Result::make();
if ( ! isset( $style['id'] ) || ! is_string( $style['id'] ) ) {
$result->errors()->add( 'id', 'missing_or_invalid' );
}
if ( ! isset( $style['type'] ) || ! in_array( $style['type'], self::VALID_TYPES, true ) ) {
$result->errors()->add( 'type', 'missing_or_invalid' );
}
if ( ! isset( $style['label'] ) || ! is_string( $style['label'] ) ) {
$result->errors()->add( 'label', 'missing_or_invalid' );
} elseif ( Plugin::$instance->experiments->is_feature_active( Opt_In::EXPERIMENT_NAME ) ) {
$label_validation = $this->validate_style_label( $style['label'] );
if ( ! $label_validation['is_valid'] ) {
$result->errors()->add( 'label', $label_validation['error_message'] );
}
}
if ( ! isset( $style['variants'] ) || ! is_array( $style['variants'] ) ) {
$result->errors()->add( 'variants', 'missing_or_invalid' );
unset( $validated_style['variants'] );
return $result->wrap( $validated_style );
}
$props_parser = Props_Parser::make( $this->schema );
foreach ( $style['variants'] as $variant_index => $variant ) {
if ( ! isset( $variant['meta'] ) ) {
$result->errors()->add( 'meta', 'missing' );
continue;
}
$meta_result = $this->validate_meta( $variant['meta'] );
$custom_css_result = $this->validate_custom_css( $variant );
$result->errors()->merge( $meta_result->errors(), 'meta' );
$result->errors()->merge( $custom_css_result->errors(), 'custom_css' );
if ( $meta_result->is_valid() ) {
$variant_result = $props_parser->validate( $variant['props'] );
$result->errors()->merge( $variant_result->errors(), "variants[$variant_index]" );
$validated_style['variants'][ $variant_index ]['props'] = $variant_result->unwrap();
} else {
unset( $validated_style['variants'][ $variant_index ] );
}
}
return $result->wrap( $validated_style );
}
private function validate_style_label( string $label ): array {
$label = strtolower( $label );
$reserved_class_names = [ 'container' ];
if ( strlen( $label ) > 50 ) {
return [
'is_valid' => false,
'error_message' => 'class_name_too_long',
];
}
if ( strlen( $label ) < 2 ) {
return [
'is_valid' => false,
'error_message' => 'class_name_too_short',
];
}
if ( in_array( $label, $reserved_class_names, true ) ) {
return [
'is_valid' => false,
'error_message' => 'reserved_class_name',
];
}
$regexes = [
[
'pattern' => '/^(|[^0-9].*)$/',
'message' => 'class_name_starts_with_digit',
],
[
'pattern' => '/^\S*$/',
'message' => 'class_name_contains_spaces',
],
[
'pattern' => '/^(|[a-zA-Z0-9_-]+)$/',
'message' => 'class_name_invalid_chars',
],
[
'pattern' => '/^(?!--).*/',
'message' => 'class_name_double_hyphen',
],
[
'pattern' => '/^(?!-[0-9])/',
'message' => 'class_name_starts_with_hyphen_digit',
],
];
foreach ( $regexes as $rule ) {
if ( ! preg_match( $rule['pattern'], $label ) ) {
return [
'is_valid' => false,
'error_message' => $rule['message'],
];
}
}
return [
'is_valid' => true,
'error_message' => null,
];
}
private function validate_meta( $meta ): Parse_Result {
$result = Parse_Result::make();
if ( ! is_array( $meta ) ) {
$result->errors()->add( 'meta', 'invalid_type' );
return $result;
}
if ( ! array_key_exists( 'state', $meta ) || ! Style_States::is_valid_state( $meta['state'] ) ) {
$result->errors()->add( 'state', 'missing_or_invalid_value' );
return $result;
}
// TODO: Validate breakpoint based on the existing breakpoints in the system [EDS-528]
if ( ! isset( $meta['breakpoint'] ) || ! is_string( $meta['breakpoint'] ) ) {
$result->errors()->add( 'breakpoint', 'missing_or_invalid_value' );
return $result;
}
return $result;
}
private function validate_custom_css( array $variant ): Parse_Result {
$result = Parse_Result::make();
if ( ! empty( $variant['custom_css']['raw'] ) && (
! is_string( $variant['custom_css']['raw'] ) ||
null === Utils::decode_string( $variant['custom_css']['raw'], null )
)
) {
$result->errors()->add( 'custom_css', 'invalid_type' );
}
return $result;
}
private function sanitize_meta( $meta ) {
if ( ! is_array( $meta ) ) {
return [];
}
if ( isset( $meta['breakpoint'] ) ) {
$meta['breakpoint'] = sanitize_key( $meta['breakpoint'] );
}
return $meta;
}
private function sanitize_custom_css( array $variant ) {
if ( empty( $variant['custom_css']['raw'] ) ) {
return null;
}
$custom_css = Utils::decode_string( $variant['custom_css']['raw'] );
$custom_css = sanitize_textarea_field( $custom_css );
$custom_css = [ 'raw' => Utils::encode_string( $custom_css ) ];
return empty( $custom_css['raw'] ) ? null : $custom_css;
}
/**
* @param array $style
* the style object to sanitize
*/
private function sanitize( array $style ): Parse_Result {
$props_parser = Props_Parser::make( $this->schema );
if ( isset( $style['label'] ) ) {
$style['label'] = sanitize_text_field( $style['label'] );
}
if ( isset( $style['id'] ) ) {
$style['id'] = sanitize_key( $style['id'] );
}
if ( ! empty( $style['variants'] ) ) {
foreach ( $style['variants'] as $variant_index => $variant ) {
$style['variants'][ $variant_index ]['props'] = $props_parser->sanitize( $variant['props'] )->unwrap();
$style['variants'][ $variant_index ]['meta'] = $this->sanitize_meta( $variant['meta'] );
$style['variants'][ $variant_index ]['custom_css'] = $this->sanitize_custom_css( $variant );
}
}
return Parse_Result::make()->wrap( $style );
}
/**
* @param array $style
* the style object to parse
*/
public function parse( array $style ): Parse_Result {
$validate_result = $this->validate( $style );
$sanitize_result = $this->sanitize( $validate_result->unwrap() );
$sanitize_result->errors()->merge( $validate_result->errors() );
return $sanitize_result;
}
}

View File

@@ -0,0 +1,256 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropDependencies;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Manager {
const RELATION_OR = 'or';
const RELATION_AND = 'and';
const OPERATORS = [
'lt',
'lte',
'eq',
'ne',
'gte',
'gt',
'exists',
'not_exist',
'in',
'nin',
'contains',
'ncontains',
];
/**
* @var ?array{
* relation: self::RELATION_OR|self::RELATION_AND,
* terms: array{
* operator: string,
* path: array<string>,
* value?: mixed,
* newValue?: array
* }
* }
*/
private ?array $dependencies;
public function __construct( string $relation = self::RELATION_OR ) {
$this->new( $relation );
return $this;
}
public static function make( string $relation = self::RELATION_OR ): self {
return new self( $relation );
}
/**
* @param array<string, Prop_Type> $props_schema
* @return array<string, array<string>> Returns source prop path => array of dependent prop paths
*/
public static function get_source_to_dependents( array $props_schema ): array {
$dependency_graph = self::build_dependency_graph( $props_schema );
if ( self::has_circular_dependencies( $dependency_graph ) ) {
Utils::safe_throw( 'Circular prop dependencies detected' );
}
return $dependency_graph;
}
/**
* @param $config array{
* operator: string,
* path: array<string>,
* value?: mixed,
* newValue?: array,
* }
* @return self
*/
public function where( array $config, $new_value = null ): self {
if ( isset( $config['terms'] ) ) {
if ( empty( $this->dependencies ) ) {
$this->new();
}
$term = [
'terms' => $config['terms'],
'relation' => $config['relation'] ?? self::RELATION_OR,
'newValue' => $new_value ?? null,
];
$this->dependencies['terms'][] = $term;
return $this;
}
if ( ! isset( $config['operator'] ) || ! isset( $config['path'] ) ) {
Utils::safe_throw( 'Term missing mandatory configurations' );
}
if ( ! in_array( $config['operator'], self::OPERATORS, true ) ) {
Utils::safe_throw( "Invalid operator: {$config['operator']}." );
}
$term = [
'operator' => $config['operator'],
'path' => $config['path'],
'nestedPath' => $config['nestedPath'] ?? null,
'value' => $config['value'] ?? null,
'newValue' => $config['newValue'] ?? null,
];
if ( empty( $this->dependencies ) ) {
$this->new();
}
$this->dependencies['terms'][] = $term;
return $this;
}
private function new( string $relation = self::RELATION_OR ): self {
if ( ! in_array( $relation, [ self::RELATION_OR, self::RELATION_AND ], true ) ) {
Utils::safe_throw( "Invalid relation: $relation. Must be one of: " . implode( ', ', [ self::RELATION_OR, self::RELATION_AND ] ) );
}
$this->dependencies = [
'relation' => $relation,
'terms' => [],
];
return $this;
}
public function get(): ?array {
return empty( $this->dependencies['terms'] ?? [] ) ? null : $this->dependencies;
}
/**
* @param array<string, Prop_Type> $props_schema The props schema to analyze, where keys are prop names
* @param ?array<string> $current_path The current property path being processed
* @param ?array<string, array<string>> $dependency_graph The dependency graph to build
*/
private static function build_dependency_graph( array $props_schema, ?array $current_path = [], ?array $dependency_graph = [] ): array {
foreach ( $props_schema as $prop_name => $prop_type ) {
$dependency_graph = self::build_nested_prop_dependency_graph( $prop_name, $prop_type, $current_path, $dependency_graph );
$dependencies = $prop_type->get_dependencies();
if ( ! $dependencies ) {
continue;
}
foreach ( $dependencies['terms'] as $term ) {
$dependency_graph = self::process_dependency_term( $term, $current_path, $prop_name, $dependency_graph );
}
}
return $dependency_graph;
}
private static function build_nested_prop_dependency_graph( string $prop_name, Prop_Type $prop_type, array $current_path, array $dependency_graph ): array {
$nested_prop_path = array_merge( $current_path, [ $prop_name ] );
switch ( $prop_type->get_type() ) {
case 'object':
foreach ( $prop_type->get_shape() as $nested_prop_name => $nested_prop_type ) {
$dependency_graph = self::build_dependency_graph( [ $nested_prop_name => $nested_prop_type ], $nested_prop_path, $dependency_graph );
}
break;
case 'array':
$item_prop_type = $prop_type->get_item_type();
$dependency_graph = self::build_dependency_graph( [ $prop_name => $item_prop_type ], $current_path, $dependency_graph );
break;
case 'union':
foreach ( $prop_type->get_prop_types() as $nested_prop_type ) {
$dependency_graph = self::build_dependency_graph( [ $prop_name => $nested_prop_type ], $current_path, $dependency_graph );
}
break;
}
return $dependency_graph;
}
private static function process_dependency_term( array $term, array $current_path, string $prop_name, array $dependency_graph ): array {
if ( self::is_term_nested( $term ) ) {
foreach ( $term['terms'] as $nested_term ) {
$dependency_graph = self::process_dependency_term( $nested_term, $current_path, $prop_name, $dependency_graph );
}
return $dependency_graph;
}
if ( ! isset( $term['path'] ) || empty( $term['path'] ) ) {
Utils::safe_throw( 'Invalid term path in dependency.' );
}
$target_path = implode( '.', $term['path'] );
$source = array_merge( $current_path, [ $prop_name ] );
$source_path = implode( '.', $source );
if ( ! isset( $dependency_graph[ $target_path ] ) ) {
$dependency_graph[ $target_path ] = [];
}
if ( ! in_array( $source_path, $dependency_graph[ $target_path ] ) ) {
$dependency_graph[ $target_path ][] = $source_path;
}
return $dependency_graph;
}
private static function has_circular_dependencies( array $dependency_graph ): bool {
$visited_nodes = [];
$current_path_stack = [];
foreach ( array_keys( $dependency_graph ) as $node ) {
if ( isset( $visited_nodes[ $node ] ) ) {
continue;
}
if ( self::detect_cycle_from_node( $dependency_graph, $node, $visited_nodes, $current_path_stack ) ) {
return true;
}
}
return false;
}
private static function detect_cycle_from_node( array $dependency_graph, string $current_node, array &$visited_nodes, array &$current_path_stack ): bool {
if ( isset( $current_path_stack[ $current_node ] ) ) {
return true;
}
if ( isset( $visited_nodes[ $current_node ] ) ) {
return false;
}
$visited_nodes[ $current_node ] = true;
$current_path_stack[ $current_node ] = true;
foreach ( $dependency_graph[ $current_node ] ?? [] as $dependent_node ) {
$is_circular = self::detect_cycle_from_node( $dependency_graph, $dependent_node, $visited_nodes, $current_path_stack );
if ( $is_circular ) {
return true;
}
}
unset( $current_path_stack[ $current_node ] );
return false;
}
private static function is_term_nested( $term ): bool {
return isset( $term['terms'] ) && is_array( $term['terms'] );
}
}

View File

@@ -0,0 +1,534 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypeMigrations;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Migration_Interpreter {
public static function run( array $migration_schema, array $element_data, string $direction = 'up' ): array {
if ( ! in_array( $direction, [ 'up', 'down' ], true ) ) {
throw new \InvalidArgumentException( sprintf( 'Invalid direction "%s". Must be "up" or "down".', esc_html( $direction ) ) );
}
$operations = $migration_schema[ $direction ] ?? [];
if ( empty( $operations ) ) {
return $element_data;
}
foreach ( $operations as $operation_def ) {
$element_data = self::apply_operation( $operation_def, $element_data );
}
return $element_data;
}
private static function apply_operation( array $operation_def, array $element_data ): array {
$op = $operation_def['op'] ?? [];
$condition = $operation_def['condition'] ?? null;
$fn = $op['fn'] ?? null;
$path_pattern = $op['path'] ?? null;
if ( null === $fn ) {
return $element_data;
}
if ( 'move' === $fn ) {
self::execute_move( $op, $element_data );
return $element_data;
}
if ( null === $path_pattern ) {
return $element_data;
}
$resolved_paths = Path_Resolver::resolve( $path_pattern, $element_data );
if ( empty( $resolved_paths ) && 'set' === $fn && ! self::has_wildcard( $path_pattern ) ) {
$resolved_paths = [
[
'path' => $path_pattern,
'wildcard_values' => [],
],
];
}
foreach ( $resolved_paths as $path_info ) {
$resolved_path = $path_info['path'];
$wildcard_values = $path_info['wildcard_values'];
if ( null !== $condition && ! self::check_condition( $condition, $wildcard_values, $element_data ) ) {
continue;
}
self::execute_operation( $fn, $op, $resolved_path, $element_data );
}
return $element_data;
}
private static function has_wildcard( string $path ): bool {
return strpos( $path, '*' ) !== false;
}
private static function execute_operation( string $fn, array $op, string $path, array &$data ): void {
switch ( $fn ) {
case 'set':
self::execute_set( $op, $path, $data );
break;
case 'delete':
$clean = $op['clean'] ?? true;
self::execute_delete( $data, $path, $clean );
break;
case 'move':
self::execute_move( $op, $data );
break;
}
}
private static function execute_set( array $op, string $path, array &$data ): void {
$has_value = array_key_exists( 'value', $op );
$has_key = array_key_exists( 'key', $op );
$merge = $op['merge'] ?? true;
if ( $has_key ) {
$new_key = $op['key'];
self::rename_key_at_path( $data, $path, $new_key );
$path = self::get_renamed_path( $path, $new_key );
}
if ( $has_value ) {
$current_value = Path_Resolver::get( $path, $data );
$new_value = self::resolve_value( $op['value'], $current_value );
if ( $merge && is_array( $current_value ) && is_array( $new_value ) ) {
$new_value = self::deep_merge( $current_value, $new_value );
}
self::set_at_path( $data, $path, $new_value );
} elseif ( ! $has_key ) {
self::set_at_path( $data, $path, new \stdClass() );
}
}
private static function execute_move( array $op, array &$data ): void {
$src = $op['src'] ?? null;
$dest = $op['dest'] ?? null;
$clean = $op['clean'] ?? true;
if ( null === $src || null === $dest ) {
throw new \InvalidArgumentException( 'Move operation requires both "src" and "dest" parameters' );
}
$value = Path_Resolver::get( $src, $data );
if ( null === $value ) {
return;
}
self::set_at_path( $data, $dest, $value );
if ( $clean ) {
self::execute_delete( $data, $src, true );
}
}
private static function check_condition( array $condition, array $wildcard_values, array $data ): bool {
$fn = $condition['fn'] ?? null;
if ( null === $fn ) {
return true;
}
if ( 'and' === $fn ) {
return self::check_and_condition( $condition, $wildcard_values, $data );
}
if ( 'or' === $fn ) {
return self::check_or_condition( $condition, $wildcard_values, $data );
}
$path_pattern = $condition['path'] ?? null;
if ( null === $path_pattern ) {
return false;
}
$resolved_path = Path_Resolver::resolve_with_wildcard_binding( $path_pattern, $data, $wildcard_values );
if ( null === $resolved_path ) {
if ( 'not_exists' === $fn ) {
return true;
}
return false;
}
$value = Path_Resolver::get( $resolved_path, $data );
$expected = $condition['value'] ?? null;
return self::evaluate_condition( $fn, $value, $expected );
}
private static function check_and_condition( array $condition, array $wildcard_values, array $data ): bool {
$conditions = $condition['conditions'] ?? [];
foreach ( $conditions as $condition ) {
if ( ! self::check_condition( $condition, $wildcard_values, $data ) ) {
return false;
}
}
return true;
}
private static function check_or_condition( array $condition, array $wildcard_values, array $data ): bool {
$conditions = $condition['conditions'] ?? [];
foreach ( $conditions as $condition ) {
if ( self::check_condition( $condition, $wildcard_values, $data ) ) {
return true;
}
}
return false;
}
private static function evaluate_condition( string $fn, $value, $expected ): bool {
switch ( $fn ) {
case 'equals':
return $value === $expected;
case 'not_equals':
return $value !== $expected;
case 'exists':
return null !== $value;
case 'not_exists':
return null === $value;
case 'in':
return is_array( $expected ) && in_array( $value, $expected, true );
case 'not_in':
return is_array( $expected ) && ! in_array( $value, $expected, true );
case 'is_primitive':
return is_scalar( $value );
case 'is_object':
return is_array( $value ) && self::is_associative_array( $value );
case 'is_array':
return is_array( $value ) && ! self::is_associative_array( $value );
default:
return false;
}
}
private static function is_associative_array( array $array ): bool {
if ( empty( $array ) ) {
return true;
}
return array_keys( $array ) !== range( 0, count( $array ) - 1 );
}
private static function resolve_value( $value_definition, $current_value ) {
if ( ! self::is_reference( $value_definition ) ) {
return $value_definition;
}
if ( is_string( $value_definition ) ) {
return self::resolve_string_reference( $value_definition, $current_value );
}
if ( is_array( $value_definition ) ) {
return self::resolve_array_reference( $value_definition, $current_value );
}
return $value_definition;
}
private static function is_reference( $value ): bool {
if ( is_string( $value ) ) {
return '$$current' === $value || 0 === strpos( $value, '$$current.' );
}
if ( is_array( $value ) ) {
foreach ( $value as $item ) {
if ( self::is_reference( $item ) ) {
return true;
}
}
}
return false;
}
private static function resolve_string_reference( string $value, $current_value ) {
if ( '$$current' === $value ) {
return $current_value;
}
if ( 0 === strpos( $value, '$$current.' ) ) {
$path = substr( $value, 10 );
return self::get_nested_value( $current_value, $path );
}
return $value;
}
private static function resolve_array_reference( array $value, $current_value ): array {
$result = [];
foreach ( $value as $key => $item ) {
$result[ $key ] = self::resolve_value( $item, $current_value );
}
return $result;
}
private static function get_nested_value( $data, string $path ) {
if ( ! is_array( $data ) ) {
return null;
}
$keys = explode( '.', $path );
foreach ( $keys as $key ) {
if ( ! is_array( $data ) || ! array_key_exists( $key, $data ) ) {
return null;
}
$data = $data[ $key ];
}
return $data;
}
private static function deep_merge( array $base, array $overlay ): array {
foreach ( $overlay as $key => $value ) {
if ( is_array( $value ) && isset( $base[ $key ] ) && is_array( $base[ $key ] ) ) {
$base[ $key ] = self::deep_merge( $base[ $key ], $value );
} else {
$base[ $key ] = $value;
}
}
return $base;
}
private static function get_renamed_path( string $path, string $new_key ): string {
$last_dot = strrpos( $path, '.' );
$last_bracket = strrpos( $path, '[' );
if ( false === $last_dot && false === $last_bracket ) {
return $new_key;
}
$last_separator = max(
false === $last_dot ? -1 : $last_dot,
false === $last_bracket ? -1 : $last_bracket
);
if ( $last_separator === $last_bracket ) {
$close_bracket = strpos( $path, ']', $last_bracket );
if ( false === $close_bracket ) {
throw new \Exception( sprintf( 'Malformed path: missing closing bracket in "%s"', esc_html( $path ) ) );
}
return substr( $path, 0, $last_bracket + 1 ) . $new_key . substr( $path, $close_bracket );
}
return substr( $path, 0, $last_dot + 1 ) . $new_key;
}
private static function set_at_path( array &$data, string $path, $value ): void {
$segments = self::parse_path_segments( $path );
if ( empty( $segments ) ) {
return;
}
self::set_recursive( $data, $segments, $value );
}
private static function execute_delete( array &$data, string $path, bool $clean = true ): void {
$segments = self::parse_path_segments( $path );
if ( empty( $segments ) ) {
return;
}
self::delete_recursive( $data, $segments, $clean, false );
}
private static function rename_key_at_path( array &$data, string $path, string $new_key ): void {
$segments = self::parse_path_segments( $path );
if ( empty( $segments ) ) {
return;
}
self::rename_key_recursive( $data, $segments, $new_key );
}
private static function parse_path_segments( string $path ): array {
$segments = [];
$current = '';
$length = strlen( $path );
for ( $i = 0; $i < $length; $i++ ) {
$char = $path[ $i ];
if ( '.' === $char ) {
self::flush_segment( $segments, $current );
} elseif ( '[' === $char ) {
self::flush_segment( $segments, $current );
$i = self::parse_bracket_segment( $path, $i, $segments );
} else {
$current .= $char;
}
}
self::flush_segment( $segments, $current );
return $segments;
}
private static function flush_segment( array &$segments, string &$current ): void {
if ( '' !== $current ) {
$segments[] = $current;
$current = '';
}
}
private static function parse_bracket_segment( string $path, int $start_pos, array &$segments ): int {
$end = strpos( $path, ']', $start_pos );
if ( false === $end ) {
throw new \Exception( sprintf( 'Malformed path: unmatched opening bracket in "%s"', esc_html( $path ) ) );
}
$index = substr( $path, $start_pos + 1, $end - $start_pos - 1 );
if ( '' === $index ) {
$segments[] = '[]';
} else {
$segments[] = $index;
}
return $end;
}
private static function set_recursive( array &$data, array $segments, $value ): void {
$key = array_shift( $segments );
if ( '[]' === $key ) {
if ( empty( $segments ) ) {
$data[] = $value;
} else {
$new_index = count( $data );
$data[ $new_index ] = [];
self::set_recursive( $data[ $new_index ], $segments, $value );
}
return;
}
if ( empty( $segments ) ) {
$data[ $key ] = $value;
return;
}
if ( ! isset( $data[ $key ] ) || ! is_array( $data[ $key ] ) ) {
$data[ $key ] = [];
}
self::set_recursive( $data[ $key ], $segments, $value );
}
private static function delete_recursive( array &$data, array $segments, bool $clean = true, bool $can_convert_to_object = true ): bool {
$key = array_shift( $segments );
if ( ! array_key_exists( $key, $data ) ) {
return false;
}
if ( empty( $segments ) ) {
$was_associative = ! self::is_indexed_array( $data );
unset( $data[ $key ] );
if ( ! $was_associative ) {
$data = array_values( $data );
}
if ( $can_convert_to_object && empty( $data ) && $was_associative ) {
$data = new \stdClass();
}
if ( $clean && ( $data instanceof \stdClass || empty( $data ) ) ) {
return true;
}
return false;
}
if ( is_array( $data[ $key ] ) ) {
$should_delete_parent = self::delete_recursive( $data[ $key ], $segments, $clean, true );
if ( $should_delete_parent ) {
$was_parent_associative = ! self::is_indexed_array( $data );
unset( $data[ $key ] );
if ( ! $was_parent_associative ) {
$data = array_values( $data );
}
if ( $can_convert_to_object && empty( $data ) && $was_parent_associative ) {
$data = new \stdClass();
}
if ( $clean && ( $data instanceof \stdClass || empty( $data ) ) ) {
return true;
}
}
}
return false;
}
private static function is_indexed_array( array $array ): bool {
if ( empty( $array ) ) {
return false;
}
$keys = array_keys( $array );
return range( 0, count( $array ) - 1 ) === $keys;
}
private static function rename_key_recursive( array &$data, array $segments, string $new_key ): void {
$key = array_shift( $segments );
if ( ! array_key_exists( $key, $data ) ) {
return;
}
if ( empty( $segments ) ) {
$new_data = [];
foreach ( $data as $k => $v ) {
if ( $k === $key ) {
$new_data[ $new_key ] = $v;
} else {
$new_data[ $k ] = $v;
}
}
$data = $new_data;
return;
}
if ( is_array( $data[ $key ] ) ) {
self::rename_key_recursive( $data[ $key ], $segments, $new_key );
}
}
}

View File

@@ -0,0 +1,323 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypeMigrations;
use Elementor\Modules\AtomicWidgets\Logger\Logger;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Migrations_Loader {
private static ?self $instance = null;
private ?array $manifest = null;
private ?string $manifest_hash = null;
private string $base_path;
private string $manifest_file;
private function __construct( string $base_path, string $manifest_file = 'manifest.json' ) {
$this->base_path = rtrim( $base_path, '/' ) . '/';
$this->manifest_file = $manifest_file;
}
public static function make( string $base_path, string $manifest_file = 'manifest.json' ): self {
if ( null === self::$instance ) {
self::$instance = new self( $base_path, $manifest_file );
}
return self::$instance;
}
public static function destroy(): void {
self::$instance = null;
}
public function find_migration_path( string $source_type, string $target_type ): ?array {
$graph = $this->build_migration_graph();
$path = $this->find_shortest_path( $graph, $source_type, $target_type );
if ( $path ) {
return [
'migrations' => $path,
'direction' => 'up',
];
}
$path = $this->find_shortest_path( $graph, $target_type, $source_type );
if ( $path ) {
return [
'migrations' => array_reverse( $path ),
'direction' => 'down',
];
}
return null;
}
public function find_widget_key_migration( string $orphaned_key, array $missing_keys, string $widget_type ): ?string {
$graph = $this->build_widget_key_graph( $widget_type );
$valid_targets = [];
foreach ( $missing_keys as $missing_key ) {
if ( $this->key_path_exists( $graph, $orphaned_key, $missing_key ) ||
$this->key_path_exists( $graph, $missing_key, $orphaned_key ) ) {
$valid_targets[] = $missing_key;
}
}
if ( count( $valid_targets ) === 1 ) {
return $valid_targets[0];
}
return null;
}
private function build_migration_graph(): array {
$manifest = $this->get_manifest();
$graph = [];
$prop_types = $manifest['propTypes'] ?? [];
foreach ( $prop_types as $id => $migration ) {
$from = $migration['fromType'];
if ( ! isset( $graph[ $from ] ) ) {
$graph[ $from ] = [];
}
$migration['id'] = $id;
$graph[ $from ][] = $migration;
}
return $graph;
}
private function build_widget_key_graph( string $widget_type ): array {
$manifest = $this->get_manifest();
$graph = [];
$widget_keys = $manifest['widgetKeys'] ?? [];
if ( ! isset( $widget_keys[ $widget_type ] ) ) {
return $graph;
}
foreach ( $widget_keys[ $widget_type ] as $mapping ) {
$from = $mapping['from'];
$to = $mapping['to'];
if ( ! isset( $graph[ $from ] ) ) {
$graph[ $from ] = [];
}
$graph[ $from ][] = $to;
}
return $graph;
}
private function key_path_exists( array $graph, string $start, string $end ): bool {
if ( $start === $end ) {
return false;
}
if ( ! isset( $graph[ $start ] ) ) {
return false;
}
if ( in_array( $end, $graph[ $start ], true ) ) {
return true;
}
$visited = [ $start => true ];
$queue = [ $start ];
while ( ! empty( $queue ) ) {
$current = array_shift( $queue );
if ( ! isset( $graph[ $current ] ) ) {
continue;
}
foreach ( $graph[ $current ] as $next ) {
if ( isset( $visited[ $next ] ) ) {
continue;
}
if ( $next === $end ) {
return true;
}
$visited[ $next ] = true;
$queue[] = $next;
}
}
return false;
}
private function find_shortest_path( array $graph, string $start, string $end ): ?array {
if ( $start === $end ) {
return [];
}
$queue = [ [ $start, [] ] ];
$visited = [ $start => true ];
while ( ! empty( $queue ) ) {
list( $current, $path ) = array_shift( $queue );
if ( ! isset( $graph[ $current ] ) ) {
continue;
}
foreach ( $graph[ $current ] as $migration ) {
$next = $migration['toType'];
if ( isset( $visited[ $next ] ) ) {
continue;
}
$new_path = array_merge( $path, [ $migration ] );
if ( $next === $end ) {
return $new_path;
}
$visited[ $next ] = true;
$queue[] = [ $next, $new_path ];
}
}
return null;
}
public function load_operations( string $migration_id ): ?array {
$manifest = $this->get_manifest();
$prop_types = $manifest['propTypes'] ?? [];
if ( ! isset( $prop_types[ $migration_id ] ) ) {
return null;
}
$migration = $prop_types[ $migration_id ];
if ( ! isset( $migration['path'] ) ) {
return null;
}
$file_path = $this->base_path . $migration['path'];
$contents = $this->read_source( $file_path );
if ( false === $contents ) {
Logger::warning( 'Migration operation file not found', [
'migration_id' => $migration_id,
'path' => $file_path,
] );
return null;
}
$operations = json_decode( $contents, true );
if ( json_last_error() !== JSON_ERROR_NONE ) {
Logger::warning( 'Invalid migration operation JSON', [
'migration_id' => $migration_id,
'path' => $file_path,
'error' => json_last_error_msg(),
] );
return null;
}
return $operations;
}
public function get_manifest_hash(): string {
if ( null !== $this->manifest_hash ) {
return $this->manifest_hash;
}
$manifest = $this->get_manifest();
if ( empty( $manifest ) ) {
$this->manifest_hash = '';
return $this->manifest_hash;
}
$this->manifest_hash = md5( wp_json_encode( $manifest ) );
return $this->manifest_hash;
}
private function get_manifest(): array {
if ( null !== $this->manifest ) {
return $this->manifest;
}
$manifest_path = $this->base_path . $this->manifest_file;
$contents = $this->read_source( $manifest_path );
if ( false === $contents ) {
Logger::warning( 'Migrations manifest not found', [
'path' => $manifest_path,
] );
$this->manifest = [
'widgetKeys' => [],
'propTypes' => [],
];
return $this->manifest;
}
$manifest = json_decode( $contents, true );
if ( json_last_error() !== JSON_ERROR_NONE ) {
Logger::warning( 'Invalid migrations manifest JSON', [
'path' => $manifest_path,
'error' => json_last_error_msg(),
] );
$this->manifest = [
'widgetKeys' => [],
'propTypes' => [],
];
return $this->manifest;
}
$this->manifest = $manifest;
return $this->manifest;
}
private function read_source( string $path ) {
if ( $this->is_url( $path ) ) {
$response = wp_remote_get( $path, [ 'timeout' => 10 ] );
if ( is_wp_error( $response ) ) {
return false;
}
return wp_remote_retrieve_body( $response );
}
if ( ! file_exists( $path ) ) {
return false;
}
return file_get_contents( $path );
}
private function is_url( string $path ): bool {
return str_starts_with( $path, 'http://' ) || str_starts_with( $path, 'https://' );
}
}

View File

@@ -0,0 +1,581 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypeMigrations;
use Elementor\Modules\AtomicWidgets\Logger\Logger;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Array_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Union_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Style_Schema;
use Elementor\Modules\GlobalClasses\Utils\Atomic_Elements_Utils;
use Elementor\Plugin;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Migrations_Orchestrator {
private const MIGRATIONS_STATE_META_KEY = '_elementor_migrations_state';
private static ?self $instance = null;
private Migrations_Loader $loader;
private function __construct( string $migrations_base_path ) {
$this->loader = Migrations_Loader::make( $migrations_base_path );
}
public static function make( string $migrations_base_path ): self {
if ( null === self::$instance ) {
self::$instance = new self( $migrations_base_path );
}
return self::$instance;
}
public static function destroy(): void {
Migrations_Loader::destroy();
self::$instance = null;
}
/**
* Registers hooks to listen for experiment flag state changes.
*
* Usage example:
* ```
* static $registered = false;
* if ( $registered ) {
* return;
* }
*
* add_action(
* 'elementor/experiments/feature-state-change/' . Atomic_Widgets_Module::EXPERIMENT_INLINE_EDITING,
* [ __CLASS__, 'clear_migration_cache' ],
* 10,
* 2
* );
*
* $registered = true;
* ```
*
* This ensures that when the inline editing experiment is enabled or disabled, all
* migration state metadata is cleared, forcing documents to be re-migrated with the
* new feature flag state.
*/
public static function register_feature_flag_hooks(): void {
}
public static function clear_migration_cache( $old_state = null, $new_state = null ): void {
global $wpdb;
$deleted = $wpdb->query(
$wpdb->prepare(
"DELETE FROM {$wpdb->postmeta} WHERE meta_key = %s",
self::MIGRATIONS_STATE_META_KEY
)
);
if ( false === $deleted ) {
Logger::error( 'Failed to clear migration caches', [
'error' => $wpdb->last_error,
'reason' => 'feature_flag_change',
'old_state' => $old_state,
'new_state' => $new_state,
] );
return;
}
Logger::info( 'Cleared migration caches', [
'deleted_count' => $deleted,
'reason' => 'feature_flag_change',
'old_state' => $old_state,
'new_state' => $new_state,
] );
}
public function migrate_document(
array &$elements_data,
int $post_id,
callable $save_callback
): void {
try {
if ( $this->is_migrated( $post_id ) ) {
return;
}
$has_changes = $this->migrate_elements_recursive( $elements_data );
if ( $has_changes ) {
$save_callback( $elements_data );
}
$this->mark_as_migrated( $post_id );
} catch ( \Exception $e ) {
Logger::warning( 'Document migration failed', [
'post_id' => $post_id,
'error' => $e->getMessage(),
] );
}
}
private function migrate_elements_recursive( array &$elements_data ): bool {
$has_changes = false;
foreach ( $elements_data as &$element ) {
$element_type = $element['widgetType'] ?? $element['elType'] ?? '';
try {
$element_has_changes = $this->walk_and_migrate( $element );
if ( $element_has_changes ) {
$has_changes = true;
}
} catch ( \Exception $e ) {
Logger::warning( 'Element migration failed', [
'element_type' => $element_type,
'error' => $e->getMessage(),
] );
}
if ( isset( $element['elements'] ) && is_array( $element['elements'] ) ) {
$nested_has_changes = $this->migrate_elements_recursive( $element['elements'] );
if ( $nested_has_changes ) {
$has_changes = true;
}
}
}
return $has_changes;
}
private function walk_and_migrate( array &$data, ?array $schema = null, ?array $context = null ): bool {
$has_changes = false;
if ( null === $schema ) {
$schema = $this->try_get_schema( $data, $context );
}
if ( ! empty( $schema ) ) {
$element_type = $context['element_type'] ?? 'unknown';
$migrate_changes = $this->migrate_element( $data, $schema, $element_type );
if ( $migrate_changes ) {
$has_changes = true;
}
}
foreach ( $data as $key => &$value ) {
if ( 'elements' === $key ) {
continue;
}
if ( ! is_array( $value ) || empty( $value ) ) {
continue;
}
$nested_context = $this->build_context( $data, $key, $context );
$nested_changes = $this->walk_and_migrate( $value, null, $nested_context );
if ( $nested_changes ) {
$has_changes = true;
}
}
return $has_changes;
}
private function try_get_schema( array $data, ?array $context ): array {
if ( isset( $context['key'] ) && 'settings' === $context['key'] && isset( $context['parent'] ) ) {
return $this->get_settings_schema( $context['parent'] );
}
if ( isset( $context['key'] ) && 'props' === $context['key'] ) {
return Style_Schema::get();
}
return [];
}
private function build_context( array $parent, $key, ?array $existing_context ): array {
$context = [
'key' => $key,
'parent' => $parent,
];
if ( isset( $existing_context['element_type'] ) ) {
$context['element_type'] = $existing_context['element_type'];
} elseif ( isset( $parent['widgetType'] ) || isset( $parent['elType'] ) ) {
$context['element_type'] = $parent['widgetType'] ?? $parent['elType'] ?? 'unknown';
}
return $context;
}
private function get_settings_schema( array $element ): array {
if ( $this->is_atomic_widget( $element ) ) {
return $this->get_widget_schema( $element['widgetType'] );
}
if ( $this->is_atomic_element( $element ) ) {
return $this->get_element_schema( $element['elType'] );
}
return [];
}
private function is_migrated( int $post_id ): bool {
$current_state = $this->get_migration_state();
if ( empty( $current_state ) ) {
return false;
}
$stored_state = get_post_meta( $post_id, self::MIGRATIONS_STATE_META_KEY, true );
return $current_state === $stored_state;
}
private function mark_as_migrated( int $post_id ): void {
update_post_meta( $post_id, self::MIGRATIONS_STATE_META_KEY, $this->get_migration_state() );
}
private function get_migration_state(): string {
$hash = $this->loader->get_manifest_hash();
if ( empty( $hash ) ) {
return '';
}
return ELEMENTOR_VERSION . ':' . $hash;
}
private function get_schema( array $element ): array {
if ( $this->is_atomic_widget( $element ) ) {
return $this->get_widget_schema( $element['widgetType'] );
}
if ( $this->is_atomic_element( $element ) ) {
return $this->get_element_schema( $element['elType'] );
}
return [];
}
private function get_widget_schema( string $widget_type ): array {
$widget = Plugin::$instance->widgets_manager->get_widget_types( $widget_type );
if ( ! $widget ) {
return [];
}
if ( ! method_exists( $widget, 'get_props_schema' ) ) {
return [];
}
$schema = call_user_func( [ $widget, 'get_props_schema' ] );
return is_array( $schema ) ? $schema : [];
}
private function is_atomic_widget( array $element ): bool {
if ( ! isset( $element['elType'] ) || 'widget' !== $element['elType'] ) {
return false;
}
if ( ! isset( $element['widgetType'] ) ) {
return false;
}
$widget = Plugin::$instance->widgets_manager->get_widget_types( $element['widgetType'] );
return Atomic_Elements_Utils::is_atomic_element( $widget );
}
private function is_atomic_element( array $element ): bool {
$el_type = $element['elType'] ?? '';
if ( empty( $el_type ) || 'widget' === $el_type ) {
return false;
}
$element_instance = Plugin::$instance->elements_manager->get_element_types( $el_type );
return Atomic_Elements_Utils::is_atomic_element( $element_instance );
}
private function get_element_schema( string $element_type ): array {
$element = Plugin::$instance->elements_manager->get_element_types( $element_type );
if ( ! $element ) {
return [];
}
if ( ! method_exists( $element, 'get_props_schema' ) ) {
return [];
}
$schema = call_user_func( [ $element, 'get_props_schema' ] );
return is_array( $schema ) ? $schema : [];
}
public function migrate_element( array &$settings, array $schema, string $widget_type ): bool {
$missing_keys = array_keys( $schema );
$pending_migrations = [];
$has_changes = false;
foreach ( $settings as $key => $value ) {
if ( ! isset( $schema[ $key ] ) ) {
$this->process_missing_key( $key, $value, $widget_type, $missing_keys, $pending_migrations );
} else {
$missing_keys = array_diff( $missing_keys, [ $key ] );
if ( $this->process_setting_key( $key, $value, $schema, $settings ) ) {
$has_changes = true;
}
}
}
$this->apply_pending_key_migrations( $pending_migrations, $schema, $settings, $has_changes );
return $has_changes;
}
private function process_setting_key(
string $key,
$value,
array $schema,
array &$settings
): bool {
$result = $this->migrate_prop_if_needed( $value, $schema[ $key ], $key );
$settings[ $key ] = $result['value'];
return $result['has_changes'];
}
private function process_missing_key(
string $key,
$value,
string $widget_type,
array $missing_keys,
array &$pending_migrations
): void {
$target_key = $this->loader->find_widget_key_migration( $key, $missing_keys, $widget_type );
if ( $target_key ) {
$pending_migrations[ $target_key ][] = [
'from' => $key,
'value' => $value,
];
}
}
private function apply_pending_key_migrations( array $pending_migrations, array $schema, array &$settings, bool &$has_changes ): void {
foreach ( $pending_migrations as $target_key => $sources ) {
if ( count( $sources ) === 1 ) { // sanity check for only one key source, otherwise no-op
$result = $this->migrate_prop_if_needed(
$sources[0]['value'],
$schema[ $target_key ],
$target_key
);
$settings[ $target_key ] = $result['value'];
unset( $settings[ $sources[0]['from'] ] );
$has_changes = true;
}
}
}
private function migrate_prop_if_needed( $value, $prop_type, string $key ): array {
if ( ! ( $prop_type instanceof Prop_Type ) ) {
return [
'value' => $value,
'has_changes' => false,
];
}
return $this->migrate_prop( $value, $prop_type, $key );
}
private function migrate_prop( $value, Prop_Type $prop_type, string $prop_name ): array {
$has_changes = false;
if ( ! is_array( $value ) || ! isset( $value['$$type'] ) || ! isset( $value['value'] ) ) {
return [
'value' => $value,
'has_changes' => false,
];
}
$actual_prop_type = $prop_type;
if ( $prop_type instanceof Union_Prop_Type ) {
$actual_prop_type = $this->resolve_union_type( $value, $prop_type );
if ( ! $actual_prop_type ) {
return [
'value' => $value,
'has_changes' => false,
];
}
}
$trigger = $this->type_mismatch( $value, $actual_prop_type, $prop_name );
if ( $trigger ) {
$path_result = $this->loader->find_migration_path(
$trigger['found_type'],
$trigger['expected_type']
);
if ( $path_result ) {
$value = $this->execute_prop_migration( $value, $path_result['migrations'], $path_result['direction'] );
return [
'value' => $value,
'has_changes' => true,
];
}
}
if ( $actual_prop_type instanceof Object_Prop_Type && is_array( $value['value'] ) ) {
$shape = $actual_prop_type->get_shape();
$nested_result = $this->migrate_nested_object( $value['value'], $shape );
if ( $nested_result['has_changes'] ) {
$value['value'] = $nested_result['value'];
$has_changes = true;
}
} elseif ( $actual_prop_type instanceof Array_Prop_Type && is_array( $value['value'] ) ) {
$item_type = $actual_prop_type->get_item_type();
$nested_result = $this->migrate_nested_array( $value['value'], $item_type );
if ( $nested_result['has_changes'] ) {
$value['value'] = $nested_result['value'];
$has_changes = true;
}
}
return [
'value' => $value,
'has_changes' => $has_changes,
];
}
private function resolve_union_type( array $value, Union_Prop_Type $union_prop_type ): ?Prop_Type {
$found_type = $value['$$type'] ?? null;
if ( ! $found_type ) {
return null;
}
$variant = $union_prop_type->get_prop_type( $found_type );
if ( $variant ) {
return $variant;
}
foreach ( $union_prop_type->get_prop_types() as $variant_type ) {
$expected_key = $variant_type::get_key();
$path_exists = $this->loader->find_migration_path( $found_type, $expected_key );
if ( $path_exists ) {
return $variant_type;
}
}
return null;
}
private function migrate_nested_object( array $values, array $shape ): array {
$has_changes = false;
$migrated = [];
foreach ( $values as $key => $value ) {
if ( ! isset( $shape[ $key ] ) || ! ( $shape[ $key ] instanceof Prop_Type ) ) {
$migrated[ $key ] = $value;
continue;
}
$result = $this->migrate_prop( $value, $shape[ $key ], $key );
$migrated[ $key ] = $result['value'];
if ( $result['has_changes'] ) {
$has_changes = true;
}
}
return [
'value' => $migrated,
'has_changes' => $has_changes,
];
}
private function migrate_nested_array( array $items, Prop_Type $item_type ): array {
$has_changes = false;
$migrated = [];
foreach ( $items as $index => $item ) {
$result = $this->migrate_prop( $item, $item_type, (string) $index );
$migrated[ $index ] = $result['value'];
if ( $result['has_changes'] ) {
$has_changes = true;
}
}
return [
'value' => $migrated,
'has_changes' => $has_changes,
];
}
private function execute_prop_migration( $prop_value, array $migrations, string $direction ) {
foreach ( $migrations as $migration ) {
try {
$operations = $this->loader->load_operations( $migration['id'] );
if ( ! $operations || ! isset( $operations[ $direction ] ) ) {
continue;
}
$prop_value = Migration_Interpreter::run(
[ $direction => $operations[ $direction ] ],
$prop_value,
$direction
);
} catch ( \Exception $e ) {
Logger::warning( 'Migration operation failed', [
'migration_id' => $migration['id'],
'direction' => $direction,
'error' => $e->getMessage(),
] );
return $prop_value;
}
}
return $prop_value;
}
private function type_mismatch( $value, Prop_Type $prop_type, string $prop_name ): ?array {
if ( ! is_array( $value ) || ! isset( $value['$$type'] ) ) {
return null;
}
$expected_type = $prop_type::get_key();
$found_type = $value['$$type'];
if ( $found_type === $expected_type ) {
return null;
}
return [
'prop_name' => $prop_name,
'found_type' => $found_type,
'expected_type' => $expected_type,
'reason' => 'type_mismatch',
];
}
}

View File

@@ -0,0 +1,231 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypeMigrations;
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
class Path_Resolver {
public static function resolve( string $pattern, array $data, bool $allow_missing_leaf = true ): array {
$segments = self::parse_path( $pattern );
return self::resolve_segments( $segments, $data, [], '', $allow_missing_leaf );
}
public static function resolve_with_wildcard_binding( string $pattern, array $data, array $wildcard_values ): ?string {
$segments = self::parse_path( $pattern );
$wildcard_index = 0;
return self::resolve_with_binding( $segments, $data, '', $wildcard_values, $wildcard_index );
}
public static function get( string $path, array $data ) {
$segments = self::parse_concrete_path( $path );
$current = $data;
foreach ( $segments as $segment ) {
if ( ! is_array( $current ) ) {
return null;
}
$key = $segment['value'];
if ( ! array_key_exists( $key, $current ) ) {
return null;
}
$current = $current[ $key ];
}
return $current;
}
private static function parse_path( string $path ): array {
$segments = [];
$current = '';
$length = strlen( $path );
for ( $i = 0; $i < $length; $i++ ) {
$char = $path[ $i ];
if ( '.' === $char ) {
self::flush_current_segment( $segments, $current );
} elseif ( '[' === $char ) {
self::flush_current_segment( $segments, $current );
$end = strpos( $path, ']', $i );
if ( false === $end ) {
throw new \Exception( sprintf( 'Malformed path: unmatched opening bracket in "%s"', esc_html( $path ) ) );
}
$index = substr( $path, $i + 1, $end - $i - 1 );
$segments[] = self::create_segment( $index, 'index' );
$i = $end;
} elseif ( ']' === $char ) {
throw new \Exception( sprintf( 'Malformed path: unmatched closing bracket in "%s"', esc_html( $path ) ) );
} else {
$current .= $char;
}
}
self::flush_current_segment( $segments, $current );
return $segments;
}
private static function flush_current_segment( array &$segments, string &$current ): void {
if ( '' !== $current ) {
$segments[] = self::create_segment( $current, 'key' );
$current = '';
}
}
private static function parse_concrete_path( string $path ): array {
return self::parse_path( $path );
}
private static function create_segment( string $value, string $type ): array {
return [
'value' => $value,
'type' => $type,
'is_wildcard' => '*' === $value,
];
}
private static function resolve_segments( array $segments, $data, array $wildcard_values, string $current_path = '', bool $allow_missing_leaf = true ): array {
if ( empty( $segments ) ) {
return [
[
'path' => $current_path,
'wildcard_values' => $wildcard_values,
],
];
}
if ( ! is_array( $data ) ) {
return [];
}
$segment = array_shift( $segments );
$is_last_segment = empty( $segments );
if ( $segment['is_wildcard'] ) {
return self::resolve_wildcard_segment( $segment, $segments, $data, $wildcard_values, $current_path, $allow_missing_leaf );
}
return self::resolve_concrete_segment( $segment, $segments, $data, $wildcard_values, $current_path, $is_last_segment, $allow_missing_leaf );
}
private static function resolve_wildcard_segment( array $segment, array $segments, array $data, array $wildcard_values, string $current_path, bool $allow_missing_leaf ): array {
$results = [];
$keys = array_keys( $data );
if ( 'index' === $segment['type'] ) {
$keys = array_filter( $keys, 'is_int' );
} else {
$keys = array_filter( $keys, 'is_string' );
}
foreach ( $keys as $key ) {
$new_wildcard_values = $wildcard_values;
$new_wildcard_values[] = [
'key' => $key,
'type' => $segment['type'],
];
$new_path = self::append_to_path( $current_path, $key, $segment['type'] );
$results = array_merge(
$results,
self::resolve_segments( $segments, $data[ $key ], $new_wildcard_values, $new_path, $allow_missing_leaf )
);
}
return $results;
}
private static function resolve_concrete_segment( array $segment, array $segments, array $data, array $wildcard_values, string $current_path, bool $is_last_segment, bool $allow_missing_leaf ): array {
$key = $segment['value'];
$key_exists = array_key_exists( $key, $data );
if ( ! $key_exists && ! ( $allow_missing_leaf && $is_last_segment ) ) {
return [];
}
$new_path = self::append_to_path( $current_path, $key, $segment['type'] );
if ( $is_last_segment ) {
return [
[
'path' => $new_path,
'wildcard_values' => $wildcard_values,
],
];
}
return self::resolve_segments( $segments, $data[ $key ], $wildcard_values, $new_path, $allow_missing_leaf );
}
private static function resolve_with_binding( array $segments, $data, string $prefix, array $wildcard_values, int &$wildcard_index ): ?string {
if ( empty( $segments ) ) {
return $prefix;
}
if ( ! is_array( $data ) ) {
return null;
}
$segment = array_shift( $segments );
if ( $segment['is_wildcard'] ) {
if ( ! isset( $wildcard_values[ $wildcard_index ] ) ) {
return null;
}
$key = $wildcard_values[ $wildcard_index ]['key'];
++$wildcard_index;
if ( ! array_key_exists( $key, $data ) ) {
return null;
}
$new_prefix = self::append_to_path( $prefix, $key, $segment['type'] );
return self::resolve_with_binding( $segments, $data[ $key ], $new_prefix, $wildcard_values, $wildcard_index );
}
$key = $segment['value'];
if ( ! array_key_exists( $key, $data ) ) {
return null;
}
$new_prefix = self::append_to_path( $prefix, $key, $segment['type'] );
return self::resolve_with_binding( $segments, $data[ $key ], $new_prefix, $wildcard_values, $wildcard_index );
}
private static function build_path_string( array $wildcard_values ): string {
$path = '';
foreach ( $wildcard_values as $entry ) {
$path = self::append_to_path( $path, $entry['key'], $entry['type'] );
}
return $path;
}
private static function append_to_path( string $prefix, $key, string $type ): string {
if ( 'index' === $type ) {
return $prefix . '[' . $key . ']';
}
if ( '' === $prefix ) {
return (string) $key;
}
return $prefix . '.' . $key;
}
}

View File

@@ -0,0 +1,19 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Array_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Attributes_Prop_Type extends Array_Prop_Type {
public static function get_key(): string {
return 'attributes';
}
protected function define_item_type(): Prop_Type {
return Key_Value_Prop_Type::make();
}
}

View File

@@ -0,0 +1,21 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Background_Color_Overlay_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'background-color-overlay';
}
protected function define_shape(): array {
return [
'color' => Color_Prop_Type::make()->initial_value( '#00000033' ),
];
}
}

View File

@@ -0,0 +1,31 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Position_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Background_Gradient_Overlay_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'background-gradient-overlay';
}
protected function define_shape(): array {
return [
'type' => String_Prop_Type::make()->enum( [ 'linear', 'radial' ] ),
'angle' => Number_Prop_Type::make(),
'stops' => Gradient_Color_Stop_Prop_Type::make(),
'positions' => String_Prop_Type::make()->enum( self::get_position_enum_values() ),
];
}
private static function get_position_enum_values(): array {
return Position_Prop_Type::get_position_enum_values();
}
}

View File

@@ -0,0 +1,31 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Position_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Background_Image_Overlay_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'background-image-overlay';
}
protected function define_shape(): array {
return [
'image' => Image_Prop_Type::make(),
'repeat' => String_Prop_Type::make()->enum( [ 'repeat', 'repeat-x', 'repeat-y', 'no-repeat' ] ),
'size' => Union_Prop_Type::make()
->add_prop_type( String_Prop_Type::make()->enum( [ 'auto', 'cover', 'contain' ] ) )
->add_prop_type( Background_Image_Overlay_Size_Scale_Prop_Type::make() ),
'position' => Union_Prop_Type::make()
->add_prop_type( String_Prop_Type::make()->enum( Position_Prop_Type::get_position_enum_values() ) )
->add_prop_type( Background_Image_Position_Offset_Prop_Type::make() ),
'attachment' => String_Prop_Type::make()->enum( [ 'fixed', 'scroll' ] ),
];
}
}

View File

@@ -0,0 +1,22 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Background_Image_Overlay_Size_Scale_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'background-image-size-scale';
}
protected function define_shape(): array {
return [
'width' => Size_Prop_Type::make(),
'height' => Size_Prop_Type::make(),
];
}
}

View File

@@ -0,0 +1,25 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Size_Constants;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Background_Image_Position_Offset_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'background-image-position-offset';
}
protected function define_shape(): array {
$units = Size_Constants::position();
return [
'x' => Size_Prop_Type::make()->units( $units ),
'y' => Size_Prop_Type::make()->units( $units ),
];
}
}

View File

@@ -0,0 +1,23 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Array_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Background_Overlay_Prop_Type extends Array_Prop_Type {
public static function get_key(): string {
return 'background-overlay';
}
protected function define_item_type(): Prop_Type {
return Union_Prop_Type::make()
->add_prop_type( Background_Color_Overlay_Prop_Type::make() )
->add_prop_type( Background_Image_Overlay_Prop_Type::make() )
->add_prop_type( Background_Gradient_Overlay_Prop_Type::make() );
}
}

View File

@@ -0,0 +1,25 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Background_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'background';
}
protected function define_shape(): array {
return [
'background-overlay' => Background_Overlay_Prop_Type::make(),
'color' => Color_Prop_Type::make(),
'clip' => String_Prop_Type::make()
->enum( [ 'border-box', 'padding-box', 'content-box', 'text' ] ),
];
}
}

View File

@@ -0,0 +1,126 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes\Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Concerns;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Transformable_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
abstract class Array_Prop_Type implements Transformable_Prop_Type {
// Backward compatibility, do not change to "const". Keep name in uppercase.
// phpcs:ignore
static $KIND = 'array';
use Concerns\Has_Default;
use Concerns\Has_Generate;
use Concerns\Has_Meta;
use Concerns\Has_Required_Setting;
use Concerns\Has_Settings;
use Concerns\Has_Transformable_Validation;
use Concerns\Has_Initial_Value;
protected Prop_Type $item_type;
private ?array $dependencies = null;
public function __construct() {
$this->item_type = $this->define_item_type();
}
/**
* @return static
*/
public static function make() {
return new static();
}
public function get_type(): string {
return 'array';
}
/**
* @param Prop_Type $item_type
*
* @return $this
*/
public function set_item_type( Prop_Type $item_type ) {
$this->item_type = $item_type;
return $this;
}
public function get_item_type(): Prop_Type {
return $this->item_type;
}
public function validate( $value ): bool {
if ( is_null( $value ) ) {
return ! $this->is_required();
}
return (
$this->is_transformable( $value ) &&
$this->validate_value( $value['value'] )
);
}
protected function validate_value( $value ): bool {
if ( ! is_array( $value ) ) {
return false;
}
$prop_type = $this->get_item_type();
foreach ( $value as $item ) {
if ( $prop_type && ! $prop_type->validate( $item ) ) {
return false;
}
}
return true;
}
public function sanitize( $value ) {
$value['value'] = $this->sanitize_value( $value['value'] );
return $value;
}
public function sanitize_value( $value ) {
$prop_type = $this->get_item_type();
return array_map( function ( $item ) use ( $prop_type ) {
return $prop_type->sanitize( $item );
}, $value );
}
public function jsonSerialize(): array {
return [
// phpcs:ignore
'kind' => static::$KIND,
'key' => static::get_key(),
'default' => $this->get_default(),
'meta' => (object) $this->get_meta(),
'settings' => (object) $this->get_settings(),
'item_prop_type' => $this->get_item_type(),
'dependencies' => $this->get_dependencies(),
'initial_value' => $this->get_initial_value(),
];
}
abstract protected function define_item_type(): Prop_Type;
public function set_dependencies( ?array $dependencies ): self {
$this->dependencies = empty( $dependencies ) ? null : $dependencies;
return $this;
}
public function get_dependencies(): ?array {
return $this->dependencies;
}
}

View File

@@ -0,0 +1,171 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes\Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Concerns;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Transformable_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
abstract class Object_Prop_Type implements Transformable_Prop_Type {
// Backward compatibility, do not change to "const". Keep name in uppercase.
// phpcs:ignore
static $KIND = 'object';
use Concerns\Has_Default;
use Concerns\Has_Generate;
use Concerns\Has_Meta;
use Concerns\Has_Required_Setting;
use Concerns\Has_Settings;
use Concerns\Has_Transformable_Validation;
use Concerns\Has_Initial_Value;
/**
* @var array<Prop_Type>
*/
protected array $shape;
protected ?array $dependencies = null;
public function __construct() {
$this->shape = $this->define_shape();
}
public function get_type(): string {
return 'object';
}
public function get_default() {
if ( null !== $this->default ) {
return $this->default;
}
foreach ( $this->get_shape() as $item ) {
// If the object has at least one property with default, return an empty object so
// it'll be iterable for processes like validation / transformation.
if ( $item->get_default() !== null ) {
return static::generate( [] );
}
}
return null;
}
/**
* @return static
*/
public static function make() {
return new static();
}
/**
* @param array $shape
*
* @return $this
*/
public function set_shape( array $shape ) {
$this->shape = $shape;
return $this;
}
public function get_shape(): array {
return $this->shape;
}
public function get_shape_field( $key ): ?Prop_Type {
return $this->shape[ $key ] ?? null;
}
public function validate( $value ): bool {
if ( is_null( $value ) ) {
return ! $this->is_required();
}
return (
$this->is_transformable( $value ) &&
$this->validate_value( $value['value'] )
);
}
protected function validate_value( $value ): bool {
if ( ! is_array( $value ) ) {
return false;
}
foreach ( $this->get_shape() as $key => $prop_type ) {
if ( ! ( $prop_type instanceof Prop_Type ) ) {
Utils::safe_throw( "Object prop type must have a prop type for key: $key" );
}
if ( ! $prop_type->validate( $value[ $key ] ?? $prop_type->get_default() ) ) {
return false;
}
}
return true;
}
public function sanitize( $value ) {
$value['value'] = $this->sanitize_value( $value['value'] );
return $value;
}
public function sanitize_value( $value ) {
foreach ( $this->get_shape() as $key => $prop_type ) {
if ( ! isset( $value[ $key ] ) ) {
continue;
}
$sanitized_value = $prop_type->sanitize( $value[ $key ] );
$value[ $key ] = $sanitized_value;
}
return $value;
}
public function jsonSerialize(): array {
$default = $this->get_default();
return [
// phpcs:ignore
'kind' => static::$KIND,
'key' => static::get_key(),
'default' => is_array( $default ) ? (object) $default : $default,
'meta' => (object) $this->get_meta(),
'settings' => (object) $this->get_settings(),
'shape' => (object) $this->get_shape(),
'dependencies' => $this->get_dependencies(),
'initial_value' => $this->get_initial_value(),
];
}
/**
* @return array<Prop_Type>
*/
abstract protected function define_shape(): array;
public function set_dependencies( ?array $dependencies ): self {
$this->dependencies = empty( $dependencies ) ? null : $dependencies;
return $this;
}
public function get_dependencies(): ?array {
return $this->dependencies;
}
public function set_shape_meta( string $shape_key, array $meta ): self {
foreach ( $meta as $key => $value ) {
$this->get_shape_field( $shape_key )->meta( $key, $value );
}
return $this;
}
}

View File

@@ -0,0 +1,97 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes\Base;
use Elementor\Modules\AtomicWidgets\PropTypes\Concerns;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Transformable_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
abstract class Plain_Prop_Type implements Transformable_Prop_Type {
// Backward compatibility, do not change to "const". Keep name in uppercase.
// phpcs:ignore
static $KIND = 'plain';
use Concerns\Has_Default;
use Concerns\Has_Generate;
use Concerns\Has_Meta;
use Concerns\Has_Required_Setting;
use Concerns\Has_Settings;
use Concerns\Has_Transformable_Validation;
use Concerns\Has_Initial_Value;
/**
* @return array<Plain_Prop_Type>
*/
public static function get_subclasses(): array {
$children = [];
foreach ( get_declared_classes() as $class ) {
if ( is_subclass_of( $class, self::class ) ) {
$children[] = $class;
}
}
return $children;
}
private ?array $dependencies = null;
/**
* @return static
*/
public static function make() {
return new static();
}
public function get_type(): string {
// phpcs:ignore
return static::$KIND;
}
public function validate( $value ): bool {
if ( is_null( $value ) || ( $this->is_transformable( $value ) && empty( $value['value'] ) ) ) {
return ! $this->is_required();
}
return (
$this->is_transformable( $value ) &&
$this->validate_value( $value['value'] )
);
}
public function sanitize( $value ) {
$value['value'] = $this->sanitize_value( $value['value'] );
return $value;
}
public function jsonSerialize(): array {
return [
// phpcs:ignore
'kind' => static::$KIND,
'key' => static::get_key(),
'default' => $this->get_default(),
'meta' => (object) $this->get_meta(),
'settings' => (object) $this->get_settings(),
'dependencies' => $this->get_dependencies(),
'initial_value' => $this->get_initial_value(),
];
}
abstract public static function get_key(): string;
abstract protected function validate_value( $value ): bool;
abstract protected function sanitize_value( $value );
public function set_dependencies( ?array $dependencies ): self {
$this->dependencies = empty( $dependencies ) ? null : $dependencies;
return $this;
}
public function get_dependencies(): ?array {
return $this->dependencies;
}
}

View File

@@ -0,0 +1,27 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Size_Constants;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Border_Radius_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'border-radius';
}
protected function define_shape(): array {
$units = Size_Constants::border();
return [
'start-start' => Size_Prop_Type::make()->units( $units ),
'start-end' => Size_Prop_Type::make()->units( $units ),
'end-start' => Size_Prop_Type::make()->units( $units ),
'end-end' => Size_Prop_Type::make()->units( $units ),
];
}
}

View File

@@ -0,0 +1,27 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Object_Prop_Type;
use Elementor\Modules\AtomicWidgets\Styles\Size_Constants;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Border_Width_Prop_Type extends Object_Prop_Type {
public static function get_key(): string {
return 'border-width';
}
protected function define_shape(): array {
$units = Size_Constants::border();
return [
'block-start' => Size_Prop_Type::make()->required()->units( $units ),
'block-end' => Size_Prop_Type::make()->required()->units( $units ),
'inline-start' => Size_Prop_Type::make()->required()->units( $units ),
'inline-end' => Size_Prop_Type::make()->required()->units( $units ),
];
}
}

View File

@@ -0,0 +1,20 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Array_Prop_Type;
use Elementor\Modules\AtomicWidgets\PropTypes\Contracts\Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Box_Shadow_Prop_Type extends Array_Prop_Type {
public static function get_key(): string {
return 'box-shadow';
}
protected function define_item_type(): Prop_Type {
return Shadow_Prop_Type::make();
}
}

View File

@@ -0,0 +1,46 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Base\Plain_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Classes_Prop_Type extends Plain_Prop_Type {
public static function get_key(): string {
return 'classes';
}
protected function validate_value( $value ): bool {
if ( ! is_array( $value ) ) {
return false;
}
foreach ( $value as $class_name ) {
if ( ! is_string( $class_name ) || ! preg_match( '/^[a-z][a-z-_0-9]*$/i', $class_name ) ) {
return false;
}
}
return true;
}
protected function sanitize_value( $value ) {
if ( ! is_array( $value ) ) {
return null;
}
$sanitized = array_map(function ( $class_name ) {
if ( ! is_string( $class_name ) ) {
return null;
}
return sanitize_text_field( $class_name );
}, $value);
return array_filter($sanitized, function ( $class_name ) {
return ! empty( $class_name );
});
}
}

View File

@@ -0,0 +1,15 @@
<?php
namespace Elementor\Modules\AtomicWidgets\PropTypes;
use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
class Color_Prop_Type extends String_Prop_Type {
public static function get_key(): string {
return 'color';
}
}

Some files were not shown because too many files have changed in this diff Show More