Aller au contenu

Points d'extension

phil/taxonomy-bundle

Ce qu'une application configure, remplace ou utilise. Les ressources sont des références de phil/resource, et les slugs sont ceux de phil/slug.

Configuration

OptionCe qu'elle étend
sluggerL'identifiant de service du générateur de slugs qui produit les slugs des étiquettes et les clés de catégorie : un générateur nommé de phil/slug-bundle, phil_slug.slugger.tags, ou un générateur décoré ; null pour le générateur par translittération
fallback_localeLa langue du nom d'une catégorie quand il n'y en a aucun dans la langue demandée

Voir Étiquettes et Catégories.

Les ressources de l'application

Toute ressource est étiquetée ou classée par sa référence — article, media.image, les sortes que choisit l'application — et taggedWith() les relit par sorte : la taxonomie n'en sait rien d'autre. Un bundle qui étiquette ses propres ressources, comme phil/calendar-bundle le fait pour ses événements, choisit une sorte qui lui est propre.

TaxonomyRepository

Phil\TaxonomyBundle\Domain\Repository\TaxonomyRepository — étiquettes, catégories, traductions et attributions, un alias public de DoctrineTaxonomyRepository. Un stockage propre à l'application garde les méthodes par lot — tags(), categoriesWithIds(), translationsOf() — qui en lisent beaucoup d'un coup, et branchIds(), qui lit toute la branche en une seule lecture : les déplacements restent ainsi sans cycle sans lire l'arbre nœud par nœud.

Services et formulaires

PointComment
TaxonomyInjecté pour trouver ou créer, renommer, déplacer et fusionner, et pour étiqueter les ressources
TagsTypeLes étiquettes en texte, séparées par des virgules
CategoryTypeUne catégorie choisie dans l'arbre
Plus que ce que fait un champUne extension de type de formulaire de l'application sur l'un ou l'autre type — voir Formulaires