Message d'avertissement

The subscription service is currently unavailable. Please try again later.

Planète

Par kgaut
Adhérent
Kevin Gautreau

Sideproject : Tableau de bord de gestion de mes projets de maintenance

Petit article un peu particulier afin de présenter mon dernier side-project : un outil de gestion de mes projets de maintenance.

Jusqu'à peu, je gérais mes projets de maintenance dans des feuilles de calcul où pour chaque intervention, je notais le temps passé, pour ensuite facturer en fin de mois.

Dans le même temps, je travaille avec de multiples clients qui ont chacun leur système de ticket (github, gitlab.com, gitlab auto-hébergé, pivotal tracker...) et donc je n'avais pas non plus de vue globale sur l'ensemble de mes tickets à traiter au niveau de tous mes clients.

Tombant par hasard sur un module drupal gitlab_api, l'idée m'est venue de faire un outil pour lister l'ensemble de mes tickets gitlab (avec dans l'idée ensuite de faire des connecteurs avec d'autres systèmes). Le module n'accepte par défaut la connexion à un seul serveur, j'ai donc proposé une nouvelle fonctionnalité : l'utilisation de config entities, afin de gérer de multiples connexions (gitlab.com, et autant de gitlab auto-hébergés que nécessaires).

J'ai par la suite développé un module équivalent pour me connecter à l'api de github, puis un autre pour me connecter à pivotal tracker.

Image

Liste des serveurs gitlab

 

Image

Ajout d'un serveur gitlab

 

L'idée ensuite est de pouvoir ajouter des « clients » et de leur affecter un projet.

Voici la liste des clients, avec vision des tickets en cours, du CA global, du CA en attente de facturation...

Image

Listing des clients

 

Chaque projet étant lié à un dépôt gitlab / github / pivotal tracker :

Image

Ajout d'un projet

 

Ainsi, automatiquement sont récupérés les tickets liés à ce projet. Chaque ticket peut-être estimé si le client le demande.

Image

Liste des tickets

 

Ces tickets sont récupérés et mis à jour à intervalle régulier, via une tache cron.

Sur la capture précédente, on voit l'ensemble des tickets (clôturé ou actif) d'un seul projet, mais via les filtres au-dessus du tableau, je peux voir l'ensemble des tickets au niveau global / par client / par projet…

Ensuite, à chaque ticket, je peux affecter une « tâche », correspondant à une intervention effectuée sur le projet et qui devra être facturée.

Image

Ajout d'une tâche

 

Ces tâches sont enfin visibles sur un tableau de bord, lui aussi filtrable par client / projet / ticket / statut de facturation / facture :

Image

listing de tâches

 

En fin de période de facturation, je sélectionne les tâches que je souhaite facturer et renseigne mon numéro de facture, ainsi ces tâches passent en état « facturé ». L'intégration avec ma solution de comptabilité n'est pas encore faite, mais le processus de création est grandement simplifié, je n'ai quasiment plus qu'à saisir le total.

Le client à lui aussi accès à un tableau de bord, où il peut voir toutes ses tâches en cours, et donc les dépenses engagées. Il peut aussi consulter le détail d'une facture :

Image

tableau de bord client

 

Chaque intervention était liée à un ticket, en cliquant sur le lien, il tombera directement sur le ticket correspondant sur gitlab / github / pivotal tracker…

J'ai pu importer tous mon historique de tâches qui étaient dans des google docs en passant par des fichiers csv et un petit script de parsage.

Au niveau technique c'est un petit drupal 9.1.0 (mis à jour hier, jour de la sortie de la première version stable) avec peu de modules activés.

Les clients, projets, tickets et tâches sont des types d'entités personnalisé. les listing sont créés directement via des ListBuilder et non pas des vues. Les tickets se mettent à jours via des QueueWorkers.

Il y a pas mal de champs calculés pour, par exemple avoir au niveau d'un client le CA facturé, le CA en cours... J'ai factorisé mon code au maximum.

Le core de cet applicatif consiste en un seul module « custom » qui nécessite donc 3 autres modules :

