En la quinta parte de la serie, revisamos el cuarto lote de etiquetas de plantilla de WordPress. En esta sexta parte, vamos a ir a ver el quinto lote de las casi 200 etiquetas de plantilla. A lo largo del tutorial, veremos etiquetas de plantilla sobre posts, páginas y partes de plantilla.
Cómo obtener y mostrar clases automáticas para cada post: get_post_class()
y post_class()
Estas etiquetas de plantilla te permiten añadir clases adicionales para usar en el contenedor de cada post.
Parámetros
Ambas etiquetas de plantilla aceptan dos parámetros:
$class
(opcional, cadena): Nombres de clase CSS adicionales a añadir. (Predeterminado: Vacío)$post_ID
(opcional, entero u objeto): El ID del post. (Predeterminado: El post actual)
Uso
1 2 3 4 5 6 7 8 9 |
<?php // Añadir una clase extra y obtener las clases del post. $post_classes = get_post_class( 'mytheme-post-class' ); // Mostrar las clases de un post específico. post_class( '', 42 ); ?> |
Obtener y mostrar el enlace permanente del post actual: get_permalink()
y the_permalink()
Esta etiqueta de plantilla devuelve o muestra un «permalink» del post.
Parámetros
the_permalink()
no acepta ningún parámetro, pero get_permalink()
acepta dos parámetros:
$post_ID
(opcional, entero u objeto): El ID del post. (Predeterminado: Post actual)$leavename
(opcional, booleano): Si deseas mantener el nombre de la página o no. (Predeterminado:FALSE
)
Uso
1 2 3 4 5 6 7 8 9 |
<?php // Obtener el permalink del post actual. get_permalink(); // Mostrar el permalink de un post concreto. the_permalink( 69 ); ?> |
Obtener y mostrar el ID del post: get_the_ID()
y the_ID()
Estas etiquetas de plantilla devuelven y muestran el ID del post.
Parámetros
Estas etiquetas de plantilla no aceptan ningún parámetro.
Uso
1 2 3 4 5 |
<?php the_ID(); ?> |
Obtener y mostrar un título de página para el post: single_post_title()
Esta etiqueta de plantilla devuelve y muestra el título de la página para su uso en los títulos de página (los títulos que van dentro de la <title>
etiqueta).
Parámetros
Esta etiqueta de plantilla acepta dos parámetros:
$prefix
(opcional, cadena): Prefija el título. (Predeterminado: Vacío)$echo
(opcional, booleano): Si hace echo (TRUE
) o devuelve (FALSE
) la etiqueta. (Predeterminado:TRUE
)
Uso
1 2 3 4 5 6 7 8 9 |
<?php // Mostrar el título del post con un prefijo. single_post_title( __( 'Blog Post', 'translation-domain' ) . ': ' ); // Obtener el título del post. $post_title = single_post_title( '', false ); ?> |
Obtener y mostrar el enlace del siguiente post: get_next_post_link()
y next_post_link()
Estas etiquetas de plantilla te permiten devolver o mostrar un enlace de «siguiente entrada» para, por ejemplo, tus páginas de entrada única.
Parámetros
Ambas etiquetas de plantilla aceptan cinco parámetros:
$format
(opcional, cadena): Formato del enlace donde%link
es el parámetro$link
. (Predeterminado: ‘%link »’)$link
(opcional, cadena): Formato del texto de ancla donde%title
es el título del post. (Predeterminado: ‘%title’)$in_same_term
(opcional, booleano): Si hacer del enlace un post del mismo término de taxonomía. (Predeterminado:FALSE
)$excluded_terms
(opcional, cadena o matriz): Lista de términos excluidos. (Predeterminado: Vacío)$taxonomy
(opcional, cadena): Taxonomía para filtrar el siguiente post. (Predeterminado: ‘category’)
Uso
1 2 3 4 5 6 7 8 9 10 11 12 13 |
<?php // Obtener el enlace predeterminado del siguiente post. $next_post_link = get_next_post_link(); /** * Mostrar el enlace predeterminado del siguiente post con algunos ajustes. * (diferente formato de enlace, diferente texto de ancla y * el siguiente post debe pertenecer a la misma categoría que el post actual). */ next_post_link( __( 'Siguiente entrada', 'translation-domain' ) . ': %link', '<i class="icon-post"></i>%title', true ); ?> |
Obtener y mostrar el enlace del post anterior: get_previous_post_link()
y previous_post_link()
Estas etiquetas de plantilla te permiten devolver o mostrar un enlace de «entrada anterior» para, por ejemplo, tus páginas de entradas individuales.
Parámetros
Ambas etiquetas de plantilla aceptan cinco parámetros:
$format
(opcional, cadena): Formato del texto de ancla del enlace. (Predeterminado: ‘%link »’)$link
(opcional, cadena): Formato del enlace permanente. (Predeterminado: ‘%title’)$in_same_term
(opcional, booleano): Si hacer del enlace un post del mismo término de taxonomía. (Predeterminado:FALSE
)$excluded_terms
(opcional, cadena o matriz): Lista de términos excluidos. (Predeterminado: Vacío)$taxonomy
(opcional, cadena): Taxonomía para filtrar el post anterior. (Predeterminado: ‘category’)
Uso
1 2 3 4 5 6 7 8 9 10 11 12 13 |
<?php // Obtener el enlace predeterminado del post anterior. $previous_post_link = get_previous_post_link(); /** * Mostrar el enlace predeterminado del post anterior con algunos ajustes. * (diferente formato de enlace, diferente texto de ancla y * el anterior post debe pertenecer a la misma categoría que el post actual). */ previous_post_link( __( 'Previous Post', 'translation-domain' ) . ': %link', '<i class="icon-post"></i>%title', true ); ?> |
Obtener el permalink de una página: get_page_link()
Esta etiqueta de plantilla devuelve la dirección URL del permalink de una página determinada.
Parámetros
Esta etiqueta de plantilla acepta tres parámetros:
$post_ID
(opcional, entero u objeto): El ID del post. (Predeterminado: Post actual)$leavename
(opcional, booleano): Si deseas mantener el nombre de la página o no. (Predeterminado:FALSE
)$sample
(opcional, booleano): Si es un permalink de ejemplo. (Predeterminado:FALSE
)
Uso
1 2 3 4 5 6 |
<?php // Get and print a specific page's link. echo '<a href="' . get_page_link( 9 ) . '">' . __( 'About', 'translation-domain' ) . '</a>'; ?> |
Obtener y mostrar el permalink de un post: get_post_permalink()
y post_permalink()
Estas etiquetas de plantilla devuelven y muestran el enlace permanente del post dado.
Parámetros
get_post_permalink()
acepta tres parámetros:
$post_ID
(opcional, entero): El ID del post. (Predeterminado: Post actual)$leavename
(opcional, booleano): Si deseas mantener el nombre de la página o no. (Predeterminado:FALSE
)$sample
(opcional, booleano): Si es un permalink de muestra. (Predeterminado:FALSE
)
Y post_permalink()
solo acepta un parámetro:
$post_ID
(opcional, entero u objeto): El ID del post. (Predeterminado: Post actual)
Uso
1 2 3 4 5 6 7 8 9 |
<?php // Get a specific post's permalink. $special_post_permalink = get_post_permalink( 15 ); // Display current post's permalink. post_permalink(); ?> |
Lo que te queda por leer:
Deja una respuesta