lubuntu.me/plugins/elementor/includes/template-library/sources/base.php

<?php
namespace Elementor\TemplateLibrary;

use Elementor\Plugin;
use Elementor\Utils;

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly.
}

abstract class Source_Base {

	private $user_meta;

	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function get_id();
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function get_title();
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function register_data();
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function get_items( $args = [] );
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function get_item( $template_id );
	/**
	 * @abstract
	 * @since 1.5.0
	 * @access public
	*/
	abstract public function get_data( array $args );
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function delete_template( $template_id );
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function save_item( $template_data );
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function update_item( $new_data );
	/**
	 * @abstract
	 * @since 1.0.0
	 * @access public
	*/
	abstract public function export_template( $template_id );

	/**
	 * @since 1.0.0
	 * @access public
	*/
	public function __construct() {
		$this->register_data();
	}

	/**
	 * @since 1.9.0
	 * @access public
	 */
	public function mark_as_favorite( $template_id, $favorite = true ) {
		$favorites_templates = $this->get_user_meta( 'favorites' );

		if ( ! $favorites_templates ) {
			$favorites_templates = [];
		}

		if ( $favorite ) {
			$favorites_templates[ $template_id ] = $favorite;
		} elseif ( isset( $favorites_templates[ $template_id ] ) ) {
			unset( $favorites_templates[ $template_id ] );
		}

		return $this->update_user_meta( 'favorites', $favorites_templates );
	}

	/**
	 * @since 1.9.0
	 * @access public
	 */
	public function get_user_meta( $item = null ) {
		if ( null === $this->user_meta ) {
			$this->user_meta = get_user_meta( get_current_user_id(), $this->get_user_meta_prefix(), true );
		}

		if ( ! $this->user_meta ) {
			$this->user_meta = [];
		}

		if ( $item ) {
			if ( isset( $this->user_meta[ $item ] ) ) {
				return $this->user_meta[ $item ];
			}

			return null;
		}

		return $this->user_meta;
	}

	/**
	 * @since 1.9.0
	 * @access public
	 */
	public function update_user_meta( $key, $value ) {
		$meta = $this->get_user_meta();

		$meta[ $key ] = $value;

		$this->user_meta = $meta;

		return update_user_meta( get_current_user_id(), $this->get_user_meta_prefix(), $meta );
	}

	/**
	 * @since 1.0.0
	 * @access protected
	*/
	protected function replace_elements_ids( $content ) {
		return Plugin::$instance->db->iterate_data( $content, function( $element ) {
			$element['id'] = Utils::generate_random_string();

			return $element;
		} );
	}

	/**
	 * @since 1.9.0
	 * @access protected
	 */
	protected function get_user_meta_prefix() {
		return 'elementor_library_' . $this->get_id();
	}

	/**
	 * @since 1.5.0
	 * @access protected
	 * @param array  $content a set of elements.
	 * @param string $method  (on_export|on_import).
	 *
	 * @return mixed
	 */
	protected function process_export_import_content( $content, $method ) {
		return Plugin::$instance->db->iterate_data(
			$content, function( $element_data ) use ( $method ) {
				$element = Plugin::$instance->elements_manager->create_element_instance( $element_data );

				// If the widget/element isn't exist, like a plugin that creates a widget but deactivated
				if ( ! $element ) {
					return null;
				}

				return $this->process_element_export_import_content( $element, $method );
			}
		);
	}

	/**
	 * @since 1.5.0
	 * @access protected
	 * @param \Elementor\Controls_Stack $element
	 * @param string                    $method
	 *
	 * @return array
	 */
	protected function process_element_export_import_content( $element, $method ) {
		$element_data = $element->get_data();

		if ( method_exists( $element, $method ) ) {
			// TODO: Use the internal element data without parameters.
			$element_data = $element->{$method}( $element_data );
		}

		foreach ( $element->get_controls() as $control ) {
			$control_class = Plugin::$instance->controls_manager->get_control( $control['type'] );

			// If the control isn't exist, like a plugin that creates the control but deactivated.
			if ( ! $control_class ) {
				return $element_data;
			}

			if ( method_exists( $control_class, $method ) ) {
				$element_data['settings'][ $control['name'] ] = $control_class->{$method}( $element->get_settings( $control['name'] ), $control );
			}
		}

		return $element_data;
	}
}