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.
152 lines
4.4 KiB
152 lines
4.4 KiB
<?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;
|
|
}
|
|
}
|
|
|