← All changes | admin/admin-links.php +134 -42 2.8 → 3.7.7 View file →

		@@ -3,9 +3,9 @@
3	3	* @package Polylang
4	4	*/
5	5
6	6	/**
7		- * Manages links related functions
	7	+ * Manages links related functions.
8	8	*
9	9	* @since 1.8
10	10	*/
11	11	class PLL_Admin_Links extends PLL_Links {
		@@ -10,14 +10,14 @@
10	10	*/
11	11	class PLL_Admin_Links extends PLL_Links {
12	12
13	13	/**
14		- * Returns html markup for a new translation link
	14	+ * Returns the html markup for a new translation link.
15	15	*
16	16	* @since 2.6
17	17	*
18		- * @param string $link The new translation link.
19		- * @param object $language The language of the new translation.
	18	+ * @param string $link The new translation link.
	19	+ * @param PLL_Language $language The language of the new translation.
20	20	* @return string
21	21	*/
22	22	protected function new_translation_link( $link, $language ) {
23	23	$str = '';
		@@ -37,14 +37,14 @@
37	37	return $str;
38	38	}
39	39
40	40	/**
41		- * Returns html markup for a translation link
	41	+ * Returns the html markup for a translation link.
42	42	*
43	43	* @since 2.6
44	44	*
45		- * @param string $link The translation link.
46		- * @param object $language The language of the translation.
	45	+ * @param string $link The translation link.
	46	+ * @param PLL_Language $language The language of the translation.
47	47	* @return string
48	48	*/
49	49	public function edit_translation_link( $link, $language ) {
50	50	return $link ? sprintf(
		@@ -55,22 +55,22 @@
55	55	) : '';
56	56	}
57	57
58	58	/**
59		- * Get the link to create a new post translation
	59	+ * Get the link to create a new post translation.
60	60	*
61	61	* @since 1.5
62	62	*
63		- * @param int $post_id The source post id.
64		- * @param object $language The language of the new translation.
65		- * @param string $context Optional. Defaults to 'display' which encodes '&' to '&'.
66		- * Otherwise, preserves '&'.
	63	+ * @param int $post_id The source post id.
	64	+ * @param PLL_Language $language The language of the new translation.
	65	+ * @param string $context Optional. Defaults to 'display' which encodes '&' to '&'.
	66	+ * Otherwise, preserves '&'.
67	67	* @return string
68	68	*/
69	69	public function get_new_post_translation_link( $post_id, $language, $context = 'display' ) {
70	70	$post_type = get_post_type( $post_id );
71	71	$post_type_object = get_post_type_object( get_post_type( $post_id ) );
72		- if ( ! current_user_can( $post_type_object->cap->create_posts ) ) {
	72	+ if ( empty( $post_type_object ) || ! current_user_can( $post_type_object->cap->create_posts ) ) {
73	73	return '';
74	74	}
75	75
76	76	// Special case for the privacy policy page which is associated to a specific capability
		@@ -112,26 +112,26 @@
112	112	}
113	113	}
114	114
115	115	/**
116		- * Filter the new post translation link
	116	+ * Filters the new post translation link.
117	117	*
118	118	* @since 1.8
119	119	*
120		- * @param string $link the new post translation link
121		- * @param object $language the language of the new translation
122		- * @param int $post_id the source post id
	120	+ * @param string $link The new post translation link.
	121	+ * @param PLL_Language $language The language of the new translation.
	122	+ * @param int $post_id The source post id.
123	123	*/
124	124	return apply_filters( 'pll_get_new_post_translation_link', $link, $language, $post_id );
125	125	}
126	126
127	127	/**
128		- * Returns html markup for a new post translation link
	128	+ * Returns the html markup for a new post translation link.
129	129	*
130	130	* @since 1.8
131	131	*
132		- * @param int $post_id
133		- * @param object $language
	132	+ * @param int $post_id The source post id.
	133	+ * @param PLL_Language $language The language of the new translation.
134	134	* @return string
135	135	*/
136	136	public function new_post_translation_link( $post_id, $language ) {
137	137	$link = $this->get_new_post_translation_link( $post_id, $language );
		@@ -138,13 +138,13 @@
138	138	return $this->new_translation_link( $link, $language );
139	139	}
140	140
141	141	/**
142		- * Returns html markup for a translation link
	142	+ * Returns the html markup for a post translation link.
143	143	*
144	144	* @since 1.4
145	145	*
146		- * @param int $post_id translation post id
	146	+ * @param int $post_id The translation post id.
147	147	* @return string
148	148	*/
149	149	public function edit_post_translation_link( $post_id ) {
150	150	$link = get_edit_post_link( $post_id );
		@@ -152,16 +152,16 @@
152	152	return $this->edit_translation_link( $link, $language );
153	153	}
154	154
155	155	/**
156		- * Get the link to create a new term translation
	156	+ * Get the link to create a new term translation.
157	157	*
158	158	* @since 1.5
159	159	*
160		- * @param int $term_id
161		- * @param string $taxonomy
162		- * @param string $post_type
163		- * @param object $language
	160	+ * @param int $term_id Source term id.
	161	+ * @param string $taxonomy Taxonomy name.
	162	+ * @param string $post_type Post type name.
	163	+ * @param PLL_Language $language The language of the new translation.
164	164	* @return string
165	165	*/
166	166	public function get_new_term_translation_link( $term_id, $taxonomy, $post_type, $language ) {
167	167	$tax = get_taxonomy( $taxonomy );
		@@ -178,30 +178,30 @@
178	178
179	179	$link = add_query_arg( $args, admin_url( 'edit-tags.php' ) );
180	180
181	181	/**
182		- * Filter the new term translation link
	182	+ * Filters the new term translation link.
183	183	*
184	184	* @since 1.8
185	185	*
186		- * @param string $link the new term translation link
187		- * @param object $language the language of the new translation
188		- * @param int $term_id the source term id
189		- * @param string $taxonomy
190		- * @param string $post_type
	186	+ * @param string $link The new term translation link.
	187	+ * @param PLL_Language $language The language of the new translation.
	188	+ * @param int $term_id The source term id.
	189	+ * @param string $taxonomy Taxonomy name.
	190	+ * @param string $post_type Post type name.
191	191	*/
192	192	return apply_filters( 'pll_get_new_term_translation_link', $link, $language, $term_id, $taxonomy, $post_type );
193	193	}
194	194
195	195	/**
196		- * Returns html markup for a new term translation
	196	+ * Returns the html markup for a new term translation.
197	197	*
198	198	* @since 1.8
199	199	*
200		- * @param int $term_id
201		- * @param string $taxonomy
202		- * @param string $post_type
203		- * @param object $language
	200	+ * @param int $term_id Source term id.
	201	+ * @param string $taxonomy Taxonomy name.
	202	+ * @param string $post_type Post type name.
	203	+ * @param PLL_Language $language The language of the new translation.
204	204	* @return string
205	205	*/
206	206	public function new_term_translation_link( $term_id, $taxonomy, $post_type, $language ) {
207	207	$link = $this->get_new_term_translation_link( $term_id, $taxonomy, $post_type, $language );
		@@ -208,15 +208,15 @@
208	208	return $this->new_translation_link( $link, $language );
209	209	}
210	210
211	211	/**
212		- * Returns html markup for a term translation link
	212	+ * Returns the html markup for a term translation link.
213	213	*
214	214	* @since 1.4
215	215	*
216		- * @param object $term_id translation term id
217		- * @param string $taxonomy
218		- * @param string $post_type
	216	+ * @param int $term_id Translation term id.
	217	+ * @param string $taxonomy Taxonomy name.
	218	+ * @param string $post_type Post type name.
219	219	* @return string
220	220	*/
221	221	public function edit_term_translation_link( $term_id, $taxonomy, $post_type ) {
222	222	$link = get_edit_term_link( $term_id, $taxonomy, $post_type );
		@@ -221,6 +221,98 @@
221	221	public function edit_term_translation_link( $term_id, $taxonomy, $post_type ) {
222	222	$link = get_edit_term_link( $term_id, $taxonomy, $post_type );
223	223	$language = $this->model->term->get_language( $term_id );
224	224	return $this->edit_translation_link( $link, $language );
	225	+ }
	226	+
	227	+ /**
	228	+ * Returns some data (`from_post` and `new_lang`) from the current request.
	229	+ *
	230	+ * @since 3.7
	231	+ *
	232	+ * @param string $post_type A post type.
	233	+ * @return array {
	234	+ * @type WP_Post $from_post The source post.
	235	+ * @type PLL_Language $new_lang The target language.
	236	+ * }
	237	+ *
	238	+ * @phpstan-return array{}|array{from_post: WP_Post, new_lang: PLL_Language}|never
	239	+ */
	240	+ public function get_data_from_new_post_translation_request( string $post_type ): array {
	241	+ if ( 'attachment' === $post_type ) {
	242	+ return $this->get_data_from_new_media_translation_request();
	243	+ }
	244	+
	245	+ if ( ! isset( $GLOBALS['pagenow'], $_GET['_wpnonce'], $_GET['from_post'], $_GET['new_lang'], $_GET['post_type'] ) ) {
	246	+ return array();
	247	+ }
	248	+
	249	+ if ( 'post-new.php' !== $GLOBALS['pagenow'] ) {
	250	+ return array();
	251	+ }
	252	+
	253	+ if ( empty( $post_type ) || $post_type !== $_GET['post_type'] || ! $this->model->is_translated_post_type( $post_type ) ) {
	254	+ return array();
	255	+ }
	256	+
	257	+ // Capability check already done in post-new.php.
	258	+ check_admin_referer( 'new-post-translation' );
	259	+ return $this->get_objects_from_new_post_translation_request( (int) $_GET['from_post'], sanitize_key( $_GET['new_lang'] ) );
	260	+ }
	261	+
	262	+ /**
	263	+ * Returns some data (`from_post` and `new_lang`) from the current request.
	264	+ *
	265	+ * @since 3.7
	266	+ *
	267	+ * @return array {
	268	+ * @type WP_Post $from_post The source media.
	269	+ * @type PLL_Language $new_lang The target language.
	270	+ * }
	271	+ *
	272	+ * @phpstan-return array{}|array{from_post: WP_Post, new_lang: PLL_Language}|never
	273	+ */
	274	+ public function get_data_from_new_media_translation_request(): array {
	275	+ if ( ! $this->options['media_support'] ) {
	276	+ return array();
	277	+ }
	278	+
	279	+ if ( ! isset( $_GET['action'], $_GET['_wpnonce'], $_GET['from_media'], $_GET['new_lang'] ) || 'translate_media' !== $_GET['action'] ) {
	280	+ return array();
	281	+ }
	282	+
	283	+ check_admin_referer( 'translate_media' );
	284	+ return $this->get_objects_from_new_post_translation_request( (int) $_GET['from_media'], sanitize_key( $_GET['new_lang'] ) );
	285	+ }
	286	+
	287	+ /**
	288	+ * Returns the objects given the post ID and language slug provided in the new post translation request.
	289	+ *
	290	+ * @since 3.7
	291	+ *
	292	+ * @param int $post_id The original Post ID provided.
	293	+ * @param string $lang_slug The new translation language provided
	294	+ * @return array {
	295	+ * @type WP_Post $from_post The source post.
	296	+ * @type PLL_Language $new_lang The target language.
	297	+ * }
	298	+ *
	299	+ * @phpstan-return array{}|array{from_post: WP_Post, new_lang: PLL_Language}|never
	300	+ */
	301	+ private function get_objects_from_new_post_translation_request( int $post_id, string $lang_slug ): array {
	302	+ if ( $post_id <= 0 || empty( $lang_slug ) ) {
	303	+ return array();
	304	+ }
	305	+
	306	+ $post = get_post( $post_id );
	307	+ $lang = $this->model->get_language( $lang_slug );
	308	+
	309	+ if ( empty( $post ) || empty( $lang ) ) {
	310	+ return array();
	311	+ }
	312	+
	313	+ return array(
	314	+ 'from_post' => $post,
	315	+ 'new_lang' => $lang,
	316	+ );
225	317	}
226	318	}