Guía sobre etiquetas de plantilla: séptimo lote

En la séptima parte de la serie, vimos el sexto lote de etiquetas de plantilla de WordPress. En esta octava parte, vamos a revisar el séptimo lote de las casi 200 etiquetas de plantilla. A lo largo del tutorial, veremos etiquetas de plantilla sobre archivos, búsqueda y acciones de inicio de sesión/cierre/registro.

Obtención del enlace de archivo: `get_archives_link()`

Esta etiqueta de plantilla devuelve un enlace de archivo con varios formatos.

Parámetros

Esta etiqueta de plantilla acepta cinco parámetros:

$url (obligatorio, cadena): URL del archivo. (Predeterminado: NULL)
$text (obligatorio, cadena): Descripción del archivo si $format está establecido en ‘link’. (Predeterminado: NULL)
$format (opcional, cadena): Formato del enlace. Acepta los siguientes estilos:
- ‘link’ crea una etiqueta <link />.
- ‘option’ crea una etiqueta <option> para que puedas usarla en un menú desplegable HTML.
- ‘html’ crea una etiqueta <a> dentro de una etiqueta <li> para que puedas usarla en una lista ordenada o desordenada.
- ‘custom’ o cualquier otro texto crea una etiqueta <a>.(Predeterminado: ‘html’)
$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)

Uso

<?php
 
// Obtener y hacer echo del enlace de un archivo en forma de etiqueta <link>.
echo get_archives_link( 'https://mywebsite.com/archives/something/', __( 'Mis archivos no demasiado secretos', 'translation-domain' ), 'link' );
 
// Obtener y hacer echo del enlace de un archivo con un formato personalizado.
echo get_archives_link( 'http://mywebsite.com/archives/something/', '', 'custom', '<div class="not-so-secret-archives-link">', '</div>' );
 
?>

<?php

// Obtener y hacer echo del enlace de un archivo en forma de etiqueta <link>.

echo get_archives_link( 'https://mywebsite.com/archives/something/', __( 'Mis archivos no demasiado secretos', 'translation-domain' ), 'link' );

// Obtener y hacer echo del enlace de un archivo con un formato personalizado.

echo get_archives_link( 'http://mywebsite.com/archives/something/', '', 'custom', '<div class="not-so-secret-archives-link">', '</div>' );

Obtener & mostrar los enlaces de archivo: `wp_get_archives()`

Esta etiqueta de plantilla devuelve o muestra una lista de enlaces de archivo en varios formatos.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$args (opcional, matriz):Matriz de los argumentos siguientes:
- 'type' (cadena): Tipo de los archivos. Acepta ‘yearly’ (anual), ‘monthly’ (mensual), ‘weekly’ (semanal), ‘daily’ (diario), ‘postbypost’ (ordenado por fecha de publicación) o ‘alpha’ (ordenado alfabéticamente por título del post). (Predeterminado: ‘mensual’)
- 'limit' (cadena): Número de elementos que se van a recuperar.(Predeterminado: Vacío, lo que significa que no hay límite)
- 'format' (cadena): Uno de los siguientes formatos de salida:
  - ‘html’ crea etiquetas <a> en el interior de etiquetas <li> para que puedas usarlos en una lista ordenada o desordenada.
  - ‘option’ crea etiquetas <option> para que puedas usarlos en un menú desplegable HTML.
  - ‘link’ crea etiquetas <link />.
  - ‘custom’ crea solo etiquetas <a>. (Predeterminado: ‘html’)
- 'before' (cadena): Código HTML para agregar antes de la salida. (Predeterminado: Vacío)
- 'after' (cadena): Código HTML para agregar después de la salida. (Predeterminado: Vacío)
- 'show_post_count' (booleano): Si se muestra el recuento de posts o no. (Predeterminado: FALSE)
- 'echo' (entero): Si deseas hacer eco de la salida (1) o devolverla (0). (Predeterminado: 1)
- 'order' (cadena): Si se deben ordenar los elementos en orden ascendente (‘ASC’) o descendente (‘DESC’). (Predeterminado: ‘DESC’)

Uso

<?php
 
$args = array(
     
    // Obtener los archivos anuales.
    'type' => 'yearly',
     
    // Simplemente necesitamos etiquetas <a>, porque...
    'format' => 'custom',
     
    // ...vamos a usar los enlaces en un elemento <nav>
    'before' => '<nav class="yearly-archives">',
    'after' => '</nav>',
     
    // Mostrar el número de posts.
    'show_post_count' => true
     
);
 
wp_get_archives( $args );
 
?>

<?php

$args = array(

// Obtener los archivos anuales.

'type' => 'yearly',

// Simplemente necesitamos etiquetas <a>, porque...

'format' => 'custom',

// ...vamos a usar los enlaces en un elemento <nav>

'before' => '<nav class="yearly-archives">',

'after' => '</nav>',

// Mostrar el número de posts.

'show_post_count' => true

);

wp_get_archives( $args );

Obtener y visualizar el título de un archivo de tipo de post: `post_type_archive_title()`

