El shortcode de mostrar entradas te permite añadir una lista de tus entradas de blog a diferentes páginas. Utiliza Argumentos para visualizar entradas específicas en función de sus categorías o etiquetas.
Los shortcodes son pequeños fragmentos de código diseñados para WordPress que te permiten añadir diferentes funciones a tu sitio o blog. Puedes obtener más información sobre los shortcodes aquí.
En esta guía
📌
Si añadiste un shortcode antes de mejorar a un plan de pago que permite el uso de plugins, el código mostrará el contenido cuando instales un plugin de shortcode de mostrar entradas. Existen varios plugins que ofrecen una funcionalidad similar.
También puedes considerar el uso de los bloques Entradas de blog o Últimas entradas.
Hay varias razones por las que te puede interesar utilizar el shortcode de mostrar entradas.
- Si quieres que aparezca una breve lista de entradas en tu página de inicio y la opción de entradas destacadas no forma parte del tema que elegiste o las entradas no se muestran del modo que deseas.
- Si quieres crear en tu sitio una página de Autores con biografías y algunas de sus obras publicadas más recientes.
- Si quieres destacar entradas específicas, por ejemplo anuncios, en una página.
- Si quieres añadir una lista específica de entradas a un widget en la barra lateral o el pie de página.
- ¡Y mucho más!
Las siguientes instrucciones sirven para editar una Página, una Entrada o un Widget de texto. Cuando añadas el siguiente código, solo verás el marcador de posición del código en el editor. Sin embargo, cuando publiques tu página, verás el resultado del shortcode.
- Editar una página, entrada o widget de texto.
- Añade el shortcode [display-posts] a una entrada o página.
- Publicar o actualizar una página o entrada.
Si estás utilizando el editor de bloques de WordPress, también puedes añadir un bloque de Shortcode para añadir el shortcode de mostrar entradas.
Las nuevas entradas y las actualizaciones de entradas existentes pueden tardar hasta una hora en aparecer cuando utilices este shortcode.
El shortcode de mostrar entradas mostrará una lista en viñetas de las 10 entradas más recientes por defecto. También es posible personalizar el número de entradas, así como el estilo y los elementos de las entradas que aparecen en la lista (título, imágenes destacadas, extractos, etc.).
Los argumentos se utilizan para personalizar cómo se muestran las entradas. A continuación, encontrarás una lista de los argumentos más comunes que puedes añadir al shortcode de mostrar entradas y ejemplos del aspecto que tiene el shortcode con el argumento.
author
Especifica el autor de la entrada
Por defecto: vacío
Ejemplo: [display-posts author="bill"]
category
Especifica el slug de la categoría (o una lista de slugs de categoría separados por comas). Puedes ver este shortcode en acción en este sitio de ejemplo.
Por defecto: vacío
Ejemplo: [display-posts category="fishing, hiking"]
date_format
Indica el formato de fecha utilizado cuando include_date tiene el valor «true». Consulta Formato de fecha y hora en nuestra página Codex para obtener más información.
Por defecto: ‘(n/j/Y)’
Ejemplo: [display-posts include_date="true" date_format="F j, Y"]
id
Indica el ID de entrada específico (o los ID de entradas) que se muestran.
Por defecto: vacío
Ejemplo: [display-posts id="9, 10"]
image_size
Indica el tamaño de imagen en el que mostrar la imagen destacada, si la entrada tiene alguna. El argumento image_size puede configurarse con las opciones miniatura, medio, grande (en Ajustes > Medios).
Por defecto: vacío
Ejemplo: [display-posts image_size="thumbnail"]
Si utilizas un tema que admite Opciones de contenido y lo configuras para que no muestre imágenes destacadas en Páginas, el argumento image_size tampoco tendrá efecto en los shortcodes que utilices en una página del sitio; las imágenes destacadas no se mostrarán en ninguna entrada que añadas a través del shortcode, incluso si el shortcode indica que estas deben mostrarse.
include_content
Incluye el contenido completo de la entrada después del título.
Por defecto: vacío
Ejemplo: [display-posts include_content="true"]
include_date
Incluye la fecha de la entrada después del título correspondiente. El formato por defecto es (7/30/12), pero puede personalizarse mediante el parámetro «date_format».
Por defecto: vacío
Ejemplo: [display-posts include_date="true"]
include_excerpt
Incluye el extracto de la entrada después del título (y de la fecha, si se muestra).
Por defecto: vacío
Ejemplo: [display-posts include_excerpt="true"]
offset
El número de entradas que no se consideran
Por defecto: 0
Ejemplo: [display-posts offset="3"]
order
Especifica si las entradas se deben mostrar en orden descendente (DESC) o ascendente (ASC).
Por defecto: DESC
Ejemplo: [display-posts order="ASC"]
orderby
Especifica el elemento por el que se ordenan las entradas. Consulta los parámetros disponibles aquí.
Por defecto: date
Ejemplo: [display-posts orderby="title"]
portfolio_type
Si utilizas el tipo de entrada Portfolio, utiliza esta opción para obtener elementos de un tipo de portafolio específico.
post_parent
Muestra las páginas secundarias de una página determinada. Puedes especificar un ID o la opción «current», que muestra la página secundaria de la actual.
Por defecto: vacío
Ejemplo: [display-posts post_type="page" post_parent="8"]
post_status
muestra entradas asociadas a un determinado estado de entrada
Por defecto: publish
Ejemplo: [display-posts post_status="publish, future"]
post_type
Especifica el tipo de entrada que se debe utilizar. Puedes utilizar una por defecto (entrada o página). Para los Portafolios, utiliza «jetpack-portfolio». De forma similar, para los Testimonios, utiliza «jetpack-testimonial».
Por defecto: post
Ejemplo: [display-posts post_type="page"]
posts_per_page
El número de entradas que deseas mostrar.
Por defecto: 10
Ejemplo: [display-posts posts_per_page="5"]
tag
Especifica el slug de etiqueta (o una lista de slugs de etiquetas separados por comas)
Predeterminado: vacío
Ejemplo: [display-posts tag="tag1, tag2"]
taxonomy, tax_term y tax_operator
Utiliza estos parámetros para realizar consultas de taxonomía avanzadas. Utiliza «taxonomy» para especificar la taxonomía sobre la que deseas hacer una consulta, «tax_term» para el slug del término (o términos) que deseas incluir y «operator» para cambiar cómo la consulta utiliza estos términos (lo más probable es que este campo no sea necesario).
Por defecto: ‘taxonomy’ = empty , ‘tax_term’ = empty , ‘tax_operator’ = ‘IN’
Ejemplo: [display-posts taxonomy="color" tax_term="blue, green"]
wrapper
El tipo de HTML que debe utilizarse para mostrar las listas. Puede ser una lista sin ordenar (ul), una lista ordenada (ol) o etiquetas div (div) que puedes editar tú mismo.
Por defecto: ul
Ejemplo: [display-posts wrapper="ol"]
Aquí se muestran algunos ejemplos de shortcodes que combinan varios argumentos para mostrar una lista específica de entradas.
[display-posts tag="advanced" posts_per_page="20"]
Se muestran las 20 entradas más recientes con la etiqueta «Avanzado».
[display-posts tag="advanced" image_size="thumbnail"]
Se muestran las 10 entradas más recientes etiquetadas como «Avanzado» y la imagen de una entrada en miniatura.
[display-posts category="must-read" posts_per_page="-1" include_date="true" order="ASC" orderby="title"]
Se muestran todas las entradas de la categoría Lectura imprescindible, en orden alfabético y con la fecha al final.
[display-posts wrapper="ol"]
Se muestran las entradas en una lista ordenada. Las opciones son «ul» para las listas sin ordenar (por defecto), «ol» para las listas ordenadas o «div» para las etiquetas div.
[display-posts id="14,3"]
Solo se muestran las entradas con el ID 14 y 3.
Una solicitud habitual es la de mostrar una lista de las entradas con su título, extracto y miniatura alineados a la derecha. Este es el shortcode que puedes utilizar:
[display-posts include_excerpt="true" image_size="thumbnail" wrapper="div"]
Incluye el extracto, añade una imagen en miniatura (puedes personalizar el tamaño en Configuración → Medios) y especifica que la lista se muestre sin viñetas.
Para que la imagen flote a la derecha, añade esto a tu archivo CSS personalizado (debes tener la mejora WordPress.com Premium o WordPress.com Business):
.display-posts-listing .alignleft {
float: right;
margin: 0 0 5px 5px;
}
Aunque que la mayoría de usuarios solo necesitan hacer una consulta de taxonomía, este código abreviado permite hacer tantas como quieras. Pongamos que quieres obtener todas las entradas de la categoría «destacadas» y que se etiqueten como «página de inicio». Utilizaremos un código abreviado similar al siguiente:
[display-posts taxonomy="category" tax_term="featured" taxonomy_2="post_tag" tax_2_term="homepage"]
Si deseas incluir todas las publicaciones en la categoría «destacadas» y también etiquetarlas en color «azul» o «verde», puedes usar el siguiente shortcode:
[display-posts taxonomy="category" tax_term="featured" taxonomy_2="post_tag" tax_2_term="blue, green" tax_2_operator="OR" tax_relation="AND"]
Puedes encadenar tantos como desees, empezando el recuento a partir de 2. En la siguiente lista de campos, reemplaza (count) por el número real.
Estos son los campos disponibles:
taxonomy_(count)
Qué taxonomía consultar
Por defecto: vacío
tax_(count)_term
Qué términos se incluyen (si hay más de uno, separados por comas)
Por defecto: vacío
tax_(count)_operator
Cómo consultar los términos (IN, NOT IN o AND)
Por defecto: IN
tax_relation
Describe la relación existente entre las múltiples consultas de taxonomía (que los resultados coincidan con todas las consultas o con tan solo una). Opciones disponibles: AND y OR
Por defecto: AND
El shortcode de mostrar entradas tiene un límite de 100.
Puedes encontrar el ID de entrada en la opción «Editar URL de la entrada» del editor de entradas. Por ejemplo, el ID de entrada para el siguiente ejemplo es «125».
