first commit
This commit is contained in:
Roman Pyrih
465
wp-content/plugins/elementor/includes/managers/elements.php
Normal file
465
wp-content/plugins/elementor/includes/managers/elements.php
Normal file
@@ -0,0 +1,465 @@
|
||||
<?php
|
||||
namespace Elementor;
|
||||
|
||||
use Elementor\Includes\Elements\Container;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
/**
|
||||
* Elementor elements manager.
|
||||
*
|
||||
* Elementor elements manager handler class is responsible for registering and
|
||||
* initializing all the supported elements.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
class Elements_Manager {
|
||||
|
||||
const CATEGORY_ATOMIC_ELEMENTS = 'v4-elements';
|
||||
const CATEGORY_ATOMIC_FORM = 'atomic-form';
|
||||
const CATEGORY_FAVORITES = 'favorites';
|
||||
const CATEGORY_ANGIE_WIDGETS = 'angie-widgets';
|
||||
const CATEGORY_CUSTOM_WIDGETS = 'custom-widgets';
|
||||
const CATEGORY_BASIC = 'basic';
|
||||
|
||||
/**
|
||||
* Element types.
|
||||
*
|
||||
* Holds the list of all the element types.
|
||||
*
|
||||
* @access private
|
||||
*
|
||||
* @var Element_Base[]
|
||||
*/
|
||||
private $_element_types;
|
||||
|
||||
/**
|
||||
* Element categories.
|
||||
*
|
||||
* Holds the list of all the element categories.
|
||||
*
|
||||
* @access private
|
||||
*
|
||||
* @var $categories
|
||||
*/
|
||||
private $categories;
|
||||
|
||||
/**
|
||||
* Elements constructor.
|
||||
*
|
||||
* Initializing Elementor elements manager.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*/
|
||||
public function __construct() {
|
||||
$this->require_files();
|
||||
}
|
||||
|
||||
/**
|
||||
* Create element instance.
|
||||
*
|
||||
* This method creates a new element instance for any given element.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $element_data Element data.
|
||||
* @param array $element_args Optional. Element arguments. Default is
|
||||
* an empty array.
|
||||
* @param Element_Base $element_type Optional. Element type. Default is null.
|
||||
*
|
||||
* @return Element_Base|null Element instance if element created, or null
|
||||
* otherwise.
|
||||
*/
|
||||
public function create_element_instance( array $element_data, array $element_args = [], ?Element_Base $element_type = null ) {
|
||||
if ( null === $element_type ) {
|
||||
$element_type = $this->get_element( $element_data['elType'], isset( $element_data['widgetType'] ) ? $element_data['widgetType'] : null );
|
||||
}
|
||||
|
||||
if ( ! $element_type ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$args = array_merge( $element_type->get_default_args(), $element_args );
|
||||
|
||||
$element_class = $element_type->get_class_name();
|
||||
|
||||
try {
|
||||
$element = new $element_class( $element_data, $args );
|
||||
} catch ( \Exception $e ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return $element;
|
||||
}
|
||||
|
||||
public function get_element( string $el_type, ?string $widget_type = null ) {
|
||||
$element = null;
|
||||
|
||||
if ( 'widget' === $el_type ) {
|
||||
$element = Plugin::$instance->widgets_manager->get_widget_types( $widget_type );
|
||||
} else {
|
||||
$element = $this->get_element_types( $el_type );
|
||||
}
|
||||
|
||||
return $element;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get element categories.
|
||||
*
|
||||
* Retrieve the list of categories the element belongs to.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @return array Element categories.
|
||||
*/
|
||||
public function get_categories() {
|
||||
if ( null === $this->categories ) {
|
||||
$this->init_categories();
|
||||
}
|
||||
|
||||
return $this->categories;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add element category.
|
||||
*
|
||||
* Register new category for the element.
|
||||
*
|
||||
* @since 1.7.12
|
||||
* @access public
|
||||
*
|
||||
* @param string $category_name Category name.
|
||||
* @param array $category_properties Category properties.
|
||||
*/
|
||||
public function add_category( $category_name, $category_properties ) {
|
||||
if ( null === $this->categories ) {
|
||||
$this->get_categories();
|
||||
}
|
||||
|
||||
if ( ! isset( $this->categories[ $category_name ] ) ) {
|
||||
$this->categories[ $category_name ] = $category_properties;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Register element type.
|
||||
*
|
||||
* Add new type to the list of registered types.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param Element_Base $element Element instance.
|
||||
*
|
||||
* @return bool Whether the element type was registered.
|
||||
*/
|
||||
public function register_element_type( Element_Base $element ) {
|
||||
$this->_element_types[ $element->get_name() ] = $element;
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Unregister element type.
|
||||
*
|
||||
* Remove element type from the list of registered types.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param string $name Element name.
|
||||
*
|
||||
* @return bool Whether the element type was unregister, or not.
|
||||
*/
|
||||
public function unregister_element_type( $name ) {
|
||||
if ( ! isset( $this->_element_types[ $name ] ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
unset( $this->_element_types[ $name ] );
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get element types.
|
||||
*
|
||||
* Retrieve the list of all the element types, or if a specific element name
|
||||
* was provided retrieve his element types.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param string $element_name Optional. Element name. Default is null.
|
||||
*
|
||||
* @return null|Element_Base|Element_Base[] Element types, or a list of all the element
|
||||
* types, or null if element does not exist.
|
||||
*/
|
||||
public function get_element_types( $element_name = null ) {
|
||||
if ( is_null( $this->_element_types ) ) {
|
||||
$this->init_elements();
|
||||
}
|
||||
|
||||
if ( null !== $element_name ) {
|
||||
return isset( $this->_element_types[ $element_name ] ) ? $this->_element_types[ $element_name ] : null;
|
||||
}
|
||||
|
||||
return $this->_element_types;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get element types config.
|
||||
*
|
||||
* Retrieve the config of all the element types.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @return array Element types config.
|
||||
*/
|
||||
public function get_element_types_config() {
|
||||
$config = [];
|
||||
|
||||
foreach ( $this->get_element_types() as $element ) {
|
||||
$config[ $element->get_name() ] = $element->get_config();
|
||||
}
|
||||
|
||||
return $config;
|
||||
}
|
||||
|
||||
/**
|
||||
* Render elements content.
|
||||
*
|
||||
* Used to generate the elements templates on the editor.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*/
|
||||
public function render_elements_content() {
|
||||
foreach ( $this->get_element_types() as $element_type ) {
|
||||
$element_type->print_template();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Init elements.
|
||||
*
|
||||
* Initialize Elementor elements by registering the supported elements.
|
||||
* Elementor supports by default `section` element and `column` element.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @access private
|
||||
*/
|
||||
private function init_elements() {
|
||||
$this->_element_types = [];
|
||||
|
||||
foreach ( [ 'section', 'column' ] as $element_name ) {
|
||||
$class_name = __NAMESPACE__ . '\Element_' . $element_name;
|
||||
|
||||
$this->register_element_type( new $class_name() );
|
||||
}
|
||||
|
||||
$experiments_manager = Plugin::$instance->experiments;
|
||||
|
||||
if ( $experiments_manager->is_feature_active( 'container' ) ) {
|
||||
$this->register_element_type( new Container() );
|
||||
}
|
||||
|
||||
/**
|
||||
* After elements registered.
|
||||
*
|
||||
* Fires after Elementor elements are registered.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
do_action( 'elementor/elements/elements_registered', $this );
|
||||
}
|
||||
|
||||
/**
|
||||
* Init categories.
|
||||
*
|
||||
* Initialize the element categories.
|
||||
*
|
||||
* @since 1.7.12
|
||||
* @access private
|
||||
*/
|
||||
private function init_categories() {
|
||||
$this->categories = [
|
||||
self::CATEGORY_ATOMIC_ELEMENTS => [
|
||||
'title' => esc_html__( 'Atomic Elements', 'elementor' ),
|
||||
'hideIfEmpty' => true,
|
||||
],
|
||||
'layout' => [
|
||||
'title' => esc_html__( 'Layout', 'elementor' ),
|
||||
'hideIfEmpty' => true,
|
||||
],
|
||||
'basic' => [
|
||||
'title' => esc_html__( 'Basic', 'elementor' ),
|
||||
'icon' => 'eicon-font',
|
||||
],
|
||||
'pro-elements' => [
|
||||
'title' => esc_html__( 'Pro', 'elementor' ),
|
||||
'promotion' => [
|
||||
'url' => esc_url( 'https://go.elementor.com/go-pro-section-pro-widget-panel/' ),
|
||||
],
|
||||
],
|
||||
'helloplus' => [
|
||||
'title' => esc_html__( 'Hello+', 'elementor' ),
|
||||
'hideIfEmpty' => true,
|
||||
],
|
||||
'general' => [
|
||||
'title' => esc_html__( 'General', 'elementor' ),
|
||||
'icon' => 'eicon-font',
|
||||
],
|
||||
'link-in-bio' => [
|
||||
'title' => esc_html__( 'Link In Bio', 'elementor' ),
|
||||
'hideIfEmpty' => true,
|
||||
],
|
||||
'theme-elements' => [
|
||||
'title' => esc_html__( 'Site', 'elementor' ),
|
||||
'active' => false,
|
||||
'promotion' => [
|
||||
'url' => esc_url( 'https://go.elementor.com/go-pro-section-site-widget-panel/' ),
|
||||
],
|
||||
],
|
||||
'woocommerce-elements' => [
|
||||
'title' => esc_html__( 'WooCommerce', 'elementor' ),
|
||||
'active' => false,
|
||||
'promotion' => [
|
||||
'url' => esc_url( 'https://go.elementor.com/go-pro-section-woocommerce-widget-panel/' ),
|
||||
],
|
||||
],
|
||||
];
|
||||
|
||||
if ( Plugin::$instance->experiments->is_feature_active( 'e_atomic_elements' ) ) {
|
||||
$atomic_form_category = [
|
||||
'title' => esc_html__( 'Atomic Form', 'elementor' ),
|
||||
];
|
||||
|
||||
if ( Utils::has_pro() && Plugin::$instance->experiments->is_feature_active( 'e_pro_atomic_form' ) ) {
|
||||
$atomic_form_category['hideIfEmpty'] = true;
|
||||
} elseif ( ! Utils::has_pro() ) {
|
||||
$atomic_form_category['hideIfEmpty'] = false;
|
||||
$atomic_form_category['promotion'] = [
|
||||
'url' => esc_url( 'https://go.elementor.com/go-pro-atomic-form-section/' ),
|
||||
];
|
||||
} else {
|
||||
$atomic_form_category['hideIfEmpty'] = true;
|
||||
}
|
||||
|
||||
$this->categories = array_merge(
|
||||
[ self::CATEGORY_ATOMIC_ELEMENTS => $this->categories[ self::CATEGORY_ATOMIC_ELEMENTS ] ],
|
||||
[ self::CATEGORY_ATOMIC_FORM => $atomic_form_category ],
|
||||
array_diff_key( $this->categories, [ self::CATEGORY_ATOMIC_ELEMENTS => true ] )
|
||||
);
|
||||
}
|
||||
|
||||
// Not using the `add_category` because it doesn't allow 3rd party to inject a category on top the others.
|
||||
$this->categories = array_merge_recursive( [
|
||||
self::CATEGORY_FAVORITES => [
|
||||
'title' => esc_html__( 'Favorites', 'elementor' ),
|
||||
'icon' => 'eicon-heart',
|
||||
'sort' => 'a-z',
|
||||
'hideIfEmpty' => false,
|
||||
],
|
||||
], $this->categories );
|
||||
|
||||
/**
|
||||
* When categories are registered.
|
||||
*
|
||||
* Fires after basic categories are registered, before WordPress
|
||||
* category have been registered.
|
||||
*
|
||||
* This is where categories registered by external developers are
|
||||
* added.
|
||||
*
|
||||
* @since 2.0.0
|
||||
*
|
||||
* @param Elements_Manager $this Elements manager instance.
|
||||
*/
|
||||
do_action( 'elementor/elements/categories_registered', $this );
|
||||
|
||||
$after_candidates = Plugin::$instance->experiments->is_feature_active( 'e_atomic_elements' )
|
||||
? [ self::CATEGORY_ATOMIC_FORM, self::CATEGORY_ATOMIC_ELEMENTS ]
|
||||
: [ self::CATEGORY_BASIC ];
|
||||
|
||||
$this->promote_category_after( self::CATEGORY_ANGIE_WIDGETS, $after_candidates );
|
||||
$this->promote_category_after( self::CATEGORY_CUSTOM_WIDGETS, $after_candidates );
|
||||
|
||||
$this->categories['wordpress'] = [
|
||||
'title' => esc_html__( 'WordPress', 'elementor' ),
|
||||
'icon' => 'eicon-wordpress',
|
||||
'active' => false,
|
||||
];
|
||||
}
|
||||
|
||||
public function enqueue_elements_styles() {
|
||||
foreach ( $this->get_element_types() as $element ) {
|
||||
$element->enqueue_styles();
|
||||
}
|
||||
}
|
||||
|
||||
public function enqueue_elements_scripts() {
|
||||
foreach ( $this->get_element_types() as $element ) {
|
||||
$element->enqueue_scripts();
|
||||
}
|
||||
}
|
||||
|
||||
public function register_frontend_handlers() {
|
||||
foreach ( $this->get_element_types() as $element ) {
|
||||
$element->register_frontend_handlers();
|
||||
}
|
||||
}
|
||||
|
||||
private function promote_category_after( string $category_name, array $after_candidates ): void {
|
||||
if ( ! isset( $this->categories[ $category_name ] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$after = null;
|
||||
|
||||
foreach ( $after_candidates as $candidate ) {
|
||||
if ( isset( $this->categories[ $candidate ] ) ) {
|
||||
$after = $candidate;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! $after ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$category = $this->categories[ $category_name ];
|
||||
unset( $this->categories[ $category_name ] );
|
||||
|
||||
$position = array_search( $after, array_keys( $this->categories ), true ) + 1;
|
||||
$this->categories = array_merge(
|
||||
array_slice( $this->categories, 0, $position, true ),
|
||||
[ $category_name => $category ],
|
||||
array_slice( $this->categories, $position, null, true )
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Require files.
|
||||
*
|
||||
* Require Elementor element base class and column, section and repeater
|
||||
* elements.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access private
|
||||
*/
|
||||
private function require_files() {
|
||||
require_once ELEMENTOR_PATH . 'includes/base/element-base.php';
|
||||
|
||||
require ELEMENTOR_PATH . 'includes/elements/column.php';
|
||||
require ELEMENTOR_PATH . 'includes/elements/section.php';
|
||||
require ELEMENTOR_PATH . 'includes/elements/repeater.php';
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user