> For the complete documentation index, see [llms.txt](https://akyos.gitbook.io/book/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://akyos.gitbook.io/book/wordpress/akyos-confort.md).

# Akyos Confort

## Process création de bloc Akyos 👩🏻‍🎨

1. Duplication de la colonne “Exemple de bloc” dans le Trello Blocs Akyos
2. Suivre le process “Comment créer un bloc Akyos ?”
3. Tester le bloc sur une nouvelle installation Wordpress de test
4. Faire une revue de code avec un leaddev
5. Présenter le bloc à Loucas et Corentin
6. Traiter les éventuels retours
7. Mettre à jour le référentiel des blocs Akyos pour ajouter le nouveau bloc à la liste

## Développement du bloc 🧑🏻‍💻

1. Valider avec Loucas et Corentin, à partir du design system, l’utilité, les fonctionnalités et les options du bloc à développer

2. Récupérer le repo Bloc Akyos sur Github, le cloner dans le projet directement sans passer par Composer et créer une nouvelle branche avec le nom du bloc

3. Suivre les étapes suivantes : \
   \
   NomDuBlock / NomDuBlock.php

   * Ajouter un premier champ select pour choisir le template (s’il y a plusieurs styles différents pour le même bloc), avec pour l’instant une seule option pour le template du bloc
   * Bien découper le bloc en sous blocs (titre et tag, image, boutons, … afin de ne pas dupliquer du code), que ce soit pour les groupes de champs ou pour les templates
   * Ajouter les champs dont on a besoin pour le bloc (titre, image, … ) en réutilisant les groupes de champs par défaut
   * Créer un fichier scss propre au bloc en utilisant les variables scss pré-existantes ou en en créant de nouvelles si besoin (couleurs, paddings, transitions, …)
   * Créer un template propre au bloc en réutilisant les sous blocs déjà existants

4. Respecter les bonnes pratiques suivantes : 

   * Pour nommer les champs, respecter la même nomenclature que pour les autres blocs déjà créés, nom en anglais, en snake\_case, qui décrit bien l’utilité dans le bloc
   * Tous les blocs vont avoir plusieurs variantes, ils doivent donc avoir plusieurs templates et le fichier scss doit contenir plusieurs styles (.style1, .style2, … ).
   * Bien mettre des commentaires sur chaque champ et chaque classe scss parentes pour expliquer son utilité
   * Pour le scss, respecter les bonnes pratiques Akyos <https://akyos.gitbook.io/book/sass/principes-obligatoires>&#x20;
   * Pour rendre le composant, utiliser la fonction printComponent <https://github.com/akyoscommunication/akyos-x-core/blob/main/src/bootstrap/helpers.php> afin de ne pas avoir à repasser sur tous les templates à chaque changement
   * Bien respecter les bonnes pratiques pour le backoffice <https://akyos.gitbook.io/book/php/wordpress-sage/back-office>

5. Vérifier avec un lead dev que le code est propre

6. Vérifier avec Corentin et Loucas que le rendu correspond bien à la maquette

7. Merge la branche sur la master puis **supprimer la branche**