OwlCyberSecurity - MANAGER
Edit File: admin-static-pages.php
<?php /** * @package Polylang */ /** * Manages the static front page and the page for posts on admin side * * @since 1.8 */ class PLL_Admin_Static_Pages extends PLL_Static_Pages { /** * @var PLL_Admin_Links|null */ protected $links; /** * Constructor: setups filters and actions. * * @since 1.8 * * @param object $polylang An array of attachment metadata. */ public function __construct( &$polylang ) { parent::__construct( $polylang ); $this->links = &$polylang->links; // Add post state for translations of the front page and posts page add_filter( 'display_post_states', array( $this, 'display_post_states' ), 10, 2 ); // Refreshes the language cache when a static front page or page for for posts has been translated. add_action( 'pll_save_post', array( $this, 'pll_save_post' ), 10, 3 ); // Prevents WP resetting the option add_filter( 'pre_update_option_show_on_front', array( $this, 'update_show_on_front' ), 10, 2 ); add_action( 'admin_notices', array( $this, 'notice_must_translate' ) ); } /** * Adds post state for translations of the front page and posts page. * * @since 1.8 * * @param string[] $post_states An array of post display states. * @param WP_Post $post The current post object. * @return string[] */ public function display_post_states( $post_states, $post ) { if ( in_array( $post->ID, $this->model->get_languages_list( array( 'fields' => 'page_on_front' ) ) ) ) { $post_states['page_on_front'] = __( 'Front Page', 'polylang' ); } if ( in_array( $post->ID, $this->model->get_languages_list( array( 'fields' => 'page_for_posts' ) ) ) ) { $post_states['page_for_posts'] = __( 'Posts Page', 'polylang' ); } return $post_states; } /** * Refreshes the language cache when a static front page or page for for posts has been translated. * * @since 1.8 * * @param int $post_id Not used. * @param WP_Post $post Not used. * @param int[] $translations Translations of the post being saved. * @return void */ public function pll_save_post( $post_id, $post, $translations ) { if ( in_array( $this->page_on_front, $translations ) || in_array( $this->page_for_posts, $translations ) ) { $this->model->clean_languages_cache(); } } /** * Prevents WP resetting the option if the admin language filter is active for a language with no pages. * * @since 1.9.3 * * @param string $value The new, unserialized option value. * @param string $old_value The old option value. * @return string */ public function update_show_on_front( $value, $old_value ) { if ( ! empty( $GLOBALS['pagenow'] ) && 'options-reading.php' === $GLOBALS['pagenow'] && 'posts' === $value && ! get_pages() && get_pages( array( 'lang' => '' ) ) ) { $value = $old_value; } return $value; } /** * Add a notice to translate the static front page if it is not translated in all languages * This is especially useful after a new language is created. * The notice is not dismissible and displayed on the Languages pages and the list of pages. * * @since 2.6 * * @return void */ public function notice_must_translate() { $screen = get_current_screen(); if ( ! empty( $screen ) && ( 'toplevel_page_mlang' === $screen->id || 'edit-page' === $screen->id ) ) { $message = $this->get_must_translate_message(); if ( ! empty( $message ) ) { printf( '<div class="error"><p>%s</p></div>', $message // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ); } } } /** * Returns the message asking to translate the static front page in all languages. * * @since 2.8 * * @return string */ public function get_must_translate_message() { $message = ''; if ( $this->page_on_front ) { $untranslated = array(); foreach ( $this->model->get_languages_list() as $language ) { if ( ! $this->model->post->get( $this->page_on_front, $language ) ) { $untranslated[] = sprintf( '<a href="%s">%s</a>', esc_url( $this->links->get_new_post_translation_link( $this->page_on_front, $language ) ), esc_html( $language->name ) ); } } if ( ! empty( $untranslated ) ) { $message = sprintf( /* translators: %s is a comma separated list of native language names */ esc_html__( 'You must translate your static front page in %s.', 'polylang' ), implode( ', ', $untranslated ) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ); } } return $message; } }