Esta etiqueta de plantilla obtiene y se hace eco del tipo de post para su uso como títulos de archivo de tipo de post.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

$prefix (opcional, cadena): Prefija el título. (Predeterminado: Vacío)
$echo (opcional, booleano): Si hacer echo (TRUE) o devolver (FALSE) la etiqueta. (Predeterminado: TRUE)

Uso

<?php
 
// Obtener el título del tipo de post del archivo.
$archive_title = post_type_archive_title( '', false );
 
// Mostrar el título del tipo de post del archivo.
post_type_archive_title( '<i class="icon-archive"></i>' );
 
?>

<?php

// Obtener el título del tipo de post del archivo.

$archive_title = post_type_archive_title( '', false );

// Mostrar el título del tipo de post del archivo.

post_type_archive_title( '<i class="icon-archive"></i>' );

Cómo obtener y mostrar un título de página para archivos mensuales: `single_month_title()`

Esta etiqueta de plantilla devuelve y muestra el nombre del mes para usarlo en los títulos de página.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

$prefix (opcional, cadena): Prefija el título. (Predeterminado: Vacío)
$echo (opcional, booleano): Si hacer echo (TRUE) o devolver (FALSE) la etiqueta. (Predeterminado: TRUE)

Uso

<?php
 
// Mostrar el título del archivo mensual con un prefijo.
single_month_title( __( 'Monthly Archives', 'translation-domain' ) . ': ' );
 
// Obtener el título del archivo mensual.
$month_title = single_month_title( '', false );
 
?>

<?php

// Mostrar el título del archivo mensual con un prefijo.

single_month_title( __( 'Monthly Archives', 'translation-domain' ) . ': ' );

// Obtener el título del archivo mensual.

$month_title = single_month_title( '', false );

Cómo obtener y mostrar el enlace para la página «Siguientes entradas»: `get_next_posts_link()` y `next_posts_link()`

Estas etiquetas de plantilla devuelven o muestran un enlace de «siguientes entradas» para los listados de entradas (como índices de blog o páginas de archivo).

Parámetros

Ambas etiquetas de plantilla aceptan dos parámetros:

$label (opcional, cadena): Texto que se mostrará para el enlace. (Predeterminado: ‘Página siguiente »’)
$max_page (opcional, entero): Cantidad máxima de páginas. (Predeterminado: 0)

Uso

<?php
 
// Obtener el enlace "Siguientes entradas" con los valores predeterminados.
$next_comments_link = get_next_posts_link();
 
// Mostrar el enlace "Siguientes entradas" con una etiqueta diferente, usando una flecha que señala a la derecha.
next_posts_link( '&#8594;' );
 
?>

<?php

// Obtener el enlace "Siguientes entradas" con los valores predeterminados.

$next_comments_link = get_next_posts_link();

// Mostrar el enlace "Siguientes entradas" con una etiqueta diferente, usando una flecha que señala a la derecha.

next_posts_link( '→' );

Obtener y mostrar el enlace para la página «Entradas anteriores»: `get_previous_posts_link()` y `previous_posts_link()`

Estas etiquetas de plantilla devuelven o muestran un enlace «entradas anteriores» para los listados de entradas (como índices de blog o páginas de archivo).

Parámetros

Ambas etiquetas de plantilla solo aceptan un parámetro:

$label (opcional, cadena): Texto que se mostrará para el enlace. (Predeterminado: ‘« Página anterior’)

Uso

<?php
 
// Get the "previous posts" link with default values.
Obtener el enlace "Entradas anteriores" con los valores predeterminados.
$previous_comments_link = get_previous_posts_link();
 
// Mostrar el enlace "Siguientes entradas" con una etiqueta diferente, usando una flecha que señala a la izquierda.
previous_posts_link( '&#8592;' );
 
?>

<?php

// Get the "previous posts" link with default values.

Obtener el enlace "Entradas anteriores" con los valores predeterminados.

$previous_comments_link = get_previous_posts_link();

// Mostrar el enlace "Siguientes entradas" con una etiqueta diferente, usando una flecha que señala a la izquierda.

previous_posts_link( '←' );

Obtener y mostrar enlaces para las páginas «Entradas siguientes y anteriores»: `get_posts_nav_link()` y `posts_nav_link()`

Estas etiquetas de plantilla te permiten usar enlaces de navegación «entradas siguientes y anteriores».

Parámetros

get_posts_nav_link() solo acepta un parámetro:

$args (opcional, matriz):Matriz de los argumentos siguientes:
- 'sep' (cadena): Texto separador (Predeterminado: ‘ — ‘)
- 'prelabel' (cadena): Etiqueta para el enlace «página anterior». (Predeterminado: ‘« Página anterior’)
- 'nxtlabel' (cadena): Etiqueta para el enlace «página siguiente». (Predeterminado: ‘Página siguiente »’)

Y posts_nav_link() acepta tres parámetros:

$sep (opcional, cadena):Texto separador. (Predeterminado: Vacío)
$prelabel (opcional, cadena): Etiqueta para el enlace de la página anterior. (Predeterminado: «« Página anterior»)
$nxtlabel (opcional, cadena): Etiqueta para el enlace de la página siguiente. (Predeterminado: «Página siguiente »»)

