balmet.com

manager.php (7787B)

---

 <?php
 namespace Elementor\Core\Settings\Base;
 
 use Elementor\Core\Common\Modules\Ajax\Module as Ajax;
 use Elementor\Plugin;
 
 if ( ! defined( 'ABSPATH' ) ) {
 	exit; // Exit if accessed directly.
 }
 
 /**
  * Elementor settings base manager.
  *
  * Elementor settings base manager handler class is responsible for registering
  * and managing Elementor settings base managers.
  *
  * @since 1.6.0
  * @abstract
  */
 abstract class Manager {
 
 	/**
 	 * Models cache.
 	 *
 	 * Holds all the models.
 	 *
 	 * @since 1.6.0
 	 * @access private
 	 *
 	 * @var Model[]
 	 */
 	private $models_cache = [];
 
 	/**
 	 * Settings base manager constructor.
 	 *
 	 * Initializing Elementor settings base manager.
 	 *
 	 * @since 1.6.0
 	 * @access public
 	 */
 	public function __construct() {
 		add_action( 'elementor/editor/init', [ $this, 'on_elementor_editor_init' ] );
 
 		add_action( 'elementor/ajax/register_actions', [ $this, 'register_ajax_actions' ] );
 	}
 
 	/**
 	 * Register ajax actions.
 	 *
 	 * Add new actions to handle data after an ajax requests returned.
 	 *
 	 * Fired by `elementor/ajax/register_actions` action.
 	 *
 	 * @since 2.0.0
 	 * @access public
 	 *
 	 * @param Ajax $ajax_manager
 	 */
 	public function register_ajax_actions( $ajax_manager ) {
 		$name = $this->get_name();
 
 		$ajax_manager->register_ajax_action( "save_{$name}_settings", [ $this, 'ajax_save_settings' ] );
 	}
 
 	/**
 	 * Get model for config.
 	 *
 	 * Retrieve the model for settings configuration.
 	 *
 	 * @since 1.6.0
 	 * @access public
 	 * @abstract
 	 *
 	 * @return Model The model object.
 	 */
 	abstract public function get_model_for_config();
 
 	/**
 	 * Get manager name.
 	 *
 	 * Retrieve settings manager name.
 	 *
 	 * @since 1.6.0
 	 * @access public
 	 * @abstract
 	 */
 	abstract public function get_name();
 
 	/**
 	 * Get model.
 	 *
 	 * Retrieve the model for any given model ID.
 	 *
 	 * @since 1.6.0
 	 * @access public
 	 *
 	 * @param int $id Optional. Model ID. Default is `0`.
 	 *
 	 * @return Model The model.
 	 */
 	final public function get_model( $id = 0 ) {
 		if ( ! isset( $this->models_cache[ $id ] ) ) {
 			$this->create_model( $id );
 		}
 
 		return $this->models_cache[ $id ];
 	}
 
 	/**
 	 * Ajax request to save settings.
 	 *
 	 * Save settings using an ajax request.
 	 *
 	 * @since 1.6.0
 	 * @access public
 	 *
 	 * @param array $request Ajax request.
 	 *
 	 * @return array Ajax response data.
 	 */
 	final public function ajax_save_settings( $request ) {
 		$data = $request['data'];
 
 		$id = 0;
 
 		if ( ! empty( $request['id'] ) ) {
 			$id = $request['id'];
 		}
 
 		$this->ajax_before_save_settings( $data, $id );
 
 		$this->save_settings( $data, $id );
 
 		$settings_name = $this->get_name();
 
 		$success_response_data = [];
 
 		/**
 		 * Settings success response data.
 		 *
 		 * Filters the success response data when saving settings using ajax.
 		 *
 		 * The dynamic portion of the hook name, `$settings_name`, refers to the settings name.
 		 *
 		 * @since 2.0.0
 		 *
 		 * @param array $success_response_data Success response data.
 		 * @param int   $id                    Settings ID.
 		 * @param array $data                  Settings data.
 		 */
 		$success_response_data = apply_filters( "elementor/settings/{$settings_name}/success_response_data", $success_response_data, $id, $data );
 
 		return $success_response_data;
 	}
 
 	/**
 	 * Save settings.
 	 *
 	 * Save settings to the database.
 	 *
 	 * @since 1.6.0
 	 * @access public
 	 *
 	 * @param array $settings Settings.
 	 * @param int   $id       Optional. Post ID. Default is `0`.
 	 */
 	public function save_settings( array $settings, $id = 0 ) {
 		$special_settings = $this->get_special_settings_names();
 
 		$settings_to_save = $settings;
 
 		foreach ( $special_settings as $special_setting ) {
 			if ( isset( $settings_to_save[ $special_setting ] ) ) {
 				unset( $settings_to_save[ $special_setting ] );
 			}
 		}
 
 		$this->save_settings_to_db( $settings_to_save, $id );
 
 		// Clear cache after save.
 		if ( isset( $this->models_cache[ $id ] ) ) {
 			unset( $this->models_cache[ $id ] );
 		}
 	}
 
 	/**
 	 * On Elementor init.
 	 *
 	 * Add editor template for the settings
 	 *
 	 * Fired by `elementor/init` action.
 	 *
 	 * @since 2.3.0
 	 * @access public
 	 */
 	public function on_elementor_editor_init() {
 		Plugin::$instance->common->add_template( $this->get_editor_template(), 'text' );
 	}
 
 	/**
 	 * Get saved settings.
 	 *
 	 * Retrieve the saved settings from the database.
 	 *
 	 * @since 1.6.0
 	 * @access protected
 	 * @abstract
 	 *
 	 * @param int $id Post ID.
 	 */
 	abstract protected function get_saved_settings( $id );
 
 	/**
 	 * Save settings to DB.
 	 *
 	 * Save settings to the database.
 	 *
 	 * @since 1.6.0
 	 * @access protected
 	 * @abstract
 	 *
 	 * @param array $settings Settings.
 	 * @param int   $id       Post ID.
 	 */
 	abstract protected function save_settings_to_db( array $settings, $id );
 
 	/**
 	 * Get special settings names.
 	 *
 	 * Retrieve the names of the special settings that are not saved as regular
 	 * settings. Those settings have a separate saving process.
 	 *
 	 * @since 1.6.0
 	 * @access protected
 	 *
 	 * @return array Special settings names.
 	 */
 	protected function get_special_settings_names() {
 		return [];
 	}
 
 	/**
 	 * Ajax before saving settings.
 	 *
 	 * Validate the data before saving it and updating the data in the database.
 	 *
 	 * @since 1.6.0
 	 * @access public
 	 *
 	 * @param array $data Post data.
 	 * @param int   $id   Post ID.
 	 */
 	public function ajax_before_save_settings( array $data, $id ) {}
 
 	/**
 	 * Print the setting template content in the editor.
 	 *
 	 * Used to generate the control HTML in the editor using Underscore JS
 	 * template. The variables for the class are available using `data` JS
 	 * object.
 	 *
 	 * @since 1.6.0
 	 * @access protected
 	 *
 	 * @param string $name Settings panel name.
 	 */
 	protected function print_editor_template_content( $name ) {
 		?>
 		<#
 		const tabs = elementor.config.settings.<?php
 			// PHPCS - the variable $name does not contain a user input value.
 			echo $name; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 		?>.tabs;
 
 		if ( Object.values( tabs ).length > 1 ) { #>
 			<div class="elementor-panel-navigation">
 				<# _.each( tabs, function( tabTitle, tabSlug ) {
 					$e.bc.ensureTab( 'panel/<?php
 						// PHPCS - the variable $name does not contain a user input value.
 						echo $name; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
 					?>-settings', tabSlug ); #>
 					<div class="elementor-component-tab elementor-panel-navigation-tab elementor-tab-control-{{ tabSlug }}" data-tab="{{ tabSlug }}">
 						<a href="#">{{{ tabTitle }}}</a>
 					</div>
 				<# } ); #>
 			</div>
 		<# } #>
 		<div id="elementor-panel-<?php echo esc_attr( $name ); ?>-settings-controls"></div>
 		<?php
 	}
 
 	/**
 	 * Create model.
 	 *
 	 * Create a new model object for any given model ID and store the object in
 	 * models cache property for later use.
 	 *
 	 * @since 1.6.0
 	 * @access private
 	 *
 	 * @param int $id Model ID.
 	 */
 	private function create_model( $id ) {
 		$class_parts = explode( '\\', get_called_class() );
 
 		array_splice( $class_parts, count( $class_parts ) - 1, 1, 'Model' );
 
 		$class_name = implode( '\\', $class_parts );
 
 		$this->models_cache[ $id ] = new $class_name( [
 			'id' => $id,
 			'settings' => $this->get_saved_settings( $id ),
 		] );
 	}
 
 	/**
 	 * Get editor template.
 	 *
 	 * Retrieve the final HTML for the editor.
 	 *
 	 * @since 1.6.0
 	 * @access private
 	 *
 	 * @return string Settings editor template.
 	 */
 	private function get_editor_template() {
 		$name = $this->get_name();
 
 		ob_start();
 		?>
 		<script type="text/template" id="tmpl-elementor-panel-<?php echo esc_attr( $name ); ?>-settings">
 			<?php $this->print_editor_template_content( $name ); ?>
 		</script>
 		<?php
 
 		return ob_get_clean();
 	}
 }