Completed
Push — develop ( eaa7fe...6d8077 )
by Aristeides
02:01
created

Kirki_Helper::get_terms()   A

Complexity

Conditions 2
Paths 2

Size

Total Lines 15
Code Lines 6

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 2
eloc 6
nc 2
nop 1
dl 0
loc 15
rs 9.4285
c 0
b 0
f 0
1
<?php
2
/**
3
 * Helper methods
4
 *
5
 * @package     Kirki
6
 * @category    Core
7
 * @author      Aristeides Stathopoulos
8
 * @copyright   Copyright (c) 2017, Aristeides Stathopoulos
9
 * @license     http://opensource.org/licenses/https://opensource.org/licenses/MIT
10
 * @since       1.0
11
 */
12
13
// Exit if accessed directly.
14
if ( ! defined( 'ABSPATH' ) ) {
15
	exit;
16
}
17
18
/**
19
 * A simple object containing static methods.
20
 */
21
class Kirki_Helper {
22
23
	/**
24
	 * Recursive replace in arrays.
25
	 *
26
	 * @static
27
	 * @access public
28
	 * @param array $array The first array.
29
	 * @param array $array1 The second array.
30
	 * @return mixed
31
	 */
32
	public static function array_replace_recursive( $array, $array1 ) {
33
		if ( function_exists( 'array_replace_recursive' ) ) {
34
			return array_replace_recursive( $array, $array1 );
35
		}
36
37
		// Handle the arguments, merge one by one.
38
		$args  = func_get_args();
39
		$array = $args[0];
40
		if ( ! is_array( $array ) ) {
41
			return $array;
42
		}
43
		$count = count( $args );
44
		for ( $i = 1; $i < $count; $i++ ) {
45
			if ( is_array( $args[ $i ] ) ) {
46
				$array = self::recurse( $array, $args[ $i ] );
47
			}
48
		}
49
		return $array;
50
	}
51
52
	/**
53
	 * Helper method to be used from the array_replace_recursive method.
54
	 *
55
	 * @static
56
	 * @access public
57
	 * @param array $array The first array.
58
	 * @param array $array1 The second array.
59
	 * @return array
60
	 */
61
	public static function recurse( $array, $array1 ) {
62
		foreach ( $array1 as $key => $value ) {
63
			// Create new key in $array, if it is empty or not an array.
64
			if ( ! isset( $array[ $key ] ) || ( isset( $array[ $key ] ) && ! is_array( $array[ $key ] ) ) ) {
65
				$array[ $key ] = array();
66
			}
67
68
			// Overwrite the value in the base array.
69
			if ( is_array( $value ) ) {
70
				$value = self::recurse( $array[ $key ], $value );
71
			}
72
			$array[ $key ] = $value;
73
		}
74
		return $array;
75
	}
76
77
	/**
78
	 * Initialize the WP_Filesystem
79
	 */
80
	public static function init_filesystem() {
81
		global $wp_filesystem;
82
		if ( empty( $wp_filesystem ) ) {
83
			require_once( ABSPATH . '/wp-admin/includes/file.php' );
84
			WP_Filesystem();
85
		}
86
	}
87
88
	/**
89
	 * Returns the attachment object
90
	 *
91
	 * @static
92
	 * @access public
93
	 * @see https://pippinsplugins.com/retrieve-attachment-id-from-image-url/
94
	 * @param string $url URL to the image.
95
	 * @return int|string Numeric ID of the attachement.
96
	 */
97
	public static function get_image_id( $url ) {
98
		global $wpdb;
99
		if ( empty( $url ) ) {
100
			return 0;
101
		}
102
103
		$attachment = wp_cache_get( 'kirki_image_id_' . md5( $url ), null );
104
		if ( false === $attachment ) {
105
			$attachment = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE guid = %s;", $url ) );
106
			wp_cache_add( 'kirki_image_id_' . md5( $url ), $attachment, null );
107
		}
108
109
		if ( ! empty( $attachment ) ) {
110
			return $attachment[0];
111
		}
112
		return 0;
113
	}
114
115
	/**
116
	 * Returns an array of the attachment's properties.
117
	 *
118
	 * @param string $url URL to the image.
119
	 * @return array
120
	 */
121
	public static function get_image_from_url( $url ) {
122
123
		$image_id = self::get_image_id( $url );
124
		$image    = wp_get_attachment_image_src( $image_id, 'full' );
125
126
		return array(
127
			'url'       => $image[0],
128
			'width'     => $image[1],
129
			'height'    => $image[2],
130
			'thumbnail' => $image[3],
131
		);
132
133
	}
134
135
	/**
136
	 * Get an array of posts.
137
	 *
138
	 * @static
139
	 * @access public
140
	 * @param array $args Define arguments for the get_posts function.
141
	 * @return array
142
	 */
143
	public static function get_posts( $args ) {
144
145
		if ( is_string( $args ) ) {
146
			$args = add_query_arg(
147
				array(
148
					'suppress_filters' => false,
149
				)
150
			);
151
		} elseif ( is_array( $args ) && ! isset( $args['suppress_filters'] ) ) {
152
			$args['suppress_filters'] = false;
153
		}
154
155
		// Get the posts.
156
		$posts = get_posts( $args );
157
158
		// Properly format the array.
159
		$items = array();
160
		foreach ( $posts as $post ) {
161
			$items[ $post->ID ] = $post->post_title;
162
		}
163
		wp_reset_postdata();
164
165
		return $items;
166
167
	}
168
169
	/**
170
	 * Get an array of publicly-querable taxonomies.
171
	 *
172
	 * @static
173
	 * @access public
174
	 * @return array
175
	 */
176
	public static function get_taxonomies() {
177
178
		$items = array();
179
180
		// Get the taxonomies.
181
		$taxonomies = get_taxonomies(
182
			array(
183
				'public' => true,
184
			)
185
		);
186
187
		// Build the array.
188
		foreach ( $taxonomies as $taxonomy ) {
189
			$id           = $taxonomy;
190
			$taxonomy     = get_taxonomy( $taxonomy );
191
			$items[ $id ] = $taxonomy->labels->name;
192
		}
193
194
		return $items;
195
196
	}
197
198
	/**
199
	 * Get an array of publicly-querable post-types.
200
	 *
201
	 * @static
202
	 * @access public
203
	 * @return array
204
	 */
205
	public static function get_post_types() {
206
207
		$items = array();
208
209
		// Get the post types.
210
		$post_types = get_post_types(
211
			array(
212
				'public' => true,
213
			), 'objects'
214
		);
215
216
		// Build the array.
217
		foreach ( $post_types as $post_type ) {
218
			$items[ $post_type->name ] = $post_type->labels->name;
219
		}
220
221
		return $items;
222
223
	}
224
225
	/**
226
	 * Get an array of terms from a taxonomy
227
	 *
228
	 * @static
229
	 * @access public
230
	 * @param string|array $taxonomies See https://developer.wordpress.org/reference/functions/get_terms/ for details.
231
	 * @return array
232
	 */
233
	public static function get_terms( $taxonomies ) {
234
235
		$items = array();
236
237
		// Get the post types.
238
		$terms = get_terms( $taxonomies );
239
240
		// Build the array.
241
		foreach ( $terms as $term ) {
242
			$items[ $term->term_id ] = $term->name;
243
		}
244
245
		return $items;
246
247
	}
248
249
	/**
250
	 * Gets an array of material-design colors.
251
	 *
252
	 * @static
253
	 * @access public
254
	 * @param string $context Allows us to get subsets of the palette.
255
	 * @return array
256
	 */
257
	public static function get_material_design_colors( $context = 'primary' ) {
258
259
		$colors = array(
260
			'primary'     => array( '#FFFFFF', '#000000', '#F44336', '#E91E63', '#9C27B0', '#673AB7', '#3F51B5', '#2196F3', '#03A9F4', '#00BCD4', '#009688', '#4CAF50', '#8BC34A', '#CDDC39', '#FFEB3B', '#FFC107', '#FF9800', '#FF5722', '#795548', '#9E9E9E', '#607D8B' ),
261
			'red'         => array( '#FFEBEE', '#FFCDD2', '#EF9A9A', '#E57373', '#EF5350', '#F44336', '#E53935', '#D32F2F', '#C62828', '#B71C1C', '#FF8A80', '#FF5252', '#FF1744', '#D50000' ),
262
			'pink'        => array( '#FCE4EC', '#F8BBD0', '#F48FB1', '#F06292', '#EC407A', '#E91E63', '#D81B60', '#C2185B', '#AD1457', '#880E4F', '#FF80AB', '#FF4081', '#F50057', '#C51162' ),
263
			'purple'      => array( '#F3E5F5', '#E1BEE7', '#CE93D8', '#BA68C8', '#AB47BC', '#9C27B0', '#8E24AA', '#7B1FA2', '#6A1B9A', '#4A148C', '#EA80FC', '#E040FB', '#D500F9', '#AA00FF' ),
264
			'deep-purple' => array( '#EDE7F6', '#D1C4E9', '#B39DDB', '#9575CD', '#7E57C2', '#673AB7', '#5E35B1', '#512DA8', '#4527A0', '#311B92', '#B388FF', '#7C4DFF', '#651FFF', '#6200EA' ),
265
			'indigo'      => array( '#E8EAF6', '#C5CAE9', '#9FA8DA', '#7986CB', '#5C6BC0', '#3F51B5', '#3949AB', '#303F9F', '#283593', '#1A237E', '#8C9EFF', '#536DFE', '#3D5AFE', '#304FFE' ),
266
			'blue'        => array( '#E3F2FD', '#BBDEFB', '#90CAF9', '#64B5F6', '#42A5F5', '#2196F3', '#1E88E5', '#1976D2', '#1565C0', '#0D47A1', '#82B1FF', '#448AFF', '#2979FF', '#2962FF' ),
267
			'light_blue'  => array( '#E1F5FE', '#B3E5FC', '#81D4fA', '#4fC3F7', '#29B6FC', '#03A9F4', '#039BE5', '#0288D1', '#0277BD', '#01579B', '#80D8FF', '#40C4FF', '#00B0FF', '#0091EA' ),
268
			'cyan'        => array( '#E0F7FA', '#B2EBF2', '#80DEEA', '#4DD0E1', '#26C6DA', '#00BCD4', '#00ACC1', '#0097A7', '#00838F', '#006064', '#84FFFF', '#18FFFF', '#00E5FF', '#00B8D4' ),
269
			'teal'        => array( '#E0F2F1', '#B2DFDB', '#80CBC4', '#4DB6AC', '#26A69A', '#009688', '#00897B', '#00796B', '#00695C', '#004D40', '#A7FFEB', '#64FFDA', '#1DE9B6', '#00BFA5' ),
270
			'green'       => array( '#E8F5E9', '#C8E6C9', '#A5D6A7', '#81C784', '#66BB6A', '#4CAF50', '#43A047', '#388E3C', '#2E7D32', '#1B5E20', '#B9F6CA', '#69F0AE', '#00E676', '#00C853' ),
271
			'light-green' => array( '#F1F8E9', '#DCEDC8', '#C5E1A5', '#AED581', '#9CCC65', '#8BC34A', '#7CB342', '#689F38', '#558B2F', '#33691E', '#CCFF90', '#B2FF59', '#76FF03', '#64DD17' ),
272
			'lime'        => array( '#F9FBE7', '#F0F4C3', '#E6EE9C', '#DCE775', '#D4E157', '#CDDC39', '#C0CA33', '#A4B42B', '#9E9D24', '#827717', '#F4FF81', '#EEFF41', '#C6FF00', '#AEEA00' ),
273
			'yellow'      => array( '#FFFDE7', '#FFF9C4', '#FFF590', '#FFF176', '#FFEE58', '#FFEB3B', '#FDD835', '#FBC02D', '#F9A825', '#F57F17', '#FFFF82', '#FFFF00', '#FFEA00', '#FFD600' ),
274
			'amber'       => array( '#FFF8E1', '#FFECB3', '#FFE082', '#FFD54F', '#FFCA28', '#FFC107', '#FFB300', '#FFA000', '#FF8F00', '#FF6F00', '#FFE57F', '#FFD740', '#FFC400', '#FFAB00' ),
275
			'orange'      => array( '#FFF3E0', '#FFE0B2', '#FFCC80', '#FFB74D', '#FFA726', '#FF9800', '#FB8C00', '#F57C00', '#EF6C00', '#E65100', '#FFD180', '#FFAB40', '#FF9100', '#FF6D00' ),
276
			'deep-orange' => array( '#FBE9A7', '#FFCCBC', '#FFAB91', '#FF8A65', '#FF7043', '#FF5722', '#F4511E', '#E64A19', '#D84315', '#BF360C', '#FF9E80', '#FF6E40', '#FF3D00', '#DD2600' ),
277
			'brown'       => array( '#EFEBE9', '#D7CCC8', '#BCAAA4', '#A1887F', '#8D6E63', '#795548', '#6D4C41', '#5D4037', '#4E342E', '#3E2723' ),
278
			'grey'        => array( '#FAFAFA', '#F5F5F5', '#EEEEEE', '#E0E0E0', '#BDBDBD', '#9E9E9E', '#757575', '#616161', '#424242', '#212121', '#000000', '#ffffff' ),
279
			'blue-grey'   => array( '#ECEFF1', '#CFD8DC', '#B0BBC5', '#90A4AE', '#78909C', '#607D8B', '#546E7A', '#455A64', '#37474F', '#263238' ),
280
		);
281
282
		switch ( $context ) {
283
284
			case '50':
285
			case '100':
286
			case '200':
287
			case '300':
288
			case '400':
289
			case '500':
290
			case '600':
291
			case '700':
292
			case '800':
293
			case '900':
294
			case 'A100':
295
			case 'A200':
296
			case 'A400':
297
			case 'A700':
298
				$key = absint( $context ) / 100;
299
				if ( 'A100' === $context ) {
300
					$key = 10;
301
					unset( $colors['grey'] );
302
				} elseif ( 'A200' === $context ) {
303
					$key = 11;
304
					unset( $colors['grey'] );
305
				} elseif ( 'A400' === $context ) {
306
					$key = 12;
307
					unset( $colors['grey'] );
308
				} elseif ( 'A700' === $context ) {
309
					$key = 13;
310
					unset( $colors['grey'] );
311
				}
312
				unset( $colors['primary'] );
313
				$position_colors = array();
314
				foreach ( $colors as $color_family ) {
315
					if ( isset( $color_family[ $key ] ) ) {
316
						$position_colors[] = $color_family[ $key ];
317
					}
318
				}
319
				return $position_colors;
320
			case 'all':
321
				unset( $colors['primary'] );
322
				$all_colors = array();
323
				foreach ( $colors as $color_family ) {
324
					foreach ( $color_family as $color ) {
325
						$all_colors[] = $color;
326
					}
327
				}
328
				return $all_colors;
329
			case 'primary':
330
				return $colors['primary'];
331
			default:
332
				if ( isset( $colors[ $context ] ) ) {
333
					return $colors[ $context ];
334
				}
335
				return $colors['primary'];
336
		} // End switch().
337
	}
338
339
	/**
340
	 * Get an array of all available dashicons.
341
	 *
342
	 * @static
343
	 * @access public
344
	 * @return array
345
	 */
346
	public static function get_dashicons() {
347
348
		return array(
349
			'admin-menu'     => array( 'menu', 'admin-site', 'dashboard', 'admin-post', 'admin-media', 'admin-links', 'admin-page', 'admin-comments', 'admin-appearance', 'admin-plugins', 'admin-users', 'admin-tools', 'admin-settings', 'admin-network', 'admin-home', 'admin-generic', 'admin-collapse', 'filter', 'admin-customizer', 'admin-multisite' ),
350
			'welcome-screen' => array( 'welcome-write-blog', 'welcome-add-page', 'welcome-view-site', 'welcome-widgets-menus', 'welcome-comments', 'welcome-learn-more' ),
351
			'post-formats'   => array( 'format-aside', 'format-image', 'format-gallery', 'format-video', 'format-status', 'format-quote', 'format-chat', 'format-audio', 'camera', 'images-alt', 'images-alt2', 'video-alt', 'video-alt2', 'video-alt3' ),
352
			'media'          => array( 'media-archive', 'media-audio', 'media-code', 'media-default', 'media-document', 'media-interactive', 'media-spreadsheet', 'media-text', 'media-video', 'playlist-audio', 'playlist-video', 'controls-play', 'controls-pause', 'controls-forward', 'controls-skipforward', 'controls-back', 'controls-skipback', 'controls-repeat', 'controls-volumeon', 'controls-volumeoff' ),
353
			'image-editing'  => array( 'image-crop', 'image-rotate', 'image-rotate-left', 'image-rotate-right', 'image-flip-vertical', 'image-flip-horizontal', 'image-filter', 'undo', 'redo' ),
354
			'tinymce'        => array( 'editor-bold', 'editor-italic', 'editor-ul', 'editor-ol', 'editor-quote', 'editor-alignleft', 'editor-aligncenter', 'editor-alignright', 'editor-insertmore', 'editor-spellcheck', 'editor-expand', 'editor-contract', 'editor-kitchensink', 'editor-underline', 'editor-justify', 'editor-textcolor', 'editor-paste-word', 'editor-paste-text', 'editor-removeformatting', 'editor-video', 'editor-customchar', 'editor-outdent', 'editor-indent', 'editor-help', 'editor-strikethrough', 'editor-unlink', 'editor-rtl', 'editor-break', 'editor-code', 'editor-paragraph', 'editor-table' ),
355
			'posts'          => array( 'align-left', 'align-right', 'align-center', 'align-none', 'lock', 'unlock', 'calendar', 'calendar-alt', 'visibility', 'hidden', 'post-status', 'edit', 'trash', 'sticky' ),
356
			'sorting'        => array( 'external', 'arrow-up', 'arrow-down', 'arrow-right', 'arrow-left', 'arrow-up-alt', 'arrow-down-alt', 'arrow-right-alt', 'arrow-left-alt', 'arrow-up-alt2', 'arrow-down-alt2', 'arrow-right-alt2', 'arrow-left-alt2', 'sort', 'leftright', 'randomize', 'list-view', 'exerpt-view', 'grid-view' ),
357
			'social'         => array( 'share', 'share-alt', 'share-alt2', 'twitter', 'rss', 'email', 'email-alt', 'facebook', 'facebook-alt', 'googleplus', 'networking' ),
358
			'wordpress_org'  => array( 'hammer', 'art', 'migrate', 'performance', 'universal-access', 'universal-access-alt', 'tickets', 'nametag', 'clipboard', 'heart', 'megaphone', 'schedule' ),
359
			'products'       => array( 'wordpress', 'wordpress-alt', 'pressthis', 'update', 'screenoptions', 'info', 'cart', 'feedback', 'cloud', 'translation' ),
360
			'taxonomies'     => array( 'tag', 'category' ),
361
			'widgets'        => array( 'archive', 'tagcloud', 'text' ),
362
			'notifications'  => array( 'yes', 'no', 'no-alt', 'plus', 'plus-alt', 'minus', 'dismiss', 'marker', 'star-filled', 'star-half', 'star-empty', 'flag', 'warning' ),
363
			'misc'           => array( 'location', 'location-alt', 'vault', 'shield', 'shield-alt', 'sos', 'search', 'slides', 'analytics', 'chart-pie', 'chart-bar', 'chart-line', 'chart-area', 'groups', 'businessman', 'id', 'id-alt', 'products', 'awards', 'forms', 'testimonial', 'portfolio', 'book', 'book-alt', 'download', 'upload', 'backup', 'clock', 'lightbulb', 'microphone', 'desktop', 'tablet', 'smartphone', 'phone', 'index-card', 'carrot', 'building', 'store', 'album', 'palmtree', 'tickets-alt', 'money', 'smiley', 'thumbs-up', 'thumbs-down', 'layout' ),
364
		);
365
366
	}
367
}
368