# Structure des dossiers et nomenclaturev1.1+

Voici la nomenclature pour chaque type de contenu dans le panneau d'administration.

WARNING

Utilisez toujours les camelCases pour être cohérent avec la façon native de Craft CMS

# Sections

Nommez les handles de vos sections selon la formule suivante [section type][name en anglais]. Le nom des structures et channel est visible pour le client, celui-ci peut être en français.

# Exemples si le client est francophone :

Type de section	Name	Handle
Channel	Nouvelles	channelNews
Structure	Équipe	structureTeam
Single	Accueil - Single	singleHome

# Exemples si le client est anglophone :

Type de section	Name	Handle
Channel	News	channelNews
Structure	Team	structureTeam
Single	Home - Single	singleHome

TIP

Les handle seront donc toujours uniques. Que faire si j'ai 2 noms identiques ?

Comme le nom de section doit être unique dans le panneau, si par exemple, vous avez un Single et un Channel avec le même nom, nommez le Single Nom du single - Single. Donc, toujours utiliser le nom "court" pour les structures et channel car un single sera renommé par son champ Title.

# Entry types multiples

# Exemples si une section a plusieurs entry types :

Essayez de conserver un nom de handle simple et court pour les entry types.

Section	Entry types name	Handle
structureTeam	Boss	boss
	Employee	employee
	Council	council
-	-	-
structurePages	Mission	mission
	Événements	events

TIP

Pourquoi le entry type possède un nom simple ?

C'est scopé à la section
Dans le dossier de templates, le dossier sera nommé selon ce handle et le index.twig de la structure va pointer automatiquement vers ce dossier.

# Fields

Regroupez vos fields par groupes en utilisant le nom de vos sections. Voici quelques exemple :

• structureTeam, structurePartners, channelNews, etc.

Si des fields sont partagés, un groupe devra être créé dans la sidebar et nommé shared. Pour les fields globaux, un groupe devra être créé et nommé global.

# Nomenclature - Fields d'une section avec 1 seul entry type

Préfixer les fields du nom de la section. Exemple pour un channel channelEvents avec 1 seul entry type :

Name	Handle
Lieu	channelEventsLocation
Date de début	channelEventsStartDate

# Nomenclature - Fields d'une section avec plusieurs entry types

Si votre section a plusieurs entry types, le entry type se retrouvera dans le handle. Exemple pour une section structurePages avec plusieurs entry types.

Dans la sidebar, un seul field group sera présent et nommé structurePages.

Name	Handle
Présentation	structurePagesAboutPresentation
CTA équipe	structurePagesTeamCtaText
Valeurs	structurePagesAboutValues

TIP

Pourquoi préfixer avec la section ? Imaginez un gros site avec une structure Events, mais également un single Events (disons une page). Les deux sections possèdent un field Intro, mais différent. Le préfixe permet de régler cela facilement. Nous aurions dans ce cas, un field singleEventsIntro et un field structureEventsIntro.

# Matrix fields

Le matrix field va prendre le handle tel que vu précémment. Pour une matrix principale partagée à travers plusieurs sections, ce serait exemple : sharedMainMatrix.

# Les blocks

Les blocs d'une matrix sont scopés à cette matrix. Utilisez seulement le préfix block.

blockTextImg, blockGallery, etc.

# Les fields des blocks

Pour les fields de vos blocs, utilisez ensuite le nom du bloc comme préfix. Exemple :

blockGalleryIntro, blockGalleryAssets, blockGalleryLink, etc.

# Category Groups

Pour les groupes de catégories, utilisez le Handle sous la forme suivante : categoryNameOfMyCategory

Quelques exemples :

Name	Handle
Activités Type - Catégories	categoryActivitiesTypes
Nouvelles Sujet - Catégories	categoryNewsSubject
Fruits couleurs - Catégories	categoryFruitsColors

# Global fields

À venir

← Dossiers Compilation →