actions_delete

Syntaxe

Paramètres

Description

Cette fonction permet de supprimer une simple action de la base de données.

Remarques

• Suppression d'une action configurée : La fonction actions_delete() sert à supprimer une action précédemment créée et enregistrée dans le système de Drupal. Elle est utilisée lorsque l'administrateur souhaite retirer une action personnalisée du système afin qu'elle ne puisse plus être exécutée.
• Utilisation dans Drupal 7 : Dans Drupal 7, cette fonction fait partie du système d'actions, permettant d'associer des actions automatiques à des événements. Elle supprime l'action de la base de données, notamment depuis la table {actions}, garantissant qu'elle n'apparaît plus dans les interfaces d'administration.
• Exemple d'appel de la fonction : Voici un exemple de suppression d'une action enregistrée :
1. actions_delete('node_publish_action');

Dans cet exemple, l'action node_publish_action est supprimée, empêchant son utilisation future pour automatiser la publication de contenus.

• Impact sur les déclencheurs (Triggers) : Si une action supprimée était associée à un déclencheur (Trigger) dans Drupal 7, elle ne pourra plus être exécutée. Cela peut impacter certaines automatisations, comme la publication automatique de contenus ou la modification d'utilisateurs.
• Suppression des actions entreposées en base de données : Cette fonction n'est pas utilisée pour supprimer les actions définies en dur dans le code (comme celles fournies par un module). Elle ne supprime que celles ayant été ajoutées dynamiquement et stockées en base de données, souvent via l'interface d'administration.
• Disparition dans Drupal 8 et 9 : Dans Drupal 8 et versions ultérieures, actions_delete() n'existe plus, car le système d'actions a été remplacé par un système basé sur les Plugiciels d'actions. Désormais, chaque action est définie dans une classe PHP, et leur suppression se fait différemment.
• Alternative en Drupal 8+ : suppression des plugiciels d'actions : Dans Drupal 8 et 9, pour supprimer une action, il faut désactiver ou désinstaller le plugiciel d'action concerné. Contrairement à Drupal 7 où les actions étaient entreposées dans la base de données, les nouvelles actions sont définies dans le code et sont gérées via la configuration du site.
• Précaution lors de la suppression d'actions : Lorsqu'une action est supprimée avec actions_delete(), il est important de vérifier si elle était utilisée dans des règles (Rules) ou d'autres automatisations. Sinon, cela peut provoquer des erreurs ou des comportements inattendus dans le système.