Guía sobre las etiquetas de plantilla: octavo lote

En la octava parte de la serie, pasamos por el séptimo lote de etiquetas de plantilla de WordPress. En esta novena parte, vamos a revisar el último lote de las casi 200 etiquetas de plantilla. A lo largo del tutorial, veremos etiquetas de plantilla sobre marcadores y otras etiquetas de plantilla «misceláneas».

Advertencia sobre los marcadores: A partir de WordPress 3.5, de forma predeterminada, los «marcadores» están ocultos desde el panel de administración. Para trabajar con los marcadores, debes instalar el plugin Link Manager.

Obtener y mostrar una lista de marcadores: `wp_list_bookmarks()`

Esta etiqueta de plantilla devuelve o se hace eco de una lista de marcadores, una antigua característica de WordPress.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$args (opcional: matriz):Una matriz de los siguientes argumentos:
- 'orderby' (cadena): Cómo ordenar los marcadores. Acepta ‘name’, ‘link_id’, ‘url’, ‘target’, ‘description’, ‘owner’ (el usuario que añadió el marcador), ‘rating’, ‘updated’ (fechas de actualización), ‘rel’ (relación XFN de marcador), ‘notes’, ‘rss’, ‘length’ (longitud del nombre del marcador), ‘rand’ (aleatorio). (Predeterminado: ‘nombre’)
- 'order' (cadena): Si se deben pedir artículos en orden ascendente (‘ASC’) o descendente (‘DESC’). (Predeterminado: ‘ASC’)
- 'limit' (entero): Número de elementos que se mostrarán. (Predeterminado: -1 que significa todos los marcadores)
- 'category' (cadena): ID de categoría separados por comas para obtener elementos. (Predeterminado: ‘ ‘ lo que significa todas las categorías)
- 'exclude_category' (cadena): identificadores de categorías de marcadores a excluir. (Predeterminado: ‘ ‘)
- 'category_name' (cadena): Un nombre de categoría desde la que mostrar marcadores (reemplaza ‘category’). (Predeterminado: ‘ ‘)
- 'hide_invisible' (entero): Si deseas ocultar enlaces invisibles o mostrarlos. (Predeterminado: 1)
- 'show_updated' (entero): Si se debe mostrar o no la última marca de tiempo actualizada. (Predeterminado: 0)
- 'echo' (entero): Si deseas hacer eco de la salida (1) o devolverla (0). (Predeterminado: 1)
- 'categorize' (entero): Si se deben agrupar marcadores por sus categorías (1) o no (0). (Predeterminado: 1)
- 'title_li' (cadena): Envuelve la salida con una etiqueta <li> y muestra un título antes de la lista de marcadores. Probablemente desearas establecer esto en una cadena vacía y deshabilitar la envoltura. (Predeterminado: ‘Marcadores’)
- 'title_before' (cadena): Código HTML a añadir antes de cada título. (Predeterminado: ‘<h2>’)
- 'title_after' (cadena): Código HTML para añadir después de cada título. (Predeterminado: ‘</h2>’)
- 'class' (cadena): Nombres de clase CSS a añadir a cada categoría.(Predeterminado: ‘linkcat’)
- 'category_before' (cadena): Código HTML a añadir antes de cada categoría. (Predeterminado: ‘<li id=%id class=%class>’)
- 'category_after' (cadena): Código HTML a añadir después de cada categoría. (Predeterminado: ‘</li>’)
- 'category_orderby' (cadena): Cómo ordenar las categorías. Acepta ‘name’, ‘id’, ‘slug’ y ‘count’. (Predeterminado: ‘name’)
- 'category_order' (cadena): Si se deben ordenar categorías en orden ascendente (‘ASC’) o descendente (‘DESC’). (Predeterminado: ‘ASC’)

Uso

<?php
 
$args = array(
     
    // Orden aleatorio.
    'orderby' => 'rand',
     
    // Coge solo 5 marcadores.
    'limit' => 5,
     
    // Coge marcadores de una categoría concreta.
    'category_name' => 'Amigos',
     
    // No hagas echo.
    'echo' => 0,
     
    // Clase personalizada.
    'class' => 'lista-marcadores-amigos'
     
);
 
$bookmarks_list = wp_list_bookmarks( $args );
 
?>

<?php

$args = array(

// Orden aleatorio.

'orderby' => 'rand',

// Coge solo 5 marcadores.

'limit' => 5,

// Coge marcadores de una categoría concreta.

'category_name' => 'Amigos',

// No hagas echo.

'echo' => 0,

// Clase personalizada.

'class' => 'lista-marcadores-amigos'

);

