WP Manifestindependent plugin directory
manifest / content / ng1-catalogue-collection

NG1 Catalogue Collection

Ajoute un Custom Post Type "collection" avec les taxonomies "couleurs", "effets", "dimensions" et "épaisseur", exposés via l'API REST.

by GEHIN Nicolas · github.com/nicolascaen/ng1-catalogue-collection

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/nicolascaen/ng1-catalogue-collection/archive/refs/heads/Master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/nicolascaen/ng1-catalogue-collection ↗

Plugin WordPress permettant de gérer un catalogue de collections avec filtrage avancé dans l'API REST et exposition de métadonnées synthétiques.

Fonctionnalités principales

  • Enregistre un Custom Post Type public collection avec support de l'éditeur, des images mises en avant, des extraits et des champs personnalisés. L'API REST expose ces contenus sous wp-json/wp/v2/collections grâce à la base rest_base => collections.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#69-168
  • Crée six taxonomies hiérarchiques (categorie, couleurs, effets, dimensions, epaisseur, labels) toutes disponibles dans l'administration et via l'API REST, avec une base REST dédiée évitant les collisions de routes.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#109-167
  • Ajoute un filtre REST rest_collection_query acceptant des paramètres par IDs ou slugs, ainsi qu'un opérateur AND optionnel (*_all=1) pour restreindre les collections retournées. Support étendu à la taxonomie labels pour marquer « Nouveauté », « Premier Prix », etc.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#14-63
  • Expose des métadonnées de comptage (categorie_count, couleurs_count, etc.) dans l'API REST et met automatiquement à jour ces valeurs au moment de l'enregistrement d'une collection.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#171-266
  • Masque automatiquement le rendu des blocs liés aux métas de comptage lorsque la valeur est nulle, afin d'éviter l'affichage d'informations vides.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#268-333
  • Insère des termes par défaut pour la taxonomie categorie lors de l'activation du plugin pour faciliter la prise en main.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#336-374

Installation

  1. Copier le dossier ng1-catalogue-collection dans wp-content/plugins/.
  2. Activer le plugin depuis Extensions > Installées dans l'administration WordPress.
  3. Accéder au menu Collections pour créer vos contenus.

L'activation du plugin enregistre automatiquement le type de contenu et les taxonomies, puis insère les catégories par défaut avant de rafraîchir les permaliens.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#336-354

Configuration et personnalisation

  • Compléter ou modifier les termes des différentes taxonomies selon votre catalogue (menu Collections > Taxonomies associées).
  • Mettre à jour les permaliens si nécessaire depuis Réglages > Permaliens après des changements majeurs de structure.
  • Adapter les métadonnées exposées en modifiant la carte retournée par ng1_cc_get_taxonomy_meta_map() si vous souhaitez ajouter ou retirer des champs.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#170-205

Utilisation

Interface d'administration

  • Ajoutez de nouvelles collections via Collections > Ajouter. Les champs standards de WordPress sont disponibles : titre, éditeur, image mise en avant, extrait, champs personnalisés et révisions.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#90-107
  • Associez des termes de taxonomie pour permettre un filtrage fin dans le front ou via l'API.

API REST

Les collections sont exposées sous :

GET /wp-json/wp/v2/collections

Paramètres de filtrage disponibles (valeurs CSV) :

Paramètre Description Exemple
categorie IDs de termes categorie categorie=12,45
categorie_slugs Slugs de termes categorie categorie_slugs=sols
couleurs, effets, dimensions, epaisseur, labels IDs pour les autres taxonomies couleurs=1,7
{taxonomie}_slugs Slugs pour chaque taxonomie (labels_slugs inclus) effets_slugs=mat,brut
{taxonomie}_all=1 Active un filtrage AND (tous les termes doivent matcher) dimensions_all=1

Sans suffixe _all, le filtrage utilise un opérateur IN (équivalent OR).@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#14-63

Métadonnées exposées

Chaque collection fournit dans l'API les méta-clés suivantes :

  • categorie_count
  • couleurs_count
  • effets_count
  • dimensions_count
  • epaisseur_count

Leur valeur est formatée automatiquement ("2 Couleurs", "1 Effet", etc.) et masquée dans le front si elle vaut zéro.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#224-333

Hooks disponibles

  • rest_collection_query (filtre) : adapter les arguments de requête REST avant exécution. La fonction fournie est ng1_cc_rest_collection_query() et peut être remplacée par un hook personnalisé si besoin.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#22-63
  • render_block (filtre) : ng1_cc_hide_zero_meta_binding() masque certains blocs en fonction des métadonnées. Votre propre hook peut s'exécuter avant ou après (priorité 9).@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#283-333

Développement

  • Version : 1.1.0.@plugins/ng1-catalogue-collection/ng1-catalogue-collection.php#5-7
  • Auteur : Nicolas Gehin.
  • Le code est entièrement localisé via le text domain ng1-catalogue-collection. Pensez à charger vos fichiers de traduction si vous étendez le plugin.

Support

Pour toute question ou contribution, contactez l'auteur via les canaux habituels ou créez une issue sur le dépôt correspondant.