316 lines
6.4 KiB
PHP
316 lines
6.4 KiB
PHP
<?php
|
|
/**
|
|
* 2007-2022 Apollotheme
|
|
*
|
|
* NOTICE OF LICENSE
|
|
*
|
|
* LeoElements is module help you can build content for your shop
|
|
*
|
|
* DISCLAIMER
|
|
*
|
|
* @author Apollotheme <apollotheme@gmail.com>
|
|
* @copyright 2007-2022 Apollotheme
|
|
* @license http://apollotheme.com - prestashop template provider
|
|
*/
|
|
|
|
namespace LeoElements\Core\Base;
|
|
|
|
use LeoElements\Leo_Helper;
|
|
|
|
if ( ! defined( '_PS_VERSION_' ) ) {
|
|
exit; // Exit if accessed directly.
|
|
}
|
|
|
|
/**
|
|
* Elementor module.
|
|
*
|
|
* An abstract class that provides the needed properties and methods to
|
|
* manage and handle modules in inheriting classes.
|
|
*
|
|
* @since 1.7.0
|
|
* @abstract
|
|
*/
|
|
abstract class Module extends Base_Object {
|
|
|
|
/**
|
|
* Module class reflection.
|
|
*
|
|
* Holds the information about a class.
|
|
*
|
|
* @since 1.7.0
|
|
* @access private
|
|
*
|
|
* @var \ReflectionClass
|
|
*/
|
|
private $reflection;
|
|
|
|
/**
|
|
* Module components.
|
|
*
|
|
* Holds the module components.
|
|
*
|
|
* @since 1.7.0
|
|
* @access private
|
|
*
|
|
* @var array
|
|
*/
|
|
private $components = [];
|
|
|
|
/**
|
|
* Module instance.
|
|
*
|
|
* Holds the module instance.
|
|
*
|
|
* @since 1.7.0
|
|
* @access protected
|
|
*
|
|
* @var Module
|
|
*/
|
|
protected static $_instances = [];
|
|
|
|
/**
|
|
* Get module name.
|
|
*
|
|
* Retrieve the module name.
|
|
*
|
|
* @since 1.7.0
|
|
* @access public
|
|
* @abstract
|
|
*
|
|
* @return string Module name.
|
|
*/
|
|
abstract public function get_name();
|
|
|
|
/**
|
|
* Instance.
|
|
*
|
|
* Ensures only one instance of the module class is loaded or can be loaded.
|
|
*
|
|
* @since 1.7.0
|
|
* @access public
|
|
* @static
|
|
*
|
|
* @return Module An instance of the class.
|
|
*/
|
|
public static function instance() {
|
|
$class_name = static::class_name();
|
|
|
|
if ( empty( static::$_instances[ $class_name ] ) ) {
|
|
static::$_instances[ $class_name ] = new static();
|
|
}
|
|
|
|
return static::$_instances[ $class_name ];
|
|
}
|
|
|
|
/**
|
|
* @since 2.0.0
|
|
* @access public
|
|
* @static
|
|
*/
|
|
public static function is_active() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Class name.
|
|
*
|
|
* Retrieve the name of the class.
|
|
*
|
|
* @since 1.7.0
|
|
* @access public
|
|
* @static
|
|
*/
|
|
public static function class_name() {
|
|
return get_called_class();
|
|
}
|
|
|
|
/**
|
|
* Clone.
|
|
*
|
|
* Disable class cloning and throw an error on object clone.
|
|
*
|
|
* The whole idea of the singleton design pattern is that there is a single
|
|
* object. Therefore, we don't want the object to be cloned.
|
|
*
|
|
* @since 1.7.0
|
|
* @access public
|
|
*/
|
|
public function __clone() {
|
|
// Cloning instances of the class is forbidden
|
|
_doing_it_wrong( __FUNCTION__, Leo_Helper::esc_html__( 'Something went wrong.', 'elementor' ), '1.0.0' );
|
|
}
|
|
|
|
/**
|
|
* Wakeup.
|
|
*
|
|
* Disable unserializing of the class.
|
|
*
|
|
* @since 1.7.0
|
|
* @access public
|
|
*/
|
|
public function __wakeup() {
|
|
// Unserializing instances of the class is forbidden
|
|
_doing_it_wrong( __FUNCTION__, Leo_Helper::esc_html__( 'Something went wrong.', 'elementor' ), '1.0.0' );
|
|
}
|
|
|
|
/**
|
|
* @since 2.0.0
|
|
* @access public
|
|
*/
|
|
public function get_reflection() {
|
|
if ( null === $this->reflection ) {
|
|
$this->reflection = new \ReflectionClass( $this );
|
|
}
|
|
|
|
return $this->reflection;
|
|
}
|
|
|
|
/**
|
|
* Add module component.
|
|
*
|
|
* Add new component to the current module.
|
|
*
|
|
* @since 1.7.0
|
|
* @access public
|
|
*
|
|
* @param string $id Component ID.
|
|
* @param mixed $instance An instance of the component.
|
|
*/
|
|
public function add_component( $id, $instance ) {
|
|
$this->components[ $id ] = $instance;
|
|
}
|
|
|
|
/**
|
|
* @since 1.0.0
|
|
* @access public
|
|
* @return Module[]
|
|
*/
|
|
public function get_components() {
|
|
return $this->components;
|
|
}
|
|
|
|
/**
|
|
* Get module component.
|
|
*
|
|
* Retrieve the module component.
|
|
*
|
|
* @since 1.7.0
|
|
* @access public
|
|
*
|
|
* @param string $id Component ID.
|
|
*
|
|
* @return mixed An instance of the component, or `false` if the component
|
|
* doesn't exist.
|
|
*/
|
|
public function get_component( $id ) {
|
|
if ( isset( $this->components[ $id ] ) ) {
|
|
return $this->components[ $id ];
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Get assets url.
|
|
*
|
|
* @since 1.0.0
|
|
* @access protected
|
|
*
|
|
* @param string $file_name
|
|
* @param string $file_extension
|
|
* @param string $relative_url Optional. Default is null.
|
|
* @param string $add_min_suffix Optional. Default is 'default'.
|
|
*
|
|
* @return string
|
|
*/
|
|
final protected function get_assets_url( $file_name, $file_extension, $relative_url = null, $add_min_suffix = 'default' ) {
|
|
static $is_test_mode = null;
|
|
|
|
if ( null === $is_test_mode ) {
|
|
$is_test_mode = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG || defined( 'LEOELEMENTS_TESTS' ) && LEOELEMENTS_TESTS;
|
|
}
|
|
|
|
if ( ! $relative_url ) {
|
|
$relative_url = $this->get_assets_relative_url() . $file_extension . '/';
|
|
}
|
|
|
|
$url = $this->get_assets_base_url() . $relative_url . $file_name;
|
|
|
|
if ( 'default' === $add_min_suffix ) {
|
|
$add_min_suffix = ! $is_test_mode;
|
|
}
|
|
|
|
if ( $add_min_suffix ) {
|
|
$url .= '.min';
|
|
}
|
|
|
|
return $url . '.' . $file_extension;
|
|
}
|
|
|
|
/**
|
|
* Get js assets url
|
|
*
|
|
* @since 1.0.0
|
|
* @access protected
|
|
*
|
|
* @param string $file_name
|
|
* @param string $relative_url Optional. Default is null.
|
|
* @param string $add_min_suffix Optional. Default is 'default'.
|
|
*
|
|
* @return string
|
|
*/
|
|
final protected function get_js_assets_url( $file_name, $relative_url = null, $add_min_suffix = 'default' ) {
|
|
return $this->get_assets_url( $file_name, 'js', $relative_url, $add_min_suffix );
|
|
}
|
|
|
|
/**
|
|
* Get css assets url
|
|
*
|
|
* @since 1.0.0
|
|
* @access protected
|
|
*
|
|
* @param string $file_name
|
|
* @param string $relative_url Optional. Default is null.
|
|
* @param string $add_min_suffix Optional. Default is 'default'.
|
|
* @param bool $add_direction_suffix Optional. Default is `false`
|
|
*
|
|
* @return string
|
|
*/
|
|
final protected function get_css_assets_url( $file_name, $relative_url = null, $add_min_suffix = 'default', $add_direction_suffix = false ) {
|
|
static $direction_suffix = null;
|
|
|
|
if ( ! $direction_suffix ) {
|
|
$direction_suffix = Leo_Helper::is_rtl() ? '-rtl' : '';
|
|
}
|
|
|
|
if ( $add_direction_suffix ) {
|
|
$file_name .= $direction_suffix;
|
|
}
|
|
|
|
return $this->get_assets_url( $file_name, 'css', $relative_url, $add_min_suffix );
|
|
}
|
|
|
|
/**
|
|
* Get assets base url
|
|
*
|
|
* @since 1.0.0
|
|
* @access protected
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function get_assets_base_url() {
|
|
return LEOELEMENTS_URL;
|
|
}
|
|
|
|
/**
|
|
* Get assets relative url
|
|
*
|
|
* @since 1.0.0
|
|
* @access protected
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function get_assets_relative_url() {
|
|
return 'assets/';
|
|
}
|
|
} |