$bookmarks_list = wp_list_bookmarks( $args );

Obtener una matriz de todos los marcadores: `get_bookmarks()`

Esta etiqueta de plantilla devuelve una matriz de tus marcadores de WordPress.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$args (opcional: matriz):Matriz de los siguientes argumentos:
- 'orderby' (cadena): Cómo ordenar los enlaces. Acepta campos de post como ‘name’, ‘ID’, ‘title’, ‘date’, etc. (Predeterminado: ‘name’)
- 'order' (cadena): Si se deben ordenar los elementos en orden ascendente (‘ASC’) o descendente (‘DESC’). (Predeterminado: ‘ASC’)
- 'limit' (entero): Número de elementos que se mostrarán. (Predeterminado: -1 lo que significa todo)
- 'category' (cadena): ID de categorías separados por comas para obtener elementos. (Predeterminado: Vacío)
- 'category_name' (cadena): Nombre de la categoría de la que obtener elementos. (Predeterminado: Vacío)
- 'hide_invisible' (entero o booleano): Si se debe mostrar u ocultar vinculado marcado como «invisible». (Predeterminado: 1|TRUE)
- 'show_updated' (entero o booleano): si deseas mostrar la hora en la que se actualizó por última vez el marcador. (Predeterminado: 0|FALSE)
- 'include' (cadena): Lista de ID separados por comas a incluir. (Predeterminado: Vacío)
- 'exclude' (cadena): Lista de ID separados por comas que se van a excluir. (Predeterminado: Vacío)

Uso

<?php
 
$args = array(
    'orderby' => 'title',
    'order' => 'ASC',
    'limit' => 15,
    'hide_invisible' => false,
    'exclude' => '12,16,23'
);
 
$bookmarks_array =  get_bookmarks( $args );
 
?>

<?php

$args = array(

'orderby' => 'title',

'order' => 'ASC',

'limit' => 15,

'hide_invisible' => false,

'exclude' => '12,16,23'

);

$bookmarks_array = get_bookmarks( $args );

Obtención de datos de marcadores: `get_bookmark()`

Esta etiqueta de plantilla devuelve todos los datos de un marcador determinado.

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

$bookmark (obligatorio: mixto): El identificador u objeto del marcador. (Predeterminado: NULL)
$output (opcional: cadena): Constante OBJECT, ARRAY_N o ARRAY_A. (Predeterminado: OBJECT)
$filter (opcional: cadena): Si deseas escapar la salida o no. Si deseas filtrar la salida, establécelo en ‘display’. (Predeterminado: ‘raw’)

Uso

<?php
 
// Obtener los campos de un marcador concreto escapando la salida.
$bookmark_data( 19, OBJECT, 'display' );
 
?>

<?php

// Obtener los campos de un marcador concreto escapando la salida.

$bookmark_data( 19, OBJECT, 'display' );

Obtención de datos de un único marcador: `get_bookmark_field()`

Esta etiqueta de plantilla te permite obtener los datos del campo de un único marcador.

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

$field (obligatorio: cadena): El nombre del campo. (Predeterminado: NULL)
$bookmark (obligatorio: entero): El identificador del marcador. (Predeterminado: NULL)
$context (opcional: cadena): Cómo filtrar el valor del campo, ya sea ‘raw’, ‘edit’, ‘attribute’, ‘js’, ‘db’ o ‘display’. (Predeterminado: ‘display’)

Uso

<?php
 
// Obtener el marcador con el ID 16 y escapamos y mostramos el título.
echo get_bookmark_field( 'title', 16, 'display' );
 
?>

<?php

// Obtener el marcador con el ID 16 y escapamos y mostramos el título.

echo get_bookmark_field( 'title', 16, 'display' );

Obtener y mostrar el enlace «Editar marcador»: `get_edit_bookmark_link()` y `edit_bookmark_link()`

Estas etiquetas de plantilla te permiten obtener o hacer eco de un enlace «editar este marcador» para usarlo en tus plantillas.

Parámetros

get_edit_bookmark_link() solo acepta un parámetro:

$bookmark_id (obligatorio: entero): El identificador del marcador. (Predeterminado: 0)

Y edit_bookmark_link() acepta cuatro parámetros:

$text (opcional: cadena): Texto para mostrar el enlace. (Predeterminado: ‘Editar esto’)
$before (opcional: cadena): El texto o el código HTML que se va a mostrar antes de la salida. (Predeterminado: Vacío)
$after (opcional: cadena): El texto o el código HTML que se mostrará después de la salida. (Predeterminado: Vacío)
$bookmark_id (obligatorio: entero): El identificador del marcador. (Predeterminado: NULL)

Uso

<?php
 
// Obtener el enlace "editar el marcador" del marcador actual.
$edit_bookmark_link = get_edit_bookmark_link();
 
// Obtener el enlace "editar el marcador" de un marcador concreto.
$edit_bookmark_link = get_edit_bookmark_link( 98 );
 
// Mostrar el enlace "editar el marcador" del marcador actual.
edit_bookmark_link( __( 'Edit', 'translation-domain' ), '<strong>', '</strong>' );
 
// Mostrar el enlace "editar el marcador" de un marcador concreto.
edit_bookmark_link( __( 'Edit', 'translation-domain' ), '', '', 98 );
 
?>

<?php

// Obtener el enlace "editar el marcador" del marcador actual.

$edit_bookmark_link = get_edit_bookmark_link();

// Obtener el enlace "editar el marcador" de un marcador concreto.

$edit_bookmark_link = get_edit_bookmark_link( 98 );

// Mostrar el enlace "editar el marcador" del marcador actual.

edit_bookmark_link( __( 'Edit', 'translation-domain' ), '<strong>', '</strong>' );

// Mostrar el enlace "editar el marcador" de un marcador concreto.

edit_bookmark_link( __( 'Edit', 'translation-domain' ), '', '', 98 );

Cómo obtener y mostrar la información de tu sitio: `get_bloginfo()` y `bloginfo()`

Estas etiquetas de plantilla extremadamente populares devuelven y muestran la información general de tu sitio.

Parámetros

get_ bloginfo() acepta dos parámetros:

$show (opcional: cadena): El fragmento de información a buscar. Uno de los siguientes valores:
- 'url' (cadena): La URL de inicio.
- 'wpurl' (cadena): La URL donde está instalado WordPress.
- 'description' (cadena): Descripción del sitio.
- 'rdf_url' (cadena): La URL del feed RDF/RSS 1.0.
- 'rss_url' (cadena): La URL del feed RSS 0.92.
- 'rss2_url' (cadena): La URL del feed RSS 2.0.
- 'atom_url' (cadena): La URL del feed Atom.
- 'comments_rss2_url' (cadena): La URL del feed RSS 2.0 para los comentarios.
- 'comments_atom_url' (cadena): La URL del feed Atom para los comentarios.
- 'pingback_url' (cadena): La dirección URL del archivo XML-RPC de pingback.
- 'stylesheet_url' (cadena): La URL del archivo CSS principal del tema.
- 'stylesheet_directory' (cadena): La URL del directorio principal del archivo CSS del tema.
- 'template_directory' o 'template_url' (cadena): La dirección URL del directorio del tema activo.
- 'admin_email' (cadena): La dirección de correo electrónico introducida cuando se instaló WordPress.
- 'charset' (cadena): Juego de caracteres del sitio.
- 'html_type' (cadena): El tipo de contenido de las páginas HTML de WordPress.
- 'version' (cadena): Versión de WordPress.
- 'language' (cadena): Idioma de la instalación de WordPress.
- 'text_direction' (cadena): Dirección del texto del idioma.
- 'name' (cadena): Nombre del sitio.(Predeterminado: ‘name’)
$filter (opcional: cadena): Establécelo en 'filter' para filtrar la dirección URL devuelta de esta etiqueta de plantilla. (Predeterminado: ‘raw’)

Y bloginfo() solo acepta un parámetro:

$show (opcional: cadena): Los mismos detalles que los anteriores. (Predeterminado: ‘blogname’)

Uso

<?php
 
// Mostrar en nombre del sitio.
bloginfo();
 
// Obtener la URL de la hoja de estilos.
$stylesheet = get_bloginfo( 'stylesheet_url' );
 
// Mostrar la versión de WordPress.
bloginfo( 'version' );
 
?>

<?php

// Mostrar en nombre del sitio.

bloginfo();

// Obtener la URL de la hoja de estilos.

$stylesheet = get_bloginfo( 'stylesheet_url' );

// Mostrar la versión de WordPress.

bloginfo( 'version' );

Obtener y mostrar clases de `<body>` automáticas: `get_body_class()` y `body_class()`

Estas populares etiquetas de plantilla generan clases semánticas y nos permiten hacer eco de las mismas o devolverlas. También nos permiten agregar nombres de clase adicionales.

