Une stratégie pour initialiser les paramètres du plugin
Chaque fois que vous travaillez sur un plugin qui propose une page pour ses paramètres, vous pouvez enregistrer et récupérer les informations de plusieurs manières.
Tu peux:
- utiliser l’ API Paramètres ,
- utiliser une page personnalisée et des appels qui sont un hybride des deux,
- utiliser un type d’hybride entre une page de sous-menu (ou une page de menu) et d’autres fonctionnalités.
Plus j’ai travaillé avec WordPress, moins je me soucie d’utiliser l’API Settings et j’opte pour une approche un peu hybride.
Selon les exigences du projet, la mise en œuvre variera ; cependant, j’essaie d’utiliser une manière relativement cohérente de créer la fonctionnalité.
Et bien que cet article n’aborde pas les différentes manières dont je crée mes pages, les classes associées, etc., il vous proposera une manière d’initialiser les paramètres du plug-in lorsque vous travaillez sur votre projet ou sur un projet pour quelqu’un d’autre.
Initialisation des paramètres du plugin
Pour cet article, supposons que les exigences exigent le stockage des valeurs d’une page sous la forme d’un tableau associatif qui est nettoyé et sérialisé à partir du plugin.
Outre la fonctionnalité de désinfection dont vous aurez besoin, vous savez également que vous allez travailler avec :
- le tableau des options,
- et, à ce titre, une clé unique pour les options stockées dans la table des options
Maintenant, dans le contexte de la programmation orientée objet, j’ai normalement plusieurs classes configurées pour gérer toutes ces fonctionnalités, mais je suis principalement concerné par la manière de procéder pour initialiser les paramètres du plugin.
Mais pourquoi?
Si vous chargez une page destinée à récupérer des options de la base de données et que les valeurs n’ont pas été initialisées, vous verrez des avertissements sur votre écran ou quelque chose apparaîtra dans votre fichier journal de débogage.
Tout dépend de la façon dont vous avez configuré votre installation locale ainsi que de la façon dont votre hôte a défini sa configuration.
Quoi qu’il en soit, vous voulez vous assurer que vous avez initialisé les paramètres du plug-in afin d’avoir au moins la ligne définie dans la base de données et des valeurs initiales ou des valeurs vides définies pour le plug-in.
Comment faire
Comme mentionné précédemment, parce que je suis fan de l’utilisation de classes dans mon travail, je configure généralement une classe responsable de la lecture et de l’écriture des valeurs dans la base de données. Et cela inclut l’initialisation des paramètres du plugin.
Pour ce faire, je travaille généralement selon le processus suivant :
- initialiser la classe,
- vérifier si une option existe dans la base de données,
- si ce n’est pas le cas, initialisez-le,
- si c’est le cas, ne faites rien.
Le code initial pour faire cela peut ressembler à ceci :
Mais parce que c’est dans sa propre fonction, il peut être appelé dans le constructeur de votre classe, ou vous pouvez le marquer comme public et l’appeler en dehors de la classe. Pour ce post, cependant, je place un appel pour cela dans le constructeur :
Et une fois les valeurs initialisées, un attribut sur la classe peut être défini :
Bien qu’il y ait un cas à faire que cela ne devrait pas être fait dans le constructeur, j’aime avoir des propriétés de classe initialisées dans le constructeur de ladite classe.
Et puisque la classe est responsable du maintien d’une référence aux paramètres, il est logique d’initialiser les paramètres ici.