get_option()

Définition : get_option() lit la valeur d’une option stockée dans WordPress, avec possibilité de fournir une valeur par défaut. Elle permet aux thèmes et extensions de consulter leurs paramètres persistants pendant une requête.

Terminologie

Terme officiel : get_option()

Autres appellations : Lecture d’option

À quoi cela sert

Elle permet de personnaliser le comportement d’un plugin selon ses réglages : titre, limite d’affichage, couleur ou état d’une fonctionnalité. WordPress gère en interne l’accès aux options et les mécanismes de cache associés.

Comment cela fonctionne

La fonction cherche une option selon son nom. Elle retourne sa valeur, ou la valeur de secours si l’option n’existe pas. Certains types simples peuvent être restitués sous forme de chaîne après stockage, d’où l’importance des conversions explicites.

Dans quel contexte l’utiliser

À utiliser pour consulter un réglage déjà déclaré ou enregistré sans répéter des requêtes SQL directes dans les extensions.

Exemple concret

Une page publique affiche au maximum le nombre de fiches configuré par l’administrateur.

Exemple de code commenté

<?php
// Lecture dans un contexte normal de plugin.
$limite = get_option( 'atoolpha_demo_nombre', 10 );
$limite = max( 1, min( 50, absint( $limite ) ) );

$requete = new WP_Query( array(
    'post_type'      => 'post',
    'posts_per_page' => $limite,
    'no_found_rows'  => true,
) );
// Exploiter ensuite les résultats puis restaurer le contexte
// si une boucle secondaire appelle the_post().

Explication pas à pas de l’exemple

get_option() lit le réglage ou fournit 10 si absent. La conversion borne la quantité avant de la transmettre à WP_Query. no_found_rows évite le comptage total lorsque la pagination n’est pas nécessaire.

Résultat attendu

La requête peut être limitée à 1–50 articles selon la préférence enregistrée, sans écrire directement dans la base de données.

Précautions et limites

Une option manquante et une valeur booléenne false peuvent être ambiguës sans valeur par défaut appropriée. Éviter de conserver d’énormes données métier dans une seule option.