| 1 |
<?php |
| 2 |
/** |
| 3 |
* @package Polylang |
| 4 |
*/ |
| 5 |
|
| 6 |
/** |
| 7 |
* Main Polylang class for REST API requrests, accessible from @see PLL(). |
| 8 |
* |
| 9 |
* @since 2.6 |
| 10 |
*/ |
| 11 |
class PLL_REST_Request extends PLL_Base { |
| 12 |
/** |
| 13 |
* @var PLL_Language|false|null A `PLL_Language` when defined, `false` otherwise. `null` until the language |
| 14 |
* definition process runs. |
| 15 |
*/ |
| 16 |
public $curlang; |
| 17 |
|
| 18 |
/** |
| 19 |
* @var PLL_Filters|null |
| 20 |
*/ |
| 21 |
public $filters; |
| 22 |
|
| 23 |
/** |
| 24 |
* @var PLL_Filters_Links|null |
| 25 |
*/ |
| 26 |
public $filters_links; |
| 27 |
|
| 28 |
/** |
| 29 |
* @var PLL_Admin_Links|null |
| 30 |
*/ |
| 31 |
public $links; |
| 32 |
|
| 33 |
/** |
| 34 |
* @var PLL_Nav_Menu|null |
| 35 |
*/ |
| 36 |
public $nav_menu; |
| 37 |
|
| 38 |
/** |
| 39 |
* @var PLL_Static_Pages|null |
| 40 |
*/ |
| 41 |
public $static_pages; |
| 42 |
|
| 43 |
/** |
| 44 |
* @var PLL_Filters_Widgets_Options|null |
| 45 |
*/ |
| 46 |
public $filters_widgets_options; |
| 47 |
|
| 48 |
/** |
| 49 |
* Constructor. |
| 50 |
* |
| 51 |
* @since 3.4 |
| 52 |
* |
| 53 |
* @param PLL_Links_Model $links_model Reference to the links model. |
| 54 |
*/ |
| 55 |
public function __construct( &$links_model ) { |
| 56 |
parent::__construct( $links_model ); |
| 57 |
|
| 58 |
// Static front page and page for posts. |
| 59 |
// Early instantiated to be able to correctly initialize language properties. |
| 60 |
if ( 'page' === get_option( 'show_on_front' ) ) { |
| 61 |
$this->static_pages = new PLL_Static_Pages( $this ); |
| 62 |
} |
| 63 |
|
| 64 |
$this->model->set_languages_ready(); |
| 65 |
} |
| 66 |
|
| 67 |
/** |
| 68 |
* Setup filters. |
| 69 |
* |
| 70 |
* @since 2.6 |
| 71 |
* |
| 72 |
* @return void |
| 73 |
*/ |
| 74 |
public function init() { |
| 75 |
parent::init(); |
| 76 |
|
| 77 |
if ( ! $this->model->has_languages() ) { |
| 78 |
return; |
| 79 |
} |
| 80 |
|
| 81 |
add_filter( 'rest_pre_dispatch', array( $this, 'set_language' ), 10, 3 ); |
| 82 |
|
| 83 |
$this->filters_links = new PLL_Filters_Links( $this ); |
| 84 |
$this->filters = new PLL_Filters( $this ); |
| 85 |
$this->filters_widgets_options = new PLL_Filters_Widgets_Options( $this ); |
| 86 |
|
| 87 |
$this->links = new PLL_Admin_Links( $this ); |
| 88 |
$this->nav_menu = new PLL_Frontend_Nav_Menu( $this ); // For auto added pages to menu. |
| 89 |
} |
| 90 |
|
| 91 |
/** |
| 92 |
* Sets the current language during a REST request if sent. |
| 93 |
* |
| 94 |
* @since 3.3 |
| 95 |
* |
| 96 |
* @param mixed $result Response to replace the requested version with. Remains untouched. |
| 97 |
* @param WP_REST_Server $server Server instance. |
| 98 |
* @param WP_REST_Request $request Request used to generate the response. |
| 99 |
* @return mixed Untouched $result. |
| 100 |
* |
| 101 |
* @phpstan-param WP_REST_Request<array{lang?: string}> $request |
| 102 |
*/ |
| 103 |
public function set_language( $result, $server, $request ) { |
| 104 |
$lang = $request->get_param( 'lang' ); |
| 105 |
|
| 106 |
if ( ! empty( $lang ) && is_string( $lang ) ) { |
| 107 |
$this->curlang = $this->model->get_language( sanitize_key( $lang ) ); |
| 108 |
|
| 109 |
if ( empty( $this->curlang ) && ! empty( $this->options['default_lang'] ) && is_string( $this->options['default_lang'] ) ) { |
| 110 |
// A lang has been requested but it is invalid, let's fall back to the default one. |
| 111 |
$this->curlang = $this->model->get_language( sanitize_key( $this->options['default_lang'] ) ); |
| 112 |
} |
| 113 |
} |
| 114 |
|
| 115 |
if ( ! empty( $this->curlang ) ) { |
| 116 |
/** This action is documented in frontend/choose-lang.php */ |
| 117 |
do_action( 'pll_language_defined', $this->curlang->slug, $this->curlang ); |
| 118 |
} else { |
| 119 |
/** This action is documented in include/class-polylang.php */ |
| 120 |
do_action( 'pll_no_language_defined' ); // To load overridden textdomains. |
| 121 |
} |
| 122 |
|
| 123 |
return $result; |
| 124 |
} |
| 125 |
} |
| 126 |
|