Parámetros

Ambas etiquetas de plantilla aceptan únicamente un parámetro:

$class (opcional: cadena o matriz): Nombres de clase CSS adicionales para añadir. (Predeterminado: Vacío)

Uso

<?php
 
// Mostrar la clase del body.
body_class();
 
// Obtener la clase del body con una clase extra.
$body_class = get_body_class( 'mytheme-body' );
 
?>

<?php

// Mostrar la clase del body.

body_class();

// Obtener la clase del body con una clase extra.

$body_class = get_body_class( 'mytheme-body' );

Lo que te queda por leer:

Obtener y mostrar un menú de navegación: `wp_nav_menu()`

Obtener y mostrar títulos de página: `wp_title()`

Obtener y mostrar la URL de inicio: `get_home_url()` y `home_url()`

Obtener y mostrar la URL del sitio: `get_site_url()` & `site_url()`

Obtención del ID del sitio actual: `get_current_blog_id()`

Obtener y mostrar la URL del Panel de administración: `get_admin_url()` y `admin_url()`

Obtener y mostrar el permalink de un tipo de feed: `get_feed_link()` y `the_feed_link()`

Hacer que la cadena termine con o sin una barra diagonal final: `user_trailingslashit()`

Obtención del número de días desde el inicio de la semana: `calendar_week_mod()`

Obtener y mostrar el calendario: `get_calendar()`

seguir leyendo en Tuts+

Entradas relacionadas

Twittear

Pocket

Obtener y mostrar una lista de marcadores: wp_list_bookmarks()

Parámetros

Uso

Obtener una matriz de todos los marcadores: get_bookmarks()

Parámetros

Uso

Obtención de datos de marcadores: get_bookmark()

Parámetros

Uso

Obtención de datos de un único marcador: get_bookmark_field()

Parámetros

Uso

Obtener y mostrar el enlace «Editar marcador»: get_edit_bookmark_link() y edit_bookmark_link()

Parámetros

Uso

Cómo obtener y mostrar la información de tu sitio: get_bloginfo() y bloginfo()

Parámetros

Uso

Obtener y mostrar clases de <body> automáticas: get_body_class() y body_class()

Parámetros

Uso

Obtener y mostrar un menú de navegación: wp_nav_menu()

Obtener y mostrar títulos de página: wp_title()

Obtener y mostrar la URL de inicio: get_home_url() y home_url()

Obtener y mostrar la URL del sitio: get_site_url() & site_url()

Obtención del ID del sitio actual: get_current_blog_id()

Obtener y mostrar la URL del Panel de administración: get_admin_url() y admin_url()

Obtener y mostrar el permalink de un tipo de feed: get_feed_link() y the_feed_link()

Hacer que la cadena termine con o sin una barra diagonal final: user_trailingslashit()

Obtención del número de días desde el inicio de la semana: calendar_week_mod()

Obtener y mostrar el calendario: get_calendar()

Entradas relacionadas

Acerca de Eva Collados Pascual

Interacciones con los lectores

Deja una respuesta Cancelar la respuesta

Obtener y mostrar una lista de marcadores: `wp_list_bookmarks()`

Obtener una matriz de todos los marcadores: `get_bookmarks()`

Obtención de datos de marcadores: `get_bookmark()`

Obtención de datos de un único marcador: `get_bookmark_field()`

Obtener y mostrar el enlace «Editar marcador»: `get_edit_bookmark_link()` y `edit_bookmark_link()`

Cómo obtener y mostrar la información de tu sitio: `get_bloginfo()` y `bloginfo()`

Obtener y mostrar clases de `<body>` automáticas: `get_body_class()` y `body_class()`

Obtener y mostrar un menú de navegación: `wp_nav_menu()`

Obtener y mostrar títulos de página: `wp_title()`

Obtener y mostrar la URL de inicio: `get_home_url()` y `home_url()`

Obtener y mostrar la URL del sitio: `get_site_url()` & `site_url()`

Obtención del ID del sitio actual: `get_current_blog_id()`

Obtener y mostrar la URL del Panel de administración: `get_admin_url()` y `admin_url()`

Obtener y mostrar el permalink de un tipo de feed: `get_feed_link()` y `the_feed_link()`

Hacer que la cadena termine con o sin una barra diagonal final: `user_trailingslashit()`

Obtención del número de días desde el inicio de la semana: `calendar_week_mod()`

Obtener y mostrar el calendario: `get_calendar()`