*
{figure}
* {title}{content}{button}
*
*
* @param array $attrs Block attributes.
* @param string $content Block content (unused).
* @param WP_Block $block Parsed block.
* @param ModuleElements $elements Module elements helper.
*
* @return string
*/
public static function render_callback($attrs, $content, $block, $elements)
{
$advanced = $attrs['module']['advanced'] ?? [];
$main_figure = $advanced['mainFigure']['desktop']['value'] ?? 'image';
$img_anim = $advanced['imgAnim']['desktop']['value'] ?? 'none';
$use_button = ($advanced['useButton']['desktop']['value'] ?? 'off') === 'on';
// Media figure.
$figure_html = self::render_figure($advanced, $main_figure);
$media_html = '';
if (!empty($figure_html)) {
$media_html = sprintf(' %1$s
', $figure_html);
}
// Title + content elements.
$title_html = $elements->render(['attrName' => 'title']);
$content_html = $elements->render(['attrName' => 'content']);
// Button.
$button_html = '';
if ($use_button) {
$button = ButtonElement::render($attrs['button'] ?? [], 'dtq-btn-info-box');
if (!empty($button)) {
$button_html = sprintf('%1$s
', $button);
}
}
$children = sprintf(
'',
esc_attr($img_anim),
$media_html,
$title_html,
$content_html,
$button_html
);
return Module::render(
[
'attrs' => $attrs,
'elements' => $elements,
'id' => $block->parsed_block['id'],
'name' => $block->block_type->name,
'moduleCategory' => $block->block_type->category,
'classnamesFunction' => [self::class, 'module_classnames'],
'stylesComponent' => [self::class, 'module_styles'],
'scriptDataComponent' => [self::class, 'module_script_data'],
'orderIndex' => $block->parsed_block['orderIndex'] ?? 0,
'storeInstance' => $block->parsed_block['storeInstance'] ?? null,
'children' => [
// Background pattern/mask and the box-shadow overlay are DOM,
// not CSS. Without this call Divi renders them in the builder
// and nowhere else, so the options silently do nothing on the
// front end.
$elements->style_components(['attrName' => 'module']),
$children,
],
]
);
}
/**
* Render the media figure (image, icon or video) markup.
*
* @param array $advanced The `module.advanced` attrs array.
* @param string $main_figure The selected media type.
*
* @return string
*/
/**
* Render the image hover overlay.
*
* The whole `designOverlay` option group (useOverlay, overlayIcon, colours,
* size, opacity, speed) was declared in module.json but no `.dtq-overlay`
* was ever emitted, so none of it did anything. Mirrors the Image Card
* module, which implements the same feature (InfoCard render + module.scss).
*
* @param array $advanced The `module.advanced` attrs array.
*
* @return string
*/
public static function render_overlay($advanced)
{
$use_overlay = ($advanced['useOverlay']['desktop']['value'] ?? 'off') === 'on';
if (!$use_overlay) {
return '';
}
$icon = $advanced['overlayIcon']['desktop']['value'] ?? '';
if (is_array($icon)) {
$uni = $icon['unicode'] ?? '';
$type = $icon['type'] ?? 'divi';
$wt = $icon['weight'] ?? '400';
} else {
$parts = explode('||', (string) $icon);
$uni = $parts[0] ?? '';
$type = $parts[1] ?? 'divi';
$wt = $parts[2] ?? '400';
}
if ('' === $uni) {
// D4 still renders the overlay with an empty icon element.
return '
';
}
$font = 'fa' === $type ? 'FontAwesome' : 'ETmodules';
if (function_exists('dtq_inject_fa_icons')) {
dtq_inject_fa_icons($uni . '||' . $type . '||' . $wt);
}
return sprintf(
'%3$s
',
esc_attr($font),
esc_attr($wt),
dtq_resolve_icon_unicode($uni)
);
}
public static function render_figure($advanced, $main_figure)
{
if ('image' === $main_figure) {
$photo = DynamicValue::resolve($advanced['photo']['desktop']['value'] ?? '');
if (empty($photo)) {
return '';
}
return self::render_overlay($advanced) . sprintf(
'
',
esc_url($photo)
);
}
if ('icon' === $main_figure) {
$icon = $advanced['icon']['desktop']['value'] ?? '';
if (empty($icon)) {
return '';
}
if (is_array($icon)) {
$uni = $icon['unicode'] ?? '';
$type = $icon['type'] ?? 'divi';
$wt = $icon['weight'] ?? '400';
} else {
$p = explode('||', (string) $icon);
$uni = $p[0] ?? '';
$type = $p[1] ?? 'divi';
$wt = $p[2] ?? '400';
}
if (empty($uni)) {
return '';
}
if (function_exists('dtq_inject_fa_icons')) {
// Pass the full "unicode||type||weight" string: et_pb_maybe_fa_font_icon()
// detects FontAwesome by the "||" separator, so a bare unicode always
// registered et_icons_all and the FontAwesome @font-face never loaded —
// the glyph rendered as tofu. Calling it unconditionally also registers
// the full Divi icon font, which extended Divi glyphs need.
dtq_inject_fa_icons($uni . '||' . $type . '||' . $wt);
}
$font = 'fa' === $type ? 'FontAwesome' : 'ETmodules';
return sprintf(
'
%3$s
',
esc_attr($font),
esc_attr($wt),
dtq_resolve_icon_unicode($uni)
);
}
// Video.
$video = $advanced['video']['desktop']['value'] ?? '';
if (empty($video)) {
return '';
}
$overlay_src = $advanced['voSrc']['desktop']['value'] ?? '';
if (function_exists('et_pb_check_oembed_provider') && false !== et_pb_check_oembed_provider(esc_url($video))) {
$video_src = wp_oembed_get(esc_url($video));
} else {
$video_src = sprintf('', esc_url($video));
}
$overlay_html = '';
if (!empty($overlay_src)) {
$overlay_html = sprintf(
'',
esc_url($overlay_src)
);
}
return sprintf(
'',
$video_src,
$overlay_html
);
}
}