150 lines
3.2 KiB
PHP
150 lines
3.2 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
|
|
}
|
|
|
|
/**
|
|
* Base Object
|
|
*
|
|
* Base class that provides basic settings handling functionality.
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
class Base_Object {
|
|
|
|
/**
|
|
* Settings.
|
|
*
|
|
* Holds the object settings.
|
|
*
|
|
* @access private
|
|
*
|
|
* @var array
|
|
*/
|
|
private $settings;
|
|
|
|
/**
|
|
* Get Settings.
|
|
*
|
|
* @since 1.0.0
|
|
* @access public
|
|
*
|
|
* @param string $setting Optional. The key of the requested setting. Default is null.
|
|
*
|
|
* @return mixed An array of all settings, or a single value if `$setting` was specified.
|
|
*/
|
|
final public function get_settings( $setting = null ) {
|
|
$this->ensure_settings();
|
|
|
|
return self::get_items( $this->settings, $setting );
|
|
}
|
|
|
|
/**
|
|
* Set settings.
|
|
*
|
|
* @since 1.0.0
|
|
* @access public
|
|
*
|
|
* @param array|string $key If key is an array, the settings are overwritten by that array. Otherwise, the
|
|
* settings of the key will be set to the given `$value` param.
|
|
*
|
|
* @param mixed $value Optional. Default is null.
|
|
*/
|
|
final public function set_settings( $key, $value = null ) {
|
|
$this->ensure_settings();
|
|
|
|
if ( is_array( $key ) ) {
|
|
$this->settings = $key;
|
|
} else {
|
|
$this->settings[ $key ] = $value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Delete setting.
|
|
*
|
|
* Deletes the settings array or a specific key of the settings array if `$key` is specified.
|
|
* @since 1.0.0
|
|
* @access public
|
|
*
|
|
* @param string $key Optional. Default is null.
|
|
*/
|
|
public function delete_setting( $key = null ) {
|
|
if ( $key ) {
|
|
unset( $this->settings[ $key ] );
|
|
} else {
|
|
$this->settings = [];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get items.
|
|
*
|
|
* Utility method that receives an array with a needle and returns all the
|
|
* items that match the needle. If needle is not defined the entire haystack
|
|
* will be returned.
|
|
*
|
|
* @since 1.0.0
|
|
* @access protected
|
|
* @static
|
|
*
|
|
* @param array $haystack An array of items.
|
|
* @param string $needle Optional. Needle. Default is null.
|
|
*
|
|
* @return mixed The whole haystack or the needle from the haystack when requested.
|
|
*/
|
|
final protected static function get_items( array $haystack, $needle = null ) {
|
|
if ( $needle ) {
|
|
return isset( $haystack[ $needle ] ) ? $haystack[ $needle ] : null;
|
|
}
|
|
|
|
return $haystack;
|
|
}
|
|
|
|
/**
|
|
* Get init settings.
|
|
*
|
|
* Used to define the default/initial settings of the object. Inheriting classes may implement this method to define
|
|
* their own default/initial settings.
|
|
*
|
|
* @since 1.0.0
|
|
* @access protected
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function get_init_settings() {
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Ensure settings.
|
|
*
|
|
* Ensures that the `$settings` member is initialized
|
|
*
|
|
* @since 1.0.0
|
|
* @access private
|
|
*/
|
|
private function ensure_settings() {
|
|
if ( null === $this->settings ) {
|
|
$this->settings = $this->get_init_settings();
|
|
}
|
|
}
|
|
} |