*/ namespace LiteSpeed; defined( 'WPINC' ) || exit; class Admin_Display extends Base { const NOTICE_BLUE = 'notice notice-info'; const NOTICE_GREEN = 'notice notice-success'; const NOTICE_RED = 'notice notice-error'; const NOTICE_YELLOW = 'notice notice-warning'; const DB_MSG = 'messages'; const DB_MSG_PIN = 'msg_pin'; const PURGEBY_CAT = '0'; const PURGEBY_PID = '1'; const PURGEBY_TAG = '2'; const PURGEBY_URL = '3'; const PURGEBYOPT_SELECT = 'purgeby'; const PURGEBYOPT_LIST = 'purgebylist'; const DB_DISMISS_MSG = 'dismiss'; const RULECONFLICT_ON = 'ExpiresDefault_1'; const RULECONFLICT_DISMISSED = 'ExpiresDefault_0'; protected $messages = array(); protected $default_settings = array(); protected $_is_network_admin = false; protected $_is_multisite = false; private $_btn_i = 0; /** * Initialize the class and set its properties. * * @since 1.0.7 */ public function __construct() { // main css add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_style' ) ); // Main js add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_scripts' ) ); $this->_is_network_admin = is_network_admin(); $this->_is_multisite = is_multisite(); // Quick access menu if ( is_multisite() && $this->_is_network_admin ) { $manage = 'manage_network_options'; } else { $manage = 'manage_options'; } if ( current_user_can( $manage ) ) { if ( ! defined( 'LITESPEED_DISABLE_ALL' ) ) { add_action( 'wp_before_admin_bar_render', array( GUI::cls(), 'backend_shortcut' ) ); } // `admin_notices` is after `admin_enqueue_scripts` // @see wp-admin/admin-header.php add_action( $this->_is_network_admin ? 'network_admin_notices' : 'admin_notices', array( $this, 'display_messages' ) ); } /** * In case this is called outside the admin page * @see https://codex.wordpress.org/Function_Reference/is_plugin_active_for_network * @since 2.0 */ if ( ! function_exists( 'is_plugin_active_for_network' ) ) { require_once( ABSPATH . '/wp-admin/includes/plugin.php' ); } // add menus ( Also check for mu-plugins) if ( $this->_is_network_admin && ( is_plugin_active_for_network( LSCWP_BASENAME ) || defined( 'LSCWP_MU_PLUGIN' ) ) ) { add_action( 'network_admin_menu', array( $this, 'register_admin_menu' ) ); } else { add_action( 'admin_menu', array( $this, 'register_admin_menu' ) ); } } /** * Show the title of one line * * @since 3.0 * @access public */ public function title( $id ) { echo Lang::title( $id ); } /** * Register the admin menu display. * * @since 1.0.0 * @access public */ public function register_admin_menu() { $capability = $this->_is_network_admin ? 'manage_network_options' : 'manage_options'; if ( current_user_can( $capability ) ) { // root menu add_menu_page( 'LiteSpeed Cache', 'LiteSpeed Cache', 'manage_options', 'litespeed' ); // sub menus $this->_add_submenu( __( 'Dashboard', 'litespeed-cache' ), 'litespeed', 'show_menu_dash' ); $this->_add_submenu( __( 'General', 'litespeed-cache' ), 'litespeed-general', 'show_menu_general' ); $this->_add_submenu( __( 'Cache', 'litespeed-cache' ), 'litespeed-cache', 'show_menu_cache' ); ! $this->_is_network_admin && $this->_add_submenu( __( 'CDN', 'litespeed-cache' ), 'litespeed-cdn', 'show_menu_cdn' ); $this->_add_submenu( __( 'Image Optimization', 'litespeed-cache' ), 'litespeed-img_optm', 'show_img_optm' ); ! $this->_is_network_admin && $this->_add_submenu( __( 'Page Optimization', 'litespeed-cache' ), 'litespeed-page_optm', 'show_page_optm' ); $this->_add_submenu( __( 'Database', 'litespeed-cache' ), 'litespeed-db_optm', 'show_db_optm' ); ! $this->_is_network_admin && $this->_add_submenu( __( 'Crawler', 'litespeed-cache' ), 'litespeed-crawler', 'show_crawler' ); $this->_add_submenu( __( 'Toolbox', 'litespeed-cache' ), 'litespeed-toolbox', 'show_toolbox' ); // sub menus under options add_options_page('LiteSpeed Cache', 'LiteSpeed Cache', $capability, 'litespeed-cache-options', array($this, 'show_menu_cache')); } } /** * Helper function to set up a submenu page. * * @since 1.0.4 * @access private * @param string $menu_title The title that appears on the menu. * @param string $menu_slug The slug of the page. * @param string $callback The callback to call if selected. */ private function _add_submenu( $menu_title, $menu_slug, $callback ) { add_submenu_page( 'litespeed', $menu_title, $menu_title, 'manage_options', $menu_slug, array( $this, $callback ) ); } /** * Register the stylesheets for the admin area. * * @since 1.0.14 * @access public */ public function enqueue_style() { wp_enqueue_style(Core::PLUGIN_NAME, LSWCP_PLUGIN_URL . 'assets/css/litespeed.css', array(), Core::VER, 'all'); } /** * Register the JavaScript for the admin area. * * @since 1.0.0 * @access public */ public function enqueue_scripts() { wp_register_script( Core::PLUGIN_NAME, LSWCP_PLUGIN_URL . 'assets/js/litespeed-cache-admin.js', array(), Core::VER, false ); $localize_data = array(); if ( GUI::has_whm_msg() ) { $ajax_url_dismiss_whm = Utility::build_url( Core::ACTION_DISMISS, GUI::TYPE_DISMISS_WHM, true ); $localize_data[ 'ajax_url_dismiss_whm' ] = $ajax_url_dismiss_whm; } if ( GUI::has_msg_ruleconflict() ) { $ajax_url = Utility::build_url( Core::ACTION_DISMISS, GUI::TYPE_DISMISS_EXPIRESDEFAULT, true ); $localize_data[ 'ajax_url_dismiss_ruleconflict' ] = $ajax_url; } $promo_tag = GUI::cls()->show_promo( true ); if ( $promo_tag ) { $ajax_url_promo = Utility::build_url( Core::ACTION_DISMISS, GUI::TYPE_DISMISS_PROMO, true, null, array( 'promo_tag' => $promo_tag ) ); $localize_data[ 'ajax_url_promo' ] = $ajax_url_promo; } // Injection to LiteSpeed pages global $pagenow; if ( $pagenow == 'admin.php' && ! empty( $_GET[ 'page' ] ) && ( strpos( $_GET[ 'page' ], 'litespeed-' ) === 0 || $_GET[ 'page' ] == 'litespeed' ) ) { // Admin footer add_filter('admin_footer_text', array($this, 'admin_footer_text'), 1); if ( $_GET[ 'page' ] == 'litespeed-crawler' || $_GET[ 'page' ] == 'litespeed-cdn' ) { // Babel JS type correction add_filter( 'script_loader_tag', array( $this, 'bable_type' ), 10, 3 ); wp_enqueue_script( Core::PLUGIN_NAME . '-lib-react', LSWCP_PLUGIN_URL . 'assets/js/react.min.js', array(), Core::VER, false ); wp_enqueue_script( Core::PLUGIN_NAME . '-lib-babel', LSWCP_PLUGIN_URL . 'assets/js/babel.min.js', array(), Core::VER, false ); } // Crawler Cookie Simulation if ( $_GET[ 'page' ] == 'litespeed-crawler' ) { wp_enqueue_script( Core::PLUGIN_NAME . '-crawler', LSWCP_PLUGIN_URL . 'assets/js/component.crawler.js', array(), Core::VER, false ); $localize_data[ 'lang' ] = array(); $localize_data[ 'lang' ][ 'cookie_name' ] = __( 'Cookie Name', 'litespeed-cache' ); $localize_data[ 'lang' ][ 'cookie_value' ] = __( 'Cookie Values', 'litespeed-cache' ); $localize_data[ 'lang' ][ 'one_per_line' ] = Doc::one_per_line( true ); $localize_data[ 'lang' ][ 'remove_cookie_simulation' ] = __( 'Remove cookie simulation', 'litespeed-cache' ); $localize_data[ 'lang' ][ 'add_cookie_simulation_row' ] = __( 'Add new cookie to simulate', 'litespeed-cache' ); empty( $localize_data[ 'ids' ] ) && $localize_data[ 'ids' ] = array(); $localize_data[ 'ids' ][ 'crawler_cookies' ] = self::O_CRAWLER_COOKIES; } // CDN mapping if ( $_GET[ 'page' ] == 'litespeed-cdn' ) { $home_url = home_url( '/' ); $parsed = parse_url( $home_url ); $home_url = str_replace( $parsed[ 'scheme' ] . ':', '', $home_url ); $cdn_url = 'https://cdn.' . substr( $home_url, 2 ); wp_enqueue_script( Core::PLUGIN_NAME . '-cdn', LSWCP_PLUGIN_URL . 'assets/js/component.cdn.js', array(), Core::VER, false ); $localize_data[ 'lang' ] = array(); $localize_data[ 'lang' ][ 'cdn_mapping_url' ] = Lang::title( self::CDN_MAPPING_URL ); $localize_data[ 'lang' ][ 'cdn_mapping_inc_img' ] = Lang::title( self::CDN_MAPPING_INC_IMG ); $localize_data[ 'lang' ][ 'cdn_mapping_inc_css' ] = Lang::title( self::CDN_MAPPING_INC_CSS ); $localize_data[ 'lang' ][ 'cdn_mapping_inc_js' ] = Lang::title( self::CDN_MAPPING_INC_JS ); $localize_data[ 'lang' ][ 'cdn_mapping_filetype' ] = Lang::title( self::CDN_MAPPING_FILETYPE ); $localize_data[ 'lang' ][ 'cdn_mapping_url_desc' ] = sprintf( __( 'CDN URL to be used. For example, %s', 'litespeed-cache' ), '' . $cdn_url . '' ); $localize_data[ 'lang' ][ 'one_per_line' ] = Doc::one_per_line( true ); $localize_data[ 'lang' ][ 'cdn_mapping_remove' ] = __( 'Remove CDN URL', 'litespeed-cache' ); $localize_data[ 'lang' ][ 'add_cdn_mapping_row' ] = __( 'Add new CDN URL', 'litespeed-cache' ); $localize_data[ 'lang' ][ 'on' ] = __( 'ON', 'litespeed-cache' ); $localize_data[ 'lang' ][ 'off' ] = __( 'OFF', 'litespeed-cache' ); empty( $localize_data[ 'ids' ] ) && $localize_data[ 'ids' ] = array(); $localize_data[ 'ids' ][ 'cdn_mapping' ] = self::O_CDN_MAPPING; } // If on Server IP setting page, append getIP link if ( $_GET[ 'page' ] == 'litespeed-general' ) { $localize_data[ 'ajax_url_getIP' ] = function_exists( 'get_rest_url' ) ? get_rest_url( null, 'litespeed/v1/tool/check_ip' ) : '/'; $localize_data[ 'nonce' ] = wp_create_nonce( 'wp_rest' ); } // Activate or deactivate a specific crawler if ( $_GET[ 'page' ] == 'litespeed-crawler' ) { $localize_data[ 'ajax_url_crawler_switch' ] = function_exists( 'get_rest_url' ) ? get_rest_url( null, 'litespeed/v1/toggle_crawler_state' ) : '/'; $localize_data[ 'nonce' ] = wp_create_nonce( 'wp_rest' ); } } if ( $localize_data ) { wp_localize_script( Core::PLUGIN_NAME, 'litespeed_data', $localize_data ); } wp_enqueue_script( Core::PLUGIN_NAME ); } /** * Babel type for crawler * * @since 3.6 */ public function bable_type( $tag, $handle, $src ) { if ( $handle != Core::PLUGIN_NAME . '-crawler' && $handle != Core::PLUGIN_NAME . '-cdn' ) { return $tag; } return ''; } /** * Callback that adds LiteSpeed Cache's action links. * * @since 1.0.0 * @access public * @param array $links Previously added links from other plugins. * @return array Links array with the litespeed cache one appended. */ public function add_plugin_links($links) { // $links[] = '' . __('Settings', 'litespeed-cache') . ''; $links[] = '' . __('Settings', 'litespeed-cache') . ''; return $links; } /** * Change the admin footer text on LiteSpeed Cache admin pages. * * @since 1.0.13 * @param string $footer_text * @return string */ public function admin_footer_text($footer_text) { require_once LSCWP_DIR . 'tpl/inc/admin_footer.php'; return $footer_text; } /** * Builds the html for a single notice. * * @since 1.0.7 * @access public * @param string $color The color to use for the notice. * @param string $str The notice message. * @return string The built notice html. */ public static function build_notice( $color, $str, $irremovable = false ) { $cls = $color; if ( $irremovable ) { $cls .= ' litespeed-irremovable'; } else { $cls .= ' is-dismissible'; } return '

'. $str . '

'; } /** * Display info notice * * @since 1.6.5 * @access public */ public static function info( $msg, $echo = false, $irremovable = false ) { self::add_notice( self::NOTICE_BLUE, $msg, $echo, $irremovable ); } /** * Display note notice * * @since 1.6.5 * @access public */ public static function note( $msg, $echo = false, $irremovable = false ) { self::add_notice( self::NOTICE_YELLOW, $msg, $echo, $irremovable ); } /** * Display success notice * * @since 1.6 * @access public */ public static function succeed( $msg, $echo = false, $irremovable = false ) { self::add_notice( self::NOTICE_GREEN, $msg, $echo, $irremovable ); } /** * Display error notice * * @since 1.6 * @access public */ public static function error( $msg, $echo = false, $irremovable = false ) { self::add_notice( self::NOTICE_RED, $msg, $echo, $irremovable ); } /** * Adds a notice to display on the admin page * * @since 1.0.7 * @access public */ public static function add_notice( $color, $msg, $echo = false, $irremovable = false ) { // Bypass adding for CLI or cron if ( defined( 'LITESPEED_CLI' ) || defined( 'DOING_CRON' ) ) { // WP CLI will show the info directly if ( defined( 'WP_CLI' ) && WP_CLI ) { $msg = strip_tags( $msg ); if ( $color == self::NOTICE_RED ) { \WP_CLI::error( $msg, false ); } else { \WP_CLI::success( $msg ); } } return; } if ( $echo ) { echo self::build_notice( $color, $msg ); return; } $msg_name = $irremovable ? self::DB_MSG_PIN : self::DB_MSG; $messages = self::get_option( $msg_name, array() ); if ( is_array($msg) ) { foreach ( $msg as $k => $str ) { $messages[ $k ] = self::build_notice( $color, $str, $irremovable ); } } else { $messages[] = self::build_notice( $color, $msg, $irremovable ); } $messages = array_unique( $messages ); self::update_option( $msg_name, $messages ); } /** * Display notices and errors in dashboard * * @since 1.1.0 * @access public */ public function display_messages() { if ( ! defined( 'LITESPEED_CONF_LOADED' ) ) { $this->_in_upgrading(); } if ( GUI::has_whm_msg() ) { $this->show_display_installed(); } Data::cls()->check_upgrading_msg(); // If is in dev version, always check latest update Cloud::cls()->check_dev_version(); // One time msg $messages = self::get_option( self::DB_MSG, array() ); $added_thickbox = false; if( is_array( $messages ) ) { foreach ( $messages as $msg ) { // Added for popup links if ( strpos( $msg, 'TB_iframe' ) && ! $added_thickbox ) { add_thickbox(); $added_thickbox = true; } echo $msg; } } self::delete_option( self::DB_MSG ); // Pinned msg $messages = self::get_option( self::DB_MSG_PIN, array() ); if( is_array( $messages ) ) { foreach ( $messages as $k => $msg ) { // Added for popup links if ( strpos( $msg, 'TB_iframe' ) && ! $added_thickbox ) { add_thickbox(); $added_thickbox = true; } // Append close btn if ( substr( $msg, -6 ) == '' ) { $link = Utility::build_url( Core::ACTION_DISMISS, GUI::TYPE_DISMISS_PIN, false, null, array( 'msgid' => $k ) ); $msg = substr( $msg, 0, -6 ) . '

' . __( 'Dismiss', 'litespeed-cache' ) . '' . '

'; } echo $msg; } } if( empty( $_GET[ 'page' ] ) || strpos( $_GET[ 'page' ], 'litespeed' ) !== 0 ) { global $pagenow; if ( $pagenow != 'plugins.php' ) { // && $pagenow != 'index.php' return; } } // Show disable all warning if ( defined( 'LITESPEED_DISABLE_ALL' ) ) { Admin_Display::error( Error::msg( 'disabled_all' ), true ); } if ( ! $this->conf( self::O_NEWS ) ) { return; } // Show promo from cloud Cloud::cls()->show_promo(); /** * Check promo msg first * @since 2.9 */ GUI::cls()->show_promo(); // Show version news Cloud::cls()->news(); } /** * Dismiss pinned msg * * @since 3.5.2 * @access public */ public static function dismiss_pin() { if ( ! isset( $_GET[ 'msgid' ] ) ) { return; } $messages = self::get_option( self::DB_MSG_PIN, array() ); if ( empty( $messages[ $_GET[ 'msgid' ] ] ) ) { return; } unset( $messages[ $_GET[ 'msgid' ] ] ); if ( ! $messages ) { self::delete_option( self::DB_MSG_PIN ); } else { self::update_option( self::DB_MSG_PIN, $messages ); } } /** * Hooked to the in_widget_form action. * Appends LiteSpeed Cache settings to the widget edit settings screen. * This will append the esi on/off selector and ttl text. * * @since 1.1.0 * @access public */ public function show_widget_edit($widget, $return, $instance) { require LSCWP_DIR . 'tpl/esi_widget_edit.php'; } /** * Displays the dashboard page. * * @since 3.0 * @access public */ public function show_menu_dash() { require_once LSCWP_DIR . 'tpl/dash/entry.tpl.php'; } /** * Displays the General page. * * @since 3.0 * @access public */ public function show_menu_general() { require_once LSCWP_DIR . 'tpl/general/entry.tpl.php'; } /** * Displays the CDN page. * * @since 3.0 * @access public */ public function show_menu_cdn() { require_once LSCWP_DIR . 'tpl/cdn/entry.tpl.php'; } /** * Outputs the LiteSpeed Cache settings page. * * @since 1.0.0 * @access public */ public function show_menu_cache() { if ( $this->_is_network_admin ) { require_once LSCWP_DIR . 'tpl/cache/entry_network.tpl.php'; } else { require_once LSCWP_DIR . 'tpl/cache/entry.tpl.php'; } } /** * Tools page * * @since 3.0 * @access public */ public function show_toolbox() { require_once LSCWP_DIR . 'tpl/toolbox/entry.tpl.php'; } /** * Outputs the crawler operation page. * * @since 1.1.0 * @access public */ public function show_crawler() { require_once LSCWP_DIR . 'tpl/crawler/entry.tpl.php'; } /** * Outputs the optimization operation page. * * @since 1.6 * @access public */ public function show_img_optm() { require_once LSCWP_DIR . 'tpl/img_optm/entry.tpl.php'; } /** * Page optm page. * * @since 3.0 * @access public */ public function show_page_optm() { require_once LSCWP_DIR . 'tpl/page_optm/entry.tpl.php'; } /** * DB optm page. * * @since 3.0 * @access public */ public function show_db_optm() { require_once LSCWP_DIR . 'tpl/db_optm/entry.tpl.php'; } /** * Outputs a notice to the admin panel when the plugin is installed * via the WHM plugin. * * @since 1.0.12 * @access public */ public function show_display_installed() { require_once LSCWP_DIR . 'tpl/inc/show_display_installed.php'; } /** * Display error cookie msg. * * @since 1.0.12 * @access public */ public static function show_error_cookie() { require_once LSCWP_DIR . 'tpl/inc/show_error_cookie.php'; } /** * Display warning if lscache is disabled * * @since 2.1 * @access public */ public function cache_disabled_warning() { include LSCWP_DIR . "tpl/inc/check_cache_disabled.php"; } /** * Display conf data upgrading banner * * @since 2.1 * @access private */ private function _in_upgrading() { include LSCWP_DIR . "tpl/inc/in_upgrading.php"; } /** * Output litespeed form info * * @since 3.0 * @access public */ public function form_action( $action = false, $type = false, $has_upload = false ) { if ( ! $action ) { $action = Router::ACTION_SAVE_SETTINGS; } $has_upload = $has_upload ? 'enctype="multipart/form-data"' : ''; if ( ! defined( 'LITESPEED_CONF_LOADED' ) ) { echo '
'; } echo ''; if ( $type ) { echo ''; } wp_nonce_field( $action, Router::NONCE ); } /** * Output litespeed form info END * * @since 3.0 * @access public */ public function form_end( $disable_reset = false ) { echo "
"; if ( ! defined( 'LITESPEED_CONF_LOADED' ) ) { submit_button( __( 'Save Changes', 'litespeed-cache' ), 'secondary litespeed-duplicate-float', 'litespeed-submit', true, array( 'disabled' => 'disabled' ) ); echo '
'; } else { submit_button( __( 'Save Changes', 'litespeed-cache' ), 'primary litespeed-duplicate-float', 'litespeed-submit', true, array( 'id' => 'litespeed-submit-' . $this->_btn_i++ ) ); echo ''; } } /** * Register this setting to save * * @since 3.0 * @access public */ public function enroll( $id ) { echo ''; } /** * Build a textarea * * @since 1.1.0 * @access public */ public function build_textarea( $id, $cols = false, $val = null ) { if ( $val === null ) { $val = $this->conf( $id, true ); if ( is_array( $val ) ) { $val = implode( "\n", $val ); } } if ( ! $cols ) { $cols = 80; } $rows = 5; $lines = substr_count( $val, "\n" ) + 2; if ( $lines > $rows ) { $rows = $lines; } if ( $rows > 40 ) { $rows = 40; } $this->enroll( $id ); echo ""; $this->_check_overwritten( $id ); } /** * Build a text input field * * @since 1.1.0 * @access public */ public function build_input( $id, $cls = null, $val = null, $type = 'text', $disabled = false ) { if ( $val === null ) { $val = $this->conf( $id, true ); // Mask pswds if ( $this->_conf_pswd( $id ) && $val ) { $val = str_repeat( '*', strlen( $val ) ); } } $label_id = preg_replace( '/\W/', '', $id ); if ( $type == 'text' ) { $cls = "regular-text $cls"; } if ( $disabled ) { echo " "; } else { $this->enroll( $id ); echo " "; } $this->_check_overwritten( $id ); } /** * Build a checkbox html snippet * * @since 1.1.0 * @access public * @param string $id * @param string $title * @param bool $checked */ public function build_checkbox( $id, $title, $checked = null, $value = 1 ) { if ( $checked === null && $this->conf( $id, true ) ) { $checked = true; } $checked = $checked ? ' checked ' : ''; $label_id = preg_replace( '/\W/', '', $id ); if ( $value !== 1 ) { $label_id .= '_' . $value; } $this->enroll( $id ); echo "
"; $this->_check_overwritten( $id ); } /** * Build a toggle checkbox html snippet * * @since 1.7 */ public function build_toggle( $id, $checked = null, $title_on = null, $title_off = null ) { if ( $checked === null && $this->conf( $id, true ) ) { $checked = true; } if ( $title_on === null ) { $title_on = __( 'ON', 'litespeed-cache' ); $title_off = __( 'OFF', 'litespeed-cache' ); } $cls = $checked ? 'primary' : 'default litespeed-toggleoff'; echo "
"; } /** * Build a switch div html snippet * * @since 1.1.0 * @since 1.7 removed param $disable * @access public */ public function build_switch( $id, $title_list = false ) { $this->enroll( $id ); echo '
'; if ( ! $title_list ) { $title_list = array( __( 'OFF', 'litespeed-cache' ), __( 'ON', 'litespeed-cache' ), ); } foreach ( $title_list as $k => $v ) { $this->_build_radio( $id, $k, $v ); } echo '
'; $this->_check_overwritten( $id ); } /** * Build a radio input html codes and output * * @since 1.1.0 * @access private */ private function _build_radio( $id, $val, $txt ) { $id_attr = 'input_radio_' . preg_replace( '/\W/', '', $id ) . '_' . $val; $default = isset( self::$_default_options[ $id ] ) ? self::$_default_options[ $id ] : self::$_default_site_options[ $id ]; if ( ! is_string( $default ) ) { $checked = (int) $this->conf( $id, true ) === (int) $val ? ' checked ' : ''; } else { $checked = $this->conf( $id, true ) === $val ? ' checked ' : ''; } echo " "; } /** * Show overwritten msg if there is a const defined * * @since 3.0 */ protected function _check_overwritten( $id ) { $const_val = $this->const_overwritten( $id ); $primary_val = $this->primary_overwritten( $id ); if ( $const_val === null && $primary_val === null ) { return; } $val = $const_val !== null ? $const_val : $primary_val; $default = isset( self::$_default_options[ $id ] ) ? self::$_default_options[ $id ] : self::$_default_site_options[ $id ]; if ( is_bool( $default ) ) { $val = $val ? __( 'ON', 'litespeed-cache' ) : __( 'OFF', 'litespeed-cache' ); } else { if ( is_array( $default ) ) { $val = implode( "\n", $val ); } $val = esc_textarea( $val ); } echo '
⚠️ '; if ( $const_val !== null ) { echo sprintf( __( 'This setting is overwritten by the PHP constant %s', 'litespeed-cache' ), '' . Base::conf_const( $id ) . '' ); } else { if ( get_current_blog_id() != BLOG_ID_CURRENT_SITE && $this->conf( self::NETWORK_O_USE_PRIMARY ) ) { echo __( 'This setting is overwritten by the primary site setting', 'litespeed-cache' ); } else { echo __( 'This setting is overwritten by the Network setting', 'litespeed-cache' ); } } echo ', ' . sprintf( __( 'currently set to %s', 'litespeed-cache' ), "$val" ) . '
'; } /** * Display seconds text and readable layout * * @since 3.0 * @access public */ public function readable_seconds() { echo __( 'seconds', 'litespeed-cache' ); echo ' '; } /** * Display default value * * @since 1.1.1 * @access public */ public function recommended( $id ) { if ( ! $this->default_settings ) { $this->default_settings = $this->load_default_vals(); } $val = $this->default_settings[ $id ]; if ( $val ) { if ( is_array( $val ) ) { $rows = 5; $cols = 30; // Flexible rows/cols $lines = count( $val ) + 1; $rows = min( max( $lines, $rows ), 40 ); foreach ( $val as $v ) { $cols = max( strlen( $v ), $cols ); } $cols = min( $cols, 150 ); $val = implode( "\n", $val ); $val = esc_textarea( $val ); $val = '
' . __( 'Default value', 'litespeed-cache' ) . ':
' . ""; } else { $val = esc_textarea( $val ); $val = "$val"; $val = __( 'Default value', 'litespeed-cache' ) . ': '.$val; } echo $val; } } /** * Validate rewrite rules regex syntax * * @since 3.0 */ protected function _validate_syntax( $id ) { $val = $this->conf( $id, true ); if ( ! $val ) { return; } if ( ! is_array( $val ) ) { $val = array( $val ); } foreach ( $val as $v ) { if ( ! Utility::syntax_checker( $v ) ) { echo '
❌ ' . __( 'Invalid rewrite rule', 'litespeed-cache' ) . ': ' . $v . ''; } } } /** * Validate if the htaccess path is valid * * @since 3.0 */ protected function _validate_htaccess_path( $id ) { $val = $this->conf( $id, true ); if ( ! $val ) { return; } if ( substr( $val, -10 ) !== '/.htaccess' ) { echo '
❌ ' . sprintf( __( 'Path must end with %s', 'litespeed-cache' ), '/.htaccess' ) . ''; } } /** * Check ttl instead of error when saving * * @since 3.0 */ protected function _validate_ttl( $id, $min = false, $max = false, $allow_zero = false ) { $val = $this->conf( $id, true ); if ( $allow_zero && ! $val ) { // return; } $tip = array(); if ( $min && $val < $min && ( ! $allow_zero || $val != 0 ) ) { $tip[] = __( 'Minimum value', 'litespeed-cache' ) . ': ' . $min . '.'; } if ( $max && $val > $max ) { $tip[] = __( 'Maximum value', 'litespeed-cache' ) . ': ' . $max . '.'; } echo '
'; if ( $tip ) { echo ' ❌ ' . implode( ' ', $tip ) . ''; } $range = ''; if ( $allow_zero ) { $range .= __( 'Zero, or', 'litespeed-cache' ) . ' '; } if ( $min && $max ) { $range .= $min . ' - ' . $max; } elseif ( $min ) { $range .= __( 'Larger than', 'litespeed-cache' ) . ' ' . $min; } elseif ( $max ) { $range .= __( 'Smaller than', 'litespeed-cache' ) . ' ' . $max; } echo __( 'Value range', 'litespeed-cache' ) . ': ' . $range . ''; } /** * Check if ip is valid * * @since 3.0 */ protected function _validate_ip( $id ) { $val = $this->conf( $id, true ); if ( ! $val ) { return; } if ( ! is_array( $val ) ) { $val = array( $val ); } $tip = array(); foreach ( $val as $v ) { if ( ! $v ) { continue; } if ( ! \WP_Http::is_ip_address( $v ) ) { $tip[] = __( 'Invalid IP', 'litespeed-cache' ) . ': ' . esc_textarea( $v ) . '.'; } } if ( $tip ) { echo '
❌ ' . implode( ' ', $tip ) . ''; } } /** * Display API environment variable support * * @since 1.8.3 * @access protected */ protected function _api_env_var() { $args = func_get_args(); $s = '' . implode( ', ', $args ) . ''; echo ' ' . __( 'API', 'litespeed-cache' ) . ': ' . sprintf( __( 'Server variable(s) %s available to override this setting.', 'litespeed-cache' ), $s ); Doc::learn_more( 'https://docs.litespeedtech.com/lscache/lscwp/admin/#limiting-the-crawler' ); } /** * Display URI setting example * * @since 2.6.1 * @access protected */ protected function _uri_usage_example() { echo __( 'The URLs will be compared to the REQUEST_URI server variable.', 'litespeed-cache' ); echo ' ' . sprintf( __( 'For example, for %s, %s can be used here.', 'litespeed-cache' ), '/mypath/mypage?aa=bb', 'mypage?aa=' ); echo '
'; echo sprintf( __( 'To match the beginning, add %s to the beginning of the item.', 'litespeed-cache' ), '^' ); echo ' ' . sprintf( __( 'To do an exact match, add %s to the end of the URL.', 'litespeed-cache' ), '$' ); echo ' ' . __( 'One per line.', 'litespeed-cache' ); echo ''; } /** * Return groups string * * @since 2.0 * @access public */ public static function print_plural( $num, $kind = 'group' ) { if ( $num > 1 ) { switch ( $kind ) { case 'group' : return sprintf( __( '%s groups', 'litespeed-cache' ), $num ); case 'image' : return sprintf( __( '%s images', 'litespeed-cache' ), $num ); default: return $num; } } switch ( $kind ) { case 'group' : return sprintf( __( '%s group', 'litespeed-cache' ), $num ); case 'image' : return sprintf( __( '%s image', 'litespeed-cache' ), $num ); default: return $num; } } /** * Return guidance html * * @since 2.0 * @access public */ public static function guidance( $title, $steps, $current_step ) { if ( $current_step === 'done' ) { $current_step = count( $steps ) + 1; } $percentage = ' (' . floor( ( $current_step - 1 ) * 100 / count( $steps ) ) . '%)'; $html = '
' . '

' . $title . $percentage . '

' . '
    '; foreach ( $steps as $k => $v ) { $step = $k + 1; if ( $current_step > $step ) { $html .= '
  1. '; } else { $html .= '
  2. '; } $html .= $v . '
  3. '; } $html .= '
'; return $html; } }