Ayant l'envie de tester Drupal 8, sans prendre trop de risques, je me suis décidé à prendre comme prétexte la création d'un site de pronostics pour l'euro 2016 (oui je m'y prends tôt).
Un petit coup de modélisation de mon schéma de données, et hop c'est parti.
Pour info, je vais tenter de faire plusieurs notes comme celle là, et autant en faire profiter tout le monde, mon code sera sur Github, au fur et à mesure, car cela évitera d'avoir des posts de 4km de long, l'adresse du projet sur Github : https://github.com/kgaut/mespronos
Le contexte
Installation du Drupal, je suis parti sur la beta 2.
Petites modifications dans le fichier settings.php pour sortir les dossiers de configurations de Drupal en dehors du docroot (donc non accessible via le web) :
$config_directories['active'] = '../config/active';
$config_directories['staging'] = '../config/staging';
Ensuite on rentre dans le vif du sujet avec la création de ma première entité drupal 8.
Je vous présente l'entité "League" qui contiendra les différentes compétitions de sport sur lesquelles des concours de pronostics seront organisés.
- lid : Clé primaire
- name : le nom de la compétition. Ex : "Ligue 1 2014-2015"
- classement : doit-on calculer le classement pour ce concours ? (oui pour un championnat, non pour un mondial ou un euro)
- status : archivé, en cours, terminé...
Mon entité sera contenue dans un module qui s’appellera "mespronos_leagues", car j'aime bien avoir un module par fonctionnalité.
Let's generate !
Pour la génération du module ainsi que de l'entité j'ai utilisé le super projet "console", que j'ai installé via composer. Je vous invite à découvrir l'installation et l'utilisation de ce module via ce tutoriel à l'adresse suivante : Créer un module Drupal 8 en 30 secondes | Flocon de toile.
J'ai donc crée mon module à l'aide de la commande suivantes
bin/console generate:module
une fois le module généré, il est temps de créer l'entité, toujours avec console, via la commande suivante :
bin/console generate:entity:content
et là c'est magique, le contrôleur, les routes, l'entité, l'arborescence des dossiers... tout est généré automatiquement :
Encore une fois, sur la génération d'entités, tout est encore superbement expliqué sur ce site : Créer une entité Drupal 8 en 10 secondes top chrono | Flocon de toile
[scald=9:sdl_editor_representation]
il ne reste plus qu'à personnaliser selon nos besoins.
Ajout de propriétés
Une entité est "fieldable" c'est à dire que l'on peut très bien lui ajouter des champs via l'interface d'administration, comme l'on ferai avec un type de contenu. Mais comme vous le savez sûrement l'ajout d'un champ entraîne la création de deux tables (une pour la valeur, et une pour les révisions) ainsi une baisse de performance lors de l'affichage de notre contenu car cela génère forcement des jointures.
Une autre possibilité offerte par les entités est de définir des propriétés, c'est à dire des attributs qui seront présents directement dans la même table que notre entité.
Il faut pour cela modifier la méthode baseFieldDefinitions de notre entité (dans le fichier src/Entity/League.php)
Voici un exemple de code pour ajouter mon attribut "classement", qui est un booléen non affiché en front, mais présent sur le formulaire d'administration.
$fields['classement'] = BaseFieldDefinition::create('boolean')
->setLabel(t('Classement activé'))
->setDescription(t('Doit-on calculer le classement entre les équipes pour cette competitions'))
->setDisplayConfigurable('form', TRUE)
->setDisplayConfigurable('view', TRUE)
->setDefaultValue(TRUE)
->setDisplayOptions('form', array(
'type' => 'boolean_checkbox',
'settings' => array(
'display_label' => TRUE,
)
))
->setDisplayOptions('view', array(
'type' => 'hidden',
));Pour voir l'intégralité de mes modifications, vous pouvez consulter le fichier sur github : https://github.com/kgaut/mespronos/blob/master/modules/custom/mespronos_...
Personnalisation des routes et du menu
Dernier point que je souhaiter modifier, les routes et le menu. Dans drupal 8 le HOOK_menu n'existe plus, tout à été remplacé par de la configuration dans des fichiers YAML (welcome Symfony)
Les routes sont les chemins d'accès, et sont défini dans le fichier mespronos_leagues.routing.yml.
Les éléments de menu sont eux dispatchés dans plusieurs fichiers suivant leur type :
[scald=10:sdl_editor_representation]
Dans l'admin dans la partie contenu, je voulais un onglet menant à la liste de tous mes compétitions, comme cela :
[scald=11:sdl_editor_representation]
J'ai donc pour cela modifié le fichier mespronos_leagues.routing.yml et ajouté les lignes suivantes :
league.list:
title: 'Compétitions'
route_name: league.list
description: 'Liste de toutes les compétitions'
base_route: system.admin_content
C'est tout pour aujourd'hui, n'hésitez pas à consulter mon code sur github, j'ai mis l'intégralité de ce module, et j'ajouterai au fur et à mesure la suite. Si vous voyez des erreurs, des améliorations, n'hésitez-pas à me faire des push-request.
Le projet sur github : https://github.com/kgaut/mespronos
Quelques liens qui m'ont beaucoup servis :
