Doc technique

⌘K
  2. Accueil
  4. Docs
  6. Doc technique
  8. Doc technique (v6)
  10. Personnaliser les CPT et taxonomies (v6)

Personnaliser les CPT et taxonomies (v6)

WP-Apidae enregistre 14 Custom Post Types (CPT) pour les types d’objets touristiques Apidae et une cinquantaine de taxonomies pour les critères associés (communes, thèmes, distinctions, labels…). Chaque enregistrement expose un filtre d’arguments qui permet de personnaliser labels, slugs et options.

Filtres d’enregistrement des CPT

Pour chaque CPT, WP-Apidae expose un filtre au nom normalisé wpdae_register_post_type_{slug}. La liste complète :

  • wpdae_register_post_type_ad_activite
  • wpdae_register_post_type_ad_commerce_et_servi
  • wpdae_register_post_type_ad_degustation
  • wpdae_register_post_type_ad_domaine_skiable
  • wpdae_register_post_type_ad_equipement
  • wpdae_register_post_type_ad_fete_et_manifesta
  • wpdae_register_post_type_ad_hebergement_colle
  • wpdae_register_post_type_ad_hebergement_locat
  • wpdae_register_post_type_ad_hotellerie
  • wpdae_register_post_type_ad_hotellerie_plein_
  • wpdae_register_post_type_ad_patrimoine_cultur
  • wpdae_register_post_type_ad_patrimoine_nature
  • wpdae_register_post_type_ad_restauration
  • wpdae_register_post_type_ad_sejour_package

Chaque filtre reçoit les arguments passés à register_post_type() et doit les retourner (éventuellement modifiés).

Exemple : personnaliser le slug et les labels d’un CPT

add_filter( 'wpdae_register_post_type_ad_hebergement_locat', function( $args ) {
    // Slug d'URL : /locations/ au lieu de /ad_hebergement_locat/
    $args['rewrite']['slug'] = 'locations';

    // Labels
    $args['labels']['name'] = 'Locations de vacances';
    $args['labels']['singular_name'] = 'Location de vacances';

    // Activer les archives
    $args['has_archive'] = 'locations';

    return $args;
} );

Filtres d’enregistrement des taxonomies

Pour chaque taxonomie Apidae, un filtre similaire est exposé : wpdae_register_taxonomy_{slug} (le slug taxonomie utilise le préfixe at_).

Exemples : wpdae_register_taxonomy_at_communes, wpdae_register_taxonomy_at_themes, wpdae_register_taxonomy_at_distinctions, wpdae_register_taxonomy_at_labels, etc.

Exemple : personnaliser le slug d’une taxonomie

add_filter( 'wpdae_register_taxonomy_at_communes', function( $args ) {
    $args['rewrite']['slug'] = 'ville';
    $args['labels']['name'] = 'Villes';
    $args['labels']['singular_name'] = 'Ville';
    return $args;
} );

Options depuis l’admin

Plusieurs options de configuration des CPT et taxonomies sont accessibles directement depuis WP-Apidae → Réglages → Objets touristiques :

  • Afficher les fiches dans le back office — masquer ou non les CPT du menu admin
  • Objets touristiques à importer — activer/désactiver chaque type
  • Permaliens — slug d’URL par défaut pour chaque type
  • Options des types de post personnalisés — show_in_nav_menus, has_archive globaux

Les filtres PHP wpdae_register_post_type_* interviennent après ces options admin et peuvent donc les surcharger.

Taxonomies Apidae principales

Rappel des taxonomies les plus utiles côté frontal (toutes préfixées at_) :

  • at_selectionids — sélections d’appartenance
  • at_communes — communes
  • at_departements — départements
  • at_themes — thèmes
  • at_categories — catégories
  • at_types — types
  • at_environnements — environnements
  • at_services — services
  • at_labels — labels
  • at_pratiques — pratiques
  • at_tourisme_affaire — aspects tourisme d’affaire
  • at_distinctions — distinctions (hiérarchique depuis v6.3)

Filtres liés aux distinctions

Les distinctions (étoiles hôtel, clés Clévacances, épis Gîtes de France…) ont leur propre API de filtres depuis v6.3 :

  • wpdae/distinctions/get_data — modifier les données d’une distinction
  • wpdae/distinctions/legacy_reference — fournir une référence legacy
  • wpdae/distinctions/before_process — pré-traitement
  • wpdae/distinctions/before_create_term — avant création du terme associé
  • wpdae/distinctions/enable_dual_write — activer la double écriture v5/v6

Aller plus loin

Étiquettes