Créer le formulaire de candidature
Nous rejoindre sur Discord : lien discord
Objet : Créer son formulaire de candidature
Pour créer votre formulaire de candidature, vous devez éditez le fichier site/content/candidature.json. Attention, le fichier json doit être identique pour le site vitrine et le site intranet de chaque faction. Sinon il ne fonctionnera pas correctement.
Le principe de fonctionnement de la structure prend la forme d'un tableau. Chaque élément de ce tableau représentera une section du formulaire de candidature. Voici un exemple de 2 sections :
Créer une section
Pour créer une section, vous devez ajouter l'élément suivant :
{
"section": "titre de la section",
"questions": [
"Liste des questions"
]
}
(Ajouter une virgule s'il y a une autre section qui suit)
Ajouter une question
Il existe différents types de section :
- text : Saisir un texte court
- longtext : Saisir un texte long
- number : Saisir un nombre
- list : Liste déroulante
- date : Format date (format Xelyos)
Vous pouvez placer chaque élément dans l'ordre que vous souhaitez.
Type text
Le type text permet à un candidat de saisir une information sous forme de texte court.
Format de la structure :
- type : type de la question (ici text)
- title : Titre de la question
- placeholder : Texte présent si la saisie est vide
- ecole : Titre de la question affiché côté l'intranet
- required : Est ce que la question est obligatoire ? (true => Oui, false => Non)
{
"type": "text",
"title": "Nom Prénom (IG) :",
"placeholder": "Entrer votre nom et votre prénom",
"ecole": "Nom/Prénom :",
"required": true
}
(Ajouter une virgule s'il y a une autre section qui suit)
Exemple de rendu :
Type longtext
Le type longtext permet à un candidat de saisir une information sous forme de texte long.
Format de la structure :
- type : type de la question (ici longtext)
- title : Titre de la question
- placeholder : Texte présent si la saisie est vide
- ecole : Titre de la question affiché côté l'intranet
- required : Est ce que la question est obligatoire ? (true => Oui, false => Non)
{
"type": "longtext",
"title": "Quels sont vos motivations ?",
"placeholder": "Motivations",
"ecole": "Motivations ?",
"required": true
}
(Ajouter une virgule s'il y a une autre section qui suit)
Exemple de rendu :
Type number
Le type number permet à un candidat de saisir une information sous forme de nombre.
Format de la structure :
- type : type de la question (ici number)
- title : Titre de la question
- placeholder : Texte présent si la saisie est vide
- ecole : Titre de la question affiché côté l'intranet
- min : Valeur minimum autorisée
- max : Valeur maximum autorisée
- required : Est ce que la question est obligatoire ? (true => Oui, false => Non)
{
"type": "number",
"title": "Age (IG) :",
"placeholder": "Age IG",
"ecole": "Age (IG) :",
"min": 18,
"max": 60,
"required": true
}
(Ajouter une virgule s'il y a une autre section qui suit)
Exemple de rendu :
Type list
Le type list permet à un candidat de saisir une information sous forme d'une liste déroulante.
Format de la structure :
- type : type de la question (ici liste déroulante)
- title : Titre de la question
- ecole : Titre de la question affiché côté l'intranet
- responses : Liste des réponses possible dans la liste de sélection (ajouter autant de réponse que vous le souhaitez)
{
"type": "list",
"title": "Avez-vous déjà été membres des forces de l'ordre ?",
"ecole": "Force de l'ordre ?",
"responses": [
"Non",
"Oui"
]
}
(Ajouter une virgule s'il y a une autre section qui suit)
Exemple de rendu :
Type date
Le type date permet à un candidat de saisir ses disponibilités.
Format de la structure :
- type : type de la question (ici date)
- title : Titre de la question
- ecole : Titre de la question affiché côté l'intranet
{
"type": "date",
"title": "Période scolaire/alternance",
"ecole": "Période scolaire/alternance"
}
(Ajouter une virgule s'il y a une autre section qui suit)
Exemple de rendu :
Principe de version
Si vous devez changer certaines questions, il n'est plus nécessaire de supprimer les candidatures présentes dans la base de données mais uniquement de changer le numéro présent dans votre .env (incrémentation recommandée).
Valeur à changer : version_candidature