/home/arranoyd/public_html/wp-content/plugins/litespeed-cache/src/api.cls.php
<?php
/**
* The plugin API class.
*
* @since 1.1.3
* @since 1.4 Moved into /inc
* @package LiteSpeed
* @subpackage LiteSpeed/inc
* @author LiteSpeed Technologies <info@litespeedtech.com>
*/
namespace LiteSpeed;
defined( 'WPINC' ) || exit;
class API extends Base
{
const VERSION = Core::VER;
const TYPE_FEED = Tag::TYPE_FEED ;
const TYPE_FRONTPAGE = Tag::TYPE_FRONTPAGE ;
const TYPE_HOME = Tag::TYPE_HOME ;
const TYPE_PAGES = Tag::TYPE_PAGES ;
const TYPE_PAGES_WITH_RECENT_POSTS = Tag::TYPE_PAGES_WITH_RECENT_POSTS ;
const TYPE_HTTP = Tag::TYPE_HTTP ;
const TYPE_ARCHIVE_POSTTYPE = Tag::TYPE_ARCHIVE_POSTTYPE ;
const TYPE_ARCHIVE_TERM = Tag::TYPE_ARCHIVE_TERM ;
const TYPE_AUTHOR = Tag::TYPE_AUTHOR ;
const TYPE_ARCHIVE_DATE = Tag::TYPE_ARCHIVE_DATE ;
const TYPE_BLOG = Tag::TYPE_BLOG ;
const TYPE_LOGIN = Tag::TYPE_LOGIN ;
const TYPE_URL = Tag::TYPE_URL ;
const TYPE_ESI = Tag::TYPE_ESI ;
const PARAM_NAME = ESI::PARAM_NAME ;
const WIDGET_O_ESIENABLE = ESI::WIDGET_O_ESIENABLE ;
const WIDGET_O_TTL = ESI::WIDGET_O_TTL ;
protected static $_instance;
/**
* Instance
*
* @since 3.0
* @access protected
*/
protected function __construct()
{
}
/**
* Define hooks to be used in other plugins.
*
* The benefit to use hooks other than functions is no need to detech if LSCWP enabled and function existed or not anymore
*
* @since 3.0
*/
public function init()
{
/**
* Init
*/
// Action `litespeed_init` // @previous API::hook_init( $hook )
/**
* Conf
*/
add_filter( 'litespeed_conf', __NAMESPACE__ . '\Conf::val' ); // @previous API::config($id)
// Action `litespeed_conf_append` // @previous API::conf_append( $name, $default )
add_action( 'litespeed_conf_multi_switch', __NAMESPACE__ . '\Base::set_multi_switch', 10, 2 );
// Action ``litespeed_conf_force` // @previous API::force_option( $k, $v )
/**
* Cache Control Hooks
*/
// Action `litespeed_control_finalize` // @previous API::hook_control($tags) && action `litespeed_api_control`
add_action( 'litespeed_control_set_private', __NAMESPACE__ . '\Control::set_private' ); // @previous API::set_cache_private()
add_action( 'litespeed_control_set_nocache', __NAMESPACE__ . '\Control::set_nocache' ); // @previous API::set_nocache( $reason = false )
add_action( 'litespeed_control_set_cacheable', __NAMESPACE__ . '\Control::set_cacheable' ); // Might needed if not call hook `wp` // @previous API::set_cacheable( $reason )
add_action( 'litespeed_control_force_cacheable', __NAMESPACE__ . '\Control::force_cacheable' ); // Set cache status to force cacheable ( Will ignore most kinds of non-cacheable conditions ) // @previous API::set_force_cacheable( $reason )
add_action( 'litespeed_control_force_public', __NAMESPACE__ . '\Control::set_public_forced' ); // Set cache to force public cache if cacheable ( Will ignore most kinds of non-cacheable conditions ) // @previous API::set_force_public( $reason )
add_filter( 'litespeed_control_cacheable', __NAMESPACE__ . '\Control::is_cacheable', 3 ); // Note: Read-Only. Directly append to this filter won't work. Call actions above to set cacheable or not // @previous API::not_cacheable()
add_action( 'litespeed_control_set_ttl', __NAMESPACE__ . '\Control::set_custom_ttl', 10, 2 ); // @previous API::set_ttl( $val )
add_filter( 'litespeed_control_ttl', __NAMESPACE__ . '\Control::get_ttl', 3 ); // @previous API::get_ttl()
/**
* Tag Hooks
*/
// Action `litespeed_tag_finalize` // @previous API::hook_tag( $hook )
add_action( 'litespeed_tag_add', __NAMESPACE__ . '\Tag::add' ); // @previous API::tag_add( $tag )
add_action( 'litespeed_tag_add_post', __NAMESPACE__ . '\Tag::add_post' );
add_action( 'litespeed_tag_add_widget', __NAMESPACE__ . '\Tag::add_widget' );
add_action( 'litespeed_tag_add_private', __NAMESPACE__ . '\Tag::add_private' ); // @previous API::tag_add_private( $tags )
add_action( 'litespeed_tag_add_private_esi', __NAMESPACE__ . '\Tag::add_private_esi' );
/**
* Purge Hooks
*/
// Action `litespeed_purge_finalize` // @previous API::hook_purge($tags)
add_action( 'litespeed_purge', __NAMESPACE__ . '\Purge::add' ); // @previous API::purge($tags)
add_action( 'litespeed_purge_all', __NAMESPACE__ . '\Purge::purge_all' );
add_action( 'litespeed_purge_post', __NAMESPACE__ . '\Purge::purge_post' ); // @previous API::purge_post( $pid )
add_action( 'litespeed_purge_posttype', __NAMESPACE__ . '\Purge::purge_posttype' );
add_action( 'litespeed_purge_url', __NAMESPACE__ . '\Purge::purge_url' );
add_action( 'litespeed_purge_widget', __NAMESPACE__ . '\Purge::purge_widget' );
add_action( 'litespeed_purge_esi', __NAMESPACE__ . '\Purge::purge_esi' );
add_action( 'litespeed_purge_private', __NAMESPACE__ . '\Purge::add_private' ); // @previous API::purge_private( $tags )
add_action( 'litespeed_purge_private_esi', __NAMESPACE__ . '\Purge::add_private_esi' );
add_action( 'litespeed_purge_private_all', __NAMESPACE__ . '\Purge::add_private_all' ); // @previous API::purge_private_all()
// Action `litespeed_api_purge_post` // Triggered when purge a post // @previous API::hook_purge_post($hook)
// Action `litespeed_purged_all` // Triggered after purged all.
/**
* ESI
*/
// Action `litespeed_nonce` // @previous API::nonce_action( $action ) & API::nonce( $action = -1, $defence_for_html_filter = true )
add_filter( 'litespeed_esi_status', __NAMESPACE__ . '\Router::esi_enabled' ); // Get ESI enable status // @previous API::esi_enabled()
add_filter( 'litespeed_esi_url', __NAMESPACE__ . '\ESI::sub_esi_block', 10, 8 ); // Generate ESI block url // @previous API::esi_url( $block_id, $wrapper, $params = array(), $control = 'private,no-vary', $silence = false, $preserved = false, $svar = false, $inline_val = false )
// Filter `litespeed_widget_default_options` // Hook widget default settings value. Currently used in Woo 3rd // @previous API::hook_widget_default_options( $hook )
// Filter `litespeed_esi_params` // @previous API::hook_esi_param( $hook )
// Action `litespeed_tpl_normal` // @previous API::hook_tpl_not_esi($hook) && Action `litespeed_is_not_esi_template`
// Action `litespeed_esi_load-$block` // @usage add_action( 'litespeed_esi_load-' . $block, $hook ) // @previous API::hook_tpl_esi($block, $hook)
/**
* Vary
*
* To modify default vary, There are two ways: Action `litespeed_vary_append` or Filter `litespeed_vary`
*/
add_action( 'litespeed_vary_ajax_force', __NAMESPACE__ . '\Vary::can_ajax_vary' ); // API::force_vary() -> Action `litespeed_vary_ajax_force` // Force finalize vary even if its in an AJAX call
add_action( 'litespeed_vary_append', __NAMESPACE__ . '\Vary::append', 10, 2 ); // API::vary( $k, $v, $default = null ) -> Action `litespeed_vary_append // Alter default vary cookie value // Default vary cookie is an array before finalization, after that it will be combined to a string and store as default vary cookie name
// API::hook_vary_finalize( $hook ) -> Filter `litespeed_vary`
add_action( 'litespeed_vary_no', __NAMESPACE__ . '\Control::set_no_vary' ); // API::set_cache_no_vary() -> Action `litespeed_vary_no` // Set cache status to no vary
add_filter( 'litespeed_is_mobile', __NAMESPACE__ . '\Control::is_mobile' ); // API::set_mobile() -> Filter `litespeed_is_mobile`
/**
* GUI
*/
// API::clean_wrapper_begin( $counter = false ) -> Filter `litespeed_clean_wrapper_begin` // Start a to-be-removed html wrapper
add_filter( 'litespeed_clean_wrapper_begin', __NAMESPACE__ . '\GUI::clean_wrapper_begin' );
// API::clean_wrapper_end( $counter = false ) -> Filter `litespeed_clean_wrapper_end` // End a to-be-removed html wrapper
add_filter( 'litespeed_clean_wrapper_end', __NAMESPACE__ . '\GUI::clean_wrapper_end' );
/**
* Mist
*/
add_action( 'litespeed_debug', __NAMESPACE__ . '\Debug2::debug' ); // API::debug()-> Action `litespeed_debug`
add_action( 'litespeed_debug2', __NAMESPACE__ . '\Debug2::debug2' ); // API::debug2()-> Action `litespeed_debug2`
add_action( 'litespeed_disable_all', array( $this, '_disable_all' ) ); // API::disable_all( $reason ) -> Action `litespeed_disable_all`
add_action( 'litspeed_after_admin_init', array( $this, '_after_admin_init' ) );
}
/**
* API for admin related
*
* @since 3.0
* @access public
*/
public function _after_admin_init()
{
/**
* GUI
*/
add_action( 'litespeed_setting_enroll', array( Admin_Display::get_instance(), 'enroll' ), 10, 4 ); // API::enroll( $id ) // Register a field in setting form to save
add_action( 'litespeed_build_switch', array( Admin_Display::get_instance(), 'build_switch' ) ); // API::build_switch( $id ) // Build a switch div html snippet
// API::hook_setting_content( $hook, $priority = 10, $args = 1 ) -> Action `litespeed_settings_content`
// API::hook_setting_tab( $hook, $priority = 10, $args = 1 ) -> Action `litespeed_settings_tab`
}
/**
* Disable All (Note: Not for direct call, always use Hooks)
*
* @since 2.9.7.2
* @access public
*/
public function _disable_all( $reason )
{
do_action( 'litespeed_debug', '[API] Disabled_all due to ' . $reason );
! defined( 'LITESPEED_DISABLE_ALL' ) && define( 'LITESPEED_DISABLE_ALL', true );
}
/**
* Hook new vary cookies to vary finialization
*
* @since 2.6
* @access public
*/
public static function hook_vary_add( $hook )
{
add_action( 'litespeed_vary_add', $hook ) ;
}
/**
* Add a new vary cookie
*
* @since 1.1.3
* @since 2.7.1 Changed to filter hook instead of `Vary::add()`
* @access public
*/
public static function vary_add( $vary, $priority = 10 )
{
add_filter( 'litespeed_vary_cookies', function( $cookies ) use( $vary ) {
if ( ! is_array( $vary ) ) {
$vary = array( $vary ) ;
}
$cookies = array_merge( $cookies, $vary ) ;
return $cookies ;
}, $priority ) ;
}
/**
* Hook vary cookies to vary finialization
*
* @since 2.7.1
* @access public
*/
public static function filter_vary_cookies( $hook, $priority = 10 )
{
add_filter( 'litespeed_vary_cookies', $hook, $priority ) ;
}
/**
* Hook vary appending to vary
*
* NOTE: This will add vary to rewrite rule
*
* @since 1.1.3
* @since 2.7.1 This didn't work in 2.7- due to used add_action not filter
* @access public
*/
public static function hook_vary( $hook )
{
add_filter( 'litespeed_api_vary', $hook ) ;
}
/**
* @since 3.0
*/
public static function vary_append_commenter()
{
Vary::get_instance()->append_commenter() ;
}
}