';
}
}
/** Starts a new tab; the fields that follow belong to it. Top level only. */
class CFStudio_Field_Tab extends CFStudio_Field_Layout_Base {
public static $type = 'tab';
public static $label = 'Tab';
public static function has_wrapper() {
return false;
}
public static function render_settings( $field, $prefix ) {
?>
';
}
}
/** A collapsible section; the fields that follow are inside it. */
class CFStudio_Field_Accordion extends CFStudio_Field_Layout_Base {
public static $type = 'accordion';
public static $label = 'Accordion';
public static function has_wrapper() {
return false;
}
public static function defaults() {
return array( 'open' => 0 );
}
public static function render_settings( $field, $prefix ) {
self::setting_checkbox( 'accordion', $prefix, 'open', __( 'Open by default', 'fieldloom' ), $field );
?>
! empty( $raw['open'] ) ? 1 : 0 );
}
public static function render_input( $field, $value, $name ) {
printf(
'',
esc_attr( $field['label'] ?? '' ),
empty( $field['open'] ) ? 0 : 1
);
}
}
/**
* Group: sub fields stored one level down, e.g.
* hero_title / hero_image (+ _hero_title references), and `hero` = ''.
*/
class CFStudio_Field_Group_Field extends CFStudio_Field_Base {
public static $type = 'group';
public static $label = 'Group';
public static function defaults() {
return array(
'layout' => 'block',
'sub_fields' => array(),
);
}
public static function render_settings( $field, $prefix ) {
self::setting_select(
'group',
$prefix,
'layout',
__( 'Layout', 'fieldloom' ),
$field,
array(
'block' => __( 'Block (sub fields stacked)', 'fieldloom' ),
'row' => __( 'Row (sub fields side by side)', 'fieldloom' ),
),
'block'
);
// The Sub Fields editor is shared with Repeater (see its render_settings()).
}
public static function sanitize( $raw ) {
return array(
'layout' => self::pick( $raw, 'layout', array( 'block', 'row' ), 'block' ),
'sub_fields' => CFStudio_Field_Group::sanitize_fields( $raw['sub_fields'] ?? array() ),
);
}
protected static function sub_key( $key, $sub_field ) {
return $key . '_' . $sub_field['name'];
}
protected static function usable_sub_fields( $field ) {
$usable = array();
foreach ( (array) ( $field['sub_fields'] ?? array() ) as $sub_field ) {
if ( empty( $sub_field['name'] ) || empty( $sub_field['type'] ) ) {
continue;
}
$class = CFStudio_Field_Registry::get_class( $sub_field['type'] );
if ( $class && $class::stores_value() ) {
$usable[] = array(
'field' => $sub_field,
'class' => $class,
);
}
}
return $usable;
}
/** null when this group has never been saved (so sub fields show defaults). */
public static function load_value( $field, $ctx, $key = null ) {
$key = ( null === $key ) ? $field['name'] : $key;
if ( ! CFStudio_Storage::exists( '_' . $key, $ctx ) ) {
return null;
}
$out = array();
foreach ( self::usable_sub_fields( $field ) as $sub ) {
$out[ $sub['field']['name'] ] = $sub['class']::load_value( $sub['field'], $ctx, self::sub_key( $key, $sub['field'] ) );
}
return $out;
}
public static function save_value( $field, $raw_posted, $ctx, $key = null ) {
$key = ( null === $key ) ? $field['name'] : $key;
$raw = is_array( $raw_posted ) ? $raw_posted : array();
foreach ( self::usable_sub_fields( $field ) as $sub ) {
$sub['class']::save_value( $sub['field'], $raw[ $sub['field']['name'] ] ?? '', $ctx, self::sub_key( $key, $sub['field'] ) );
}
CFStudio_Storage::update( $key, '', $ctx );
CFStudio_Storage::update( '_' . $key, $field['key'], $ctx );
}
public static function delete_value( $field, $ctx, $key = null ) {
$key = ( null === $key ) ? $field['name'] : $key;
foreach ( self::usable_sub_fields( $field ) as $sub ) {
$sub['class']::delete_value( $sub['field'], $ctx, self::sub_key( $key, $sub['field'] ) );
}
CFStudio_Storage::delete( $key, $ctx );
CFStudio_Storage::delete( '_' . $key, $ctx );
}
public static function format_value( $value, $field ) {
if ( ! is_array( $value ) ) {
return null;
}
$out = array();
foreach ( self::usable_sub_fields( $field ) as $sub ) {
$name = $sub['field']['name'];
$out[ $name ] = $sub['class']::format_value( array_key_exists( $name, $value ) ? $value[ $name ] : '', $sub['field'] );
}
return $out;
}
public static function render_input( $field, $value, $name ) {
$subs = self::usable_sub_fields( $field );
if ( ! $subs && empty( $field['sub_fields'] ) ) {
echo '
' . esc_html__( 'This group has no sub fields yet. Add some in the field group editor.', 'fieldloom' ) . '