← All changes | include/functions.php +36 -89 2.8.2 → 2.3.6 View file →

		@@ -1,13 +1,9 @@
1	1	<?php
2		-/**
3		- * @package Polylang
4		- */
5	2
6	3	/**
7	4	* Define wordpress.com VIP equivalent of uncached functions
8		- * WordPress backward compatibility functions
9		- * and miscellaneous utility functions
	5	+ * and WordPress backward compatibility functions
10	6	*/
11	7
12	8	if ( ! function_exists( 'wpcom_vip_get_page_by_title' ) ) {
13	9	/**
		@@ -20,118 +16,69 @@
20	16	* @param string|array $post_type Optional. Post type or array of post types. Default 'page'.
21	17	* @return WP_Post|array|null WP_Post (or array) on success, or null on failure.
22	18	*/
23	19	function wpcom_vip_get_page_by_title( $page_title, $output = OBJECT, $post_type = 'page' ) {
24		- return get_page_by_title( $page_title, $output, $post_type ); // phpcs:ignore WordPressVIPMinimum.Functions.RestrictedFunctions.get_page_by_title_get_page_by_title
	20	+ return get_page_by_title( $page_title, $output, $post_type );
25	21	}
26	22	}
27	23
28		-if ( ! function_exists( 'wp_doing_ajax' ) ) {
	24	+if ( ! function_exists( 'wpcom_vip_get_category_by_slug' ) ) {
29	25	/**
30		- * Determines whether the current request is a WordPress Ajax request.
31		- * Backward compatibility function for WP < 4.7
	26	+ * Retrieve category object by category slug.
32	27	*
33		- * @since 2.2
	28	+ * @since 2.0
34	29	*
35		- * @return bool True if it's a WordPress Ajax request, false otherwise.
	30	+ * @param string $slug The category slug.
	31	+ * @return object Category data object
36	32	*/
37		- function wp_doing_ajax() {
38		- /** This filter is documented in wp-includes/load.php */
39		- return apply_filters( 'wp_doing_ajax', defined( 'DOING_AJAX' ) && DOING_AJAX );
	33	+ function wpcom_vip_get_category_by_slug( $slug ) {
	34	+ return get_category_by_slug( $slug );
40	35	}
41	36	}
42	37
43		-if ( ! function_exists( 'wp_doing_cron' ) ) {
	38	+if ( ! function_exists( 'wpcom_vip_get_term_by' ) ) {
44	39	/**
45		- * Determines whether the current request is a WordPress cron request.
46		- * Backward compatibility function for WP < 4.8
	40	+ * Get all Term data from database by Term field and data.
47	41	*
48		- * @since 2.6
	42	+ * @since 2.0
49	43	*
50		- * @return bool True if it's a WordPress cron request, false otherwise.
	44	+ * @param string $field Either 'slug', 'name', 'id' (term_id), or 'term_taxonomy_id'
	45	+ * @param string|int $value Search for this term value
	46	+ * @param string $taxonomy Taxonomy name. Optional, if `$field` is 'term_taxonomy_id'.
	47	+ * @param string $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N. Default OBJECT.
	48	+ * @param string $filter Optional, default is raw or no WordPress defined filter will applied.
	49	+ * @return WP_Term|array|false WP_Term instance (or array) on success. Will return false if `$taxonomy` does not exist or `$term` was not found.
51	50	*/
52		- function wp_doing_cron() {
53		- /** This filter is documented in wp-includes/load.php */
54		- return apply_filters( 'wp_doing_cron', defined( 'DOING_CRON' ) && DOING_CRON );
	51	+ function wpcom_vip_get_term_by( $field, $value, $taxonomy = '', $output = OBJECT, $filter = 'raw' ) {
	52	+ return get_term_by( $field, $value, $taxonomy, $output, $filter );
55	53	}
56	54	}
57	55
58		-if ( ! function_exists( 'wp_using_themes' ) ) {
	56	+if ( ! function_exists( 'wpcom_vip_get_term_link' ) ) {
59	57	/**
60		- * Determines whether the current request should use themes.
61		- * Backward compatibility function for WP < 5.1
	58	+ * Generate a permalink for a taxonomy term archive.
62	59	*
63		- * @since 2.6
	60	+ * @since 2.0
64	61	*
65		- * @return bool True if themes should be used, false otherwise.
	62	+ * @param object|int|string $term The term object, ID, or slug whose link will be retrieved.
	63	+ * @param string $taxonomy Optional. Taxonomy. Default empty.
	64	+ * @return string|WP_Error HTML link to taxonomy term archive on success, WP_Error if term does not exist.
66	65	*/
67		- function wp_using_themes() {
68		- /** This filter is documented in wp-includes/load.php */
69		- return apply_filters( 'wp_using_themes', defined( 'WP_USE_THEMES' ) && WP_USE_THEMES );
	66	+ function wpcom_vip_get_term_link( $term, $taxonomy = '' ) {
	67	+ return get_term_link( $term, $taxonomy );
70	68	}
71	69	}
72	70
73		-/**
74		- * Determines whether we should load the cache compatibility
75		- *
76		- * @since 2.3.8
77		- *
78		- * return bool True if the cache compatibility must be loaded
79		- */
80		-function pll_is_cache_active() {
	71	+if ( ! function_exists( 'wp_doing_ajax' ) ) {
81	72	/**
82		- * Filters whether we should load the cache compatibility
	73	+ * Determines whether the current request is a WordPress Ajax request.
	74	+ * Backward compatibility function for WP < 4.7
83	75	*
84		- * @since 2.3.8
	76	+ * @since 2.2
85	77	*
86		- * @bool $is_cache True if a known cache plugin is active
87		- * incl. WP Fastest Cache which doesn't use WP_CACHE
	78	+ * @return bool True if it's a WordPress Ajax request, false otherwise.
88	79	*/
89		- return apply_filters( 'pll_is_cache_active', ( defined( 'WP_CACHE' ) && WP_CACHE ) || defined( 'WPFC_MAIN_PATH' ) );
90		-}
91		-
92		-/**
93		- * Get the the current requested url
94		- *
95		- * @since 2.6
96		- *
97		- * @return string Requested url
98		- */
99		-function pll_get_requested_url() {
100		- if ( isset( $_SERVER['HTTP_HOST'], $_SERVER['REQUEST_URI'] ) ) {
101		- return set_url_scheme( esc_url_raw( wp_unslash( 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] ) ) );
	80	+ function wp_doing_ajax() {
	81	+ /** This filter is documented in wp-includes/load.php */
	82	+ return apply_filters( 'wp_doing_ajax', defined( 'DOING_AJAX' ) && DOING_AJAX );
102	83	}
103		-
104		- /*
105		- * In WP CLI context, few developers define superglobals in wp-config.php
106		- * as proposed in https://make.wordpress.org/cli/handbook/common-issues/#php-notice-undefined-index-on-_server-superglobal
107		- * So let's return the unfiltered home url to avoid a bunch of notices.
108		- */
109		- if ( defined( 'WP_CLI' ) && WP_CLI ) {
110		- return get_option( 'home' );
111		- }
112		-
113		- if ( WP_DEBUG ) {
114		- // phpcs:ignore WordPress.PHP.DevelopmentFunctions
115		- trigger_error( '$_SERVER[\'HTTP_HOST\'] or $_SERVER[\'REQUEST_URI\'] are required but not set.' );
116		- }
117		-
118		- return '';
119		-}
120		-
121		-/**
122		- * Determines whether we should load the block editor plugin or the legacy languages metabox.
123		- *
124		- * @since 2.6.0
125		- *
126		- * return bool True to use the block editor plugin.
127		- */
128		-function pll_use_block_editor_plugin() {
129		- /**
130		- * Filters whether we should load the block editor plugin or the legacy languages metabox.
131		- *
132		- * @since 2.6.0
133		- *
134		- * @param bool $use_plugin True when loading the block editor plugin.
135		- */
136		- return class_exists( 'PLL_Block_Editor_Plugin' ) && apply_filters( 'pll_use_block_editor_plugin', ! defined( 'PLL_USE_BLOCK_EDITOR_PLUGIN' ) || PLL_USE_BLOCK_EDITOR_PLUGIN );
137	84	}