Uso

<?php
 
// Obtener la navegación de las entradas.
$args = array(
    'sep' => ' &middot; ',
    'prelabel' => '&laquo;',
    'nxtlabel' => '&raquo;'
);
 
$posts_nav = get_posts_nav_link( $args );
 
// Mstrar la navegación de las entradas.
posts_nav_link( ' - ', __( 'Anteriores', 'translation-domain' ), __( 'Siguientes', 'translation-domain' ) );
 
?>

<?php

// Obtener la navegación de las entradas.

$args = array(

'sep' => ' · ',

'prelabel' => '«',

'nxtlabel' => '»'

);

$posts_nav = get_posts_nav_link( $args );

// Mstrar la navegación de las entradas.

posts_nav_link( ' - ', __( 'Anteriores', 'translation-domain' ), __( 'Siguientes', 'translation-domain' ) );

Lo que te queda por leer:

Obtener y mostrar el formulario de búsqueda: `get_search_form()`

Cómo obtener y mostrar la consulta de búsqueda actual: `get_search_query()` y `the_search_query()`

Obtener un Permalink para una consulta de búsqueda: `get_search_link()`

Obtener y mostrar un «Registro» o un enlace «Dashboard»: `wp_register()`

Cómo obtener y mostrar el formulario «Iniciar sesión»: `wp_login_form()`

Cómo obtener y mostrar el enlace «Iniciar sesión/salir»: `wp_loginout()`

Obtención de la URL de «Iniciar sesión»: `wp_login_url()`

Obtención de la URL de «Cerrar sesión»: `wp_logout_url()`

Obtención de la URL de «Contraseña perdida»: `wp_lostpassword_url()`

seguir leyendo en Tuts+

Entradas relacionadas

Twittear

Pocket

Obtención del enlace de archivo: get_archives_link()

Parámetros

Uso

Obtener & mostrar los enlaces de archivo: wp_get_archives()

Parámetros

Uso

Obtener y visualizar el título de un archivo de tipo de post: post_type_archive_title()

Parámetros

Uso

Cómo obtener y mostrar un título de página para archivos mensuales: single_month_title()

Parámetros

Uso

Cómo obtener y mostrar el enlace para la página «Siguientes entradas»: get_next_posts_link() y next_posts_link()

Parámetros

Uso

Obtener y mostrar el enlace para la página «Entradas anteriores»: get_previous_posts_link() y previous_posts_link()

Parámetros

Uso

Obtener y mostrar enlaces para las páginas «Entradas siguientes y anteriores»: get_posts_nav_link() y posts_nav_link()

Parámetros

Uso

Obtener y mostrar el formulario de búsqueda: get_search_form()

Cómo obtener y mostrar la consulta de búsqueda actual: get_search_query() y the_search_query()

Obtener un Permalink para una consulta de búsqueda: get_search_link()

Obtener y mostrar un «Registro» o un enlace «Dashboard»: wp_register()

Cómo obtener y mostrar el formulario «Iniciar sesión»: wp_login_form()

Cómo obtener y mostrar el enlace «Iniciar sesión/salir»: wp_loginout()

Obtención de la URL de «Iniciar sesión»: wp_login_url()

Obtención de la URL de «Cerrar sesión»: wp_logout_url()

Obtención de la URL de «Contraseña perdida»: wp_lostpassword_url()

Entradas relacionadas

Acerca de Eva Collados Pascual

Interacciones con los lectores

Deja una respuesta Cancelar la respuesta

Obtención del enlace de archivo: `get_archives_link()`

Obtener & mostrar los enlaces de archivo: `wp_get_archives()`

Obtener y visualizar el título de un archivo de tipo de post: `post_type_archive_title()`

Cómo obtener y mostrar un título de página para archivos mensuales: `single_month_title()`

Cómo obtener y mostrar el enlace para la página «Siguientes entradas»: `get_next_posts_link()` y `next_posts_link()`

Obtener y mostrar el enlace para la página «Entradas anteriores»: `get_previous_posts_link()` y `previous_posts_link()`

Obtener y mostrar enlaces para las páginas «Entradas siguientes y anteriores»: `get_posts_nav_link()` y `posts_nav_link()`

Obtener y mostrar el formulario de búsqueda: `get_search_form()`

Cómo obtener y mostrar la consulta de búsqueda actual: `get_search_query()` y `the_search_query()`

Obtener un Permalink para una consulta de búsqueda: `get_search_link()`

Obtener y mostrar un «Registro» o un enlace «Dashboard»: `wp_register()`

Cómo obtener y mostrar el formulario «Iniciar sesión»: `wp_login_form()`

Cómo obtener y mostrar el enlace «Iniciar sesión/salir»: `wp_loginout()`

Obtención de la URL de «Iniciar sesión»: `wp_login_url()`

Obtención de la URL de «Cerrar sesión»: `wp_logout_url()`

Obtención de la URL de «Contraseña perdida»: `wp_lostpassword_url()`