<?php
/**
* Basic Posts Widget for Header Footer Elementor.
*
* @package header-footer-elementor
*/
namespace HFE\WidgetsManager\Widgets\BasicPosts;
use Elementor\Controls_Manager;
use Elementor\Group_Control_Typography;
use Elementor\Core\Kits\Documents\Tabs\Global_Typography;
use Elementor\Core\Kits\Documents\Tabs\Global_Colors;
use Elementor\Group_Control_Border;
use Elementor\Group_Control_Box_Shadow;
use Elementor\Group_Control_Background;
use Elementor\Utils;
use HFE\WidgetsManager\Base\Common_Widget;
use HFE\WidgetsManager\Widgets_Loader;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* HFE Basic Posts widget
*
* Fast and lightweight posts widget with basic card layout
*
* @since 2.5.0
*/
class Basic_Posts extends Common_Widget {
/**
* Query object
*
* @var \WP_Query
*/
protected $query = null;
/**
* Retrieve the widget name.
*
* @since 2.5.0
* @access public
* @return string Widget name.
*/
public function get_name() {
return parent::get_widget_slug( 'Basic_Posts' );
}
/**
* Retrieve the widget title.
*
* @since 2.5.0
* @access public
* @return string Widget title.
*/
public function get_title() {
return parent::get_widget_title( 'Basic_Posts' );
}
/**
* Retrieve the widget icon.
*
* @since 2.5.0
* @access public
* @return string Widget icon.
*/
public function get_icon() {
return 'hfe-icon-posts';
}
/**
* Retrieve the list of keywords the widget belongs to.
*
* @since 2.6.0
* @access public
* @return array Widget keywords.
*/
public function get_keywords() {
return parent::get_widget_keywords( 'Basic_Posts' );
}
/**
* Indicates if the widget's content is dynamic.
*
* @since 2.5.0
* @return bool True for dynamic content.
*/
protected function is_dynamic_content(): bool {
return true;
}
/**
* Get widget upsale data.
*
* Retrieve the widget promotion data.
*
* @since 2.5.0
* @access protected
*
* @return array Widget promotion data.
*/
protected function get_upsale_data() {
return [
'condition' => ! defined( 'UAEL_VER' ),
'image' => esc_url( HFE_URL . 'assets/images/upgrade-pro.png' ),
'image_alt' => esc_attr__( 'Upgrade', 'header-footer-elementor' ),
'title' => esc_html__( 'Upgrade your Basic Posts Widget', 'header-footer-elementor' ),
'description' => esc_html__( 'Get the Advanced Posts widget and unlock powerful layouts, filters, and customization options with UAE Pro.', 'header-footer-elementor' ),
'upgrade_url' => esc_url( 'https://ultimateelementor.com/pricing/?utm_source=UAE-Basic-Post&utm_medium=editor&utm_campaign=static-promotion' ),
'upgrade_text' => esc_html__( 'Upgrade Now', 'header-footer-elementor' ),
];
}
/**
* Register widget controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_controls(): void {
$this->register_general_controls();
$this->register_query_controls();
$this->register_image_controls();
$this->register_content_controls();
$this->register_meta_controls();
$this->register_excerpt_controls();
$this->register_read_more_controls();
// Style Controls
$this->register_layout_style_controls();
$this->register_card_style_controls();
$this->register_title_style_controls();
$this->register_meta_style_controls();
$this->register_excerpt_style_controls();
$this->register_read_more_style_controls();
}
/**
* Register Query Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_query_controls() {
$this->start_controls_section(
'section_query',
[
'label' => __( 'Query', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'orderby',
[
'label' => __( 'Order By', 'header-footer-elementor' ),
'type' => Controls_Manager::SELECT,
'default' => 'date',
'options' => [
'date' => __( 'Date', 'header-footer-elementor' ),
'title' => __( 'Title', 'header-footer-elementor' ),
'menu_order' => __( 'Menu Order', 'header-footer-elementor' ),
'rand' => __( 'Random', 'header-footer-elementor' ),
'comment_count' => __( 'Comment Count', 'header-footer-elementor' ),
],
]
);
$this->add_control(
'order',
[
'label' => __( 'Order', 'header-footer-elementor' ),
'type' => Controls_Manager::SELECT,
'default' => 'desc',
'options' => [
'asc' => __( 'ASC', 'header-footer-elementor' ),
'desc' => __( 'DESC', 'header-footer-elementor' ),
],
]
);
$this->add_control(
'exclude_current',
[
'label' => __( 'Exclude Current Post', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => '',
]
);
$this->end_controls_section();
}
/**
* Register General Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_general_controls() {
$this->start_controls_section(
'section_general',
[
'label' => __( 'General', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'posts_per_page',
[
'label' => __( 'Posts Per Page', 'header-footer-elementor' ),
'type' => Controls_Manager::NUMBER,
'default' => 6,
'min' => 1,
'max' => 100,
]
);
$this->add_responsive_control(
'columns',
[
'label' => __( 'Columns', 'header-footer-elementor' ),
'type' => Controls_Manager::SELECT,
'default' => '3',
'tablet_default' => '2',
'mobile_default' => '1',
'options' => [
'1' => '1',
'2' => '2',
'3' => '3',
'4' => '4',
'5' => '5',
'6' => '6',
],
'selectors' => [
'{{WRAPPER}} .hfe-posts-grid' => 'grid-template-columns: repeat({{VALUE}}, 1fr);',
],
]
);
$this->end_controls_section();
}
/**
* Register Image Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_image_controls() {
$this->start_controls_section(
'section_image',
[
'label' => __( 'Featured Image', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'show_image',
[
'label' => __( 'Show Featured Image', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'yes',
]
);
$this->add_control(
'image_size',
[
'label' => __( 'Image Size', 'header-footer-elementor' ),
'type' => Controls_Manager::SELECT,
'default' => 'medium',
'options' => $this->get_image_sizes(),
'condition' => [
'show_image' => 'yes',
],
]
);
$this->end_controls_section();
}
/**
* Register Content Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_content_controls() {
$this->start_controls_section(
'section_content',
[
'label' => __( 'Title', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'show_title',
[
'label' => __( 'Show Title', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'yes',
]
);
$this->add_control(
'title_tag',
[
'label' => __( 'Title HTML Tag', 'header-footer-elementor' ),
'type' => Controls_Manager::SELECT,
'default' => 'h3',
'options' => [
'h1' => 'H1',
'h2' => 'H2',
'h3' => 'H3',
'h4' => 'H4',
'h5' => 'H5',
'h6' => 'H6',
],
'condition' => [
'show_title' => 'yes',
],
]
);
$this->end_controls_section();
}
/**
* Register Meta Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_meta_controls() {
$this->start_controls_section(
'section_meta',
[
'label' => __( 'Meta', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'show_meta',
[
'label' => __( 'Show Meta Data', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'yes',
]
);
$this->add_control(
'show_date',
[
'label' => __( 'Show Date', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'yes',
'condition' => [
'show_meta' => 'yes',
],
]
);
$this->add_control(
'show_author',
[
'label' => __( 'Show Author', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'yes',
'condition' => [
'show_meta' => 'yes',
],
]
);
$this->add_control(
'show_comments',
[
'label' => __( 'Show Comments Count', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'no',
'condition' => [
'show_meta' => 'yes',
],
]
);
$this->add_control(
'meta_separator',
[
'label' => __( 'Meta Separator', 'header-footer-elementor' ),
'type' => Controls_Manager::TEXT,
'default' => ' | ',
'condition' => [
'show_meta' => 'yes',
],
]
);
$this->end_controls_section();
}
/**
* Register Excerpt Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_excerpt_controls() {
$this->start_controls_section(
'section_excerpt',
[
'label' => __( 'Excerpt', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'show_excerpt',
[
'label' => __( 'Show Excerpt', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'yes',
]
);
$this->add_control(
'excerpt_length',
[
'label' => __( 'Excerpt Length', 'header-footer-elementor' ),
'type' => Controls_Manager::NUMBER,
'default' => 20,
'min' => 0,
'max' => 100,
'condition' => [
'show_excerpt' => 'yes',
],
]
);
$this->end_controls_section();
}
/**
* Register Read More Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_read_more_controls() {
$this->start_controls_section(
'section_read_more',
[
'label' => __( 'Call to Action', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'show_read_more',
[
'label' => __( 'Show Read More', 'header-footer-elementor' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => __( 'Yes', 'header-footer-elementor' ),
'label_off' => __( 'No', 'header-footer-elementor' ),
'return_value' => 'yes',
'default' => 'yes',
]
);
$this->add_control(
'read_more_text',
[
'label' => __( 'Read More Text', 'header-footer-elementor' ),
'type' => Controls_Manager::TEXT,
'default' => __( 'Read More →', 'header-footer-elementor' ),
'condition' => [
'show_read_more' => 'yes',
],
]
);
$this->end_controls_section();
}
/**
* Register Layout Style Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_layout_style_controls() {
$this->start_controls_section(
'section_layout_style',
[
'label' => __( 'Layout', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
]
);
$this->add_responsive_control(
'column_gap',
[
'label' => __( 'Column Gap', 'header-footer-elementor' ),
'type' => Controls_Manager::SLIDER,
'default' => [
'size' => 20,
],
'range' => [
'px' => [
'min' => 0,
'max' => 100,
],
],
'selectors' => [
'{{WRAPPER}} .hfe-posts-grid' => 'column-gap: {{SIZE}}{{UNIT}};',
],
]
);
$this->add_responsive_control(
'row_gap',
[
'label' => __( 'Row Gap', 'header-footer-elementor' ),
'type' => Controls_Manager::SLIDER,
'default' => [
'size' => 30,
],
'range' => [
'px' => [
'min' => 0,
'max' => 100,
],
],
'selectors' => [
'{{WRAPPER}} .hfe-posts-grid' => 'row-gap: {{SIZE}}{{UNIT}};',
],
]
);
$this->end_controls_section();
}
/**
* Register Card Style Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_card_style_controls() {
$this->start_controls_section(
'section_card_style',
[
'label' => __( 'Card', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
]
);
$this->add_group_control(
Group_Control_Background::get_type(),
[
'name' => 'card_background',
'label' => __( 'Background', 'header-footer-elementor' ),
'types' => [ 'classic', 'gradient' ],
'selector' => '{{WRAPPER}} .hfe-post-card',
'fields_options' => [
'background' => [
'default' => 'classic',
],
'color' => [
'default' => '#F6F6F6',
],
],
]
);
$this->add_group_control(
Group_Control_Border::get_type(),
[
'name' => 'card_border',
'label' => __( 'Border', 'header-footer-elementor' ),
'selector' => '{{WRAPPER}} .hfe-post-card',
]
);
$this->add_responsive_control(
'card_border_radius',
[
'label' => __( 'Border Radius', 'header-footer-elementor' ),
'type' => Controls_Manager::DIMENSIONS,
'size_units' => [ 'px', '%' ],
'selectors' => [
'{{WRAPPER}} .hfe-post-card' => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
'{{WRAPPER}} .hfe-post-image img' => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} 0{{UNIT}} 0{{UNIT}};',
],
]
);
$this->add_group_control(
Group_Control_Box_Shadow::get_type(),
[
'name' => 'card_box_shadow',
'label' => __( 'Box Shadow', 'header-footer-elementor' ),
'selector' => '{{WRAPPER}} .hfe-post-card',
]
);
$this->add_responsive_control(
'card_padding',
[
'label' => __( 'Padding', 'header-footer-elementor' ),
'type' => Controls_Manager::DIMENSIONS,
'size_units' => [ 'px', 'em', '%' ],
'default' => [
'top' => '20',
'right' => '20',
'bottom' => '20',
'left' => '20',
'unit' => 'px',
'isLinked' => true,
],
'selectors' => [
'{{WRAPPER}} .hfe-post-content' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
],
]
);
$this->end_controls_section();
}
/**
* Register Title Style Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_title_style_controls() {
$this->start_controls_section(
'section_title_style',
[
'label' => __( 'Title', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'condition' => [
'show_title' => 'yes',
],
]
);
$this->add_control(
'title_color',
[
'label' => __( 'Color', 'header-footer-elementor' ),
'type' => Controls_Manager::COLOR,
'global' => [
'default' => Global_Colors::COLOR_PRIMARY,
],
'selectors' => [
'{{WRAPPER}} .hfe-post-title a' => 'color: {{VALUE}};',
],
]
);
$this->add_control(
'title_hover_color',
[
'label' => __( 'Hover Color', 'header-footer-elementor' ),
'type' => Controls_Manager::COLOR,
'selectors' => [
'{{WRAPPER}} .hfe-post-title a:hover' => 'color: {{VALUE}};',
],
]
);
$this->add_group_control(
Group_Control_Typography::get_type(),
[
'name' => 'title_typography',
'label' => __( 'Typography', 'header-footer-elementor' ),
'global' => [
'default' => Global_Typography::TYPOGRAPHY_PRIMARY,
],
'selector' => '{{WRAPPER}} .hfe-post-title',
]
);
$this->add_responsive_control(
'title_spacing',
[
'label' => __( 'Bottom Spacing', 'header-footer-elementor' ),
'type' => Controls_Manager::SLIDER,
'default' => [
'size' => 5,
'unit' => 'px',
],
'range' => [
'px' => [
'min' => 0,
'max' => 50,
],
],
'selectors' => [
'{{WRAPPER}} .hfe-post-title' => 'margin-bottom: {{SIZE}}{{UNIT}};',
],
]
);
$this->end_controls_section();
}
/**
* Register Meta Style Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_meta_style_controls() {
$this->start_controls_section(
'section_meta_style',
[
'label' => __( 'Meta', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'condition' => [
'show_meta' => 'yes',
],
]
);
$this->add_control(
'meta_color',
[
'label' => __( 'Color', 'header-footer-elementor' ),
'type' => Controls_Manager::COLOR,
// 'default' => '#ADADAD',
'global' => [
'default' => Global_Colors::COLOR_TEXT,
],
'selectors' => [
'{{WRAPPER}} .hfe-post-meta' => 'color: {{VALUE}};',
],
]
);
$this->add_group_control(
Group_Control_Typography::get_type(),
[
'name' => 'meta_typography',
'label' => __( 'Typography', 'header-footer-elementor' ),
'global' => [
'default' => Global_Typography::TYPOGRAPHY_SECONDARY,
],
'selector' => '{{WRAPPER}} .hfe-post-meta',
]
);
$this->add_responsive_control(
'meta_spacing',
[
'label' => __( 'Bottom Spacing', 'header-footer-elementor' ),
'type' => Controls_Manager::SLIDER,
'default' => [
'size' => 15,
'unit' => 'px',
],
'range' => [
'px' => [
'min' => 0,
'max' => 50,
],
],
'selectors' => [
'{{WRAPPER}} .hfe-post-meta' => 'margin-bottom: {{SIZE}}{{UNIT}};',
],
]
);
$this->end_controls_section();
}
/**
* Register Excerpt Style Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_excerpt_style_controls() {
$this->start_controls_section(
'section_excerpt_style',
[
'label' => __( 'Excerpt', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'condition' => [
'show_excerpt' => 'yes',
],
]
);
$this->add_control(
'excerpt_color',
[
'label' => __( 'Color', 'header-footer-elementor' ),
'type' => Controls_Manager::COLOR,
'global' => [
'default' => Global_Colors::COLOR_TEXT,
],
'selectors' => [
'{{WRAPPER}} .hfe-post-excerpt' => 'color: {{VALUE}};',
],
]
);
$this->add_group_control(
Group_Control_Typography::get_type(),
[
'name' => 'excerpt_typography',
'label' => __( 'Typography', 'header-footer-elementor' ),
'global' => [
'default' => Global_Typography::TYPOGRAPHY_TEXT,
],
'selector' => '{{WRAPPER}} .hfe-post-excerpt',
]
);
$this->add_responsive_control(
'excerpt_spacing',
[
'label' => __( 'Bottom Spacing', 'header-footer-elementor' ),
'type' => Controls_Manager::SLIDER,
'default' => [
'size' => 15,
'unit' => 'px',
],
'range' => [
'px' => [
'min' => 0,
'max' => 50,
],
],
'selectors' => [
'{{WRAPPER}} .hfe-post-excerpt' => 'margin-bottom: {{SIZE}}{{UNIT}};',
],
]
);
$this->end_controls_section();
}
/**
* Register Read More Style Controls.
*
* @since 2.5.0
* @access protected
*/
protected function register_read_more_style_controls() {
$this->start_controls_section(
'section_read_more_style',
[
'label' => __( 'Call to Action', 'header-footer-elementor' ),
'tab' => Controls_Manager::TAB_STYLE,
'condition' => [
'show_read_more' => 'yes',
],
]
);
$this->add_control(
'read_more_color',
[
'label' => __( 'Color', 'header-footer-elementor' ),
'type' => Controls_Manager::COLOR,
'global' => [
'default' => Global_Colors::COLOR_ACCENT,
],
'selectors' => [
'{{WRAPPER}} .hfe-read-more' => 'color: {{VALUE}};',
],
]
);
$this->add_control(
'read_more_hover_color',
[
'label' => __( 'Hover Color', 'header-footer-elementor' ),
'type' => Controls_Manager::COLOR,
'selectors' => [
'{{WRAPPER}} .hfe-read-more:hover' => 'color: {{VALUE}};',
],
]
);
$this->add_group_control(
Group_Control_Typography::get_type(),
[
'name' => 'read_more_typography',
'label' => __( 'Typography', 'header-footer-elementor' ),
'selector' => '{{WRAPPER}} .hfe-read-more',
]
);
$this->end_controls_section();
}
/**
* Get available image sizes.
*
* @since 2.5.0
* @access protected
* @return array
*/
protected function get_image_sizes() {
$image_sizes = get_intermediate_image_sizes();
$options = [];
$options['full'] = __( 'Full', 'header-footer-elementor' );
foreach ( $image_sizes as $size ) {
$options[ $size ] = ucwords( str_replace( '_', ' ', $size ) );
}
return $options;
}
/**
* Query posts.
*
* @since 2.5.0
* @access protected
*/
protected function query_posts() {
$settings = $this->get_settings_for_display();
// Sanitize inputs.
$posts_per_page = absint( $settings['posts_per_page'] ?? 6 );
$orderby = sanitize_key( $settings['orderby'] ?? 'date' );
$order = sanitize_key( $settings['order'] ?? 'desc' );
// Ensure posts_per_page is within bounds
$posts_per_page = max( 1, min( 100, $posts_per_page ) );
// Validate orderby against allowed values
$allowed_orderby = [ 'date', 'title', 'menu_order', 'rand', 'comment_count' ];
if ( ! in_array( $orderby, $allowed_orderby, true ) ) {
$orderby = 'date';
}
// Validate order
$order = strtoupper( $order );
if ( ! in_array( $order, [ 'ASC', 'DESC' ], true ) ) {
$order = 'DESC';
}
$args = [
'post_type' => 'post',
'posts_per_page' => $posts_per_page,
'orderby' => $orderby,
'order' => $order,
'post_status' => 'publish',
];
// Exclude current post if enabled
if ( 'yes' === $settings['exclude_current'] && is_singular() ) {
$current_id = get_the_ID();
if ( $current_id ) {
$args['post__not_in'] = [ absint( $current_id ) ];
}
}
$this->query = new \WP_Query( $args );
}
/**
* Render template HTML using ob_start
*
* @param array $settings Widget settings.
* @return string Rendered HTML.
*/
protected function render_template( $settings ) {
ob_start();
include __DIR__ . '/template.php';
return ob_get_clean();
}
/**
* Render Basic Posts widget output on the frontend.
*
* @since 2.4.0
* @access protected
*/
protected function render() {
$settings = $this->get_settings_for_display();
$this->query_posts();
if ( ! $this->query->have_posts() ) {
echo '<p>' . esc_html__( 'No posts found.', 'header-footer-elementor' ) . '</p>';
return;
}
echo $this->render_template( $settings );
}
}