use Elementor\Core\Kits\Documents\Tabs\Global_Typography;
use Elementor\Icons_Manager;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
* Elementor alert widget.
* Elementor widget that displays a collapsible display of content in an toggle
* style, allowing the user to open multiple items.
class Widget_Alert extends Widget_Base {
* Retrieve alert widget name.
* @return string Widget name.
public function get_name() {
* Retrieve alert widget title.
* @return string Widget title.
public function get_title() {
return esc_html__( 'Alert', 'elementor' );
* Retrieve alert widget icon.
* @return string Widget icon.
public function get_icon() {
* Retrieve the list of keywords the widget belongs to.
* @return array Widget keywords.
public function get_keywords() {
return [ 'alert', 'notice', 'message' ];
protected function is_dynamic_content(): bool {
* Get style dependencies.
* Retrieve the list of style dependencies the widget requires.
* @return array Widget style dependencies.
public function get_style_depends(): array {
return [ 'widget-alert' ];
public function has_widget_inner_wrapper(): bool {
return ! Plugin::$instance->experiments->is_feature_active( 'e_optimized_markup' );
* Register alert widget controls.
* Adds different input fields to allow the user to change and customize the widget settings.
protected function register_controls() {
$this->start_controls_section(
'label' => esc_html__( 'Alert', 'elementor' ),
'label' => esc_html__( 'Type', 'elementor' ),
'type' => Controls_Manager::SELECT,
'info' => esc_html__( 'Info', 'elementor' ),
'success' => esc_html__( 'Success', 'elementor' ),
'warning' => esc_html__( 'Warning', 'elementor' ),
'danger' => esc_html__( 'Danger', 'elementor' ),
'prefix_class' => 'elementor-alert-',
'label' => esc_html__( 'Title', 'elementor' ),
'type' => Controls_Manager::TEXT,
'placeholder' => esc_html__( 'Enter your title', 'elementor' ),
'default' => esc_html__( 'This is an Alert', 'elementor' ),
'label' => esc_html__( 'Content', 'elementor' ),
'type' => Controls_Manager::TEXTAREA,
'placeholder' => esc_html__( 'Enter your description', 'elementor' ),
'default' => esc_html__( 'I am a description. Click the edit button to change this text.', 'elementor' ),
'label' => esc_html__( 'Dismiss Icon', 'elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => esc_html__( 'Show', 'elementor' ),
'label_off' => esc_html__( 'Hide', 'elementor' ),
'return_value' => 'show',
'label' => esc_html__( 'Icon', 'elementor' ),
'type' => Controls_Manager::ICONS,
'fa4compatibility' => 'icon',
'render_type' => 'template',
'show_dismiss' => 'show',
$this->end_controls_section();
$this->start_controls_section(
'label' => esc_html__( 'Alert', 'elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'label' => esc_html__( 'Background Color', 'elementor' ),
'type' => Controls_Manager::COLOR,
'{{WRAPPER}} .elementor-alert' => 'background-color: {{VALUE}};',
'label' => esc_html__( 'Side Border Color', 'elementor' ),
'type' => Controls_Manager::COLOR,
'{{WRAPPER}} .elementor-alert' => 'border-inline-start-color: {{VALUE}};',
'label' => esc_html__( 'Side Border Width', 'elementor' ),
'type' => Controls_Manager::SLIDER,
'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
'{{WRAPPER}} .elementor-alert' => 'border-inline-start-width: {{SIZE}}{{UNIT}};',
$this->end_controls_section();
$this->start_controls_section(
'label' => esc_html__( 'Title', 'elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'label' => esc_html__( 'Text Color', 'elementor' ),
'type' => Controls_Manager::COLOR,
'{{WRAPPER}} .elementor-alert-title' => 'color: {{VALUE}};',
$this->add_group_control(
Group_Control_Typography::get_type(),
'selector' => '{{WRAPPER}} .elementor-alert-title',
'default' => Global_Typography::TYPOGRAPHY_PRIMARY,
$this->add_group_control(
Group_Control_Text_Shadow::get_type(),
'name' => 'title_shadow',
'selector' => '{{WRAPPER}} .elementor-alert-title',
$this->end_controls_section();
$this->start_controls_section(
'label' => esc_html__( 'Description', 'elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'label' => esc_html__( 'Text Color', 'elementor' ),
'type' => Controls_Manager::COLOR,
'{{WRAPPER}} .elementor-alert-description' => 'color: {{VALUE}};',
$this->add_group_control(
Group_Control_Typography::get_type(),
'name' => 'alert_description',
'selector' => '{{WRAPPER}} .elementor-alert-description',
'default' => Global_Typography::TYPOGRAPHY_TEXT,
$this->add_group_control(
Group_Control_Text_Shadow::get_type(),
'name' => 'description_shadow',
'selector' => '{{WRAPPER}} .elementor-alert-description',
$this->end_controls_section();
$this->start_controls_section(
'label' => esc_html__( 'Dismiss Icon', 'elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'show_dismiss' => 'show',
$this->add_responsive_control(
'label' => esc_html__( 'Size', 'elementor' ),
'type' => Controls_Manager::SLIDER,
'size_units' => [ 'px', 'em', 'rem', 'custom' ],
'{{WRAPPER}}' => '--dismiss-icon-size: {{SIZE}}{{UNIT}};',
$this->add_responsive_control(
'dismiss_icon_vertical_position',
'label' => esc_html__( 'Vertical Position', 'elementor' ),
'type' => Controls_Manager::SLIDER,
'size_units' => [ 'px', '%', 'em', 'rem', 'vh', 'custom' ],
'{{WRAPPER}}' => '--dismiss-icon-vertical-position: {{SIZE}}{{UNIT}};',
$this->add_responsive_control(
'dismiss_icon_horizontal_position',
'label' => esc_html__( 'Horizontal Position', 'elementor' ),
'type' => Controls_Manager::SLIDER,
'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
'{{WRAPPER}}' => '--dismiss-icon-horizontal-position: {{SIZE}}{{UNIT}};',
$this->start_controls_tabs( 'dismiss_icon_colors' );
$this->start_controls_tab( 'dismiss_icon_normal_colors', [
'label' => esc_html__( 'Normal', 'elementor' ),
'dismiss_icon_normal_color',
'label' => esc_html__( 'Color', 'elementor' ),
'type' => Controls_Manager::COLOR,
'{{WRAPPER}}' => '--dismiss-icon-normal-color: {{VALUE}};',
$this->end_controls_tab();
$this->start_controls_tab( 'dismiss_icon_hover_colors', [
'label' => esc_html__( 'Hover', 'elementor' ),
'dismiss_icon_hover_color',
'label' => esc_html__( 'Color', 'elementor' ),
'type' => Controls_Manager::COLOR,
'{{WRAPPER}}' => '--dismiss-icon-hover-color: {{VALUE}};',
'dismiss_icon_hover_transition_duration',
'label' => esc_html__( 'Transition Duration', 'elementor' ) . ' (s)',
'type' => Controls_Manager::SLIDER,
'{{WRAPPER}}' => '--dismiss-icon-hover-transition-duration: {{SIZE}}s',
$this->end_controls_tab();
$this->end_controls_tabs();
$this->end_controls_section();
* Render alert widget output on the frontend.
* Written in PHP and used to generate the final HTML.
protected function render() {
$settings = $this->get_settings_for_display();
if ( Utils::is_empty( $settings['alert_title'] ) && Utils::is_empty( $settings['alert_description'] ) ) {
$this->add_render_attribute( 'alert_wrapper', 'class', 'elementor-alert' );
$this->add_render_attribute( 'alert_wrapper', 'role', 'alert' );
$this->add_render_attribute( 'alert_title', 'class', 'elementor-alert-title' );
$this->add_render_attribute( 'alert_description', 'class', 'elementor-alert-description' );
$this->add_inline_editing_attributes( 'alert_title', 'none' );
$this->add_inline_editing_attributes( 'alert_description' );
<div <?php $this->print_render_attribute_string( 'alert_wrapper' ); ?>>
<?php if ( ! Utils::is_empty( $settings['alert_title'] ) ) : ?>
<span <?php $this->print_render_attribute_string( 'alert_title' ); ?>><?php echo wp_kses_post( $settings['alert_title'] ); ?></span>