← All changes | include/links-default.php +49 -36 2.8 → 3.6.7 View file →

		@@ -3,39 +3,46 @@
3	3	* @package Polylang
4	4	*/
5	5
6	6	/**
7		- * Links model for default permalinks
8		- * for example mysite.com/?somevar=something&lang=en
9		- * implements the "links_model interface"
	7	+ * Links model for the default permalinks
	8	+ * for example mysite.com/?somevar=something&lang=en.
10	9	*
11	10	* @since 1.2
12	11	*/
13	12	class PLL_Links_Default extends PLL_Links_Model {
	13	+ /**
	14	+ * Tells this child class of PLL_Links_Model does not use pretty permalinks.
	15	+ *
	16	+ * @var bool
	17	+ */
14	18	public $using_permalinks = false;
15	19
16	20	/**
17		- * Adds language information to an url
18		- * links_model interface
	21	+ * Adds the language code in a url.
19	22	*
20	23	* @since 1.2
	24	+ * @since 3.4 Accepts now a language slug.
21	25	*
22		- * @param string $url url to modify
23		- * @param object $lang language
24		- * @return string modified url
	26	+ * @param string $url The url to modify.
	27	+ * @param PLL_Language|string|false $language Language object or slug.
	28	+ * @return string The modified url.
25	29	*/
26		- public function add_language_to_link( $url, $lang ) {
27		- return empty( $lang ) || ( $this->options['hide_default'] && $this->options['default_lang'] == $lang->slug ) ? $url : add_query_arg( 'lang', $lang->slug, $url );
	30	+ public function add_language_to_link( $url, $language ) {
	31	+ if ( $language instanceof PLL_Language ) {
	32	+ $language = $language->slug;
	33	+ }
	34	+
	35	+ return empty( $language ) || ( $this->options['hide_default'] && $this->options['default_lang'] === $language ) ? $url : add_query_arg( 'lang', $language, $url );
28	36	}
29	37
30	38	/**
31		- * Removes the language information from an url
32		- * links_model interface
	39	+ * Removes the language information from an url.
33	40	*
34	41	* @since 1.2
35	42	*
36		- * @param string $url url to modify
37		- * @return string modified url
	43	+ * @param string $url The url to modify.
	44	+ * @return string The modified url.
38	45	*/
39	46	public function remove_language_from_link( $url ) {
40	47	return remove_query_arg( 'lang', $url );
41	48	}
		@@ -40,15 +47,14 @@
40	47	return remove_query_arg( 'lang', $url );
41	48	}
42	49
43	50	/**
44		- * Returns the link to the first page
45		- * links_model interface
	51	+ * Returns the link to the first page.
46	52	*
47	53	* @since 1.2
48	54	*
49		- * @param string $url url to modify
50		- * @return string modified url
	55	+ * @param string $url The url to modify.
	56	+ * @return string The modified url.
51	57	*/
52	58	public function remove_paged_from_link( $url ) {
53	59	return remove_query_arg( 'paged', $url );
54	60	}
		@@ -53,15 +59,15 @@
53	59	return remove_query_arg( 'paged', $url );
54	60	}
55	61
56	62	/**
57		- * Returns the link to the paged page when using pretty permalinks
	63	+ * Returns the link to the paged page.
58	64	*
59	65	* @since 1.5
60	66	*
61		- * @param string $url url to modify
62		- * @param int $page
63		- * @return string modified url
	67	+ * @param string $url The url to modify.
	68	+ * @param int $page The page number.
	69	+ * @return string The modified url.
64	70	*/
65	71	public function add_paged_to_link( $url, $page ) {
66	72	return add_query_arg( array( 'paged' => $page ), $url );
67	73	}
		@@ -66,16 +72,15 @@
66	72	return add_query_arg( array( 'paged' => $page ), $url );
67	73	}
68	74
69	75	/**
70		- * Gets the language slug from the url if present
71		- * links_model interface
	76	+ * Gets the language slug from the url if present.
72	77	*
73	78	* @since 1.2
74		- * @since 2.0 add $url argument
	79	+ * @since 2.0 Add the $url argument.
75	80	*
76		- * @param string $url optional, defaults to current url
77		- * @return string language slug
	81	+ * @param string $url Optional, defaults to the current url.
	82	+ * @return string Language slug.
78	83	*/
79	84	public function get_language_from_url( $url = '' ) {
80	85	if ( empty( $url ) ) {
81	86	$url = pll_get_requested_url();
		@@ -80,24 +85,32 @@
80	85	if ( empty( $url ) ) {
81	86	$url = pll_get_requested_url();
82	87	}
83	88
84		- $pattern = '#lang=(' . implode( '|', $this->model->get_languages_list( array( 'fields' => 'slug' ) ) ) . ')#';
85		- return preg_match( $pattern, trailingslashit( $url ), $matches ) ? $matches[1] : ''; // $matches[1] is the slug of the requested language
	89	+ $pattern = sprintf(
	90	+ '#[?&]lang=(?<lang>%s)(?:$|&)#',
	91	+ implode( '|', $this->model->get_languages_list( array( 'fields' => 'slug' ) ) )
	92	+ );
	93	+ return preg_match( $pattern, $url, $matches ) ? $matches['lang'] : ''; // $matches['lang'] is the slug of the requested language.
86	94	}
87	95
88	96	/**
89		- * Returns the static front page url
	97	+ * Returns the static front page url in the given language.
90	98	*
91	99	* @since 1.8
	100	+ * @since 3.4 Accepts now an array of language properties.
92	101	*
93		- * @param object $lang
94		- * @return string
	102	+ * @param PLL_Language|array $language Language object or array of language properties.
	103	+ * @return string The static front page url.
95	104	*/
96		- public function front_page_url( $lang ) {
97		- if ( $this->options['hide_default'] && $lang->slug == $this->options['default_lang'] ) {
	105	+ public function front_page_url( $language ) {
	106	+ if ( $language instanceof PLL_Language ) {
	107	+ $language = $language->to_array();
	108	+ }
	109	+
	110	+ if ( $this->options['hide_default'] && $language['is_default'] ) {
98	111	return trailingslashit( $this->home );
99	112	}
100		- $url = home_url( '/?page_id=' . $lang->page_on_front );
101		- return $this->options['force_lang'] ? $this->add_language_to_link( $url, $lang ) : $url;
	113	+ $url = home_url( '/?page_id=' . $language['page_on_front'] );
	114	+ return $this->options['force_lang'] ? $this->add_language_to_link( $url, $language['slug'] ) : $url;
102	115	}
103	116	}