Guía sobre etiquetas de plantilla: sexto lote

En la sexta parte de la serie, vimos por el quinto lote de etiquetas de plantilla de WordPress. En esta séptima parte, vamos a revisar el sexto lote de las casi 200 etiquetas de plantilla. A lo largo del tutorial, veremos etiquetas de plantilla sobre autores y archivos adjuntos.

Obtención de la URL de los archivos de entradas del autor: `get_author_posts_url()`

Esta etiqueta de plantilla devuelve un enlace a los archivos de entradas de un autor.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

$author_ID (obligatorio, entero): El ID del autor. (Predeterminado: autor actual)
$author_nicename (opcional, string): El «nombre bonito» del autor. (Un «nombre agradable» es la versión desinfectada del «nombre de usuario» que se puede utilizar en las URL y similares.) (Predeterminado: Vacío)

Uso

<?php
 
// Obtener y mostrar el enlace a los archivos de actual autor.
echo '<a href="' . get_author_posts_url() . '">' . __( 'Author\'s Archives', 'translation-domain' ) . '</a>';
 
?>

<?php

// Obtener y mostrar el enlace a los archivos de actual autor.

echo '<a href="' . get_author_posts_url() . '">' . __( 'Author\'s Archives', 'translation-domain' ) . '</a>';

Visualización de un enlace a los archivos de las entradas del autor: `the_author_posts_link()`

Esta etiqueta de plantilla genera un enlace a los archivos de las entradas del autor.

Parámetros

Esta etiqueta de plantilla no acepta ningún parámetro.

Uso

<?php
 
the_author_posts_link();
 
?>

<?php

the_author_posts_link();

Cómo obtener y mostrar el enlace del sitio web del autor: `get_the_author_link()` y `the_author_link()`

Estas etiquetas de plantilla devuelven o hacen eco de un enlace al sitio web del autor.

Parámetros

Estas etiquetas de plantilla no aceptan ningún parámetro.

Uso

<?php
 
// Hace echo del enlace del autor. 
the_author_link();
 
// Devuelve el enlace del autor.
$the_author_link = get_the_author_link();
 
?>

<?php

// Hace echo del enlace del autor.

the_author_link();

// Devuelve el enlace del autor.

$the_author_link = get_the_author_link();

Obtener y mostrar los metadatos del autor: `get_the_author_meta()` y `the_author_meta()`

Estas etiquetas de plantilla extraen y muestran los metadatos de un autor.

Parámetros

Ambas etiquetas de plantilla aceptan dos parámetros:

$field (obligatorio, cadena): El campo a extraer (‘login’, ‘nicename’, ‘email’, ‘url’, ‘registered’ o ‘status’). (Predeterminado: Vacío)
$user_ID (opcional, entero): El ID del usuario. (Predeterminado: Global $authordata)

Uso

<?php
 
// Obtener la fecha de registro del actual autor.
get_the_author_meta( 'registered' );
 
// Mostrar la dirección de email de un autor concreto.
the_author_meta( 'email', 9 );
 
 
?>

<?php

// Obtener la fecha de registro del actual autor.

get_the_author_meta( 'registered' );

// Mostrar la dirección de email de un autor concreto.

the_author_meta( 'email', 9 );

Cómo mostrar y mostrar el recuento de entradas del autor: `get_the_author_posts()` y `the_author_posts()`

Estas etiquetas de plantilla cuentan cuántas entradas ha escrito un autor y devuelven o muestran el resultado.

Parámetros

Estas etiquetas de plantilla no aceptan ningún parámetro.

Uso

<?php
 
the_author_posts();
 
?>

<?php

the_author_posts();

Obtener y mostrar la lista de autores: `wp_list_authors()`

