* @copyright 2007-2022 Leotheme
* @license http://leotheme.com - prestashop template provider
*/
namespace LeoElements;
use LeoElements\Core\Responsive\Responsive;
use LeoElements\Core\Settings\General\Manager as General_Settings_Manager;
use LeoElements\Core\Settings\Manager;
use LeoElements\TemplateLibrary\Source_Local;
use LeoElements\Leo_Helper;
if ( ! defined( '_PS_VERSION_' ) ) {
exit; // Exit if accessed directly.
}
/**
* Elementor "Settings" page in WordPress Dashboard.
*
* Elementor settings page handler class responsible for creating and displaying
* Elementor "Settings" page in WordPress dashboard.
*
* @since 1.0.0
*/
class Settings extends Settings_Page {
/**
* Settings page ID for Elementor settings.
*/
const PAGE_ID = 'elementor';
/**
* Go Pro menu priority.
*/
const MENU_PRIORITY_GO_PRO = 502;
/**
* Settings page field for update time.
*/
const UPDATE_TIME_FIELD = '_elementor_settings_update_time';
/**
* Settings page general tab slug.
*/
const TAB_GENERAL = 'general';
/**
* Settings page style tab slug.
*/
const TAB_STYLE = 'style';
/**
* Settings page integrations tab slug.
*/
const TAB_INTEGRATIONS = 'integrations';
/**
* Settings page advanced tab slug.
*/
const TAB_ADVANCED = 'advanced';
/**
* Register admin menu.
*
* Add new Elementor Settings admin menu.
*
* Fired by `admin_menu` action.
*
* @since 1.0.0
* @access public
*/
public function register_admin_menu() {
$menu = &$GLOBALS['menu'];
$menu[] = [ '', 'read', 'separator-elementor', '', 'wp-menu-separator elementor' ]; // WPCS: override ok.
add_menu_page(
Leo_Helper::__( 'Elementor', 'elementor' ),
Leo_Helper::__( 'Elementor', 'elementor' ),
'manage_options',
self::PAGE_ID,
[ $this, 'display_settings_page' ],
'',
'58.5'
);
}
/**
* Reorder the Elementor menu items in admin.
* Based on WC.
*
* @since 1.0.0
*
* @param array $menu_order Menu order.
* @return array
*/
public function menu_order( $menu_order ) {
// Initialize our custom order array.
$elementor_menu_order = [];
// Get the index of our custom separator.
$elementor_separator = array_search( 'separator-elementor', $menu_order, true );
// Get index of library menu.
$elementor_library = array_search( Source_Local::ADMIN_MENU_SLUG, $menu_order, true );
// Loop through menu order and do some rearranging.
foreach ( $menu_order as $index => $item ) {
if ( 'elementor' === $item ) {
$elementor_menu_order[] = 'separator-elementor';
$elementor_menu_order[] = $item;
$elementor_menu_order[] = Source_Local::ADMIN_MENU_SLUG;
unset( $menu_order[ $elementor_separator ] );
unset( $menu_order[ $elementor_library ] );
} elseif ( ! in_array( $item, [ 'separator-elementor' ], true ) ) {
$elementor_menu_order[] = $item;
}
}
// Return order.
return $elementor_menu_order;
}
/**
* Register Elementor Pro sub-menu.
*
* Add new Elementor Pro sub-menu under the main Elementor menu.
*
* Fired by `admin_menu` action.
*
* @since 1.0.0
* @access public
*/
public function register_pro_menu() {
add_submenu_page(
self::PAGE_ID,
Leo_Helper::__( 'Custom Fonts', 'elementor' ),
Leo_Helper::__( 'Custom Fonts', 'elementor' ),
'manage_options',
'elementor_custom_fonts',
[ $this, 'elementor_custom_fonts' ]
);
add_submenu_page(
self::PAGE_ID,
'',
' ' . Leo_Helper::__( 'Go Pro', 'elementor' ),
'manage_options',
'go_elementor_pro',
[ $this, 'handle_external_redirects' ]
);
add_submenu_page( Source_Local::ADMIN_MENU_SLUG, Leo_Helper::__( 'Theme Templates', 'elementor' ), Leo_Helper::__( 'Theme Builder', 'elementor' ), 'manage_options', 'theme_templates', [ $this, 'elementor_theme_templates' ] );
add_submenu_page( Source_Local::ADMIN_MENU_SLUG, Leo_Helper::__( 'Popups', 'elementor' ), Leo_Helper::__( 'Popups', 'elementor' ), 'manage_options', 'popup_templates', [ $this, 'elementor_popups' ] );
}
/**
* Register Elementor knowledge base sub-menu.
*
* Add new Elementor knowledge base sub-menu under the main Elementor menu.
*
* Fired by `admin_menu` action.
*
* @since 2.0.3
* @access public
*/
public function register_knowledge_base_menu() {
add_submenu_page(
self::PAGE_ID,
'',
Leo_Helper::__( 'Getting Started', 'elementor' ),
'manage_options',
'elementor-getting-started',
[ $this, 'elementor_getting_started' ]
);
add_submenu_page(
self::PAGE_ID,
'',
Leo_Helper::__( 'Get Help', 'elementor' ),
'manage_options',
'go_knowledge_base_site',
[ $this, 'handle_external_redirects' ]
);
}
/**
* Go Elementor Pro.
*
* Redirect the Elementor Pro page the clicking the Elementor Pro menu link.
*
* Fired by `admin_init` action.
*
* @since 2.0.3
* @access public
*/
public function handle_external_redirects() {
if ( empty( Tools::getValue('page') ) ) {
return;
}
}
/**
* Display settings page.
*
* Output the content for the getting started page.
*
* @since 1.0.0
* @access public
*/
public function elementor_getting_started() {
if ( User::is_current_user_can_edit_post_type( 'page' ) ) {
$create_new_label = Leo_Helper::__( 'Create Your First Page', 'elementor' );
$create_new_cpt = 'page';
} elseif ( User::is_current_user_can_edit_post_type( 'post' ) ) {
$create_new_label = Leo_Helper::__( 'Create Your First Post', 'elementor' );
$create_new_cpt = 'post';
}
?>
handle_external_redirects();
// Save general settings in one list for a future usage
$this->handle_general_settings_update();
$this->maybe_remove_all_admin_notices();
}
/**
* Change "Settings" menu name.
*
* Update the name of the Settings admin menu from "Elementor" to "Settings".
*
* Fired by `admin_menu` action.
*
* @since 1.0.0
* @access public
*/
public function admin_menu_change_name() {
$submenu = &$GLOBALS['submenu'];
if ( isset( $submenu['elementor'] ) ) {
// @codingStandardsIgnoreStart
$submenu['elementor'][0][0] = Leo_Helper::__( 'Settings', 'elementor' );
// @codingStandardsIgnoreEnd
}
}
/**
* Update CSS print method.
*
* Clear post CSS cache.
*
* Fired by `add_option_elementor_css_print_method` and
* `update_option_elementor_css_print_method` actions.
*
* @since 1.7.5
* @access public
*/
public function update_css_print_method() {
Plugin::$instance->files_manager->clear_cache();
}
/**
* Create tabs.
*
* Return the settings page tabs, sections and fields.
*
* @since 1.5.0
* @access protected
*
* @return array An array with the settings page tabs, sections and fields.
*/
protected function create_tabs() {
$validations_class_name = __NAMESPACE__ . '\Settings_Validations';
$default_breakpoints = Responsive::get_default_breakpoints();
return [
self::TAB_GENERAL => [
'label' => Leo_Helper::__( 'General', 'elementor' ),
'sections' => [
'general' => [
'fields' => [
self::UPDATE_TIME_FIELD => [
'full_field_id' => self::UPDATE_TIME_FIELD,
'field_args' => [
'type' => 'hidden',
],
'setting_args' => [ $validations_class_name, 'current_time' ],
],
'cpt_support' => [
'label' => Leo_Helper::__( 'Post Types', 'elementor' ),
'field_args' => [
'type' => 'checkbox_list_cpt',
'std' => [ 'page', 'post' ],
'exclude' => [ 'attachment', 'elementor_library' ],
],
'setting_args' => [ $validations_class_name, 'checkbox_list' ],
],
'disable_color_schemes' => [
'label' => Leo_Helper::__( 'Disable Default Colors', 'elementor' ),
'field_args' => [
'type' => 'checkbox',
'value' => 'yes',
'sub_desc' => Leo_Helper::__( 'Checking this box will disable Elementor\'s Default Colors, and make Elementor inherit the colors from your theme.', 'elementor' ),
],
],
'disable_typography_schemes' => [
'label' => Leo_Helper::__( 'Disable Default Fonts', 'elementor' ),
'field_args' => [
'type' => 'checkbox',
'value' => 'yes',
'sub_desc' => Leo_Helper::__( 'Checking this box will disable Elementor\'s Default Fonts, and make Elementor inherit the fonts from your theme.', 'elementor' ),
],
],
],
],
'usage' => [
'label' => Leo_Helper::__( 'Improve Elementor', 'elementor' ),
'fields' => [
'allow_tracking' => [
'label' => Leo_Helper::__( 'Usage Data Tracking', 'elementor' ),
'field_args' => [
'type' => 'checkbox',
'value' => 'yes',
'default' => '',
'sub_desc' => Leo_Helper::__( 'Opt-in to our anonymous plugin data collection and to updates. We guarantee no sensitive data is collected.', 'elementor' ) . sprintf( ' %2$s', 'https://creator.axonvip.com/usage-data-tracking/', Leo_Helper::__( 'Learn more.', 'elementor' ) ),
],
'setting_args' => [ __NAMESPACE__ . '\Tracker', 'check_for_settings_optin' ],
],
],
],
],
],
self::TAB_STYLE => [
'label' => Leo_Helper::__( 'Style', 'elementor' ),
'sections' => [
'style' => [
'fields' => [
'default_generic_fonts' => [
'label' => Leo_Helper::__( 'Default Generic Fonts', 'elementor' ),
'field_args' => [
'type' => 'text',
'std' => 'Sans-serif',
'class' => 'medium-text',
'desc' => Leo_Helper::__( 'The list of fonts used if the chosen font is not available.', 'elementor' ),
],
],
'container_width' => [
'label' => Leo_Helper::__( 'Content Width', 'elementor' ),
'field_args' => [
'type' => 'number',
'attributes' => [
'min' => 300,
'placeholder' => '1140',
'class' => 'medium-text',
],
'sub_desc' => 'px',
'desc' => Leo_Helper::__( 'Sets the default width of the content area (Default: 1140)', 'elementor' ),
],
],
'space_between_widgets' => [
'label' => Leo_Helper::__( 'Space Between Widgets', 'elementor' ),
'field_args' => [
'type' => 'number',
'attributes' => [
'placeholder' => '20',
'class' => 'medium-text',
],
'sub_desc' => 'px',
'desc' => Leo_Helper::__( 'Sets the default space between widgets (Default: 20)', 'elementor' ),
],
],
'stretched_section_container' => [
'label' => Leo_Helper::__( 'Stretched Section Fit To', 'elementor' ),
'field_args' => [
'type' => 'text',
'attributes' => [
'placeholder' => 'body',
'class' => 'medium-text',
],
'desc' => Leo_Helper::__( 'Enter parent element selector to which stretched sections will fit to (e.g. #primary / .wrapper / main etc). Leave blank to fit to page width.', 'elementor' ),
],
],
'page_title_selector' => [
'label' => Leo_Helper::__( 'Page Title Selector', 'elementor' ),
'field_args' => [
'type' => 'text',
'attributes' => [
'placeholder' => 'h1.entry-title',
'class' => 'medium-text',
],
'desc' => Leo_Helper::__( 'Elementor lets you hide the page title. This works for themes that have "h1.entry-title" selector. If your theme\'s selector is different, please enter it above.', 'elementor' ),
],
],
'viewport_lg' => [
'label' => Leo_Helper::__( 'Tablet Breakpoint', 'elementor' ),
'field_args' => [
'type' => 'number',
'attributes' => [
'placeholder' => $default_breakpoints['lg'],
'min' => $default_breakpoints['md'] + 1,
'max' => $default_breakpoints['xl'] - 1,
'class' => 'medium-text',
],
'sub_desc' => 'px',
/* translators: %d: Breakpoint value */
'desc' => sprintf( Leo_Helper::__( 'Sets the breakpoint between desktop and tablet devices. Below this breakpoint tablet layout will appear (Default: %dpx).', 'elementor' ), $default_breakpoints['lg'] ),
],
],
'viewport_md' => [
'label' => Leo_Helper::__( 'Mobile Breakpoint', 'elementor' ),
'field_args' => [
'type' => 'number',
'attributes' => [
'placeholder' => $default_breakpoints['md'],
'min' => $default_breakpoints['sm'] + 1,
'max' => $default_breakpoints['lg'] - 1,
'class' => 'medium-text',
],
'sub_desc' => 'px',
/* translators: %d: Breakpoint value */
'desc' => sprintf( Leo_Helper::__( 'Sets the breakpoint between tablet and mobile devices. Below this breakpoint mobile layout will appear (Default: %dpx).', 'elementor' ), $default_breakpoints['md'] ),
],
],
'global_image_lightbox' => [
'label' => Leo_Helper::__( 'Image Lightbox', 'elementor' ),
'field_args' => [
'type' => 'checkbox',
'value' => 'yes',
'std' => 'yes',
'sub_desc' => Leo_Helper::__( 'Open all image links in a lightbox popup window. The lightbox will automatically work on any link that leads to an image file.', 'elementor' ),
'desc' => Leo_Helper::__( 'You can customize the lightbox design by going to: Top-left hamburger icon > Global Settings > Lightbox.', 'elementor' ),
],
],
],
],
],
],
self::TAB_INTEGRATIONS => [
'label' => Leo_Helper::__( 'Integrations', 'elementor' ),
'sections' => [],
],
self::TAB_ADVANCED => [
'label' => Leo_Helper::__( 'Advanced', 'elementor' ),
'sections' => [
'advanced' => [
'fields' => [
'css_print_method' => [
'label' => Leo_Helper::__( 'CSS Print Method', 'elementor' ),
'field_args' => [
'class' => 'elementor_css_print_method',
'type' => 'select',
'options' => [
'internal' => Leo_Helper::__( 'Internal Embedding', 'elementor' ),
'external' => Leo_Helper::__( 'External File', 'elementor' ),
],
'desc' => '' . Leo_Helper::__( 'Use internal CSS that is embedded in the head of the page. For troubleshooting server configuration conflicts and managing development environments (recommended).', 'elementor' ) . '
' . '' . Leo_Helper::__( 'Use external CSS files for all generated stylesheets. Choose this setting for better performance.', 'elementor' ),
],
],
'editor_break_lines' => [
'label' => Leo_Helper::__( 'Switch Editor Loader Method', 'elementor' ),
'field_args' => [
'type' => 'select',
'options' => [
'' => Leo_Helper::__( 'Disable', 'elementor' ),
1 => Leo_Helper::__( 'Enable', 'elementor' ),
],
'desc' => Leo_Helper::__( 'For troubleshooting server configuration conflicts.', 'elementor' ),
],
],
'edit_buttons' => [
'label' => Leo_Helper::__( 'Editing Handles', 'elementor' ),
'field_args' => [
'type' => 'select',
'std' => '',
'options' => [
'' => Leo_Helper::__( 'Hide', 'elementor' ),
'on' => Leo_Helper::__( 'Show', 'elementor' ),
],
'desc' => Leo_Helper::__( 'Show editing handles when hovering over the element edit button', 'elementor' ),
],
],
'allow_svg' => [
'label' => Leo_Helper::__( 'Enable SVG Uploads', 'elementor' ),
'field_args' => [
'type' => 'select',
'std' => '',
'options' => [
'' => Leo_Helper::__( 'Disable', 'elementor' ),
1 => Leo_Helper::__( 'Enable', 'elementor' ),
],
'desc' => Leo_Helper::__( 'Please note! Allowing uploads of any files (SVG included) is a potential security risk.', 'elementor' ) . '
' . Leo_Helper::__( 'Elementor will try to sanitize the SVG files, removing potential malicious code and scripts.', 'elementor' ) . '
' . Leo_Helper::__( 'We recommend you only enable this feature if you understand the security risks involved.', 'elementor' ),
],
],
],
],
],
],
];
}
/**
* Get settings page title.
*
* Retrieve the title for the settings page.
*
* @since 1.5.0
* @access protected
*
* @return string Settings page title.
*/
protected function get_page_title() {
return Leo_Helper::__( 'Elementor', 'elementor' );
}
/**
* Handle general settings update.
*
* Save general settings in one list for a future usage.
*
* @since 2.0.0
* @access private
*/
private function handle_general_settings_update() {
$post = $GLOBALS['_POST'];
if ( ! empty( $post['option_page'] ) && self::PAGE_ID === $post['option_page'] && ! empty( $post['action'] ) && 'update' === $post['action'] ) {
check_admin_referer( 'elementor-options' );
$saved_general_settings = Leo_Helper::get_option( General_Settings_Manager::META_KEY );
if ( ! $saved_general_settings ) {
$saved_general_settings = [];
}
$general_settings = Manager::get_settings_managers( 'general' )->get_model()->get_settings();
foreach ( $general_settings as $setting_key => $setting ) {
if ( ! empty( $post[ $setting_key ] ) ) {
$pure_setting_key = str_replace( 'elementor_', '', $setting_key );
$saved_general_settings[ $pure_setting_key ] = $post[ $setting_key ];
}
}
Leo_Helper::update_option( General_Settings_Manager::META_KEY, $saved_general_settings );
}
}
/**
* @since 1.0.0
* @access private
*/
private function maybe_remove_all_admin_notices() {
$elementor_pages = [
'elementor-getting-started',
'elementor-role-manager',
'elementor_custom_fonts',
'elementor-license',
];
if ( empty( Tools::getValue('page') ) || ! in_array( Tools::getValue('page'), $elementor_pages, true ) ) {
return;
}
remove_all_actions( 'admin_notices' );
}
/**
* Settings page constructor.
*
* Initializing Elementor "Settings" page.
*
* @since 1.0.0
* @access public
*/
public function __construct() {
parent::__construct();
Leo_Helper::add_action( 'admin_init', [ $this, 'on_admin_init' ] );
Leo_Helper::add_action( 'admin_menu', [ $this, 'register_admin_menu' ], 20 );
Leo_Helper::add_action( 'admin_menu', [ $this, 'admin_menu_change_name' ], 200 );
Leo_Helper::add_action( 'admin_menu', [ $this, 'register_pro_menu' ], self::MENU_PRIORITY_GO_PRO );
Leo_Helper::add_action( 'admin_menu', [ $this, 'register_knowledge_base_menu' ], 501 );
// Clear CSS Meta after change print method.
Leo_Helper::add_action( 'add_option_elementor_css_print_method', [ $this, 'update_css_print_method' ] );
Leo_Helper::add_action( 'update_option_elementor_css_print_method', [ $this, 'update_css_print_method' ] );
Leo_Helper::add_filter( 'custom_menu_order', '__return_true' );
Leo_Helper::add_filter( 'menu_order', [ $this, 'menu_order' ] );
foreach ( Responsive::get_editable_breakpoints() as $breakpoint_key => $breakpoint ) {
foreach ( [ 'add', 'update' ] as $action ) {
Leo_Helper::add_action( "{$action}_option_elementor_viewport_{$breakpoint_key}", [ 'LeoElements\Core\Responsive\Responsive', 'compile_stylesheet_templates' ] );
}
}
}
}