start_controls_section( 'section_query', [ 'label' => esc_html__( 'Query', 'addronix-addons-for-elementor' ), ] ); $this->add_control( 'post_type', [ 'label' => esc_html__( 'Source', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SELECT, 'options' => $this->get_post_type_options(), 'default' => 'post', ] ); $this->add_control( 'posts_per_page', [ 'label' => esc_html__( 'Posts Per Page', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::NUMBER, 'min' => 1, 'max' => 100, 'default' => 6, ] ); $this->add_control( 'orderby', [ 'label' => esc_html__( 'Order By', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SELECT, 'options' => [ 'date' => esc_html__( 'Date', 'addronix-addons-for-elementor' ), 'title' => esc_html__( 'Title', 'addronix-addons-for-elementor' ), 'menu_order' => esc_html__( 'Menu Order', 'addronix-addons-for-elementor' ), 'rand' => esc_html__( 'Random', 'addronix-addons-for-elementor' ), 'comment_count' => esc_html__( 'Comment Count', 'addronix-addons-for-elementor' ), ], 'default' => 'date', ] ); $this->add_control( 'order', [ 'label' => esc_html__( 'Order', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SELECT, 'options' => [ 'DESC' => esc_html__( 'Descending', 'addronix-addons-for-elementor' ), 'ASC' => esc_html__( 'Ascending', 'addronix-addons-for-elementor' ), ], 'default' => 'DESC', ] ); $this->add_control( 'category_filter', [ 'label' => esc_html__( 'Category / Term IDs (comma separated)', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::TEXT, 'placeholder' => '12, 34, 56', ] ); $this->add_control( 'include_ids', [ 'label' => esc_html__( 'Include Post IDs (comma separated)', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::TEXT, 'placeholder' => '100, 200, 300', ] ); $this->add_control( 'exclude_ids', [ 'label' => esc_html__( 'Exclude Post IDs (comma separated)', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::TEXT, 'placeholder' => '10, 20', ] ); $this->add_control( 'offset', [ 'label' => esc_html__( 'Offset', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::NUMBER, 'min' => 0, 'default' => 0, ] ); $this->end_controls_section(); // ── Layout ── $this->start_controls_section( 'section_layout', [ 'label' => esc_html__( 'Layout', 'addronix-addons-for-elementor' ), ] ); $this->add_control( 'loop_template', [ 'label' => esc_html__( 'Loop Item Template', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SELECT, 'options' => \AddronixAddons\Loop_Builder::get_templates(), ] ); $this->add_control( 'layout_type', [ 'label' => esc_html__( 'Layout', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SELECT, 'options' => [ 'grid' => esc_html__( 'Grid', 'addronix-addons-for-elementor' ), 'masonry' => esc_html__( 'Masonry', 'addronix-addons-for-elementor' ), 'list' => esc_html__( 'List', 'addronix-addons-for-elementor' ), 'carousel' => esc_html__( 'Carousel (Swiper)', 'addronix-addons-for-elementor' ), ], 'default' => 'grid', ] ); $this->add_responsive_control( 'columns', [ 'label' => esc_html__( 'Columns', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SELECT, 'options' => [ '1' => '1', '2' => '2', '3' => '3', '4' => '4', '5' => '5', '6' => '6', ], 'default' => '3', 'tablet_default' => '2', 'mobile_default' => '1', 'selectors' => [ '{{WRAPPER}} .aafe-loop-grid__grid' => 'grid-template-columns: repeat({{VALUE}}, 1fr);', ], ] ); $this->add_responsive_control( 'gap', [ 'label' => esc_html__( 'Gap', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', 'em', 'rem' ], 'range' => [ 'px' => [ 'min' => 0, 'max' => 80 ] ], 'default' => [ 'unit' => 'px', 'size' => 24 ], 'selectors' => [ '{{WRAPPER}} .aafe-loop-grid__grid' => 'gap: {{SIZE}}{{UNIT}};', ], ] ); $this->add_control( 'pagination', [ 'label' => esc_html__( 'Enable Pagination', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => '', ] ); $this->add_control( 'no_posts_message', [ 'label' => esc_html__( 'No Posts Message', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::TEXT, 'default' => esc_html__( 'No posts found.', 'addronix-addons-for-elementor' ), ] ); $this->end_controls_section(); // ── Carousel Settings ── $this->start_controls_section( 'section_carousel', [ 'label' => esc_html__( 'Carousel Settings', 'addronix-addons-for-elementor' ), 'condition' => [ 'layout_type' => 'carousel', ], ] ); $this->add_control( 'carousel_autoplay', [ 'label' => esc_html__( 'Autoplay', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', ] ); $this->add_control( 'carousel_loop', [ 'label' => esc_html__( 'Infinite Loop', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', ] ); $this->add_control( 'carousel_arrows', [ 'label' => esc_html__( 'Show Arrows', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', ] ); $this->add_control( 'carousel_dots', [ 'label' => esc_html__( 'Show Dots', 'addronix-addons-for-elementor' ), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', ] ); $this->end_controls_section(); } protected function render() { $settings = $this->get_settings_for_display(); $paged = get_query_var( 'paged' ) ? get_query_var( 'paged' ) : ( get_query_var( 'page' ) ? get_query_var( 'page' ) : 1 ); $args = [ 'post_type' => $settings['post_type'] ?: 'post', 'posts_per_page' => ! empty( $settings['posts_per_page'] ) ? absint( $settings['posts_per_page'] ) : 6, 'orderby' => $settings['orderby'] ?: 'date', 'order' => $settings['order'] ?: 'DESC', 'post_status' => 'publish', 'paged' => $paged, // Offset breaks WP pagination, so only apply it if pagination is not needed or handled customly. 'offset' => ! empty( $settings['offset'] ) ? absint( $settings['offset'] ) : 0, ]; // Fix offset + pagination conflict if ( $args['offset'] > 0 && $paged > 1 ) { $args['offset'] = $args['offset'] + ( ( $paged - 1 ) * $args['posts_per_page'] ); } if ( ! empty( $settings['include_ids'] ) ) { $args['post__in'] = array_map( 'absint', explode( ',', $settings['include_ids'] ) ); } if ( ! empty( $settings['exclude_ids'] ) ) { $args['post__not_in'] = array_map( 'absint', explode( ',', $settings['exclude_ids'] ) ); // phpcs:ignore WordPressVIPMinimum.Performance.WPQueryParams.PostNotIn_post__not_in -- Required for loop exclusions. } if ( ! empty( $settings['category_filter'] ) ) { $term_ids = array_map( 'absint', explode( ',', $settings['category_filter'] ) ); if ( 'post' === $args['post_type'] ) { $args['category__in'] = $term_ids; } elseif ( 'product' === $args['post_type'] ) { $args['tax_query'] = [ // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query [ 'taxonomy' => 'product_cat', 'field' => 'term_id', 'terms' => $term_ids, ], ]; } } $query = new \WP_Query( $args ); $template_id = ! empty( $settings['loop_template'] ) ? absint( $settings['loop_template'] ) : 0; $layout = $settings['layout_type'] ?: 'grid'; $is_carousel = 'carousel' === $layout; $classes = [ 'aafe-loop-grid', 'aafe-loop-grid--' . $layout, ]; $swiper_attr = ''; if ( $is_carousel ) { $classes[] = 'swiper'; $classes[] = 'aafe-swiper-container'; $cols_desk = ! empty( $settings['columns'] ) ? intval( $settings['columns'] ) : 3; $cols_tab = ! empty( $settings['columns_tablet'] ) ? intval( $settings['columns_tablet'] ) : 2; $cols_mob = ! empty( $settings['columns_mobile'] ) ? intval( $settings['columns_mobile'] ) : 1; $gap = isset( $settings['gap']['size'] ) && '' !== $settings['gap']['size'] ? intval( $settings['gap']['size'] ) : 24; $swiper_opts = [ 'slidesPerView' => $cols_mob, 'spaceBetween' => $gap, 'loop' => 'yes' === ( $settings['carousel_loop'] ?? '' ), 'autoplay' => 'yes' === ( $settings['carousel_autoplay'] ?? '' ) ? [ 'delay' => 3000, 'disableOnInteraction' => false ] : false, 'pagination' => 'yes' === ( $settings['carousel_dots'] ?? '' ), 'navigation' => 'yes' === ( $settings['carousel_arrows'] ?? '' ), 'breakpoints' => [ 768 => [ 'slidesPerView' => $cols_tab, 'spaceBetween' => $gap ], 1025 => [ 'slidesPerView' => $cols_desk, 'spaceBetween' => $gap ], ], ]; $swiper_attr = ' data-swiper="' . esc_attr( wp_json_encode( $swiper_opts ) ) . '"'; } echo '
'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Attribute escaped above. $wrapper_class = $is_carousel ? 'swiper-wrapper' : 'aafe-loop-grid__grid'; echo '
'; if ( $query->have_posts() ) { while ( $query->have_posts() ) { $query->the_post(); $item_class = $is_carousel ? 'swiper-slide' : 'aafe-loop-grid__item'; echo '
'; if ( $template_id && class_exists( '\Elementor\Plugin' ) ) { // Set the global $post so dynamic tags work inside the template setup_postdata( get_post() ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped echo \Elementor\Plugin::$instance->frontend->get_builder_content_for_display( $template_id, true ); } else { // Default fallback output when no template is selected ?> '; } wp_reset_postdata(); } else { echo '

' . esc_html( $settings['no_posts_message'] ) . '

'; } echo '
'; // wrapper // Carousel Controls if ( $is_carousel ) { if ( 'yes' === $settings['carousel_dots'] ) { echo '
'; } if ( 'yes' === $settings['carousel_arrows'] ) { echo '
'; echo '
'; } } // Pagination (Only if not carousel) if ( ! $is_carousel && ! empty( $settings['pagination'] ) && 'yes' === $settings['pagination'] ) { echo '
'; // Get global query if available for pagination base $format = '?paged=%#%'; if ( get_option( 'permalink_structure' ) ) { $format = 'page/%#%/'; } echo wp_kses_post( paginate_links( [ 'base' => str_replace( '999999999', '%#%', esc_url( get_pagenum_link( 999999999 ) ) ), 'format' => $format, 'current' => max( 1, $paged ), 'total' => $query->max_num_pages, 'prev_text' => '←', 'next_text' => '→', ] ) ); echo '
'; } echo '
'; // .aafe-loop-grid } /** * Get available public post types for the source dropdown. * * @return array */ private function get_post_type_options() { $options = []; $post_types = get_post_types( [ 'public' => true ], 'objects' ); foreach ( $post_types as $pt ) { if ( in_array( $pt->name, [ 'attachment', \AddronixAddons\Loop_Builder::CPT, \AddronixAddons\Header_Footer::CPT ], true ) ) { continue; } $options[ $pt->name ] = $pt->label; } return $options; } }