*/ protected $deprecated_attributes = [ 'category' => 'taxonomy', 'posts_per_grid' => 'posts_per_page', 'icon' => 'show_icon', 'post_counter' => 'show_count' ]; public function get_name() { return 'betterdocs_category_grid'; } public function get_style_depends() { return [ 'betterdocs-category-grid' ]; } public function get_script_depends() { return [ 'betterdocs-category-grid' ]; } /** * Summary of default_attributes * @return array */ public function default_attributes() { return [ 'sidebar_list' => false, 'taxonomy' => 'doc_category', 'show_icon' => true, 'category_icon' => '', 'masonry' => false, 'posts_per_page' => $this->settings->get( 'posts_number', 0 ), 'orderby' => $this->settings->get( 'alphabetically_order_post', 'betterdocs_order' ), 'order' => $this->settings->get( 'docs_order', 'ASC' ), 'show_count' => $this->settings->get( 'post_count' ), 'count_suffix' => '', 'count_suffix_singular' => '', 'column' => $this->settings->get( 'column_number' ), 'nested_subcategory' => $this->settings->get( 'nested_subcategory' ), 'terms' => '', 'terms_orderby' => '', 'terms_order' => '', 'terms_include' => '', 'terms_exclude' => '', 'terms_offset' => '', 'kb_slug' => '', 'multiple_knowledge_base' => false, 'disable_customizer_style' => false, 'title_tag' => 'h2', 'category_title_link' => false, 'layout_type' => '', 'list_icon_url' => '', 'list_icon_name' => 'list', 'show_list_icon' => true, 'sidebar_layout' => '', 'wrapper_class' => [] ]; } public function generate_attributes() { $attributes = [ 'class' => [ 'betterdocs-category-grid-inner-wrapper', $this->layout_class ] ]; $masonry = (bool) $this->settings->get( 'masonry_layout', false ); if ( $this->has( 'masonry' ) ) { $masonry = (bool) $this->attributes['masonry']; } if ( ! is_singular( 'docs' ) && ! is_tax( 'doc_category' ) && ! is_tax( 'doc_tag' ) ) { if ( $this->attributes['sidebar_list'] == true ) { $attributes['class'][] = 'layout-flex'; } elseif ( $masonry == true ) { wp_enqueue_script( 'masonry' ); $attributes['class'][] = 'masonry'; } else { $attributes['class'][] = 'layout-flex'; } if ( $this->attributes['sidebar_list'] == true ) { $_column_val = 1; } elseif ( $this->isset( 'column' ) ) { $_column_val = $this->attributes['column']; } else { $_column_val = $this->settings->get( 'column_number' ); } $attributes['class'][] = 'docs-col-' . $_column_val; $attributes['data-column_desktop'] = esc_html( $_column_val ); $attributes['style'] = "--column: $_column_val;"; if ( $this->isset( 'disable_customizer_style', false ) ) { $attributes['class'][] = 'single-kb'; } } return $attributes; } public function header_layout_sequence( $sequence, $layout, $widget_type, $args ) { return [ 'category_icon', 'category_title', 'category_counts', 'collapse_icon' ]; } public function render( $atts, $content = null ) { if ( (bool) $this->attributes['sidebar_list'] ) { add_filter( 'betterdocs_header_layout_sequence', [ $this, 'header_layout_sequence' ], 10, 4 ); } $this->views( 'layouts/base' ); if ( (bool) $this->attributes['sidebar_list'] ) { remove_filter( 'betterdocs_header_layout_sequence', [ $this, 'header_layout_sequence' ], 10 ); } } public function view_params() { $exploremore_btn = $this->settings->get( 'exploremore_btn' ); $button_text = $this->settings->get( 'exploremore_btn_txt' ); $category_title_link = isset( $this->attributes['category_title_link'] ) ? $this->attributes['category_title_link'] : ''; $show_button = false; if ( $this->attributes['posts_per_page'] == -1 ) { $show_button = false; } elseif ( $exploremore_btn && ! is_singular( 'docs' ) && Helper::get_tax() != 'doc_category' && ! is_tax( 'doc_tag' ) ) { $show_button = true; } $terms_query = $this->query->terms_query( [ 'taxonomy' => $this->attributes['taxonomy'], 'multiple_kb' => $this->attributes['multiple_knowledge_base'], 'kb_slug' => $this->attributes['kb_slug'], 'terms' => $this->attributes['terms'], 'order' => $this->attributes['terms_order'], 'orderby' => $this->attributes['terms_orderby'], 'nested_subcategory' => $this->attributes['nested_subcategory'] ] ); if ( $this->attributes['terms_include'] ) { $terms_query['include'] = $this->attributes['terms_include']; } if ( $this->attributes['terms_exclude'] ) { $terms_query['exclude'] = $this->attributes['terms_exclude']; } if ( $this->attributes['terms_offset'] ) { $terms_query['offset'] = (int) $this->attributes['terms_offset']; } $inner_wrapper_attr = $this->generate_attributes(); $docs_query = [ 'orderby' => $this->attributes['orderby'], 'order' => $this->attributes['order'], 'posts_per_page' => $this->attributes['posts_per_page'] ]; /** * Add This Attribute When Using Outside Betterdocs Templates Only */ if ( $this->attributes['multiple_knowledge_base'] && ( ! empty( $this->attributes['kb_slug'] ) ) && ( ! betterdocs()->helper->is_templates() ) ) { $inner_wrapper_attr['data-mkb-slug'] = $this->attributes['kb_slug']; } // Prepare wrapper attributes with custom classes $wrapper_attr_classes = [ 'betterdocs-category-grid-wrapper' ]; // Add custom wrapper classes if provided if ( $this->isset( 'wrapper_class' ) ) { $wrapper_classes = $this->attributes['wrapper_class']; // Handle both array and string formats if ( is_string( $wrapper_classes ) ) { // Split by comma or space and clean up $wrapper_classes = preg_split( '/[,\s]+/', $wrapper_classes ); $wrapper_classes = array_filter( array_map( 'trim', $wrapper_classes ) ); } elseif ( is_array( $wrapper_classes ) ) { $wrapper_classes = array_filter( $wrapper_classes ); } if ( ! empty( $wrapper_classes ) ) { $wrapper_attr_classes = array_merge( $wrapper_attr_classes, $wrapper_classes ); } } return [ 'wrapper_attr' => [ 'class' => $wrapper_attr_classes ], 'inner_wrapper_attr' => $inner_wrapper_attr, 'layout' => 'default', 'widget_type' => 'category-grid', 'terms_query_args' => $terms_query, 'docs_query_args' => $docs_query, 'nested_docs_query_args' => $docs_query, 'list_icon_name' => ($this->attributes['list_icon_name'] ?? 'list') == 'list' ? 'list' : [ 'value' => $this->attributes['list_icon_name'] ?? 'list' ], 'show_header' => true, 'show_list' => true, 'show_title' => true, 'show_button' => $show_button, 'button_text' => $button_text, 'show_button_icon' => true, 'button_icon_position' => true, 'title_tag' => $this->attributes['title_tag'] ?? 'h2', 'button_icon' => true, 'category_title_link' => $category_title_link, 'layout_type' => $this->attributes['layout_type'] ?? '', 'list_icon_url' => $this->attributes['list_icon_url'] ?? '', 'show_list_icon' => $this->attributes['show_list_icon'] ?? true, 'sidebar_layout' => $this->attributes['sidebar_layout'] ?? '' ]; } }