Esta etiqueta de plantilla devuelve o muestra una lista de autores que escriben en tu sitio web.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$args (opcional: matriz):Matriz de los argumentos siguientes:
- 'orderby' (cadena): Cómo ordenar los enlaces. Acepta ‘user_nicename’, ‘user_email’, ‘user_url’, ‘user_registered’, ‘name’, ‘display_name’, ‘post_count’, ‘ID’, ‘meta_value’ y ‘user_login’. (Predeterminado: ‘name’)
- 'order' (cadena): Si se deben ordenar los elementos en orden ascendente (‘ASC’) o descendente (‘DESC’). (Predeterminado: ‘ASC’)
- 'number' (número entero): Número de autores que se van a recuperar. (Predeterminado: NULL, lo que significa que no hay límite)
- 'option_count' (booleano): Si deseas mostrar el recuento de entradas junto a los nombres de los autores o no. (Predeterminado: FALSE)
- 'exclude_admin' (booleano): Si se excluye el ‘admin’ (no todos los administradores, solo el que tiene el nombre de usuario ‘admin’) de la lista. (Predeterminado: TRUE)
- 'show_fullname' (booleano): Si se deben mostrar nombres y apellidos (TRUE) o «nombres de visualización» (FALSE).(Predeterminado: FALSE)
- 'hide_empty' (booleano): Si ocultar o no los autores sin entradas.(Predeterminado: TRUE)
- 'echo' (booleano): Si deseas hacer eco de la salida (TRUE) o devolverla (FALSE).(Predeterminado: TRUE)
- 'feed' (cadena): Si se establece en cualquier valor que no esté en blanco, los enlaces de los feeds del autor aparecerán junto a los enlaces del autor. El valor será el texto de anclaje de los enlaces. (Predeterminado: Vacío)
- 'feed_type' (cadena): Tipo de feed (‘rss’, ‘rss2’, ‘atom’ o ‘rdf’).(Predeterminado: Vacío)
- 'feed_image' (cadena): Ruta de la imagen para reemplazar el texto de ancla y mostrar una imagen en su lugar. (Predeterminado: Vacío)
- 'style' (cadena): Estilo para mostrar los autores: ‘list’ para generar una lista desordenada o ‘none’ para generar una lista de enlaces separados por comas. (Predeterminado: ‘list’)
- 'html' (booleano): Si se genera HTML o texto sin formato. (Predeterminado: TRUE)
- 'include' (cadena): Lista de IDs separados por comas que se pueden incluir.(Predeterminado: Vacío)
- 'exclude' (cadena): Lista de IDs separados por comas que se van a excluir. (Predeterminado: Vacío)

Uso

<?php
 
$args = array(
 
    // Ordenar según el orden de registro.
    'orderby' => 'user_registered',
     
    // Mostrar el número de entradas junto a los nombres.
    'option_count' => true,
     
    // Mostrar los nombres completos.
    'show_fullname' => true,
     
    // Mostrar los autores que no tienen entradas.
    'hide_empty' => false,
     
    // Excluye a Mike, ¡Nos ha traicionado!
    'exclude' => 31
     
);
 
wp_list_authors( $args );
 
?>

<?php

$args = array(

// Ordenar según el orden de registro.

'orderby' => 'user_registered',

// Mostrar el número de entradas junto a los nombres.

'option_count' => true,

// Mostrar los nombres completos.

'show_fullname' => true,

// Mostrar los autores que no tienen entradas.

'hide_empty' => false,

// Excluye a Mike, ¡Nos ha traicionado!

'exclude' => 31

);

wp_list_authors( $args );

Cómo obtener y mostrar un menú desplegable HTML de usuarios: `wp_dropdown_users()`

Esta etiqueta de plantilla devuelve o se hace eco de un menú desplegable (<select>) de los usuarios.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$args (opcional: matriz):Matriz de los argumentos siguientes:
- 'show_option_all' (cadena): Texto a mostrar como valor predeterminado de la lista desplegable. (Predeterminado: Vacío)
- 'show_option_none' (cadena): Texto a mostrar como valor predeterminado de la lista desplegable cuando no se encontró ningún usuario. (Predeterminado: Vacío)
- 'option_none_value' (entero o cadena): valor que se usará para ‘show_option_none’ cuando no se encuentre ningún usuario. (Predeterminado: -1)
- 'hide_if_only_one_author' (cadena): Si deseas ocultar la lista desplegable si solo hay un autor. (Predeterminado: Vacío)
- 'orderby' (cadena): Qué columna utilizar para ordenar usuarios. (Predeterminado: ‘display_name’)
- 'order' (cadena): En qué dirección ordenar los usuarios. (Predeterminado: ‘ASC’)
- 'include' (matriz o cadena): matriz o una lista separada por comas de IDs de usuario para mostrar (y excluir el resto). (Predeterminado: Vacío)
- 'exclude' (matriz o cadena): Matriz o una lista separada por comas de IDs de usuario para excluir de la lista. (Predeterminado: Vacío)
- 'multi' (booleano o entero): Si deseas omitir el identificador del elemento SELECT. (Es útil si vas a mostrar más de un menú desplegable de usuarios.) (Predeterminado: 0)
- 'show' (cadena): Qué mostrar como nombres de los elementos de lista.(Predeterminado: ‘display_name’)
- 'echo' (booleano o entero): Si deseas mostrar o recuperar contenido. (Predeterminado: 1)
- 'selected' (entero): El ID del usuario que se seleccionará de forma predeterminada. (Predeterminado: 0)
- 'include_selected' (booleano): Si deseas incluir siempre el ID de usuario seleccionado en el menú desplegable. (Predeterminado: FALSE)
- 'name' (cadena): El valor del atributo NAME para el elemento SELECT. (Predeterminado: ‘user’)
- 'id' (cadena): El identificador del elemento SELECT. (Predeterminado: Vacío)
- 'class' (string): Clase CSS para el elemento SELECT.(Predeterminado: Vacío)
- 'blog_id' (opcional, entero): ID del blog para recuperar usuarios. (Predeterminado: Blog actual)
- 'who' (cadena): Qué tipo de usuarios consultar (Acepta ‘authors’ o una cadena vacía). (Predeterminado: Vacío)

Uso

<?php
 
