Your IP : 3.145.0.146
<?php
if ( ! defined( 'ABSPATH' ) ) {
die();
}
/** @noinspection PhpIncludeInspection */
require_once forminator_plugin_dir() . 'library/addon/class-addon-exception.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-container.php';
require_once forminator_plugin_dir() . 'library/addon/contracts/interface-addon.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-abstract.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-form-settings-abstract.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-form-hooks-abstract.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-poll-settings-abstract.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-poll-hooks-abstract.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-quiz-settings-abstract.php';
require_once forminator_plugin_dir() . 'library/addon/class-addon-quiz-hooks-abstract.php';
require_once forminator_plugin_dir() . 'library/addon/admin/class-ajax.php';
/**
* Class Forminator_Addon_Loader
* Responsible for registering addon and hold its information throughout application
*
* @since 1.1
*/
class Forminator_Addon_Loader {
/**
* wp option name of activated addons
*
* @since 1.1
* @var string
*/
private static $_active_addons_option = 'forminator_activated_addons';
/**
* @since 1.1
* @var self
*/
private static $instance = null;
/**
* Get instance of loader
*
* @since 1.1
* @return Forminator_Addon_Loader
*/
public static function get_instance() {
if ( is_null( self::$instance ) ) {
self::$instance = new self();
}
return self::$instance;
}
/**
* Define pre_activated addons here
*
* @since 1.1
* @var array
*/
private static $pre_activated_addons = array();
/**
* Array Access-able of Registered Addons
*
* @since 1.1
* @var Forminator_Addon_Container
*/
private $addons;
/**
* Array of slug activated addons
*
* @since 1.1
* @var array
*/
private $activated_addons = array();
/**
* Default addon error messages
* will be used when error happened and loader cant get addon error messages
*
* @since 1.1
* @var array
*/
private $default_addon_error_messages = array();
/**
* Last Error Message on loader
*
* @since 1.1
* @var string
*/
private $last_error_message = '';
/**
* Flag when options of `forminator_activated_addons` not exist on database
* When its true, Loader will assume, user is first time updated to 1.1
* And will try to activate @see Forminator_Addon_Loader::$pre_activated_addons
*
* @since 1.1
* @var bool
*/
private $is_non_exist_activated_option = false;
/**
* Flag when options of `forminator_activated_addons` exist but empty on database
* When its true, Loader will assume, user is already have 1.1,
* but no addons are currently activated
*
* @since 1.1
* @var bool
*/
private $is_empty_activated_option = false;
/**
* Forminator_Addon_Loader constructor.
*
* @since 1.1
*/
public function __construct() {
$this->addons = new Forminator_Addon_Container();
/**
* Initiate activated addons
*/
$active_addons = get_option( self::$_active_addons_option, false );
if ( false === $active_addons ) {
$this->is_non_exist_activated_option = true;
$active_addons = array();
} elseif ( empty( $active_addons ) ) {
$active_addons = array();
$this->is_empty_activated_option = true;
}
$active_addons = array_unique( $active_addons );
$this->activated_addons = $active_addons;
/**
* Initiate standard default error messages
*/
$this->default_addon_error_messages = array(
'activate' => __( 'Failed to activate addon', Forminator::DOMAIN ),
'deactivate' => __( 'Failed to deactivate addon', Forminator::DOMAIN ),
'update_settings' => __( 'Failed to update settings', Forminator::DOMAIN ),
'update_form_settings' => __( 'Failed to update form settings', Forminator::DOMAIN ),
);
// Only enable wp_ajax hooks
Forminator_Addon_Admin_Ajax::get_instance();
}
/**
* Register new Addon
*
* @since 1.1
*
* @param Forminator_Addon_Abstract|string $class_name instance of Addon or its classname
*
* @return bool
*/
public function register( $class_name ) {
try {
/**
* Fires immediately after an addon registering.
*
* This action executed before whole process of registering addon.
* Validation and requirement check has not been done,
* so its possible the addon will not registered in the end,
* when validation fail or requirement not set @see Forminator_Addon_Loader::register()
*
* @since 1.1
*
* @param Forminator_Addon_Abstract|string $class_name instance of Addon or its class name
*/
do_action( 'forminator_before_addon_registered', $class_name );
if ( $class_name instanceof Forminator_Addon_Abstract ) {
$addon_class = $class_name;
} else {
$addon_class = $this->validate_addon_class( $class_name );
}
$registered_addons = $this->addons;
/**
* Filter addon instance.
*
* Its possible to replace / modify addon instance when its registered
* Keep in mind instance that returned by this filter will be used throughout app
* Return must be instance of @see Forminator_Addon_Abstract.
* It will be then validated by @see Forminator_Addon_Loader::validate_addon_instance()
*
* @since 1.1
*
* @param Forminator_Addon_Abstract $addon_class Current Addon class instance
* @param array $registered_addons Current registered addons
*/
$addon_class = apply_filters( 'forminator_addon_instance', $addon_class, $registered_addons );
$addon_class = $this->validate_addon_instance( $addon_class );
$this->addons[ $addon_class->get_slug() ] = $addon_class;
if ( $this->is_non_exist_activated_option && self::$pre_activated_addons ) {
if ( in_array( $addon_class->get_slug(), self::$pre_activated_addons, true ) ) {
$this->activate_addon( $addon_class->get_slug() );
}
}
/**
* Fires after addon successfully registered
*
* When addon registered, this action will be fire
* If addon not registered because one or other things,
* this action will not executed
*
* @since 1.1
*
* @param Forminator_Addon_Abstract $addon_class Current addon that successfully registered
*/
do_action( 'forminator_after_addon_registered', $addon_class );
return true;
} catch ( Forminator_Addon_Exception $e ) {
forminator_addon_maybe_log( __METHOD__, $class_name, $e->getMessage() );
return false;
}
}
/**
* Validate Addon by its class name
*
* @since 1.1
*
* @param string $class_name
*
* @return Forminator_Addon_Abstract
* @throws Forminator_Addon_Exception
*/
private function validate_addon_class( $class_name ) {
if ( ! class_exists( $class_name ) ) {
throw new Forminator_Addon_Exception( 'Addon with ' . $class_name . ' does not exist' );
}
if ( ! is_callable( array( $class_name, 'get_instance' ) ) ) {
throw new Forminator_Addon_Exception( 'Addon with ' . $class_name . ' does not have get_instance method' );
}
$addon_class = call_user_func( array( $class_name, 'get_instance' ) );
return $addon_class;
}
/**
* Valdate addon instance
*
* @since 1.1
*
* @param Forminator_Addon_Abstract $instance
*
* @return Forminator_Addon_Abstract
* @throws Forminator_Addon_Exception
*/
private function validate_addon_instance( Forminator_Addon_Abstract $instance ) {
/** @var Forminator_Addon_Abstract $addon_class */
$addon_class = $instance;
$class_name = get_class( $instance );
if ( ! $addon_class instanceof Forminator_Addon_Abstract ) {
throw new Forminator_Addon_Exception( 'Addon with ' . $class_name . ' is not instanceof Forminator_Addon_Abstract' );
}
$slug = $addon_class->get_slug();
$version = $addon_class->get_version();
if ( empty( $slug ) ) {
throw new Forminator_Addon_Exception( 'Addon with ' . $class_name . ' does not have slug' );
}
// FIFO
if ( isset( $this->addons[ $slug ] ) ) {
throw new Forminator_Addon_Exception( 'Addon with slug ' . $slug . ' already exist' );
}
if ( empty( $version ) ) {
throw new Forminator_Addon_Exception( 'Addon with slug ' . $slug . ' does not have valid version' );
}
// check version changed if active
if ( $this->addon_is_active( $slug ) ) {
try {
// silent
if ( $addon_class->is_version_changed() ) {
$addon_class->version_changed( $addon_class->get_installed_version(), $addon_class->get_installed_version() );
}
} catch ( Exception $e ) {
forminator_addon_maybe_log( $addon_class->get_slug(), 'failed to trigger version_changed', $e->getMessage() );
}
}
return $addon_class;
}
/**
* Get Addon Instance
*
* @since 1.1
*
* @param string $slug
*
* @return Forminator_Addon_Abstract|null
*/
public function get_addon( $slug ) {
return $this->addons[ $slug ];
}
/**
* Get All registered Addons
*
* @since 1.1
* @return Forminator_Addon_Container
*/
public function get_addons() {
return $this->addons;
}
/**
* Check if addon is active
*
* @since 1.1
*
* @param string $slug
*
* @return bool
*/
public function addon_is_active( $slug ) {
if ( in_array( $slug, $this->activated_addons, true ) ) {
return true;
}
return false;
}
/**
* Deactivate Addon
* This function will call `deactivate` function of addon class if available
*
* @since 1.1
*
* @param $slug
*
* @return bool
*/
public function deactivate_addon( $slug ) {
$addon = $this->get_addon( $slug );
if ( is_null( $addon ) ) {
$this->last_error_message = __( 'Addon not found', Forminator::DOMAIN );
return false;
}
if ( ! $this->addon_is_active( $slug ) ) {
$this->last_error_message = __( 'Addon is not activated before', Forminator::DOMAIN );
return false;
}
$deactivated = $addon->deactivate();
if ( ! $deactivated ) {
$error_message = $addon->get_deactivation_error_message();
if ( empty( $error_message ) ) {
$error_message = $this->default_addon_error_messages['deactivate'];
}
$this->last_error_message = $error_message;
return false;
}
$this->force_remove_activated_addons( $slug );
/**
* Fires after addon successfully deactivated
*
* Keep in mind that addon is already deactivated here,
* So mostly `$addon` method will fail if it requires `$addon` to be **active**
*
* @since 1.1
*
* @param Forminator_Addon_Abstract $addon Current deactivated addon
*/
do_action( 'forminator_after_addon_deactivated', $addon );
return true;
}
/**
* Add activated addons to wp options
*
* @since 1.1
*
* @param $slug
*/
private function add_activated_addons( $slug ) {
$addon = $this->get_addon( $slug );
$this->activated_addons[] = $slug;
update_option( self::$_active_addons_option, $this->activated_addons );
// take from __get version since its new addon
update_option( $addon->get_version_options_name(), $addon->get_version() );
}
/**
* Force Remove activated addons
* remove activated addons from wp options, without calling deactivate on addon function
*
* @since 1.1
*
* @param $slug
*/
public function force_remove_activated_addons( $slug ) {
$addon = $this->get_addon( $slug );
$index = array_search( $slug, $this->activated_addons, true );
if ( false !== $index ) {
unset( $this->activated_addons[ $index ] );
// reset keys
$this->activated_addons = array_values( $this->activated_addons );
update_option( self::$_active_addons_option, $this->activated_addons );
}
if ( $addon ) {
$version_options_name = $addon->get_version_options_name();
$settions_options_name = $addon->get_settings_options_name();
} else {
// probably just want to remove the options
$version_options_name = 'forminator_addon_' . $slug . '_version';
$settions_options_name = 'forminator_addon_' . $slug . '_settings';
}
$setting_form_meta_name = 'forminator_addon_' . $slug . '_form_settings';
//delete version
delete_option( $version_options_name );
//delete general settings
delete_option( $settions_options_name );
//delete post meta
delete_post_meta_by_key( $setting_form_meta_name );
/**
* Fires when activated addons removed from wp options
*
* @since 1.1
*
* @param string $slug addon `slug` removed
* @param Forminator_Addon_Abstract|null Addon instance or null when addon instance unavailable
*/
do_action( 'forminator_after_activated_addons_removed', $slug, $addon );
}
/**
* Activate Addon
* This function will call `activate` function on addon if available
*
* @since 1.1
*
* @param string $slug
*
* @return bool
*/
public function activate_addon( $slug ) {
$addon = $this->get_addon( $slug );
/**
* Fires before Addon activated
*
* @since 1.1
*
* @param string $slug Slug of addon that will be activated
* @param Forminator_Addon_Abstract|null $addon addon instance or null, when its not unavailable
*/
do_action( 'forminator_before_addon_activated', $slug, $addon );
if ( is_null( $addon ) ) {
$this->last_error_message = __( 'Addon not found', Forminator::DOMAIN );
return false;
}
if ( $this->addon_is_active( $slug ) ) {
$this->last_error_message = __( 'Addon already activated before', Forminator::DOMAIN );
return false;
}
if ( ! $addon->is_activable() ) {
$this->last_error_message = __( 'Addon is not activable', Forminator::DOMAIN );
return false;
}
$activated = $addon->activate();
if ( ! $activated ) {
$error_message = $addon->get_activation_error_message();
if ( empty( $error_message ) ) {
$error_message = $this->default_addon_error_messages['activate'];
}
$this->last_error_message = $error_message;
return false;
}
$this->add_activated_addons( $slug );
/**
* Fires when an Addon activated
*
* @since 1.1
*
* @param Forminator_Addon_Abstract $addon Current activated addon
*/
do_action( 'forminator_after_addon_activated', $addon );
return true;
}
/**
* Get Last error message
*
* @since 1.1
* @return string
*/
public function get_last_error_message() {
$last_error_message = $this->last_error_message;
/**
* Filter Last error message of the addon loader
*
* @since 1.1
*
* @param string $last_error_message Current last error message
*/
$last_error_message = apply_filters( 'forminator_addon_loader_last_error_message', $last_error_message );
return $last_error_message;
}
/**
* Get default messages provided by loader
*
* @since 1.1
* @return array
*/
public function get_default_messages() {
$default_addon_error_messages = $this->default_addon_error_messages;
/**
* Filter default addon error messages.
*
* @since 1.1
*
* @param array $default_addon_error_messages Default addon error messages that created by loader and used if Addon not specify any.
*/
$default_addon_error_messages = apply_filters( 'forminator_addon_loader_default_messages', $default_addon_error_messages );
return $default_addon_error_messages;
}
/**
* Cleanup probably addons that activated before but not it doesnt exist or become invalid
*
* CAUTION : only call this when all addons already registered
*
* @since 1.1
*/
public function cleanup_activated_addons() {
$this->activated_addons = array_unique( $this->activated_addons );
$unavailable_addons = array_diff( $this->activated_addons, $this->addons->get_slugs() );
foreach ( $unavailable_addons as $unavailable_addon ) {
$this->force_remove_activated_addons( $unavailable_addon );
}
}
/**
* No activated addons = true, otherwise is false
*
* @since 1.1
*
* @return bool
*/
public function is_empty_activated_option() {
return $this->is_empty_activated_option;
}
/**
* First install = true, otherwise false
*
* @since 1.1
* @return bool
*/
public function is_non_exist_activated_option() {
return $this->is_non_exist_activated_option;
}
/**
* Get Activated addons slug
*
* @since 1.1
* @return array
*/
public function get_activated_addons() {
return $this->activated_addons;
}
}