← All changes | include/rest-request.php +107 -26 2.9 → 3.7.1 View file →

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