PluginProbe
Polylang / 2.6.2
Polylang v2.6.2
3.8.9 3.8.8 3.8.7 3.8.6 3.8.5 3.8.4 3.8.3 2.7 2.7.0.1 2.7.1 2.7.2 2.7.3 2.7.4 2.8 2.8.1 2.8.2 2.8.3 2.8.4 2.9 2.9.1 2.9.2 3.0 3.0.1 3.0.2 3.0.3 All 233 releases
← All changes | include/base.php +68 -74 3.0.22.6.2 View file →
@@ -1,8 +1,5 @@
1 1 <?php
2 -/**
3 - * @package Polylang
4 - */
5 2
6 3 /**
7 4 * Base class for both admin and frontend
8 5 *
@@ -8,47 +5,16 @@
8 5 *
9 6 * @since 1.2
10 7 */
11 8 abstract class PLL_Base {
12 - /**
13 - * Stores the plugin options.
14 - *
15 - * @var array
16 - */
17 - public $options;
9 + public $links_model, $model, $options;
18 10
19 11 /**
20 - * @var PLL_Model
21 - */
22 - public $model;
23 -
24 - /**
25 - * Instance of a child class of PLL_Links_Model.
12 + * Constructor
26 13 *
27 - * @var PLL_Links_Model
28 - */
29 - public $links_model;
30 -
31 - /**
32 - * Registers hooks on insert / update post related actions and filters.
33 - *
34 - * @var PLL_CRUD_Posts
35 - */
36 - public $posts;
37 -
38 - /**
39 - * Registers hooks on insert / update term related action and filters.
40 - *
41 - * @var PLL_CRUD_Terms
42 - */
43 - public $terms;
44 -
45 - /**
46 - * Constructor.
47 - *
48 14 * @since 1.2
49 15 *
50 - * @param PLL_Links_Model $links_model Links Model.
16 + * @param object $links_model
51 17 */
52 18 public function __construct( &$links_model ) {
53 19 $this->links_model = &$links_model;
54 20 $this->model = &$links_model->model;
@@ -60,9 +26,8 @@
60 26
61 27 // User defined strings translations
62 28 add_action( 'pll_language_defined', array( $this, 'load_strings_translations' ), 5 );
63 29 add_action( 'change_locale', array( $this, 'load_strings_translations' ) ); // Since WP 4.7
64 - add_action( 'personal_options_update', array( $this, 'load_strings_translations' ), 1, 0 ); // Before WP, for confirmation request when changing the user email.
65 30
66 31 // Switch_to_blog
67 32 add_action( 'switch_blog', array( $this, 'switch_blog' ), 10, 2 );
68 33 }
@@ -67,25 +32,28 @@
67 32 add_action( 'switch_blog', array( $this, 'switch_blog' ), 10, 2 );
68 33 }
69 34
70 35 /**
71 - * Instantiates classes reacting to CRUD operations on posts and terms,
72 - * only when at least one language is defined.
36 + * Instantiate classes always needed
73 37 *
74 38 * @since 2.6
75 - *
76 - * @return void
77 39 */
78 40 public function init() {
41 + // REST API
42 + if ( class_exists( 'PLL_REST_API' ) ) {
43 + $this->rest_api = new PLL_REST_API( $this );
44 + }
45 +
79 46 if ( $this->model->get_languages_list() ) {
80 - $this->posts = new PLL_CRUD_Posts( $this );
81 - $this->terms = new PLL_CRUD_Terms( $this );
47 + // Active languages
48 + if ( class_exists( 'PLL_Active_Languages' ) ) {
49 + $this->active_languages = new PLL_Active_Languages( $this );
50 + }
82 51
83 - // WordPress options.
84 - new PLL_Translate_Option( 'blogname', array(), array( 'context' => 'WordPress' ) );
85 - new PLL_Translate_Option( 'blogdescription', array(), array( 'context' => 'WordPress' ) );
86 - new PLL_Translate_Option( 'date_format', array(), array( 'context' => 'WordPress' ) );
87 - new PLL_Translate_Option( 'time_format', array(), array( 'context' => 'WordPress' ) );
52 + // Share post slugs
53 + if ( get_option( 'permalink_structure' ) && $this->options['force_lang'] && class_exists( 'PLL_Share_Post_Slug' ) ) {
54 + $this->share_post_slug = new PLL_Share_Post_Slug( $this );
55 + }
88 56 }
89 57 }
90 58
91 59 /**
@@ -91,10 +59,8 @@
91 59 /**
92 60 * Registers our widgets
93 61 *
94 62 * @since 0.1
95 - *
96 - * @return void
97 63 */
98 64 public function widgets_init() {
99 65 register_widget( 'PLL_Widget_Languages' );
100 66
@@ -111,13 +77,12 @@
111 77 * @since 1.2
112 78 * @since 2.1.3 $locale parameter added.
113 79 *
114 80 * @param string $locale Locale. Defaults to current locale.
115 - * @return void
116 81 */
117 82 public function load_strings_translations( $locale = '' ) {
118 83 if ( empty( $locale ) ) {
119 - $locale = ( is_admin() && ! Polylang::is_ajax_on_front() ) ? get_user_locale() : get_locale();
84 + $locale = get_locale();
120 85 }
121 86
122 87 $language = $this->model->get_language( $locale );
123 88
@@ -130,41 +95,70 @@
130 95 }
131 96 }
132 97
133 98 /**
134 - * Resets some variables when the blog is switched.
135 - * Applied only if Polylang is active on the new blog.
99 + * Resets some variables when switching blog
100 + * Applies only if Polylang is active on the new blog
136 101 *
137 102 * @since 1.5.1
138 103 *
139 - * @param int $new_blog_id New blog ID.
140 - * @param int $prev_blog_id Previous blog ID.
141 - * @return void
104 + * @param int $new_blog
105 + * @param int $old_blog
106 + * @return bool not used by WP but by child class
142 107 */
143 - public function switch_blog( $new_blog_id, $prev_blog_id ) {
144 - if ( $this->is_active_on_new_blog( $new_blog_id, $prev_blog_id ) ) {
145 - $this->options = get_option( 'polylang' ); // Needed for menus.
108 + public function switch_blog( $new_blog, $old_blog ) {
109 + $plugins = ( $sitewide_plugins = get_site_option( 'active_sitewide_plugins' ) ) && is_array( $sitewide_plugins ) ? array_keys( $sitewide_plugins ) : array();
110 + $plugins = array_merge( $plugins, get_option( 'active_plugins', array() ) );
111 +
112 + // 2nd test needed when Polylang is not networked activated
113 + // 3rd test needed when Polylang is networked activated and a new site is created
114 + if ( $new_blog != $old_blog && in_array( POLYLANG_BASENAME, $plugins ) && get_option( 'polylang' ) ) {
115 + $this->options = get_option( 'polylang' ); // Needed for menus
146 116 remove_action( 'pre_option_rewrite_rules', array( $this->links_model, 'prepare_rewrite_rules' ) );
147 117 $this->links_model = $this->model->get_links_model();
118 + return true;
148 119 }
120 + return false;
149 121 }
150 122
151 123 /**
152 - * Checks if Polylang is active on the new blog when the blog is switched.
124 + * Some backward compatibility with Polylang < 1.2
125 + * Allows for example to call $polylang->get_languages_list() instead of $polylang->model->get_languages_list()
126 + * This works but should be slower than the direct call, thus an error is triggered in debug mode
153 127 *
154 - * @since 3.0
128 + * @since 1.2
155 129 *
156 - * @param int $new_blog_id New blog ID.
157 - * @param int $prev_blog_id Previous blog ID.
158 - * @return bool
130 + * @param string $func function name
131 + * @param array $args function arguments
159 132 */
160 - protected function is_active_on_new_blog( $new_blog_id, $prev_blog_id ) {
161 - $plugins = ( $sitewide_plugins = get_site_option( 'active_sitewide_plugins' ) ) && is_array( $sitewide_plugins ) ? array_keys( $sitewide_plugins ) : array();
162 - $plugins = array_merge( $plugins, get_option( 'active_plugins', array() ) );
133 + public function __call( $func, $args ) {
134 + foreach ( $this as $prop => &$obj ) {
135 + if ( is_object( $obj ) && method_exists( $obj, $func ) ) {
136 + if ( WP_DEBUG ) {
137 + $debug = debug_backtrace(); // phpcs:ignore WordPress.PHP.DevelopmentFunctions
138 + $i = 1 + empty( $debug[1]['line'] ); // The file and line are in $debug[2] if the function was called using call_user_func
139 + trigger_error( // phpcs:ignore WordPress.PHP.DevelopmentFunctions
140 + sprintf(
141 + '%1$s was called incorrectly in %3$s on line %4$s: the call to $polylang->%1$s() has been deprecated in Polylang 1.2, use PLL()->%2$s->%1$s() instead.' . "\nError handler",
142 + esc_html( $func ),
143 + esc_html( $prop ),
144 + esc_html( $debug[ $i ]['file'] ),
145 + absint( $debug[ $i ]['line'] )
146 + )
147 + );
148 + }
149 + return call_user_func_array( array( $obj, $func ), $args );
150 + }
151 + }
163 152
164 - /*
165 - * The 2nd test is needed when Polylang is not networked activated.
166 - * The 3rd test is needed when Polylang is networked activated and a new site is created.
167 - */
168 - return $new_blog_id !== $prev_blog_id && in_array( POLYLANG_BASENAME, $plugins ) && get_option( 'polylang' );
153 + $debug = debug_backtrace(); // phpcs:ignore WordPress.PHP.DevelopmentFunctions
154 + trigger_error( // phpcs:ignore WordPress.PHP.DevelopmentFunctions
155 + sprintf(
156 + 'Call to undefined function PLL()->%1$s() in %2$s on line %3$s' . "\nError handler",
157 + esc_html( $func ),
158 + esc_html( $debug[0]['file'] ),
159 + absint( $debug[0]['line'] )
160 + ),
161 + E_USER_ERROR
162 + );
169 163 }
170 164 }