acfe-screen-functions.php — Advanced Custom Fields: Extended 0.9.2.7

acf-extended / includes / acfe-screen-functions.php

acf-extended / includes Last commit date

acfe-screen-functions.php

204 lines

1	<?php
2
3	if(!defined('ABSPATH')){
4	exit;
5	}
6
7	/**
8	* acfe_is_admin
9	*
10	* Check if current screen is back-end
11	*
12	* @return bool
13	*/
14	function acfe_is_admin(){
15	return !acfe_is_front();
16	}
17
18	/**
19	* acfe_is_front
20	*
21	* Check if current screen is front-end
22	*
23	* @return bool
24	*/
25	function acfe_is_front(){
26	return !is_admin() \|\| (is_admin() && wp_doing_ajax() && (acf_maybe_get_POST('_acf_screen') === 'acfe_form' \|\| acf_maybe_get_POST('_acf_screen') === 'acf_form'));
27	}
28
29
30	/**
31	* acfe_get_acf_screen_id
32	*
33	* Check if the current admin screen is ACF Field Group UI, ACF Tools, ACF Updates screens etc...
34	*
35	* @param string $page
36	*
37	* @return string
38	*/
39	function acfe_get_acf_screen_id($page = ''){
40
41	$prefix = sanitize_title(__("Custom Fields", 'acf'));
42
43	if(empty($page)){
44	return $prefix;
45	}
46
47	return "{$prefix}_page_{$page}";
48
49	}
50
51	/**
52	* acfe_is_admin_screen
53	*
54	* Check if the current admin screen is ACF Field Group UI, ACF tools, ACF Updates screens etc...
55	*
56	* @param false $modules
57	*
58	* @return bool
59	*/
60	function acfe_is_admin_screen($modules = false){
61
62	// global
63	global $field_group;
64
65	// global field group exists
66	if($field_group !== null){
67	return true;
68	}
69
70	// get current_screen
71	if(function_exists('get_current_screen')){
72
73	$screen = get_current_screen();
74
75	if($screen){
76
77	$post_types = array('acf-field-group');
78	$is_category = false;
79
80	// include acfe modules
81	if($modules){
82
83	// reserved post types
84	$post_types = array_merge($post_types, acfe_get_setting('reserved_post_types', array()));
85
86	// field group category
87	$is_category = $screen->post_type === 'post' && $screen->taxonomy === 'acf-field-group-category';
88
89	}
90
91	if(in_array($screen->post_type, $post_types) \|\| $is_category){
92	return true;
93	}
94
95	}
96
97	}
98
99	return false;
100
101	}
102
103	/**
104	* acfe_match_location_rules
105	*
106	* Match screen data against an array of location
107	*
108	* @param $location
109	* @param $screen
110	*
111	* @return bool
112	*/
113	function acfe_match_location_rules($location, $screen){
114
115	// Loop through location groups.
116	foreach($location as $group){
117
118	// ignore group if no rules.
119	if(empty($group)){
120	continue;
121	}
122
123	// Loop over rules and determine if all rules match.
124	$match_group = true;
125
126	foreach($group as $rule){
127
128	if(!acf_match_location_rule($rule, $screen, array())){
129	$match_group = false;
130	break;
131	}
132
133	}
134
135	// Show the field group
136	if($match_group){
137	return true;
138	}
139
140	}
141
142	return false;
143
144	}
145
146	/**
147	* acfe_is_dynamic_preview
148	*
149	* Check if currently in ACFE FlexibleContent Preview or ACF Block Type Preview
150	*
151	* @return bool
152	*/
153	function acfe_is_dynamic_preview(){
154
155	// vars
156	global $is_preview;
157	$return = false;
158
159	// flexible content
160	if(isset($is_preview) && $is_preview){
161
162	$return = true;
163
164	// block type
165	}elseif(wp_doing_ajax() && acf_maybe_get_POST('query')){
166
167	$query = acf_maybe_get_POST('query');
168
169	if(acfe_get($query, 'preview')){
170	$return = true;
171	}
172
173	}
174
175	return apply_filters('acfe/is_preview', $return);
176
177	}
178
179	/**
180	* acfe_is_block_editor
181	*
182	* An enhanced version of acf_is_block_editor that also check if currently in a block type
183	*
184	* @return bool
185	*/
186	function acfe_is_block_editor(){
187
188	// check block editor screen or ajax fetch (block edit mode)
189	return acf_is_block_editor() \|\| acf_maybe_get_POST('action') === 'acf/ajax/fetch-block';
190
191	}
192
193
194	/**
195	* acfe_is_gutenberg
196	*
197	* Check if current screen is block editor
198	*
199	* @return bool
200	* @deprecated
201	*/
202	function acfe_is_gutenberg(){
203	return acfe_is_block_editor();
204	}