feat: first working version
This commit is contained in:
MrRaph_
272
widgets/category-grid-widget.php
Normal file
272
widgets/category-grid-widget.php
Normal file
@@ -0,0 +1,272 @@
|
||||
<?php
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Empêche l'accès direct.
|
||||
}
|
||||
|
||||
/**
|
||||
* Classe Elementor_Category_Grid_Widget.
|
||||
*
|
||||
* Widget Elementor personnalisé qui affiche une grille de catégories d'articles.
|
||||
* Chaque catégorie est affichée sous forme de carte avec son nom, son image et un lien vers son archive.
|
||||
*/
|
||||
class Elementor_Category_Grid_Widget extends \Elementor\Widget_Base {
|
||||
|
||||
/**
|
||||
* Identifiant unique du widget.
|
||||
*
|
||||
* @return string Slug du widget.
|
||||
*/
|
||||
public function get_name(): string {
|
||||
return 'category-grid';
|
||||
}
|
||||
|
||||
/**
|
||||
* Titre du widget affiché dans l'interface Elementor.
|
||||
*
|
||||
* @return string Titre du widget.
|
||||
*/
|
||||
public function get_title(): string {
|
||||
return esc_html__( 'Grille de Catégories', 'category-grid-widget' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Icône du widget (bibliothèque d'icônes Elementor).
|
||||
*
|
||||
* @return string Classe de l'icône du widget.
|
||||
*/
|
||||
public function get_icon(): string {
|
||||
return 'eicon-posts-grid';
|
||||
}
|
||||
|
||||
/**
|
||||
* Catégories Elementor dans lesquelles le widget apparaîtra.
|
||||
*
|
||||
* @return array Catégories du panneau Elementor.
|
||||
*/
|
||||
public function get_categories(): array {
|
||||
return [ 'general' ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Mots-clés facilitant la recherche du widget.
|
||||
*
|
||||
* @return array Mots-clés du widget.
|
||||
*/
|
||||
public function get_keywords(): array {
|
||||
return [ 'category', 'catégorie', 'grid', 'grille' ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Enregistrer les contrôles du widget (champs configurables dans Elementor).
|
||||
*/
|
||||
protected function register_controls(): void {
|
||||
/* Section "Contenu" pour le choix des catégories et options de requête */
|
||||
$this->start_controls_section(
|
||||
'section_content',
|
||||
[
|
||||
'label' => esc_html__( 'Catégories', 'category-grid-widget' ),
|
||||
'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
|
||||
]
|
||||
);
|
||||
|
||||
// Contrôle : Sélection des catégories à afficher (multisélection).
|
||||
$options = [];
|
||||
$categories = get_categories( [ 'hide_empty' => false ] );
|
||||
foreach ( $categories as $cat ) {
|
||||
$options[ $cat->term_id ] = $cat->name;
|
||||
}
|
||||
$this->add_control(
|
||||
'categories',
|
||||
[
|
||||
'label' => esc_html__( 'Catégories à afficher', 'category-grid-widget' ),
|
||||
'type' => \Elementor\Controls_Manager::SELECT2,
|
||||
'multiple' => true,
|
||||
'label_block' => true,
|
||||
'options' => $options,
|
||||
'description' => esc_html__( 'Sélectionnez les catégories d’articles à afficher.', 'category-grid-widget' ),
|
||||
]
|
||||
);
|
||||
|
||||
// Contrôle : Inclure les sous-catégories.
|
||||
$this->add_control(
|
||||
'show_subcategories',
|
||||
[
|
||||
'label' => esc_html__( 'Afficher les sous-catégories', 'category-grid-widget' ),
|
||||
'type' => \Elementor\Controls_Manager::SWITCHER,
|
||||
'label_on' => esc_html__( 'Oui', 'category-grid-widget' ),
|
||||
'label_off' => esc_html__( 'Non', 'category-grid-widget' ),
|
||||
'return_value' => 'yes',
|
||||
'default' => 'yes',
|
||||
'description' => esc_html__( 'Inclure aussi les sous-catégories des catégories sélectionnées.', 'category-grid-widget' ),
|
||||
]
|
||||
);
|
||||
|
||||
// Contrôle : Trier par (critère de tri des catégories).
|
||||
$this->add_control(
|
||||
'order_by',
|
||||
[
|
||||
'label' => esc_html__( 'Trier par', 'category-grid-widget' ),
|
||||
'type' => \Elementor\Controls_Manager::SELECT,
|
||||
'options' => [
|
||||
'name' => esc_html__( 'Nom (alphabétique)', 'category-grid-widget' ),
|
||||
'count' => esc_html__( 'Nombre d’articles', 'category-grid-widget' ),
|
||||
'id' => esc_html__( 'ID (date de création)', 'category-grid-widget' ),
|
||||
],
|
||||
'default' => 'name',
|
||||
]
|
||||
);
|
||||
|
||||
// Contrôle : Ordre croissant/décroissant.
|
||||
$this->add_control(
|
||||
'order',
|
||||
[
|
||||
'label' => esc_html__( 'Ordre', 'category-grid-widget' ),
|
||||
'type' => \Elementor\Controls_Manager::SELECT,
|
||||
'options' => [
|
||||
'ASC' => esc_html__( 'Croissant (A-Z / 0-9)', 'category-grid-widget' ),
|
||||
'DESC' => esc_html__( 'Décroissant (Z-A / 9-0)', 'category-grid-widget' ),
|
||||
],
|
||||
'default' => 'ASC',
|
||||
]
|
||||
);
|
||||
|
||||
$this->end_controls_section();
|
||||
|
||||
/* Section "Mise en page" pour les options d'affichage (colonnes, taille d'image) */
|
||||
$this->start_controls_section(
|
||||
'section_layout',
|
||||
[
|
||||
'label' => esc_html__( 'Mise en page', 'category-grid-widget' ),
|
||||
'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
|
||||
]
|
||||
);
|
||||
|
||||
// Contrôle : Nombre de colonnes de la grille.
|
||||
$this->add_control(
|
||||
'columns',
|
||||
[
|
||||
'label' => esc_html__( 'Nombre de colonnes', 'category-grid-widget' ),
|
||||
'type' => \Elementor\Controls_Manager::SELECT,
|
||||
'options' => [
|
||||
1 => '1',
|
||||
2 => '2',
|
||||
3 => '3',
|
||||
4 => '4',
|
||||
5 => '5',
|
||||
6 => '6',
|
||||
],
|
||||
'default' => 3,
|
||||
]
|
||||
);
|
||||
|
||||
// Contrôle : Taille des images affichées.
|
||||
$this->add_control(
|
||||
'image_size',
|
||||
[
|
||||
'label' => esc_html__( 'Taille des images', 'category-grid-widget' ),
|
||||
'type' => \Elementor\Controls_Manager::SELECT,
|
||||
'options' => [
|
||||
'thumbnail' => esc_html__( 'Miniature (thumbnail)', 'category-grid-widget' ),
|
||||
'medium' => esc_html__( 'Moyen (medium)', 'category-grid-widget' ),
|
||||
'large' => esc_html__( 'Grand (large)', 'category-grid-widget' ),
|
||||
'full' => esc_html__( 'Plein (full)', 'category-grid-widget' ),
|
||||
],
|
||||
'default' => 'medium',
|
||||
]
|
||||
);
|
||||
|
||||
$this->end_controls_section();
|
||||
}
|
||||
|
||||
/**
|
||||
* Générer l'affichage du widget côté front-end.
|
||||
*/
|
||||
protected function render(): void {
|
||||
$settings = $this->get_settings_for_display();
|
||||
|
||||
// Récupérer les ID des catégories sélectionnées.
|
||||
$selected_ids = [];
|
||||
if ( ! empty( $settings['categories'] ) ) {
|
||||
// S'assurer d'avoir un tableau d'ID (entiers).
|
||||
$selected_ids = is_array( $settings['categories'] ) ? $settings['categories'] : [ $settings['categories'] ];
|
||||
$selected_ids = array_map( 'intval', $selected_ids );
|
||||
}
|
||||
if ( empty( $selected_ids ) ) {
|
||||
// Aucune catégorie sélectionnée : ne rien afficher.
|
||||
return;
|
||||
}
|
||||
|
||||
// Déterminer les catégories à afficher (inclure les sous-catégories si demandé).
|
||||
$category_ids_to_show = $selected_ids;
|
||||
if ( ! empty( $settings['show_subcategories'] ) && $settings['show_subcategories'] === 'yes' ) {
|
||||
// Ajouter les sous-catégories de chaque catégorie sélectionnée.
|
||||
foreach ( $selected_ids as $cat_id ) {
|
||||
$child_ids = get_term_children( $cat_id, 'category' );
|
||||
if ( is_array( $child_ids ) && ! empty( $child_ids ) ) {
|
||||
$category_ids_to_show = array_merge( $category_ids_to_show, $child_ids );
|
||||
}
|
||||
}
|
||||
// Éliminer les doublons d'ID au cas où.
|
||||
$category_ids_to_show = array_unique( $category_ids_to_show );
|
||||
}
|
||||
|
||||
// Préparer les arguments de requête pour récupérer les termes.
|
||||
$term_args = [
|
||||
'taxonomy' => 'category',
|
||||
'include' => $category_ids_to_show,
|
||||
'hide_empty' => false,
|
||||
];
|
||||
// Appliquer les options de tri.
|
||||
if ( ! empty( $settings['order_by'] ) ) {
|
||||
$term_args['orderby'] = $settings['order_by'];
|
||||
}
|
||||
if ( ! empty( $settings['order'] ) ) {
|
||||
$term_args['order'] = $settings['order'];
|
||||
}
|
||||
|
||||
// Obtenir les termes de catégories à afficher.
|
||||
$categories = get_terms( $term_args );
|
||||
if ( is_wp_error( $categories ) || empty( $categories ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Calculer la classe CSS pour le nombre de colonnes (pour usage dans le CSS).
|
||||
$columns = ! empty( $settings['columns'] ) ? (int) $settings['columns'] : 3;
|
||||
$grid_class = 'columns-' . $columns;
|
||||
|
||||
// Début du markup HTML de la grille.
|
||||
echo '<div class="elementor-category-grid ' . esc_attr( $grid_class ) . '">';
|
||||
foreach ( $categories as $term ) {
|
||||
$term_name = $term->name;
|
||||
$term_link = get_term_link( $term );
|
||||
if ( is_wp_error( $term_link ) ) {
|
||||
continue; // Ignorer si le lien d'archive pose un problème.
|
||||
}
|
||||
// Récupérer l'image de la catégorie via sa méta 'thumbnail_id' (image mise en avant de la catégorie).
|
||||
$image_url = '';
|
||||
$thumbnail_id = get_term_meta( $term->term_id, 'thumbnail_id', true );
|
||||
if ( $thumbnail_id ) {
|
||||
$size = ! empty( $settings['image_size'] ) ? $settings['image_size'] : 'medium';
|
||||
$image_url = wp_get_attachment_image_url( $thumbnail_id, $size );
|
||||
}
|
||||
|
||||
echo '<div class="category-card">';
|
||||
// Rendre la carte cliquable vers l'archive de la catégorie.
|
||||
echo '<a href="' . esc_url( $term_link ) . '">';
|
||||
// Image de la catégorie (si disponible).
|
||||
if ( $image_url ) {
|
||||
echo '<div class="category-card-image">';
|
||||
echo '<img src="' . esc_url( $image_url ) . '" alt="' . esc_attr( $term_name ) . '" />';
|
||||
echo '</div>';
|
||||
}
|
||||
// Nom de la catégorie.
|
||||
echo '<div class="category-card-name">' . esc_html( $term_name ) . '</div>';
|
||||
echo '</a>';
|
||||
echo '</div>'; // .category-card
|
||||
}
|
||||
echo '</div>'; // .elementor-category-grid
|
||||
|
||||
// Astuce : ajouter du CSS (feuille de style ou balise <style>) pour styliser la grille.
|
||||
// Par exemple, .elementor-category-grid.columns-3 .category-card { width: 33.33%; float: left; } pour disposer 3 colonnes.
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user