powerkit / core / core-powerkit-api.php

core-powerkit-api.php in Powerkit – Supercharge your WordPress Site 3.1.1, at core/core-powerkit-api.php

140 lines 2.8 KB

Raw Download Zip

1	<?php
2	/**
3	* The api functions for the plugin
4	*
5	* @package Powerkit
6	* @subpackage Core
7	* @version 1.0.0
8	* @since 1.0.0
9	*/
10
11	// Exit if accessed directly.
12	if ( ! defined( 'ABSPATH' ) ) {
13	exit;
14	}
15
16	/**
17	* This function will return true for a non empty array
18	*
19	* @param array $array Array.
20	*/
21	function powerkit_is_array( $array ) {
22	return ( is_array( $array ) && ! empty( $array ) );
23	}
24
25	/**
26	* This function will return true for an empty var (allows 0 as true)
27	*
28	* @param mixed $value Value.
29	*/
30	function powerkit_is_empty( $value ) {
31	return ( empty( $value ) && ! is_numeric( $value ) );
32	}
33
34	/**
35	* Alias of powerkit()->has_setting()
36	*
37	* @param string $name The name.
38	*/
39	function powerkit_has_setting( $name = '' ) {
40	return powerkit()->has_setting( $name );
41	}
42
43	/**
44	* Alias of powerkit()->get_setting()
45	*
46	* @param string $name The name.
47	*/
48	function powerkit_raw_setting( $name = '' ) {
49	return powerkit()->get_setting( $name );
50	}
51
52	/**
53	* Alias of powerkit()->update_setting()
54	*
55	* @param string $name The name.
56	* @param mixed $value The value.
57	*/
58	function powerkit_update_setting( $name, $value ) {
59
60	return powerkit()->update_setting( $name, $value );
61	}
62
63	/**
64	* Alias of powerkit()->get_setting()
65	*
66	* @param string $name The name.
67	* @param mixed $value The value.
68	*/
69	function powerkit_get_setting( $name, $value = null ) {
70
71	// Check settings.
72	if ( powerkit_has_setting( $name ) ) {
73	$value = powerkit_raw_setting( $name );
74	}
75
76	// Filter.
77	$value = apply_filters( "powerkit_settings_{$name}", $value );
78
79	return $value;
80	}
81
82	/**
83	* This function will add a value into the settings array found in the acf object
84	*
85	* @param string $name The name.
86	* @param mixed $value The value.
87	*/
88	function powerkit_append_setting( $name, $value ) {
89
90	// Vars.
91	$setting = powerkit_raw_setting( $name );
92
93	// Bail ealry if not array.
94	if ( ! is_array( $setting ) ) {
95	$setting = array();
96	}
97
98	// Append.
99	$setting[] = $value;
100
101	// Update.
102	return powerkit_update_setting( $name, $setting );
103	}
104
105	/**
106	* Returns data.
107	*
108	* @param string $name The name.
109	*/
110	function powerkit_get_data( $name ) {
111	return powerkit()->get_data( $name );
112	}
113
114	/**
115	* Sets data.
116	*
117	* @param string $name The name.
118	* @param mixed $value The value.
119	*/
120	function powerkit_set_data( $name, $value ) {
121	return powerkit()->set_data( $name, $value );
122	}
123
124	/**
125	* Retrieves the translation of $text and escapes it for safe use in HTML output.
126	*
127	* If there is no translation, or the text domain isn't loaded, the original text
128	* is escaped and returned.
129	*
130	* @since 2.8.0
131	*
132	* @param string $text Text to translate.
133	* @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
134	* Default 'default'.
135	* @return string Translated text.
136	*/
137	function powerkit_esc_html__( $text, $domain = 'default' ) {
138	return esc_html( $text );
139	}
140