field = $field;
$this->layout_meta = $layout_meta;
$this->setup();
}
/**
* Prepares the field for rendering.
*
* @since 6.5
*
* @return void
*/
private function setup() {
$layouts = array();
if ( ! empty( $this->field['layouts'] ) ) {
foreach ( $this->field['layouts'] as $layout ) {
$layouts[ $layout['name'] ] = $layout;
}
}
$this->layouts = $layouts;
}
/**
* Renders the Flexible Content field.
*
* @since 6.5
*
* @return void
*/
public function render() {
$div_attrs = array(
'class' => 'acf-flexible-content',
'data-min' => $this->field['min'],
'data-max' => $this->field['max'],
'data-button-label' => $this->field['button_label'],
);
if ( empty( $this->field['value'] ) ) {
$div_attrs['class'] .= ' -empty';
}
echo ''; // Main wrapper div.
acf_hidden_input( array( 'name' => $this->field['name'] ) );
$this->actions( 'top' );
$this->no_value_message();
$this->clones();
$this->layouts();
$this->actions( 'bottom' );
$this->add_layout_menu();
$this->more_layout_actions();
echo '
'; // End main wrapper div.
}
/**
* Renders the no value message.
*
* @since 6.5
*
* @return void
*/
private function no_value_message() {
// translators: %s the button label used for adding a new layout.
$no_value_message = __( 'Click the "%s" button below to start creating your layout', 'acf' );
$no_value_message = apply_filters( 'acf/fields/flexible_content/no_value_message', $no_value_message, $this->field );
$no_value_message = sprintf( $no_value_message, $this->field['button_label'] );
echo '' . acf_esc_html( $no_value_message ) . '
';
}
/**
* Renders the ACF clone indexes for the layouts.
*
* @since 6.5
*
* @return void
*/
private function clones() {
echo '';
if ( ! empty( $this->layouts ) ) {
foreach ( $this->layouts as $layout ) {
$clone = new Layout( $this->field, $layout, 'acfcloneindex', array() );
$clone->render();
}
}
echo '
';
}
/**
* Renders the layouts for a Flexible Content field.
*
* @since 6.5
*
* @return void
*/
private function layouts() {
echo '';
$disabled_layouts = ! empty( $this->layout_meta['disabled'] ) ? $this->layout_meta['disabled'] : array();
$renamed_layouts = ! empty( $this->layout_meta['renamed'] ) ? $this->layout_meta['renamed'] : array();
if ( ! empty( $this->field['value'] ) ) {
foreach ( $this->field['value'] as $order => $value ) {
if ( ! is_array( $value ) ) {
continue;
}
if ( empty( $this->layouts[ $value['acf_fc_layout'] ] ) ) {
continue;
}
$layout = new Layout(
$this->field,
$this->layouts[ $value['acf_fc_layout'] ],
$order,
$value,
in_array( $order, $disabled_layouts, true ),
! empty( $renamed_layouts[ $order ] ) ? $renamed_layouts[ $order ] : '',
);
$layout->render();
}
}
echo '
';
}
/**
* Renders top-level actions for the Flexible Content field.
*
* @since 6.5
*
* @param string $which The location of the actions, either 'top' or 'bottom'.
* @return void
*/
private function actions( string $which = '' ) {
if ( 'top' === $which ) {
?>
';
foreach ( $this->layouts as $layout ) {
$safe_label = acf_esc_html( $layout['label'] );
$atts = array(
'href' => '#',
'data-layout' => $layout['name'],
'data-min' => $layout['min'],
'data-max' => $layout['max'],
'title' => $safe_label,
);
printf( '- %s
', acf_esc_attrs( $atts ), $safe_label ); //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped above.
}
echo '
';
}
/**
* Renders the dropdown menu for additional layout actions.
*
* @since 6.5
*
* @return void
*/
private function more_layout_actions() {
?>