WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

es:Referencia de Funciones/get option

This page is marked as incomplete. You can help Codex by expanding it.
Nota: Diego AG 17:56, 9 December 2013 (UTC) crear los enlaces al castellano que faltan y luego eliminar los originales del inglés

Descripción

Un modo seguro de obtener valores para una opción dada desde la tabla de la base de datos. Si la opción deseada no existe, o no tiene valor asociado con ella, se retornará FALSE.

Uso

 <?php echo get_option$opción$valor_por_defecto ); ?> 

Parámetros

$opción
(string) (required) Nombre de la opcion a recuperar. Debajo hay una lista concisa de opciones válidas, pero una más completa se puede encontrar en la Option Reference es:Referencia de Opciones. Empareja $nombre_de_opción en register_setting() para opciones personalizadas.
Default: None
  • 'admin_email' - Dirección de E-mail del administrador del sitio.
  • 'blogname' - título de Weblog; guardado en 'Opciones generales'.
  • 'blogdescription' - Tagline para tu sitio; guardado en 'Opciones generales'.
  • 'blog_charset' - Codificación de caracteres para tu sitio; guardado en 'Opciones de lectura'.
  • 'date_format' - Formato de fecha por defecto; guardado en 'Opciones generales'.
  • 'default_category' - Categoría de envío (post) por defecto; guardado en 'Opciones de escritura'.
  • 'home' - La dirección principal del sitio; guardada en 'Opciones generales'.
  • 'siteurl' - dirección web de WordPress; guardada en 'Opciones generales'.
    Atención: Esto no es lo mismo que get_bloginfo('siteurl') (lo cual retornará la url de la pagina inicial), sino que es como get_bloginfo('wpurl').
  • 'template' - El nombre del tema actual; guardada en 'Presentación'.
  • 'start_of_week' - Día de la semana en el que debería empezar el calendario; guardado en 'Opciones generales'.
  • 'upload_path' - Ubicación de carga por defecto; guardado en 'Opciones misceláneas'.
  • 'posts_per_page' - Cantidad máxima de envíos a mostrar por página; guardado en 'Opciones de lectura'.
  • 'posts_per_rss' - Número máximo de los envíos más recientes para mostrar en el syndication feed; guarda en 'Opciones de lectura'.
Hay muchas más opciones disponibles, un montón de las cuales dependen de que plugins hayas instalado. Visita la página /wp-admin/options.php /wp-admin/options.php para una lista completa.

Los subrayados separan palabras, en minúsculas solamente - esto va a estar en la base de datos.

$valor_por_defecto
(mixed) (optional) El valor por defecto a devolver si nada es devuelto. (p.ej.: la opción no está en la base de datos).
Default: false

Valores de retorno

(mixed) 
Valor actual para la opción especificada. Si la opción especificada no existe, retorna el valor de verdad booleano FALSO.

Ejemplos

<?php

$no_existe_el_valor 
get_option'no_existe_el_valor' );
var_dump$no_existe_el_valor ); /* saca falso */

$no_existe_el_valor get_option'no_existe_el_valor''valor_por_defecto' );
var_dump$no_existe_el_valor ); /* saca 'valor_por_defecto' */

?>

Muestra el título del blog

Muestra el título de tu blog en una etiqueta <h1>.  <h1><?php echo get_option'blogname' ); ?></h1> 

Muestra el conjunto de caracteres

Muestra el conjunto de caracteres que tu sitio esté usando (ej: UTF-8)  <p>Conjunto de caracteres: <?php echo get_option'blog_charset' ); ?> </p> 

Recupera el E-mail de Administrador

Recupera el e-mail del administrador del blog, almacenándolo en una variable.  <?php $admin_email get_option'admin_email' ); ?> 

Notas

Log decambios

  • Desde 1.5.0

Fichero fuente

get_option() está ubicado en wp-includes/option.php.

Relacionado

Mira también el índice de referencia de funciones y el índice de etiquetas de plantilla.