$args = array(
     
    // Ordenar según fecha de registro.
    'orderby' => 'user_registered',
     
    // Excluir al administrador.
    'exclude' => 1,
     
    // Voy a usar un desplegable de más de un usuario, así que no pongo un único ID.
'multi' => 1,
     
    // No hagas echo, solo devuelve la salida.
    'echo' => 0,
     
    // Parámetro NAME de la etiqueta seleccionada.
    'name' => 'brands',
     
    // Obtiene solo autores.
    'who' => 'authors'
     
);
 
$brands_dropdown = wp_categories_dropdown( $args );
 
?>

<?php

$args = array(

// Ordenar según fecha de registro.

'orderby' => 'user_registered',

// Excluir al administrador.

'exclude' => 1,

// Voy a usar un desplegable de más de un usuario, así que no pongo un único ID.

'multi' => 1,

// No hagas echo, solo devuelve la salida.

'echo' => 0,

// Parámetro NAME de la etiqueta seleccionada.

'name' => 'brands',

// Obtiene solo autores.

'who' => 'authors'

);

$brands_dropdown = wp_categories_dropdown( $args );

Lo que te queda por leer:

Obtener y mostrar la imagen destacada de la entrada: `get_the_post_thumbnail()` y `the_post_thumbnail()`

Obtener y mostrar el permalink de una página de datos adjuntos: `wp_get_attachment_link()` y `the_attachment_link()`

Obtener el ID de la imagen destacada del post: `get_post_thumbnail_id()`

Obtener la imagen del archivo adjunto: `wp_get_attachment_image()`

Obtención de la URL de imagen de archivo adjunto: `wp_get_attachment_image_src()`

Obtención de los datos meta de imagen del archivo adjunto: `wp_get_attachment_metadata()`

Obtención de la siguiente imagen del mismo post: `next_image_link()`

Obtener la imagen anterior de la misma entrada: `previous_image_link()`

seguir leyendo en Tuts+

Entradas relacionadas

Twittear

Pocket

Obtención de la URL de los archivos de entradas del autor: get_author_posts_url()

Parámetros

Uso

Visualización de un enlace a los archivos de las entradas del autor: the_author_posts_link()

Parámetros

Uso

Cómo obtener y mostrar el enlace del sitio web del autor: get_the_author_link() y the_author_link()

Parámetros

Uso

Obtener y mostrar los metadatos del autor: get_the_author_meta() y the_author_meta()

Parámetros

Uso

Cómo mostrar y mostrar el recuento de entradas del autor: get_the_author_posts() y the_author_posts()

Parámetros

Uso

Obtener y mostrar la lista de autores: wp_list_authors()

Parámetros

Uso

Cómo obtener y mostrar un menú desplegable HTML de usuarios: wp_dropdown_users()

Parámetros

Uso

Obtener y mostrar la imagen destacada de la entrada: get_the_post_thumbnail() y the_post_thumbnail()

Obtener y mostrar el permalink de una página de datos adjuntos: wp_get_attachment_link() y the_attachment_link()

Obtener el ID de la imagen destacada del post: get_post_thumbnail_id()

Obtener la imagen del archivo adjunto: wp_get_attachment_image()

Obtención de la URL de imagen de archivo adjunto: wp_get_attachment_image_src()

Obtención de los datos meta de imagen del archivo adjunto: wp_get_attachment_metadata()

Obtención de la siguiente imagen del mismo post: next_image_link()

Obtener la imagen anterior de la misma entrada: previous_image_link()

Entradas relacionadas

Acerca de Eva Collados Pascual

Interacciones con los lectores

Deja una respuesta Cancelar la respuesta

Obtención de la URL de los archivos de entradas del autor: `get_author_posts_url()`

Visualización de un enlace a los archivos de las entradas del autor: `the_author_posts_link()`

Cómo obtener y mostrar el enlace del sitio web del autor: `get_the_author_link()` y `the_author_link()`

Obtener y mostrar los metadatos del autor: `get_the_author_meta()` y `the_author_meta()`

Cómo mostrar y mostrar el recuento de entradas del autor: `get_the_author_posts()` y `the_author_posts()`

Obtener y mostrar la lista de autores: `wp_list_authors()`

Cómo obtener y mostrar un menú desplegable HTML de usuarios: `wp_dropdown_users()`

Obtener y mostrar la imagen destacada de la entrada: `get_the_post_thumbnail()` y `the_post_thumbnail()`

Obtener y mostrar el permalink de una página de datos adjuntos: `wp_get_attachment_link()` y `the_attachment_link()`

Obtener el ID de la imagen destacada del post: `get_post_thumbnail_id()`

Obtener la imagen del archivo adjunto: `wp_get_attachment_image()`

Obtención de la URL de imagen de archivo adjunto: `wp_get_attachment_image_src()`

Obtención de los datos meta de imagen del archivo adjunto: `wp_get_attachment_metadata()`

Obtención de la siguiente imagen del mismo post: `next_image_link()`

Obtener la imagen anterior de la misma entrada: `previous_image_link()`