inherited, reference to Polylang options array
* model => inherited, reference to PLL_Model object
* links_model => inherited, reference to PLL_Links_Model object
* links => inherited, reference to PLL_Admin_Links object
* static_pages => inherited, reference to PLL_Admin_Static_Pages object
* filters_links => inherited, reference to PLL_Filters_Links object
* curlang => inherited, optional, current language used to filter the content (language of the post or term being edited, equal to filter_lang otherwise)
* filter_lang => inherited, optional, current status of the admin languages filter (in the admin bar)
* pref_lang => inherited, preferred language used as default when saving posts or terms
* posts => reference to PLL_CRUD_Posts object
* terms => reference to PLL_CRUD_Terms object
* filters => reference to PLL_Admin_Filters object
* filters_sanitization => reference to PLL_Filters_Sanitization object
* filters_columns => reference to PLL_Admin_Filters_Columns object
* filters_post => reference to PLL_Admin_Filters_Post object
* filters_term => reference to PLL_Admin_filters_Term object
* nav_menu => reference to PLL_Admin_Nav_Menu object
* block_editor => reference to PLL_Admin_Block_Editor object
* classic_editor => reference to PLL_Admin_Classic_Editor object
* filters_media => optional, reference to PLL_Admin_Filters_Media object
*
* @since 1.2
*/
class PLL_Admin extends PLL_Admin_Base {
/**
* Instance of PLL_Admin_Filters
*
* @var PLL_Admin_Filters
*/
public $filters;
/**
* Instance of PLL_Admin_Filters_Columns
*
* @var PLL_Admin_Filters_Columns
*/
public $filters_columns;
/**
* Instance of PLL_Admin_Filters_Post
*
* @var PLL_Admin_Filters_Post
*/
public $filters_post;
/**
* Instance of PLL_Admin_filters_Term
*
* @var PLL_Admin_filters_Term
*/
public $filters_term;
/**
* Instance of PLL_Admin_Nav_Menu
*
* @var PLL_Admin_Nav_Menu
*/
public $nav_menu;
/**
* Instance of PLL_Admin_Filters_Media
*
* @var PLL_Admin_Filters_Media
*/
public $filters_media;
/**
* Instance of PLL_Filters_Sanitization
*
* @since 2.9
*
* @var PLL_Filters_Sanitization
*/
public $filters_sanitization;
/**
* Loads the polylang text domain
* Setups filters and action needed on all admin pages and on plugins page
*
* @since 1.2
*
* @param object $links_model
*/
public function __construct( &$links_model ) {
parent::__construct( $links_model );
// Adds a 'settings' link in the plugins table
add_filter( 'plugin_action_links_' . POLYLANG_BASENAME, array( $this, 'plugin_action_links' ) );
add_action( 'in_plugin_update_message-' . POLYLANG_BASENAME, array( $this, 'plugin_update_message' ), 10, 2 );
}
/**
* Setups filters and action needed on all admin pages and on plugins page
* Loads the settings pages or the filters base on the request
*
* @since 1.2
*/
public function init() {
parent::init();
// Setup filters for admin pages
// Priority 5 to make sure filters are there before customize_register is fired
if ( $this->model->get_languages_list() ) {
add_action( 'wp_loaded', array( $this, 'add_filters' ), 5 );
}
}
/**
* Adds a 'settings' link in the plugins table
*
* @since 0.1
*
* @param array $links list of links associated to the plugin
* @return array modified list of links
*/
public function plugin_action_links( $links ) {
array_unshift( $links, '' . __( 'Settings', 'polylang' ) . '' );
return $links;
}
/**
* Adds the upgrade notice in plugins table
*
* @since 1.1.6
*
* @param array $plugin_data Not used
* @param object $r Plugin update data
*/
public function plugin_update_message( $plugin_data, $r ) {
if ( isset( $r->upgrade_notice ) ) {
printf( '%s
', esc_html( $r->upgrade_notice ) );
}
}
/**
* Setup filters for admin pages
*
* @since 1.2
* @since 2.7 instantiate a PLL_Bulk_Translate instance.
*/
public function add_filters() {
$this->filters_sanitization = new PLL_Filters_Sanitization( $this->get_locale_for_sanitization() );
// All these are separated just for convenience and maintainability
$classes = array( 'Filters', 'Filters_Columns', 'Filters_Post', 'Filters_Term', 'Nav_Menu', 'Classic_Editor', 'Block_Editor' );
// Don't load media filters if option is disabled or if user has no right
if ( $this->options['media_support'] && ( $obj = get_post_type_object( 'attachment' ) ) && ( current_user_can( $obj->cap->edit_posts ) || current_user_can( $obj->cap->create_posts ) ) ) {
$classes[] = 'Filters_Media';
}
foreach ( $classes as $class ) {
$obj = strtolower( $class );
/**
* Filter the class to instantiate when loading admin filters
*
* @since 1.5
*
* @param string $class class name
*/
$class = apply_filters( 'pll_' . $obj, 'PLL_Admin_' . $class );
$this->$obj = new $class( $this );
}
}
/**
* Retrieve the locale according to the current language instead of the language
* of the admin interface.
*
* @since 2.0
*
* @return string
*/
public function get_locale_for_sanitization() {
$locale = get_locale();
if ( isset( $_POST['post_lang_choice'] ) && $lang = $this->model->get_language( sanitize_key( $_POST['post_lang_choice'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$locale = $lang->locale;
} elseif ( isset( $_POST['term_lang_choice'] ) && $lang = $this->model->get_language( sanitize_key( $_POST['term_lang_choice'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$locale = $lang->locale;
} elseif ( isset( $_POST['inline_lang_choice'] ) && $lang = $this->model->get_language( sanitize_key( $_POST['inline_lang_choice'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$locale = $lang->locale;
} elseif ( ! empty( $this->curlang ) ) {
$locale = $this->curlang->locale;
}
return $locale;
}
}