<?php /** * @package Polylang */ /** * A class to manage URL modifications settings * * @since 1.8 */ class PLL_Settings_Url extends PLL_Settings_Module { /** * Stores the display order priority. * * @var int */ public $priority = 10; /** * The page id of the static front page. * * @var int|null */ protected $page_on_front; /** * Constructor. * * @since 1.8 * * @param object $polylang The Polylang object. */ public function __construct( &$polylang ) { parent::__construct( $polylang, array( 'module' => 'url', 'title' => __( 'URL modifications', 'polylang' ), 'description' => __( 'Decide how your URLs will look like.', 'polylang' ), ) ); $this->page_on_front = &$polylang->static_pages->page_on_front; } /** * Displays the fieldset to choose how the language is set * * @since 1.8 * * @return void */ protected function force_lang() { if ( 'yes' === get_option( 'pll_language_from_content_available' ) ) { ?> <p class="description"><?php esc_html_e( 'Some themes or plugins may not be fully compatible with the language defined by the content or by domains.', 'polylang' ); ?></p> <label> <?php printf( '<input name="force_lang" type="radio" value="0" %s /> %s', checked( $this->options['force_lang'], 0, false ), esc_html__( 'The language is set from content', 'polylang' ) ); ?> </label> <p class="description"><?php esc_html_e( 'Posts, pages, categories and tags URLs will not be modified.', 'polylang' ); ?></p> <?php } else { ?> <p class="description"><?php esc_html_e( 'Some themes or plugins may not be fully compatible with the language defined by domains.', 'polylang' ); ?></p> <?php } ?> <label> <?php printf( '<input name="force_lang" type="radio" value="1" %s/> %s', checked( $this->options['force_lang'], 1, false ), ( $this->links_model->using_permalinks ? esc_html__( 'The language is set from the directory name in pretty permalinks', 'polylang' ) : esc_html__( 'The language is set from the code in the URL', 'polylang' ) ) ); ?> </label> <p class="description"><?php echo esc_html__( 'Example:', 'polylang' ) . ' <code>' . esc_html( home_url( $this->links_model->using_permalinks ? 'en/my-post/' : '?lang=en&p=1' ) ) . '</code>'; ?></p> <label> <?php printf( '<input name="force_lang" type="radio" value="2" %s %s/> %s', disabled( $this->links_model->using_permalinks, false, false ), checked( $this->options['force_lang'], 2, false ), esc_html__( 'The language is set from the subdomain name in pretty permalinks', 'polylang' ) ); ?> </label> <p class="description"><?php echo esc_html__( 'Example:', 'polylang' ) . ' <code>' . esc_html( str_replace( array( '://', 'www.' ), array( '://en.', '' ), home_url( 'my-post/' ) ) ) . '</code>'; ?></p> <label> <?php printf( '<input name="force_lang" type="radio" value="3" %s %s/> %s', disabled( $this->links_model->using_permalinks, false, false ), checked( $this->options['force_lang'], 3, false ), esc_html__( 'The language is set from different domains', 'polylang' ) ); ?> </label> <table id="pll-domains-table" class="form-table" <?php echo 3 == $this->options['force_lang'] ? '' : 'style="display: none;"'; ?>> <?php foreach ( $this->model->get_languages_list() as $lg ) { $url = $this->options['domains'][ $lg->slug ] ?? ( $lg->is_default ? $this->links_model->home : '' ); printf( '<tr><td><label for="pll-domain[%1$s]">%2$s</label></td>' . '<td><input name="domains[%1$s]" id="pll-domain[%1$s]" type="text" value="%3$s" class="regular-text code" aria-required="true" /></td></tr>', esc_attr( $lg->slug ), esc_attr( $lg->name ), esc_url( $url ) ); } ?> </table> <?php } /** * Displays the fieldset to choose to hide the default language information in url * * @since 1.8 * * @return void */ protected function hide_default() { ?> <label> <?php printf( '<input name="hide_default" type="checkbox" value="1" %s /> %s', checked( $this->options['hide_default'], true, false ), esc_html__( 'Hide URL language information for default language', 'polylang' ) ); ?> </label> <?php } /** * Displays the fieldset to choose to hide /language/ in url * * @since 1.8 * * @return void */ protected function rewrite() { ?> <label> <?php printf( '<input name="rewrite" type="radio" value="1" %s %s/> %s', disabled( $this->links_model->using_permalinks, false, false ), checked( $this->options['rewrite'], true, false ), sprintf( /* translators: %s is a URL slug: `/language/`. */ esc_html__( 'Remove %s in pretty permalinks', 'polylang' ), '<code>/language/</code>' ) ); ?> </label> <p class="description"><?php echo esc_html__( 'Example:', 'polylang' ) . ' <code>' . esc_html( home_url( 'en/' ) ) . '</code>'; ?></p> <label> <?php printf( '<input name="rewrite" type="radio" value="0" %s %s/> %s', disabled( $this->links_model->using_permalinks, false, false ), checked( $this->options['rewrite'], false, false ), sprintf( /* translators: %s is a URL slug: `/language/`. */ esc_html__( 'Keep %s in pretty permalinks', 'polylang' ), '<code>/language/</code>' ) ); ?> </label> <p class="description"><?php echo esc_html__( 'Example:', 'polylang' ) . ' <code>' . esc_html( home_url( 'language/en/' ) ) . '</code>'; ?></p> <?php } /** * Displays the fieldset to choose to redirect the home page to language page * * @since 1.8 * * @return void */ protected function redirect_lang() { ?> <label> <?php printf( '<input name="redirect_lang" type="checkbox" value="1" %s/> %s', checked( $this->options['redirect_lang'], true, false ), esc_html__( 'The front page URL contains the language code instead of the page name or page id', 'polylang' ) ); ?> </label> <p class="description"> <?php // That's nice to display the right home urls but don't forget that the page on front may have no language yet $lang = $this->model->post->get_language( $this->page_on_front ); /** @var PLL_Language $lang */ $lang = $lang ?: $this->model->get_default_language(); printf( /* translators: %1$s example url when the option is active. %2$s example url when the option is not active */ esc_html__( 'Example: %1$s instead of %2$s', 'polylang' ), '<code>' . esc_html( $this->links_model->home_url( $lang ) ) . '</code>', '<code>' . esc_html( _get_page_link( $this->page_on_front ) ) . '</code>' ); ?> </p> <?php } /** * Displays the settings * * @since 1.8 * * @return void */ public function form() { ?> <div class="pll-settings-url-col"> <fieldset class="pll-col-left pll-url" id="pll-force-lang"> <?php $this->force_lang(); ?> </fieldset> </div> <div class="pll-settings-url-col"> <fieldset class="pll-col-right pll-url" id="pll-hide-default" <?php echo 3 > $this->options['force_lang'] ? '' : 'style="display: none;"'; ?>> <?php $this->hide_default(); ?> </fieldset> <?php if ( $this->links_model->using_permalinks ) { ?> <fieldset class="pll-col-right pll-url" id="pll-rewrite" <?php echo 2 > $this->options['force_lang'] ? '' : 'style="display: none;"'; ?>> <?php $this->rewrite(); ?> </fieldset> <?php } if ( $this->page_on_front ) { ?> <fieldset class="pll-col-right pll-url" id="pll-redirect-lang" <?php echo 2 > $this->options['force_lang'] ? '' : 'style="display: none;"'; ?>> <?php $this->redirect_lang(); ?> </fieldset> <?php } ?> </div> <?php } /** * Prepares the received data before saving. * * @since 3.7 * * @param array $options Raw values to save. * @return array */ protected function prepare_raw_data( array $options ): array { $defaults = array( 'force_lang' => 0, 'domains' => array(), 'hide_default' => 0, 'rewrite' => 0, 'redirect_lang' => 0, ); return array_intersect_key( array_merge( $defaults, $options ), $defaults ); // Take care to return only validated options } }