Guía sobre etiquetas de plantilla: segundo lote

En la segunda parte de la serie, repasamos el primer lote de etiquetas de plantilla de WordPress. En esta tercera parte, vamos a ir a través del segundo lote de las casi 200 etiquetas de plantilla. A lo largo del tutorial, veremos etiquetas de plantilla sobre taxonomías y términos.

Obtener la descripción de una categoría: `category_description()`

Esta etiqueta de plantilla devuelve la descripción de una categoría.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$category_ID (opcional: entero):El ID de la categoría.(Predeterminado: la categoría consultada)

Uso

<?php
 
$cat_desc = get_category_description( 15 );
 
?>

<?php

$cat_desc = get_category_description( 15 );

Obtener la descripción de una etiqueta: `tag_description()`

Esta etiqueta de plantilla devuelve la descripción de una etiqueta.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$tag_ID (opcional: entero):El ID de la etiqueta.(Predeterminado: Etiqueta actual)

Uso

<?php
 
// Mostrar la descripción de la etiqueta actual.
echo tag_description();
 
// Get the description of a specific tag.
$special_tag_desc = tag_description( 42 );
 
?>

<?php

// Mostrar la descripción de la etiqueta actual.

echo tag_description();

// Get the description of a specific tag.

$special_tag_desc = tag_description( 42 );

Obtener la descripción de un término: `term_description()`

Esta etiqueta de plantilla simplemente devuelve la descripción de un término.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

$term_ID (opcional: entero): El ID del término. (Predeterminado: Término actual)
$taxonomy (opcional: cadena): La taxonomía del término. (Predeterminado: ‘post_tag’)

Uso

<?php
 
// Mostrar la descripción del término actual.
echo term_description();
 
// Get the description of a specific term from a specific taxonomy.
$special_term_desc = term_description( 14, 'laptop_inches' );
 
?>

<?php

// Mostrar la descripción del término actual.

echo term_description();

// Get the description of a specific term from a specific taxonomy.

$special_term_desc = term_description( 14, 'laptop_inches' );

Obtener y mostrar un título de página para los archivos de categorías: `single_cat_title()`

Esta etiqueta de plantilla devuelve y muestra el título de la categoría para su uso en los títulos de página.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

$prefix (opcional: cadena): Prefijo del título. (Predeterminado: Vacío)
$echo (opcional—booleano): Si se hace echo (TRUE) o se devuelve (FALSE) la etiqueta. (Predeterminado: TRUE)

Uso

<?php
 
// Mostrar el título de una categoría con un prefijo.
single_cat_title( 'Categoría: ' );
 
// Get the category title.
$cat_title = single_cat_title( '', false );
 
?>

<?php

// Mostrar el título de una categoría con un prefijo.

single_cat_title( 'Categoría: ' );

// Get the category title.

$cat_title = single_cat_title( '', false );

Obtener y mostrar un título de página para los archivos de etiquetas: `single_tag_title()`

Esta etiqueta de plantilla devuelve y muestra el título de la etiqueta para su uso 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 se hace echo (TRUE) o se devuelve (FALSE) la etiqueta. (Predeterminado: TRUE)

Uso

<?php
 
// Mostrar el título de la etiqueta con un prefijo.
single_tag_title( 'Etiqueta de archivo: ' );
 
// Get the tag title.
$tag_title = single_tag_title( '', false );
 
?>

<?php

// Mostrar el título de la etiqueta con un prefijo.

single_tag_title( 'Etiqueta de archivo: ' );

// Get the tag title.

$tag_title = single_tag_title( '', false );

Cómo obtener y mostrar un título de página para los archivos de los términos: `single_term_title()`

Esta etiqueta de plantilla devuelve y muestra el título del término 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 se hace echo (TRUE) o se devuelve (FALSE) la etiqueta. (Predeterminado: TRUE)

Uso

<?php
 
// Muestra el título de término con un prefijo.
single_term_title( 'Archivo de término: ' );
 
