/**
* The class constructor.
*
* @var string the setting ID.
* @var string theme_mod / option
* @var array an array of arrays of the output arguments.
* @var mixed a callable function.
*/
public static function css($field)
{
/**
* Make sure the field is sanitized before proceeding any further.
*/
$field_sanitized = Kirki_Field_Sanitize::sanitize_field($field);
/**
* Set class vars
*/
self::$settings = $field_sanitized['settings'];
self::$callback = $field_sanitized['sanitize_callback'];
self::$field_type = $field_sanitized['type'];
self::$output = $field_sanitized['output'];
if (!is_array(self::$output)) {
self::$output = array(array('element' => self::$output, 'sanitize_callback' => null));
}
/**
* Get the value of this field
*/
self::$value = Kirki_Values::get_sanitized_field_value($field_sanitized);
/**
* Returns the styles
*/
return self::styles();
}
public function test_sanitize_active_callback()
{
$field = Kirki_Field_Sanitize::sanitize_field(array('active_callback' => '__return_true'));
$this->assertEquals('__return_true', $field['active_callback']);
$field = Kirki_Field_Sanitize::sanitize_field(array());
$this->assertEquals('__return_true', $field['active_callback']);
$field = Kirki_Field_Sanitize::sanitize_field(array('required' => array()));
$this->assertEquals(array('Kirki_Active_Callback', 'evaluate'), $field['active_callback']);
}
/**
* Build the background fields.
* Takes a single field with type = background and explodes it to multiple controls.
*
* @param array
* @return null|array
*/
public static function explode($field)
{
$i18n = Kirki_Toolkit::i18n();
$choices = self::background_choices();
// Early exit if this is not a background field.
if ('background' != $field['type']) {
return;
}
// Sanitize field
$field = Kirki_Field_Sanitize::sanitize_field($field);
// No need to proceed any further if no defaults have been set.
// We build the array of fields based on what default values have been defined.
if (!isset($field['default']) || !is_array($field['default'])) {
return;
}
$fields = array();
$i = 0;
foreach ($field['default'] as $key => $value) {
// No need to process the opacity, it is factored in the color control.
if ('opacity' == $key) {
continue;
}
$key = esc_attr($key);
$setting = $key;
$help = $field['help'];
$description = isset($i18n['background-' . $key]) ? $i18n['background-' . $key] : '';
$output_property = 'background-' . $key;
$label = 0 === $i ? $field['label'] : '';
$type = 'select';
$sanitize_callback = 'esc_attr';
switch ($key) {
case 'color':
/**
* Use 'color-alpha' instead of 'color' if default is an rgba value
* or if 'opacity' is set.
*/
$type = false !== strpos($field['default']['color'], 'rgba') ? 'color-alpha' : 'color';
$type = isset($field['default']['opacity']) ? 'color-alpha' : $type;
if (isset($field['default']['opacity']) && false === strpos($value, 'rgb')) {
$value = Kirki_Color::get_rgba($value, $field['default']['opacity']);
}
$sanitize_callback = array('Kirki_Sanitize_Values', 'color');
break;
case 'image':
$type = 'image';
$sanitize_callback = 'esc_url_raw';
break;
case 'attach':
/**
* Small hack so that background attachments properly work.
*/
$output_property = 'background-attachment';
$description = $i18n['background-attachment'];
break;
default:
$help = '';
break;
}
/**
* If we're using options & option_name is set, then we need to modify the setting.
*/
if (isset($field['option_type']) && 'option' == $field['option_type'] && isset($field['option_name']) && !empty($field['option_name'])) {
$property_setting = str_replace(']', '', str_replace($field['option_name'] . '[', '', $field['settings']));
$property_setting = esc_attr($field['option_name']) . '[' . esc_attr($property_setting) . '_' . $setting . ']';
} else {
$property_setting = esc_attr($field['settings']) . '_' . $setting;
}
/**
* Build the field.
* We're merging with the original field here, so any extra properties are inherited.
*/
$fields[$property_setting] = array_merge($field, array('type' => $type, 'label' => $label, 'settings' => $property_setting, 'help' => $help, 'section' => $field['section'], 'priority' => $field['priority'], 'required' => $field['required'], 'description' => $description, 'default' => $value, 'id' => Kirki_Field_Sanitize::sanitize_id(array('settings' => $field['settings'] . '_' . $setting)), 'choices' => isset($choices[$key]) ? $choices[$key] : array(), 'output' => '' != $field['output'] ? array(array('element' => $field['output'], 'property' => $output_property)) : '', 'sanitize_callback' => isset($sanitize_callback) ? $sanitize_callback : Kirki_Field_Sanitize::fallback_callback($type)));
$i++;
}
return $fields;
}
/**
* Add the control.
*
* @param $arg array
* @return void
*/
public function add_control($args)
{
$control_class_name = self::control_class_name($args);
$this->wp_customize->add_control(new $control_class_name($this->wp_customize, Kirki_Field_Sanitize::sanitize_id($args), Kirki_Field_Sanitize::sanitize_field($args)));
}
public function google_link()
{
/**
* Get the array of fields from the Kirki object.
*/
$fields = Kirki::$fields;
/**
* Early exit if no fields are found.
*/
if (empty($fields)) {
return;
}
$fonts = array();
/**
* Run a loop for our fields
*/
foreach ($fields as $field) {
/**
* Sanitize the field
*/
$field = Kirki_Field_Sanitize::sanitize_field($field);
/**
* No reason to proceed any further if no 'output' has been defined
* or if it's not defined as an array.
*/
if (!isset($field['output']) || !is_array($field['output'])) {
continue;
}
/**
* Run through each of our "output" items in the array separately.
*/
foreach ($field['output'] as $output) {
$valid = false;
/**
* If the field-type exists and is set to "typography"
* then we need some extra checks to figure out if we need to proceed.
*/
if (isset($field['type']) && 'typography' == $field['type']) {
if (isset($field['choices']) && isset($field['choices']['font-family']) && $field['choices']['font-family']) {
$valid = true;
}
}
/**
* Check if the "property" of this item is related to typography.
*/
if (isset($output['property']) && in_array($output['property'], array('font-family', 'font-weight', 'font-subset'))) {
$valid = true;
}
/**
* If the $valid var is not true, then we don't need to proceed.
* Continue to the next item in the array.
*/
if (!$valid) {
continue;
}
/**
* Get the value of this field
*/
$value = Kirki_Values::get_sanitized_field_value($field);
/**
* Typography fields arew a bit more complex than usual fields.
* We need to get the sub-items of the array
* and then base our calculations on these.
*/
if ('typography' == $field['type']) {
/**
* Add the font-family to the array
*/
if (isset($value['font-family'])) {
$fonts[]['font-family'] = $value['font-family'];
}
/**
* Add the font-weight to the array
*/
if (isset($value['font-weight'])) {
$fonts[]['font-weight'] = $value['font-weight'];
}
} else {
if ('font-family' == $output['property']) {
/**
* Add the font-family to the array
*/
$fonts[]['font-family'] = $value;
} else {
if ('font-weight' == $output['property']) {
/**
* Add font-weight to the array
*/
$fonts[]['font-weight'] = $value;
} else {
if ('font-subset' == $output['property']) {
/**
* add font subsets to the array
*/
$fonts[]['subsets'] = $value;
}
}
}
}
}
}
/**
* Start going through all the items in the $fonts array.
*/
foreach ($fonts as $font) {
/**
* Do we have font-families?
*/
if (isset($font['font-family'])) {
$font_families = !isset($font_families) ? array() : $font_families;
$font_families[] = $font['font-family'];
/**
* Determine if we need to create a google-fonts link or not.
*/
if (!isset($has_google_font)) {
if (Kirki_Toolkit::fonts()->is_google_font($font['font-family'])) {
$has_google_font = true;
}
}
}
/**
* Do we have font-weights?
*/
if (isset($font['font-weight'])) {
$font_weights = !isset($font_weights) ? array() : $font_weights;
$font_weights[] = $font['font-weight'];
}
/**
* Do we have font-subsets?
*/
if (isset($font['subsets'])) {
$font_subsets = !isset($font_subsets) ? array() : $font_subsets;
$font_subsets[] = $font['subsets'];
}
}
/**
* Make sure there are no empty values and define some sane defaults.
*/
$font_families = !isset($font_families) || empty($font_families) ? false : $font_families;
$font_weights = !isset($font_weights) || empty($font_weights) ? array('400') : $font_weights;
$font_subsets = !isset($font_subsets) || empty($font_subsets) ? array('all') : $font_subsets;
/**
* Get rid of duplicate values
*/
if (is_array($font_families) && !empty($font_families)) {
$font_families = array_unique($font_families);
}
if (is_array($font_weights) && !empty($font_weights)) {
$font_weights = array_unique($font_weights);
}
if (is_array($font_subsets) && !empty($font_subsets)) {
$font_subsets = array_unique($font_subsets);
}
if (!isset($has_google_font) || !$has_google_font) {
$font_families = false;
}
// Return the font URL.
return $font_families ? Kirki_Toolkit::fonts()->get_google_font_uri($font_families, $font_weights, $font_subsets) : false;
}