← All changes | include/rest-request.php +99 -51 2.7.3 → 3.6.7 View file →

		@@ -1,77 +1,125 @@
1	1	<?php
	2	+/**
	3	+ * @package Polylang
	4	+ */
2	5
3	6	/**
4		- * REST API controller
5		- * accessible as $polylang global object
	7	+ * Main Polylang class for REST API requests, accessible from @see PLL().
6	8	*
7		- * Properties:
8		- * options => inherited, reference to Polylang options array
9		- * model => inherited, reference to PLL_Model object
10		- * links_model => inherited, reference to PLL_Links_Model object
11		- * links => reference to PLL_Admin_Links object
12		- * static_pages => reference to PLL_Static_Pages object
13		- * filters => reference to PLL_Frontend_Filters object
14		- * filters_links => reference to PLL_Filters_Links object
15		- * posts => reference to PLL_CRUD_Posts object
16		- * terms => reference to PLL_CRUD_Terms object
17		- * sync => reference to PLL_Sync object
18		- *
19	9	* @since 2.6
20	10	*/
21	11	class PLL_REST_Request extends PLL_Base {
22		- public $links, $static_pages, $posts, $terms, $filters, $filters_links, $sync;
	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;
23	17
24	18	/**
25		- * Setup filters
	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.
26	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	+ *
27	70	* @since 2.6
	71	+ *
	72	+ * @return void
28	73	*/
29	74	public function init() {
30	75	parent::init();
31	76
32		- if ( $this->model->get_languages_list() ) {
	77	+ if ( ! $this->model->has_languages() ) {
	78	+ return;
	79	+ }
33	80
34		- /** This action is documented in include/class-polylang.php */
35		- do_action( 'pll_no_language_defined' ); // To load overridden textdomains.
	81	+ add_filter( 'rest_pre_dispatch', array( $this, 'set_language' ), 10, 3 );
36	82
37		- $this->filters_links = new PLL_Filters_Links( $this );
38		- $this->filters = new PLL_Filters( $this );
	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 );
39	86
40		- // Static front page and page for posts
41		- if ( 'page' === get_option( 'show_on_front' ) ) {
42		- $this->static_pages = new PLL_Static_Pages( $this );
43		- }
	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	+ }
44	90
45		- $this->links = new PLL_Admin_Links( $this );
46		- $this->posts = new PLL_CRUD_Posts( $this );
47		- $this->terms = new PLL_CRUD_Terms( $this );
48		- $this->sync = new PLL_Sync( $this );
	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' );
49	105
50		- $this->nav_menu = new PLL_Nav_Menu( $this ); // For auto added pages to menu
	106	+ if ( ! empty( $lang ) && is_string( $lang ) ) {
	107	+ $this->curlang = $this->model->get_language( sanitize_key( $lang ) );
51	108
52		- // Share term slugs
53		- if ( get_option( 'permalink_structure' ) && $this->options['force_lang'] && class_exists( 'PLL_Share_Term_Slug' ) ) {
54		- $this->share_term_slug = new PLL_Share_Term_Slug( $this );
	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'] ) );
55	112	}
	113	+ }
56	114
57		- // Translate slugs, only for pretty permalinks
58		- if ( get_option( 'permalink_structure' ) && class_exists( 'PLL_Translate_Slugs' ) ) {
59		- $curlang = null;
60		- $slugs_model = new PLL_Translate_Slugs_Model( $this );
61		- $this->translate_slugs = new PLL_Translate_Slugs( $slugs_model, $curlang );
62		- }
	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	+ }
63	122
64		- if ( class_exists( 'PLL_Sync_Post_Model' ) ) {
65		- $this->sync_post_model = new PLL_Sync_Post_Model( $this );
66		- }
67		-
68		- if ( class_exists( 'PLL_Sync_Post_REST' ) ) {
69		- $this->sync_post = new PLL_Sync_Post_REST( $this );
70		- }
71		-
72		- if ( class_exists( 'PLL_Duplicate_REST' ) ) {
73		- $this->duplicate_rest = new PLL_Duplicate_REST();
74		- }
75		- }
	123	+ return $result;
76	124	}
77	125	}