// Get the term title.
$term_title = single_term_title( '', false );
 
?>

<?php

// Muestra el título de término con un prefijo.

single_term_title( 'Archivo de término: ' );

// Get the term title.

$term_title = single_term_title( '', false );

Obtener y mostrar las categorías del post: `get_the_category_list()` y `the_category()`

Estas etiquetas de plantilla capturan y generan las categorías asignadas al post.

Parámetros

Ambas etiquetas de plantilla aceptan tres parámetros:

$separator (opcional: cadena):Texto separador.(Predeterminado: Vacío, si este parámetro está vacío, las funciones devolverán y mostrarán una lista desordenada de categorías)
$parents (opcional: cadena):Cómo mostrar las categorías padre (‘multiple’, ‘single’ o vacías).(Predeterminado: Vacío)
$post_ID (opcional: entero):El ID del post.(Predeterminado: Post actual)

Uso

<?php
 
// Obtener una lista desordenada con las categorías de la entrada actual.
get_the_category_list();
 
// Mostrar las categorías de la entrada actuales separadas por comas junto con sus categorías superiores (en caso de que existan).
the_category( ', ', 'multiple' );
 
?>

<?php

// Obtener una lista desordenada con las categorías de la entrada actual.

get_the_category_list();

// Mostrar las categorías de la entrada actuales separadas por comas junto con sus categorías superiores (en caso de que existan).

the_category( ', ', 'multiple' );

Obtener y mostrar las categorías del post para los feeds: `get_the_category_rss()` y `the_category_rss()`

Estas etiquetas de plantilla hacen que las categorías asignadas al post estén listas para los feeds y las devuelvan o las muestren.

Parámetros

Ambas etiquetas de plantilla solo aceptan un parámetro:

$feed_type (opcional: string):Tipo del feed.(Predeterminado: tipo de feed predeterminado)

Uso

<?php
 
// Obtener los elementos del feed de las categorías para el tipo de feed predeterminado.
get_the_category_rss();
 
// Mostrar los elementos del feed de categorías para los feeds de atom.
the_category_rss( 'atom' );
 
?>

<?php

// Obtener los elementos del feed de las categorías para el tipo de feed predeterminado.

get_the_category_rss();

// Mostrar los elementos del feed de categorías para los feeds de atom.

the_category_rss( 'atom' );

Obtener y mostrar las etiquetas de un post: `get_the_tag_list()` y `the_tags()`

Estas etiquetas de plantilla devuelven o muestran las etiquetas de tus posts.

Parámetros

Ambas etiquetas de plantilla aceptan tres parámetros:

$before (opcional: cadena): El texto o el código HTML que se va a mostrar antes de la salida. (Predeterminado: Vacío para get_the_tag_list() y ‘Etiquetas:’ para the_tags())
$sep (opcional: cadena): Texto que se utilizará como separador. (Predeterminado: Vacío para get_the_tag_list() y ‘, ‘ para the_tags())
$after (opcional: cadena): El texto o el código HTML que se mostrará después de la salida. (Predeterminado: Vacío)

Uso

<?php
 
// Obtener un simple listado de etiquetas.
get_the_tag_list();
 
// Mostrar las etiquetas con parámetros personalizados.
the_tags( '<div class="las-etiquetas-de-mi-tema">' . __( 'Etiquetas: ', 'translation-domain' ) , ' &middot; ', '</div>' );
 
?>

<?php

// Obtener un simple listado de etiquetas.

get_the_tag_list();

// Mostrar las etiquetas con parámetros personalizados.

the_tags( '<div class="las-etiquetas-de-mi-tema">' . __( 'Etiquetas: ', 'translation-domain' ) , ' · ', '</div>' );

Obtener y mostrar los términos de un post: `get_the_term_list()` y `the_terms()`

Estas etiquetas de plantilla obtienen y hacen eco de una lista de términos asignados para el post.

Parámetros

Ambas etiquetas de plantilla aceptan cinco parámetros:

$post_ID (opcional: entero): El ID del post. (Predeterminado: Post actual)
$taxonomy (obligatorio—cadena): Taxonomía para mostrar sus términos. (Predeterminado: Vacío)
$before (opcional: cadena): El texto o el código HTML que se va a mostrar antes de la salida. (Predeterminado: Vacío)
$sep (opcional: cadena): Texto separador. (Predeterminado: ‘, ‘)
$after (opcional: cadena): El texto o el código HTML que se mostrará después de la salida. (Predeterminado: Vacío)

Uso

<?php
 
// Obtener los términos de la entrada actual de la taxonomía "Marcas disponibles".
get_the_term_list( $post->ID, 'available-brands' );
 
// Mostrar los términos de la entrada actual de la taxonomía "Marcas disponibles" con alguna personalización.
the_terms( $post->ID, 'marcas-disponibles', __( 'Marcas disponibles: ', 'translation-domain' ), ' - ' );
 
?>

<?php

// Obtener los términos de la entrada actual de la taxonomía "Marcas disponibles".

get_the_term_list( $post->ID, 'available-brands' );

// Mostrar los términos de la entrada actual de la taxonomía "Marcas disponibles" con alguna personalización.

the_terms( $post->ID, 'marcas-disponibles', __( 'Marcas disponibles: ', 'translation-domain' ), ' - ' );

Visualización de las taxonomías de un post: `the_taxonomies()`

Esta etiqueta de plantilla muestra las taxonomías y los términos asociados a esas taxonomías.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

$args (opcional: arreglo de discos):Matriz de los argumentos siguientes:
- 'post' (entero): ID del post. (Predeterminado: 0)
- 'before' (cadena): Código HTML para agregar antes de la salida. (Predeterminado: Vacío)
- 'sep' (cadena): Texto separador. (Predeterminado: ‘ ‘)
- 'after' (cadena): Código HTML para agregar después de la salida.(Predeterminado: Vacío)
- 'template' (cadena): La plantilla que se va a utilizar para mostrar los términos de taxonomía. (Predeterminado: ‘%s: %l.’ donde %s es la etiqueta de taxonomía y %t es la lista de enlaces de términos)

Uso

<?php
 
$args = array(
    'before' => '<div class="taxonomies">',
    'sep'    => ', ',
    'after'  => '</div>'
);
 
the_taxonomies( $args );
 
?>

<?php

$args = array(

'before' => '<div class="taxonomies">',

'sep' => ', ',

'after' => '</div>'

);

the_taxonomies( $args );

Obtener y mostrar el enlace «Editar etiqueta»: `get_edit_tag_link()` y `edit_tag_link()`

Estas etiquetas de plantilla devuelven o se hacen eco de un enlace «editar esta etiqueta» para que lo uses en tus plantillas.

Parámetros

get_edit_tag_link() acepta dos parámetros:

$tag_ID (obligatorio: entero): El ID de la etiqueta. (Predeterminado: NULL)
$taxonomy (opcional: cadena): El tipo de taxonomía. (Predeterminado: ‘post_tag’)

Y edit_tag_link() acepta cuatro parámetros:

$link (opcional: cadena):Texto que se mostrará para 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)
$tag (obligatorio: objeto):Objeto de etiqueta.(Predeterminado: NULL)

Uso

<?php
 
// Recuperar el enlace "editar etiqueta" para las actuales etiquetas.
$edit_tag_link = get_edit_tag_link();
 
// Recuperar el enlace "editar etiqueta" de un término concreto.
$edit_tag_link = get_edit_tag_link( 4, 'keyboard-brand' );
 
// Mostrar el enlace "editar etiqueta" para la etiqueta actual.
edit_tag_link( __( 'Edit', 'translation-domain' ), '<strong>', '</strong>' );
 
// Mostrar el enlace "editar etiqueta" de una etiqueta concreta.
edit_tag_link( __( 'Edit', 'translation-domain' ), '', '', 11 );
 
?>

<?php