gitlab_api : pour s'interconnecter avec plusieurs serveurs gitlab, module tiers disponible sur drupal.org auquel j'ai contribué.
github_api : pour s'interconnecter avec github, module développé par mes soins un peu « quick'n'dirty »
pivotal_api : pour s'interconnecter avec pivotal tracker, développé aussi par mes soins, mais encore trop sale pour être opensourcé pour l'instant.

Dans les faits, le module core est suffisamment générique pour être opensourcé, si vous êtes intéressé, n'hésitez-pas à vous signaler, ça me donnera la motivation à accélérer le processus ! Je pense que d'autres freelances pourraient être intéressés par la solution.

C'est là qu'on voit toute la puissance de drupal (surtout à partir de la version 8) pour développer très rapidement des applicatifs métiers puissants, intégrés et interconnectés. Le tout en codant en se faisant plaisir !

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Surcharger l'autocomplétion d'un champ « entity_reference »

Il est possible dans drupal 8 et 9 de surcharger l'auto-completion d'un champ « référence à un type d'entité », à la fois la requête générée (pour par exemple faire la recherche sur d'autres champs que le titre, mais aussi le label des éléments retournés.

Attention, la seconde étape diffère entre les versions 8 et 9 de drupal. Logiquement la version drupal 9 fonctionne sur les dernières version de drupal 8, je n'ai pas vérifié. Mais l'inverse ne fonctionne en tout cas pas !

Modification du formulaire (drupal 8 et drupal 9)

Pour cela il faut commencer par altérer le formulaire pour modifier un attribut de notre champ autocomplete :

// mon_module.module (ou bien un fichier de définition de formulaire directement // ici, mon champ « entity_reference » est issue// dashboard:issue est une clé qui sera définie à l'étape 2  function mon_module_form_alter(&$form, FormStateInterface $form_state) {  if ($form['id'] === '...') {    $form['issue']['widget'][0]['target_id']['#selection_handler'] = 'dashboard:issue';  }}

Définition du nouveau filtre de sélection  (drupal 9)

mon_module/src/Plugin/EntityReferenceSelection/IssueSelection.php getConfiguration()['target_type'];     // ici c'est une EntityQuery classique    $query = $this->buildEntityQuery($match, $match_operator);    $or = $query->orConditionGroup();     // Je fais une condition sur le titre de mon contenu mais aussi sur le champ « external_id »    $or->condition('title', $match, $match_operator);    $or->condition('external_id', $match, $match_operator);    $query->condition($or);     if ($limit > 0) {      $query->range(0, $limit);    }    $result = $query->execute();     if (empty($result)) {      return [];    }     $options = [];    /** @var \Drupal\dashboard\Entity\Issue[] $entities */    $entities = $this->entityTypeManager->getStorage($target_type)->loadMultiple($result);    foreach ($entities as $entity_id => $entity) {      $project = $entity->getProject();      $bundle = $entity->bundle();       // Ici, pour chaque résultat, définition du label de l'élément qui sera affiché dans la liste déroulante      $options[$bundle][$entity_id] = Html::escape($project->label() . ' #' . $entity->getExternalId(). ' -  ' . $entity->label() );    }     return $options;  } }

Définition du nouveau filtre de sélection  (drupal 8)

mon_module/src/Plugin/EntityReferenceSelection/IssueSelection.php getConfiguration()['target_type'];     // ici c'est une EntityQuery classique    $query = $this->entityManager->getStorage($target_type)->getQuery();    $or = $query->orConditionGroup();     // Je fais une condition sur le titre de mon contenu mais aussi sur le champ « external_id »    $or->condition('title', $match, $match_operator);    $or->condition('external_id', $match, $match_operator);    $query->condition($or);     if ($limit > 0) {      $query->range(0, $limit);    }    $result = $query->execute();     if (empty($result)) {      return [];    }     $options = [];    /** @var \Drupal\dashboard\Entity\Issue[] $entities */    $entities = $this->entityManager->getStorage($target_type)->loadMultiple($result);    foreach ($entities as $entity_id => $entity) {      $project = $entity->getProject();      $bundle = $entity->bundle();       // Ici, pour chaque résultat, définition du label de l'élément qui sera affiché dans la liste déroulante      $options[$bundle][$entity_id] = Html::escape($project->label() . ' #' . $entity->getExternalId(). ' -  ' . $entity->label() );    }     return $options;  } }

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Ajouter une propriété (basefield) à un type d'entité via une fonction update

