WordPress
Options API
Recherche…
Introduction
Les options sont des éléments de données que WordPress utilise pour stocker diverses préférences et paramètres de configuration. L'API Options est un moyen simple et standardisé de stocker des données dans la base de données. L'API facilite la création, l'accès, la mise à jour et la suppression des options.
Syntaxe
// Créer une nouvelle option dans WordPress
add_option ($ option, $ value =, $ deprecated =, $ autoload = 'yes');// Supprime une option de la base de données.
delete_option (option $)// Récupère une option enregistrée
get_option ($ option, $ default = false);// Met à jour la valeur d'une option déjà ajoutée.
update_option ($ option, $ newvalue);// Il existe également des versions * _site_option () de ces fonctions,
// manipuler les options du réseau dans WordPress Multisite// Créer une nouvelle option de réseau
add_site_option (option $, $ value =, $ deprecated =, $ autoload = 'yes');// Supprime une option réseau
delete_site_option (option $);// Récupère une option de réseau enregistrée
get_site_option ($ option, $ default = false);// Met à jour la valeur d'une option déjà ajoutée.
update_site_option (option $, $ newvalue);
Remarques
L'API Options est un moyen simple et standardisé de travailler avec des données stockées dans la table d'options de la base de données MySQL. L'API facilite la création, la lecture, la mise à jour et la suppression des options.
get_option
La fonction get_option permet de récupérer une valeur depuis la table d'options en fonction du nom de l'option.
Vous pouvez utiliser le code suivant pour obtenir l'adresse électronique d'un administrateur de site WordPress.
<?php echo get_option('admin_email'); ?>
get_option()
a un deuxième argument facultatif, qui vous permet de définir une valeur par défaut à renvoyer dans le cas où l'option demandée n'est pas définie. Par défaut, cet argument est false
.
Pour récupérer une chaîne de texte et utiliser une chaîne standard si le texte n'est pas défini dans la table d'options, vous pouvez le faire:
<?php get_option( 'my_text', "I don't have anything written. Yet." ); ?>
add_option
La fonction add_option ins permet d'insérer une nouvelle ligne dans la table d'options.
Cela insérera une nouvelle ligne dans la table d'options avec le nom de l'option nom_option_prix et la valeur some_option_value
<?php add_option( 'some_option_name', 'some_option_value' ); ?>
delete_option
La fonction delete_option est utilisée pour supprimer une option du tableau d'options.
Cela supprimera my_custom_option de la table d'options.
<?php delete_option( 'my_custom_option' ); ?>
update_option
La fonction update_option est utilisée pour mettre à jour une valeur qui existe déjà dans la table d'options. Si l'option n'existe pas, alors l'option sera ajoutée avec la valeur de l'option.
Cela définira le statut de commentaire par défaut sur «fermé»:
update_option( 'default_comment_status', 'closed' );