// Recuperar el enlace "editar etiqueta" para las actuales etiquetas.

$edit_tag_link = get_edit_tag_link();

// Recuperar el enlace "editar etiqueta" de un término concreto.

$edit_tag_link = get_edit_tag_link( 4, 'keyboard-brand' );

// Mostrar el enlace "editar etiqueta" para la etiqueta actual.

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

// Mostrar el enlace "editar etiqueta" de una etiqueta concreta.

edit_tag_link( __( 'Edit', 'translation-domain' ), '', '', 11 );

Lo que te queda por leer:

Obtener y mostrar la lista de categorías: `wp_list_categories()`

Obtener y mostrar un menú desplegable HTML de categorías: `wp_dropdown_categories()`

Obtener y mostrar la nube de etiquetas: `wp_tag_cloud()`

Obtener una nube de etiquetas generada personalizada: `wp_generate_tag_cloud()`

seguir leyendo en Tuts+

Entradas relacionadas

Twittear

Pocket

Obtener la descripción de una categoría: category_description()

Parámetros

Uso

Obtener la descripción de una etiqueta: tag_description()

Parámetros

Uso

Obtener la descripción de un término: term_description()

Parámetros

Uso

Obtener y mostrar un título de página para los archivos de categorías: single_cat_title()

Parámetros

Uso

Obtener y mostrar un título de página para los archivos de etiquetas: single_tag_title()

Parámetros

Uso

Cómo obtener y mostrar un título de página para los archivos de los términos: single_term_title()

Parámetros

Uso

Obtener y mostrar las categorías del post: get_the_category_list() y the_category()

Parámetros

Uso

Obtener y mostrar las categorías del post para los feeds: get_the_category_rss() y the_category_rss()

Parámetros

Uso

Obtener y mostrar las etiquetas de un post: get_the_tag_list() y the_tags()

Parámetros

Uso

Obtener y mostrar los términos de un post: get_the_term_list() y the_terms()

Parámetros

Uso

Visualización de las taxonomías de un post: the_taxonomies()

Parámetros

Uso

Obtener y mostrar el enlace «Editar etiqueta»: get_edit_tag_link() y edit_tag_link()

Parámetros

Uso

Obtener y mostrar la lista de categorías: wp_list_categories()

Obtener y mostrar un menú desplegable HTML de categorías: wp_dropdown_categories()

Obtener y mostrar la nube de etiquetas: wp_tag_cloud()

Obtener una nube de etiquetas generada personalizada: wp_generate_tag_cloud()

Entradas relacionadas

Acerca de Eva Collados Pascual

Interacciones con los lectores

Deja una respuesta Cancelar la respuesta

Obtener la descripción de una categoría: `category_description()`

Obtener la descripción de una etiqueta: `tag_description()`

Obtener la descripción de un término: `term_description()`

Obtener y mostrar un título de página para los archivos de categorías: `single_cat_title()`

Obtener y mostrar un título de página para los archivos de etiquetas: `single_tag_title()`

Cómo obtener y mostrar un título de página para los archivos de los términos: `single_term_title()`

Obtener y mostrar las categorías del post: `get_the_category_list()` y `the_category()`

Obtener y mostrar las categorías del post para los feeds: `get_the_category_rss()` y `the_category_rss()`

Obtener y mostrar las etiquetas de un post: `get_the_tag_list()` y `the_tags()`

Obtener y mostrar los términos de un post: `get_the_term_list()` y `the_terms()`

Visualización de las taxonomías de un post: `the_taxonomies()`

Obtener y mostrar el enlace «Editar etiqueta»: `get_edit_tag_link()` y `edit_tag_link()`

Obtener y mostrar la lista de categorías: `wp_list_categories()`

Obtener y mostrar un menú desplegable HTML de categorías: `wp_dropdown_categories()`

Obtener y mostrar la nube de etiquetas: `wp_tag_cloud()`

Obtener una nube de etiquetas generada personalizada: `wp_generate_tag_cloud()`