Voici comment ajouter un basefield slug à un type d'entité client. La définition de cette propriété se trouvant dans la méthode baseFieldDefinitions de notre type d'entité :

function dashboard_update_9005() {  $entity_type_id = 'client'; // nom machine de notre type d'entité  $fields = ['slug']; // champ(s) à créer  $definition_update_manager = \Drupal::entityDefinitionUpdateManager();  \Drupal::entityTypeManager()->clearCachedDefinitions();  $entity_type = $definition_update_manager->getEntityType($entity_type_id);  foreach ($fields as $field) {    $fieldDefinition = $entity_type->getClass()::baseFieldDefinitions($entity_type)[$field];    $definition_update_manager->installFieldStorageDefinition($field, $entity_type_id, $entity_type_id, $fieldDefinition);  }}

En adaptant la seconde ligne de la fonction, il est possible d'ajouter autant de propriétés que l'on souhaite à notre type d'entité.

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Entité - Champ de base URL

À la différence d'une propriété « lien » (voir : Drupal 8 & Drupal 9 - Entité - Champ de base « link ») un champ de type « uri » ne prendra qu'une colonne dans votre table de base de données : pas de titre, pas d'options (target...) Mais du coup plus économique si on se fiche de ces attributs.

$fields['url'] = BaseFieldDefinition::create('uri')  ->setLabel(t('Issue URL'))  ->setRequired(TRUE)  ->setDisplayConfigurable('view', TRUE)  ->setDisplayConfigurable('form', TRUE);

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Entité - Champ de base « Référence à une entité » (entity reference)

Je me suis rendu compte que je n'avais jamais documenté comment ajouter une propriété « référence à une entité » :

Pour un type d'entité « client » :

$fields['client'] = BaseFieldDefinition::create('entity_reference')  ->setLabel(t('Client'))  ->setSetting('target_type', 'client')  ->setDisplayConfigurable('form', TRUE)  ->setDisplayConfigurable('view', TRUE);

Pour un nœud :

$fields['contenu'] = BaseFieldDefinition::create('entity_reference')  ->setLabel(t('Contenu'))  ->setSetting('target_type', 'node')  ->setDisplayConfigurable('form', TRUE)  ->setDisplayConfigurable('view', TRUE);

Il est aussi possible de restreindre le/les bundle(s) :

$fields['contenu'] = BaseFieldDefinition::create('entity_reference')  ->setLabel(t('Contenu'))  ->setSetting('target_type', 'node')      -  ->setSetting('handler_settings', [    'target_bundles' => [      'article' => 'article',      'page' => 'page',    ]  ])  ->setDisplayConfigurable('form', TRUE)  ->setDisplayConfigurable('view', TRUE);

 

Par kgaut
Adhérent
Kevin Gautreau

Lancer une inspection PHP Code Sniffer pour un drupal dans un container docker

Phpcs (ou PHP Code Sniffer) est un inspecteur de code permettant de vérifier la validité du code écrits en fonction de standards.

Pour  l'ajouter à notre projet drupal géré via composer :

composer require squizlabs/php_codesniffer # Ou si vous utilisez docker-compose docker-compose exec php composer require squizlabs/php_codesniffer

Drupal a son propre fichier de règles (un fichier xml) utilisable par phpcs, il est compris dans une dépendance drupal spécifique : coder

Pour l'installer :

composer require drupal/coder:^8.3.1 # Ou avec docker-compose docker-compose exec php composer require drupal/coder:^8.3.1

Une fois coder installé, il faut informer phpcs de l'emplacement du fichier de règles (contenu dans coder) :

#  /var/www/html/ est le docroot de mon projet dans mon container dockerdocker-compose exec php vendor/bin/phpcs --config-set installed_paths /var/www/html/vendor/drupal/coder/coder_sniffer

On vérifie que « Drupal » est maintenant bien présent dans les standards de code installés :

docker-compose exec php vendor/bin/phpcs -i                                                                          # Ce qui devrait vous retourner : # The installed coding standards are PEAR, PSR2, Zend, MySource, Squiz, PSR12, PSR1, DrupalPractice and Drupal

Et voila, nous pouvons maintenant lancer des inspections :

# Note : ici je me contente d'inspecter le module "mespronos" situé dans le dossier : ./web/modules/mespronosdocker-compose exec php ./vendor/bin/phpcs --colors --standard=Drupal --extensions=php,module,inc,install,test,profile,theme,css,info,txt,md,yml ./web/modules/mespronos # on pourrait imaginer inspecter tous nos modules custom avec la commande suivante : docker-compose exec php ./vendor/bin/phpcs --colors --standard=Drupal --extensions=php,module,inc,install,test,profile,theme,css,info,txt,md,yml ./web/modules/custom

Si vous utilisez un makefile (plus d'informations) vous pouvez vous créer un « raccourci » :

## phpcs	: Launch phpcs inspections for ./web/modules/customphpcs:	@docker-compose exec php ./vendor/bin/phpcs --colors --standard=Drupal --extensions=php,module,inc,install,test,profile,theme,css,info,txt,md,yml ./web/modules/custom

Ainsi pour lancer vos inspections, vous n'aurez qu'à lancer la commande « make phpcs »

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Webform - avoir un destinataire dynamique en fonction d'une catégorie

Dans le contexte d'un webform, je voulais pouvoir envoyer une notification à un email en particulier en fonction du sujet du message de contact.

Au niveau de mon webform, mon champ sujet est un select dont les options sont issues d'un vocabulaire de taxonomie :

Image

Webform sujet taxonomy

 Dans le vocabulaire en question, j'ai ajouté un champ de type email field_destinataire_message :

Image

Taxo field email

Ainsi pour chaque sujet de contact, l'administrateur pourra saisir un destinataire différent.

Maintenant reste la partie la plus importante, le gestionnaire de notification du webform.

Création d'un plugin EmailWebformHandler :

web/modules/custom/mon_module/src/Plugin/WebformHandler/ContactWebformHandler.php

get('mail');     // Je recupère la valeur du champ « sujet » (un entier : l'id du terme de taxonomy)    $subjectTid = $webform_submission->getRawData()['subject'];    if (($subject = Term::load($subjectTid)) && $destinataire = $subject->get('field_destinataire_message')->value) {      $recipient = $destinataire;    }    // je définis le destinataire    $message['to_mail'] = $recipient;     parent::sendMessage($webform_submission, $message);  } }

Pour terminer, il faut activer cette notification cela se passe au niveau de notre webform dans l'administration : onglet « paramètres », sous-onglet « Emails / Handlers » : Ajouter un gestionnaire :

Image

webform handler

Sélectionner le handler que l'on vient de créer puis cliquez sur le lien « Ajouter un gestionnaire ».

Et il ne restera plus qu'à configurer la notification comme classiquement, sauf qu'évidement cette fois le champ destinataire n'est pas disponible !

webform handler destinataire

Par kgaut
Adhérent
Kevin Gautreau

Vidéo mini formation : Versionner son projet Drupal avec Git

Une nouvelle vidéo fraîchement mise en ligne pour le weekend. Au programme du jour : Git et comment l'utiliser sur un projet drupal.

Mini introduction sur git et ses fondamentaux
Passage en revue des dossiers et fichiers composants l'architecture d'un projet Drupal
Exemple d'organisation pour travailler en équipe avec les branches Git et les environnements.

Attention, je le répète, dans la troisième parti je présente une organisation de fonctionnement qui me convient à moi et qui répond aux problématiques que j'ai rencontré. Mais ça n'est pas la seule et unique manière de faire et encore moins la meilleure.

Désolé pour le petit faux-contact au niveau du micro qui entraîne parfois un peu de bruit, mon ingé son est viré, le problème est résolu.

Le dépôt utilisé dans la vidéo est librement accessible : https://gitlab.kgaut.net/kgaut/formation-drupal-git

Retrouvez la vidéo sur youtube directement (pensez à passer en plein écran) ou bien juste ci-dessous.

N'oubliez-pas que vous pouvez voter ou me proposer des sujets à l'adresse suivante : https://kgaut.net/suggestion-sujet-video-formation.

Commandes GIT vues dans la vidéo

Initialiser un dépôt

git init

Versionner un fichier et le commiter

git add readme.mdgit commit -m "Ajout fichier readme"

Ajouter une remote

git remote add origin URL_DEPOT_GIT

Créer un tag git

git tag NOMTAG # exemple :  git tag 1.0.0 # ou  git tag 20201030-01

Créer une nouvelle branche git

git checkout -b feature-blog

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Installer un nouveau type d'entité via un HOOK_update

Voici comment installer un type d'entité personnalisé via un hook_update.

À noter, les types d'entités d'un module sont automatiquement installés lors de l'installation du module. Ce snippet n'est utile que pour un type d'entité créé à postériori.

/** * Create entity Type « inscription_newsletter » */function MON_MODULE_update_8008() {  \Drupal::entityTypeManager()->clearCachedDefinitions();  \Drupal::entityDefinitionUpdateManager()->installEntityType(\Drupal::entityTypeManager()->getDefinition('inscription_newsletter'));}

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Entité - Champ de base « email »

Voici comment définir une propriété (basefield) « e-mail » sur un type d'entité.

    $fields['email'] = BaseFieldDefinition::create('email')      ->setLabel(t('Email'))      ->setDefaultValue('')      ->setDisplayConfigurable('form', TRUE)      ->setDisplayConfigurable('view', TRUE);

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Afficher un formulaire dans un bloc ou un contrôleur

Il est possible dans un contrôleur ou un bloc de récupérer un formulaire et de l'afficher comme n'importe quelle autre variable.

À l'époque de drupal 7 on utilisait la fonction drupal_get_form(), à partir de drupal 8, il faut utiliser le service form_builder et sa méthode getForm() en lui passant la classe du formulaire :

#dans la méthode build de mon bloc ou mon controleur :$build['#mon_formulaire'] = \Drupal::service('form_builder')->getForm(\Drupal\mon_module\Form\LoginForm::class);$build['#theme'] = 'mon_template';

Note : il est toujours préférable d'injecter le service en utilisant l'injection de dépendance.

Ensuite il sera possible d'afficher le formulaire dans le template via la variable mon_formulaire :

{# Dans le template twig : mon-template.html.twig #}{{ mon_formulaire }}

Évidement, il ne faut pas oublier d'avoir déclaré la variable mon_formulaire dans la déclaration du template :

//mon_module.module  function mon_module_theme() {  $themes = [];  $themes['mon_template'] = [    'render element' => 'elements',    'variables' => [      'mon_formulaire' => [],    ],    'template' => 'mon-template',  ];   return $themes;}

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Entité - Champ de base « Référence à un media »

 Voila comment ajouter une propriétée faisant référence à un média sur un type d'entité :

$fields['header_image'] = BaseFieldDefinition::create('entity_reference')  ->setLabel(t('Header image'))  ->setSetting('target_type', 'media')  ->setSetting('handler_settings', ['target_bundles' => ['image' => 'image']])  ->setDisplayConfigurable('form', TRUE)  ->setDisplayConfigurable('view', TRUE);

Via la ligne ci-dessous, il est possible de spécifier les types de media acceptés

  ->setSetting('handler_settings', ['target_bundles' => ['image' => 'image']])

 

Par kgaut
Adhérent
Kevin Gautreau

Vidéo mini formation : La configuration dans Drupal et le module config_split

Deuxième épisode de mes vidéos de mini-formations à Drupal avec au sujet du jour un point important : la gestion de la configuration dans Drupal.

Qu'est-ce que la configuration ? Comment l'exporter, l'importer, mais aussi et surtout comment, à l'aide du module config_split.

Retrouvez la vidéo sur youtube à l'adresse suivante : https://youtu.be/qy_nq3_sbyM

ou bien directement ci-dessous :

 

Pour proposer des sujets, c'est par ici.

Quelques indications / précisions.

Drush

Installé dans vendor/bin/drush, il peut être appelé directement via se chemin

# Depuis la racine de votre projetvendor/bin/drush COMMANDE

Il est aussi possible d'installer drush-launcher pour éxecuter directement la commande drush : https://github.com/drush-ops/drush-launcher

Activer manuellement un environnement de config split

Dans votre fichier settings.local.php :

// « dev » correspond au nom machine de l'environnement à activer$config['config_split.config_split.dev']['status'] = TRUE;

Les spécificités de l'environnement « prod »

La configuration spécifique de production est exportée dans un dossier ../config/prod

Via un .gitignore, j'exclue du versioning le contenu de ce dossier, afin que si la configuration est modifiée en prod, son export ne gène pas GIT, qu'il ne détecte pas de fichiers modifié.

Process d'un déploiement en production

Qu'il soit automatisé ou non, pour rappel, cette solution me convient personnellement, mais elle ne répond pas forcément à toutes les problématiques, n'hésitez-pas à l'adapter si besoin.

Connexion en SSH au serveur
Script vérifiant qu'aucun fichier n'a été modifié via un git status, si des fichiers sont modifiés alors un mail m'est envoyé et le déploiement est annulé
Script vérifiant que la configuration active n'a pas été modifiée directement en prod. Pour cela un config export est fait, si des modifications sont détectées (encore via un git status) alors un mail m'est envoyé et le déploiement est annulé. La configuration spécifique à l'environnement étant exportée dans un dossier exclu du versioning, alors aucune modification n'est détectée.
git pull (ou )
composer install --no-dev pour insta
drush updb (pour lancer les éventuelles mise à jour de la base de données)
drush config:import afin d'importer la configuration éventuellement modifiée, (la config spécifique de prod ayant été exportée à l'étape 3, elle sera réimportée à ce moment là.

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Views - Utiliser un view_mode spécifique pour un seul élément

Dans la continuité de Drupal 8 & Drupal 9 - Views - créer un Pager personnalisé.

Sur un de mes projets j'ai une vue qui liste des nœuds de type « Article » avec le mode d'affichage (view_mode) « Teaser », mais j'avais besoin d'afficher le premier élément de la première avec un autre mode d'affichage, le contenu prendra toute la largeur, au lieu d'un tiers pour les suivants.

J'ai pour cela utilisé le hook HOOK_views_post_render :

function MON_MODULE_views_post_render(ViewExecutable $view, &$output, \Drupal\views\Plugin\views\cache\CachePluginBase $cache) {  if ($view->id() === 'front_actualites' && $view->current_display === "page" && \Drupal::request()->query->get('page', 0) === 0) {    $output['#rows'][0]['#rows'][0]['#view_mode'] = 'teaser_pinned';  }}

avec

$view->id() === 'front_actualites' && $view->current_display === "page"

Je teste si je suis bien sur la bonne vue avec le bon mode d'affichage

\Drupal::request()->query->get('page', 0) === 0

Me permet de tester le paramètre GET ?page= (qui gère la pagination) en fournissant la valeur par défaut 0, afin de tester que je sois bien sur la première page.

Enfin je change le view_mode de la première ligne de mes résultats :

$output['#rows'][0]['#rows'][0]['#view_mode'] = 'teaser_pinned';

 

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Views - créer un Pager personnalisé

Pour un projet j'avais besoin d'afficher une pagination particulière sur une vue.

La première page devait afficher 9 éléments, et les suivantes 12.

J'ai donc pour cela créé un Pager personnalisé pour Views, et ajouté ce paramètre en option.

En voici le code, disponible aussi sur github : https://github.com/kgaut/kgaut_tools/blob/2.0.x/src/Plugin/views/pager/…

Ce code est à placer dans un module, au chemin suivant : modules/custom/mon_module/src/Plugin/views/pager/PagerFullWithSpecificFirstPage.php

 10];    unset($options['expose']);    return $options;  }   /**   * {@inheritdoc}   */  public function buildOptionsForm(&$form, FormStateInterface $form_state) {    parent::buildOptionsForm($form, $form_state);    $pager_text = $this->displayHandler->getPagerText();    $form['items_per_page']['#weight'] = -2;    $form['items_per_page_first_page'] = [      '#title' => $pager_text['items per page title'] . ' for the first page',      '#type' => 'number',      '#min' => 0,      '#weight' => -1,      '#description' => $pager_text['items per page description'],      '#default_value' => $this->options['items_per_page_first_page'],    ];     unset($form['expose']);  }   /**   * {@inheritdoc}   */  public function validateOptionsForm(&$form, FormStateInterface $form_state) {    // Only accept integer values.    $error = FALSE;  }   /**   * {@inheritdoc}   */  public function summaryTitle() {    if (!empty($this->options['offset'])) {      if ($this->options['items_per_page'] !== $this->options['items_per_page_first_page']) {        return $this->formatPlural($this->options['items_per_page'], '@count item (@count_first for the first page), skip @skip', 'Paged, @count items, skip @skip', [          '@count' => $this->options['items_per_page'],          '@count_first' => $this->options['items_per_page_first_page'],          '@skip' => $this->options['offset'],        ]);      }      return $this->formatPlural($this->options['items_per_page'], '@count item, skip @skip', 'Paged, @count items, skip @skip', [        '@count' => $this->options['items_per_page'],        '@skip' => $this->options['offset'],      ]);    }    if ($this->options['items_per_page'] !== $this->options['items_per_page_first_page']) {      return $this->formatPlural($this->options['items_per_page'], '@count item', 'Paged, @count items (@count_first for the first page)', [        '@count' => $this->options['items_per_page'],        '@count_first' => $this->options['items_per_page_first_page'],      ]);    }    return $this->formatPlural($this->options['items_per_page'], '@count item', 'Paged, @count items', ['@count' => $this->options['items_per_page']]);  }   /**   * {@inheritdoc}   */  public function query() {    if ($this->current_page === 0) {      $this->options['items_per_page'] = $this->options['items_per_page_first_page'];    }    $limit = $this->options['items_per_page'];    $offset = $this->options['offset'];    if ($this->current_page > 0) {      $offset += ($this->current_page - 1) * $this->options['items_per_page'];      $offset += $this->options['items_per_page_first_page'];    }    if (!empty($this->options['total_pages'])) {      if ($this->current_page >= $this->options['total_pages']) {        $limit = $this->options['items_per_page'];        $offset = $this->options['total_pages'] * $this->options['items_per_page'];      }    }    $this->view->query->setLimit($limit);    $this->view->query->setOffset($offset);  }   public function updatePageInfo() {    if (!empty($this->options['total_pages'])) {      if (($this->options['total_pages'] * $this->options['items_per_page']) total_items) {        $this->total_items = $this->options['total_pages'] * $this->options['items_per_page'];      }    }     // Don't set pager settings for items per page = 0.    $items_per_page = $this->getItemsPerPage();    $items_per_page_first = $this->getItemsPerPageFirst();    if (!empty($items_per_page)) {      // quick fix if specific number on first page      $total_items = (int) $this->getCurrentPage() !== 0 ? $this->getTotalItems() + $items_per_page_first - 1 : $this->getTotalItems();      $pager = $this->pagerManager->createPager($total_items, $this->options['items_per_page'], $this->options['id']);      // See if the requested page was within range:      if ($this->getCurrentPage() >= $pager->getTotalPages()) {        $this->setCurrentPage($pager->getTotalPages() - 1);      }    }  }   public function getItemsPerPageFirst() {    return isset($this->options['items_per_page_first_page']) ? $this->options['items_per_page_first_page'] : 0;  } }

Vous pouvez retrouver

Par kgaut
Adhérent
Kevin Gautreau

Composer - Drupal - résoudre l'erreur "undefined index: extra"

Depuis quelques jours, on peut rencontrer l'erreur «  undefined index: extra » lors d'un composer update ou composer require.

Si vous rencontrez ce soucis, exécutez la commande :

composer update zaporylie/composer-drupal-optimizations --no-plugins

Cela devrait résoudre le soucis.

Plus d'informations ici : https://github.com/zaporylie/composer-drupal-optimizations/pull/22

Par Christophe MOLLET
Christophe Mollet

Comment choisir son CMS pour un projet web ?

Lorsque l'on souhaite réaliser un projet web, il n'est pas toujours facile de choisir le CMS le plus adapté à votre besoin. Pour vous aider à y voir plus clair pour votre projet, notre agence web vous explique les technologies web en détails.

Bien que nos gènes viennent et resterons dans le web, la barrière entre les applications mobiles et les sites web est de plus en plus flou. Technologie front, back, CMS, application native, hybride, PWA, on est vite perdu lorsque nous devons choisir une technologie ou la raison pour laquelle nous choisissons cette technologie.

Par kgaut
Adhérent
Kevin Gautreau

Vidéo mini formation : Installer drupal 9 avec composer

J'ai mis en ligne tard vendredi soir ma première vidéo de mini-formation à drupal.

J'ai commencé par un sujet basique : Le téléchargement et l'installation du CMS Drupal avec composer.

La vidéo est disponible gratuitement sur youtube et dure 20 minutes.

Je ne m'étais jamais confronté avant au format vidéo, et même si j'ai déjà donné des conférence et animé des formations, le format est évidement complètement différent.

Le résultat n'est pas parfait, mais j'en suis assez content. N'hésitez-pas à me faire vos retours sur le fond comme sur la forme.

Si vous souhaitez me suggérer un sujet pour une prochaine vidéo, vous pouvez le faire à la page suivante : https://kgaut.net/suggestion-sujet-video-formation.

Pour info, je suis déjà en train de préparer le conducteur de la prochaine qui présentera la gestion de la configuration et le module config split dans Drupal.

On m'a posé la question du temps passé et de mon organisation, voici en détail les étapes.

J'ai commencé évidement à définir le conducteur et les différents liens à afficher en me servent de notion.so, environ 2h de préparation.

Image

Conducteur drupal 9 avec composer - notion

 

J'ai ensuite fait l'enregistrement avec le logiel OBS, très bon soft, super facile à prendre en main. Il permet de mixer les "scènes" (captation d'un écran, d'une webcam, image fixe) et les sources de son (micro, pc...). La captation m'a pris environ 1h30. J'avais divisé la captation en séquences, une pour chaque chapitre, me permettant de reprendre mon souffle et de boire un peu d'eau entre chaque. Pour chaque séquence, il m'a souvent fallu plus de 5 prises pour en avoir enfin une correcte.

Enfin le montage a été fait avec le logiciel Kdenlive. Ici aussi très facile à prendre en main. Cette phase à consisté à enchaîner les séquences filmées et en faisant des "cuts", quand c'était nécessaire (bafouille, répétition...) Pour cette partie en comptant le visionnage final : 2H00, sans compter le temps de rendu, environ 30 minutes.

Soit un total d'environ 6H pour 20 minutes utiles de vidéo.

Par kgaut
Adhérent
Kevin Gautreau

Drupal 8 & Drupal 9 - Ajouter un champ Media dans un formulaire et l'afficher dans un template

Voici comment ajouter un champ de type « référence à un media » dans un formulaire personnalisé en utilisant le widget Media Library :

    $form['video'] = [      '#type' => 'media_library',      '#allowed_bundles' => ['video', 'remote_video'],      '#title' => t('Video'),      '#default_value' => $config->get('video') ?? NULL,    ];

la clé #allowed_bundles contient la liste des types de media que l'on veut autoriser

Voici ensuite comment le rendre dans un template via un controller :

Dans le controller :

if($config['video'] && $media = Media::load($config['video'])) {    $config['video'] = $this->entityTypeManager->getViewBuilder('media')->view($media, 'default');}     return [   '#theme' => 'mon_template',   '#data' => $config,];

et dans le template twig, un simple :

{{ data.video }}

 

Pages