WordPress.org

Ready to get started?Download WordPress

Codex

it:Riferimento funzioni/get option

Contents

Descrizione

Questa funzione si usa per ottenere in modo sicuro il valore di un'opzione, dato il suo nome, dalla tabella del database che contiene le opzioni. Se l'opzione desiderata non esiste, o nessun valore è associato ad essa, viene restituito FALSE.

Utilizzo

 <?php echo get_option$option$default ); ?> 

Parametri

$option
(string) (richiesto) Nome dell'opzione da recuperare. Una lista concisa di opzioni valide è mostrata qui sotto, mentre una più completa può essere trovata in Option Reference. Equivale al parametro $option_name in register_setting() che si usa per registrare le opzioni personalizzate.
Default: Nessuno
  • 'admin_email' - Indirizzo e-mail dell'amministratore del sito.
  • 'blogname' - Titolo del sito; impostato nelle opzioni Generali.
  • 'blogdescription' - Motto del sito; impostato nelle opzioni Generali.
  • 'blog_charset' - Codifica dei caratteri del sito; impostato nelle opzioni di Lettura.
  • 'date_format' - Formato predefinito della data; impostato nelle opzioni Generali.
  • 'default_category' - Categoria predefinita degli articoli; impostata nelle opzioni di Scrittura.
  • 'home' - Indirzzo dell'home page del sito; impostato nelle opzioni Generali.
  • 'siteurl' - Indirizzo del back-end di WordPress; impostato nelle opzioni Generali.
    Attenzione: Questa opzione non equivale a get_bloginfo('siteurl') (che restituisce l'URL dell'home page), ma a get_bloginfo('wpurl').
  • 'template' - Il nome del tema corrente; impostato in Aspetto.
  • 'start_of_week' - Giorno in cui comincia la settimana; impostato nelle opzioni Generali.
  • 'upload_path' - Cartella predefinita in cui caricare i file; impostata nelle opzioni Varie.
  • 'posts_per_page' - Numero massimo di post per pagina; impostato nelle opzioni di Lettura.
  • 'posts_per_rss' - Numero massimo di post più recenti da mostrare in un feed; impostato nelle opzioni di Lettura.
Ci sono molte altre opzioni disponibili, molte delle quali dipendono dai plugin installati. Visitare la pagina Settings General Screen per una lista completa.

Gli underscore separano le parole, solo lettere minuscole - questo finisce nel database.

$default
(mixed) (opzionale) Il valore predefinito da restituire se nessun valore viene restituito (es. l'opzione non si trova nel database).
Default: false

Valori restituiti

(mixed) 
Valore corrente per l'opzione specificata. Se tale opzione non esiste, viene restituito FALSE.

Esempi

<?php

$no_exists_value 
get_option'no_exists_value' );
var_dump$no_exists_value ); /* stampa false */

$no_exists_value get_option'no_exists_value''default_value' );
var_dump$no_exists_value ); /* stampa 'default_value' */

?>

Mostrare il titolo del sito

Mostra il titolo del proprio sito in un tag <h1>.  <h1><?php echo get_option'blogname' ); ?></h1> 

Mostrare il set di caratteri

Mostra il set di caratteri che il sito usa (es: UTF-8)  <p>Set di caratteri: <?php echo get_option'blog_charset' ); ?> </p> 

Recuperare l'e-mail dell'amministratore

Recupera l'e-mail dell'amministratore del sito, memorizzandola in una variabile.  <?php $admin_email get_option'admin_email' ); ?> 

Note

  • Utilizza: apply_filters()
    • Richiama 'pre_option_$option' prima di controllare l'opzione. Valori diversi da false faranno "cortocircuitare" il recupero dell'opzione. Non si dovrebbe tentare di sovrascrivere le opzioni speciali, ma nulla impedisce di fare ciò.
    • Richiama 'option_$option', dopo aver controllato l'opzione, con il valore dell'opzione.
    • Richiama 'default_option_$option' per filtrare $default prima di restituirlo se è impostato e il valore dell'opzione non esiste.
  • Utilizza: maybe_unserialize() per deserializzare il valore prima di restituirlo.

Log delle modifiche

  • Da 1.5.0

File sorgente

get_option() si trova in wp-includes/option.php.

Correlati

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.