You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

219 lines
5.8 KiB

<?php
/**
* @package Polylang
*/
/**
* Base class for both admin and frontend
*
* @since 1.2
*/
#[AllowDynamicProperties]
abstract class PLL_Base {
/**
* Stores the plugin options.
*
* @var array
*/
public $options;
/**
* @var PLL_Model
*/
public $model;
/**
* Instance of a child class of PLL_Links_Model.
*
* @var PLL_Links_Model
*/
public $links_model;
/**
* Registers hooks on insert / update post related actions and filters.
*
* @var PLL_CRUD_Posts|null
*/
public $posts;
/**
* Registers hooks on insert / update term related action and filters.
*
* @var PLL_CRUD_Terms|null
*/
public $terms;
/**
* Constructor.
*
* @since 1.2
*
* @param PLL_Links_Model $links_model Links Model.
*/
public function __construct( &$links_model ) {
$this->links_model = &$links_model;
$this->model = &$links_model->model;
$this->options = &$this->model->options;
$GLOBALS['l10n_unloaded']['pll_string'] = true; // Short-circuit _load_textdomain_just_in_time() for 'pll_string' domain in WP 4.6+
add_action( 'widgets_init', array( $this, 'widgets_init' ) );
// User defined strings translations
add_action( 'pll_language_defined', array( $this, 'load_strings_translations' ), 5 );
add_action( 'change_locale', array( $this, 'load_strings_translations' ) ); // Since WP 4.7
add_action( 'personal_options_update', array( $this, 'load_strings_translations' ), 1, 0 ); // Before WP, for confirmation request when changing the user email.
add_action( 'lostpassword_post', array( $this, 'load_strings_translations' ), 10, 0 ); // Password reset email.
// Switch_to_blog
add_action( 'switch_blog', array( $this, 'switch_blog' ), 10, 2 );
}
/**
* Instantiates classes reacting to CRUD operations on posts and terms,
* only when at least one language is defined.
*
* @since 2.6
*
* @return void
*/
public function init() {
if ( $this->model->has_languages() ) {
$this->posts = new PLL_CRUD_Posts( $this );
$this->terms = new PLL_CRUD_Terms( $this );
// WordPress options.
new PLL_Translate_Option( 'blogname', array(), array( 'context' => 'WordPress' ) );
new PLL_Translate_Option( 'blogdescription', array(), array( 'context' => 'WordPress' ) );
new PLL_Translate_Option( 'date_format', array(), array( 'context' => 'WordPress' ) );
new PLL_Translate_Option( 'time_format', array(), array( 'context' => 'WordPress' ) );
}
}
/**
* Registers our widgets
*
* @since 0.1
*
* @return void
*/
public function widgets_init() {
register_widget( 'PLL_Widget_Languages' );
// Overwrites the calendar widget to filter posts by language
if ( ! defined( 'PLL_WIDGET_CALENDAR' ) || PLL_WIDGET_CALENDAR ) {
unregister_widget( 'WP_Widget_Calendar' );
register_widget( 'PLL_Widget_Calendar' );
}
}
/**
* Loads user defined strings translations
*
* @since 1.2
* @since 2.1.3 $locale parameter added.
*
* @param string $locale Language locale or slug. Defaults to current locale.
* @return void
*/
public function load_strings_translations( $locale = '' ) {
if ( empty( $locale ) ) {
$locale = ( is_admin() && ! Polylang::is_ajax_on_front() ) ? get_user_locale() : get_locale();
}
$language = $this->model->get_language( $locale );
if ( ! empty( $language ) ) {
$mo = new PLL_MO();
$mo->import_from_db( $language );
$GLOBALS['l10n']['pll_string'] = &$mo;
} else {
unset( $GLOBALS['l10n']['pll_string'] );
}
}
/**
* Resets some variables when the blog is switched.
* Applied only if Polylang is active on the new blog.
*
* @since 1.5.1
*
* @param int $new_blog_id New blog ID.
* @param int $prev_blog_id Previous blog ID.
* @return void
*/
public function switch_blog( $new_blog_id, $prev_blog_id ) {
if ( (int) $new_blog_id === (int) $prev_blog_id ) {
// Do nothing if same blog.
return;
}
$this->links_model->remove_filters();
if ( $this->is_active_on_current_site() ) {
$this->options = get_option( 'polylang' ); // Needed for menus.
$this->links_model = $this->model->get_links_model();
}
}
/**
* Checks if Polylang is active on the current blog (useful when the blog is switched).
*
* @since 3.5.2
*
* @return bool
*/
protected function is_active_on_current_site(): bool {
return pll_is_plugin_active( POLYLANG_BASENAME ) && get_option( 'polylang' );
}
/**
* Check if the customize menu should be removed or not.
*
* @since 3.2
*
* @return bool True if it should be removed, false otherwise.
*/
public function should_customize_menu_be_removed() {
// Exit if a block theme isn't activated.
if ( ! function_exists( 'wp_is_block_theme' ) || ! wp_is_block_theme() ) {
return false;
}
return ! $this->is_customize_register_hooked();
}
/**
* Tells whether or not Polylang or third party callbacks are hooked to `customize_register`.
*
* @since 3.4.3
*
* @global $wp_filter
*
* @return bool True if Polylang's callbacks are hooked, false otherwise.
*/
protected function is_customize_register_hooked() {
global $wp_filter;
if ( empty( $wp_filter['customize_register'] ) || ! $wp_filter['customize_register'] instanceof WP_Hook ) {
return false;
}
/*
* 'customize_register' is hooked by:
* @see PLL_Nav_Menu::create_nav_menu_locations()
* @see PLL_Frontend_Static_Pages::filter_customizer()
*/
$floor = 0;
if ( ! empty( $this->nav_menu ) && (bool) $wp_filter['customize_register']->has_filter( 'customize_register', array( $this->nav_menu, 'create_nav_menu_locations' ) ) ) {
++$floor;
}
if ( ! empty( $this->static_pages ) && (bool) $wp_filter['customize_register']->has_filter( 'customize_register', array( $this->static_pages, 'filter_customizer' ) ) ) {
++$floor;
}
$count = array_sum( array_map( 'count', $wp_filter['customize_register']->callbacks ) );
return $count > $floor;
}
}