← All changes | include/functions.php +53 -58 2.9 → 2.5 View file →

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