Aller au contenu principal
Version: 0.3.0

Taxonomies

La création de taxonomies se fait via la méthode addTaxonomies. Cette méthode retourne une instance de la façade Taxonomy.

Créer une taxonomie​

astuce

Puisque chaque méthode public sera automatiquement éxecutée lors de l'enregistrement du post type, il est recommandé de créer les champs dans une méthode à part du constructeur.

app/PostTypes/MyPostType.php
public function setupCategoryTaxonomy()
{
    $this->addTaxonomy('caracteristics', 'Caractéristiques')
        ->isFemale()
        ->setLabels([
            'plural' => 'caractéristiques',
            'singular' => 'caractéristique',
        ])
        ->register();
}

slug​

string slug de la taxonomie.

string nom de la taxonomie dans le menu.

options​

array options de la taxonomie

Options par défaut
public $options = [
        "hierarchical" => true,
        "public" => true,
        "show_ui" => true,
        "show_admin_column" => true,
        "show_in_nav_menus" => true,
        "show_tagcloud" => true,
        "show_in_rest" => true,
        "query_var" => true,
    ];

isFemale | isMale​

Défini si le nom de la taxonomie est au féminin ou masculin.

setLabels​

array Défini les labels de la taxonomie.

  • plural : Nom pluriel de la taxonomie.
  • singular : Nom singulier de la taxonomie.

register​

void Enregistre la taxonomie.

Récupération des données​

getTerms​

array Récupère tout les termes de la taxonomie.

app/PostTypes/MyPostType.php
$terms = $this->getTerms('my_tax');

Arguments​

taxonomy​

string Nom de la taxonomie.

all​

bool Récupère tout les termes de la taxonomie, même ceux non utilisés.
(optionnel) | false

postId​

int ID du post. Récupère les termes associés à un post.
(optionnel) | null