| @@ -3,71 +3,44 @@ | ||
| 3 | 3 | * @package Polylang |
| 4 | 4 | */ |
| 5 | 5 | |
| 6 | 6 | /** |
| 7 | - * Main Polylang class for admin (except Polylang pages), accessible from @see PLL(). | |
| 7 | + * Admin side controller | |
| 8 | + * accessible in $polylang global object | |
| 8 | 9 | * |
| 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 => inherited, reference to PLL_Admin_Links object | |
| 15 | + * static_pages => inherited, reference to PLL_Admin_Static_Pages object | |
| 16 | + * filters_links => inherited, reference to PLL_Filters_Links object | |
| 17 | + * curlang => inherited, optional, current language used to filter the content (language of the post or term being edited, equal to filter_lang otherwise) | |
| 18 | + * filter_lang => inherited, optional, current status of the admin languages filter (in the admin bar) | |
| 19 | + * pref_lang => inherited, preferred language used as default when saving posts or terms | |
| 20 | + * posts => reference to PLL_CRUD_Posts object | |
| 21 | + * terms => reference to PLL_CRUD_Terms object | |
| 22 | + * filters => reference to PLL_Admin_Filters object | |
| 23 | + * filters_columns => reference to PLL_Admin_Filters_Columns object | |
| 24 | + * filters_post => reference to PLL_Admin_Filters_Post object | |
| 25 | + * filters_term => reference to PLL_Admin_filters_Term object | |
| 26 | + * nav_menu => reference to PLL_Admin_Nav_Menu object | |
| 27 | + * block_editor => reference to PLL_Admin_Block_Editor object | |
| 28 | + * classic_editor => reference to PLL_Admin_Classic_Editor object | |
| 29 | + * filters_media => optional, reference to PLL_Admin_Filters_Media object | |
| 30 | + * | |
| 9 | 31 | * @since 1.2 |
| 10 | 32 | */ |
| 11 | 33 | class PLL_Admin extends PLL_Admin_Base { |
| 12 | - /** | |
| 13 | - * @var PLL_Admin_Filters | |
| 14 | - */ | |
| 15 | - public $filters; | |
| 34 | + public $filters, $filters_columns, $filters_post, $filters_term, $nav_menu, $filters_media; | |
| 16 | 35 | |
| 17 | 36 | /** |
| 18 | - * @var PLL_Admin_Filters_Columns | |
| 19 | - */ | |
| 20 | - public $filters_columns; | |
| 21 | - | |
| 22 | - /** | |
| 23 | - * @var PLL_Admin_Filters_Post | |
| 24 | - */ | |
| 25 | - public $filters_post; | |
| 26 | - | |
| 27 | - /** | |
| 28 | - * @var PLL_Admin_Filters_Term | |
| 29 | - */ | |
| 30 | - public $filters_term; | |
| 31 | - | |
| 32 | - /** | |
| 33 | - * @var PLL_Admin_Filters_Media | |
| 34 | - */ | |
| 35 | - public $filters_media; | |
| 36 | - | |
| 37 | - /** | |
| 38 | - * @since 2.9 | |
| 37 | + * Loads the polylang text domain | |
| 38 | + * Setups filters and action needed on all admin pages and on plugins page | |
| 39 | 39 | * |
| 40 | - * @var PLL_Filters_Sanitization | |
| 41 | - */ | |
| 42 | - public $filters_sanitization; | |
| 43 | - | |
| 44 | - /** | |
| 45 | - * @var PLL_Admin_Block_Editor | |
| 46 | - */ | |
| 47 | - public $block_editor; | |
| 48 | - | |
| 49 | - /** | |
| 50 | - * @var PLL_Admin_Classic_Editor | |
| 51 | - */ | |
| 52 | - public $classic_editor; | |
| 53 | - | |
| 54 | - /** | |
| 55 | - * @var PLL_Admin_Nav_Menu | |
| 56 | - */ | |
| 57 | - public $nav_menu; | |
| 58 | - | |
| 59 | - /** | |
| 60 | - * @var PLL_Admin_Filters_Widgets_Options | |
| 61 | - */ | |
| 62 | - public $filters_widgets; | |
| 63 | - | |
| 64 | - /** | |
| 65 | - * Setups filters and action needed on all admin pages and on plugins page. | |
| 66 | - * | |
| 67 | 40 | * @since 1.2 |
| 68 | 41 | * |
| 69 | - * @param PLL_Links_Model $links_model Reference to the links model. | |
| 42 | + * @param object $links_model | |
| 70 | 43 | */ |
| 71 | 44 | public function __construct( &$links_model ) { |
| 72 | 45 | parent::__construct( $links_model ); |
| 73 | 46 | |
| @@ -92,14 +65,14 @@ | ||
| 92 | 65 | } |
| 93 | 66 | } |
| 94 | 67 | |
| 95 | 68 | /** |
| 96 | - * Adds a 'settings' link for our plugin in the plugins list table. | |
| 69 | + * Adds a 'settings' link in the plugins table | |
| 97 | 70 | * |
| 98 | 71 | * @since 0.1 |
| 99 | 72 | * |
| 100 | - * @param string[] $links List of links associated to the plugin. | |
| 101 | - * @return string[] Modified list of links. | |
| 73 | + * @param array $links list of links associated to the plugin | |
| 74 | + * @return array modified list of links | |
| 102 | 75 | */ |
| 103 | 76 | public function plugin_action_links( $links ) { |
| 104 | 77 | array_unshift( $links, '<a href="admin.php?page=mlang">' . __( 'Settings', 'polylang' ) . '</a>' ); |
| 105 | 78 | return $links; |
| @@ -111,9 +84,8 @@ | ||
| 111 | 84 | * @since 1.1.6 |
| 112 | 85 | * |
| 113 | 86 | * @param array $plugin_data Not used |
| 114 | 87 | * @param object $r Plugin update data |
| 115 | - * @return void | |
| 116 | 88 | */ |
| 117 | 89 | public function plugin_update_message( $plugin_data, $r ) { |
| 118 | 90 | if ( isset( $r->upgrade_notice ) ) { |
| 119 | 91 | printf( '<p style="margin: 3px 0 0 0; border-top: 1px solid #ddd; padding-top: 3px">%s</p>', esc_html( $r->upgrade_notice ) ); |
| @@ -124,14 +96,10 @@ | ||
| 124 | 96 | * Setup filters for admin pages |
| 125 | 97 | * |
| 126 | 98 | * @since 1.2 |
| 127 | 99 | * @since 2.7 instantiate a PLL_Bulk_Translate instance. |
| 128 | - * @return void | |
| 129 | 100 | */ |
| 130 | 101 | public function add_filters() { |
| 131 | - $this->filters_sanitization = new PLL_Filters_Sanitization( $this->get_locale_for_sanitization() ); | |
| 132 | - $this->filters_widgets = new PLL_Admin_Filters_Widgets_Options( $this ); | |
| 133 | - | |
| 134 | 102 | // All these are separated just for convenience and maintainability |
| 135 | 103 | $classes = array( 'Filters', 'Filters_Columns', 'Filters_Post', 'Filters_Term', 'Nav_Menu', 'Classic_Editor', 'Block_Editor' ); |
| 136 | 104 | |
| 137 | 105 | // Don't load media filters if option is disabled or if user has no right |
| @@ -151,30 +119,6 @@ | ||
| 151 | 119 | */ |
| 152 | 120 | $class = apply_filters( 'pll_' . $obj, 'PLL_Admin_' . $class ); |
| 153 | 121 | $this->$obj = new $class( $this ); |
| 154 | 122 | } |
| 155 | - } | |
| 156 | - | |
| 157 | - /** | |
| 158 | - * Retrieve the locale according to the current language instead of the language | |
| 159 | - * of the admin interface. | |
| 160 | - * | |
| 161 | - * @since 2.0 | |
| 162 | - * | |
| 163 | - * @return string | |
| 164 | - */ | |
| 165 | - public function get_locale_for_sanitization() { | |
| 166 | - $locale = get_locale(); | |
| 167 | - | |
| 168 | - if ( isset( $_POST['post_lang_choice'] ) && $lang = $this->model->get_language( sanitize_key( $_POST['post_lang_choice'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification | |
| 169 | - $locale = $lang->locale; | |
| 170 | - } elseif ( isset( $_POST['term_lang_choice'] ) && $lang = $this->model->get_language( sanitize_key( $_POST['term_lang_choice'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification | |
| 171 | - $locale = $lang->locale; | |
| 172 | - } elseif ( isset( $_POST['inline_lang_choice'] ) && $lang = $this->model->get_language( sanitize_key( $_POST['inline_lang_choice'] ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification | |
| 173 | - $locale = $lang->locale; | |
| 174 | - } elseif ( ! empty( $this->curlang ) ) { | |
| 175 | - $locale = $this->curlang->locale; | |
| 176 | - } | |
| 177 | - | |
| 178 | - return $locale; | |
| 179 | 123 | } |
| 180 | 124 | } |
