Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress

La Guía Tuts+ para las Etiquetas de Plantilla: Primer conjunto de etiquetas

by
Read Time:8 minsLanguages:
This post is part of a series called The Tuts+ Guide to Template Tags.
The Tuts+ Guide to Template Tags: Introduction
The Tuts+ Guide to Template Tags: Second Batch

Spanish (Español) translation by Lucas Nicolas Frezzini (you can also view the original English article)

En la primera parte de la serie, teníamos un vistazo a qué son los tags de plantilla, donde se encuentran, cómo funcionan y cómo usarlos.

En esta segunda parte, vamos a ir a través del primer conjunto de las casi 200 etiquetas de plantilla. A lo largo del tutorial, vamos a ver etiquetas de plantilla sobre los datos de las Entradas: títulos, fechas, contenidos y otros meta datos.

Obtener y Mostrar el Contenido de una Entrada: get_the_content() y the_content()

Podrían ser las etiquetas de plantilla más populares de todos los tiempos: estas etiquetas de plantilla devuelven (return) o imprimen (echo) el contenido de la Entrada.

Parámetros

Ambas clásicas etiquetas de plantilla aceptan dos parámetros:

  • $more_link_text (opcional — string):
    Texto para reemplazar el texto por defecto "(más...)".
    (Por defecto: "(more…)")
  • $strip_teaser (opcional — boolean)
    Quitar el teaser text.
    (Por defecto: false)

Una nota sobre el "teaser text": ¿sabía usted que hay una etiqueta, <!--noteaser-->, para hacer el contenido antes de <!--more--> un "teaser text" y no mostrar esa parte de la página en una Entrada individual, incluso si $strip_teaser está establecida en falso (FALSE)? ¡Seguramente no la sabia! No es totalmente desconocido, aunque, aquí hay un post de 2009.

Utilización

Obtener y Mostrar el contenido de la Entrada a travéz de Feeds: get_the_content_feed() y the_content_feed()

Estas etiquetas de plantilla obtienen y devuelven el resultado para el contenido de los feeds.

Parámetros

Ambas etiquetas de plantilla aceptan solo un parámetro:

  • $feed_type (opcional—string):
    Tipo del feed.
    (Por defecto: tipo de feed por defecto)

Utilización

Obtener y Mostrar el Extracto de las Entradas: get_the_excerpt() y the_excerpt()

Estas etiquetas de plantilla traen y muestran el extracto de la Entrada.

Parámetros

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

Utilización

Mostrando el Extracto de una Entrada por Feeds: the_excerpt_rss()

Esta etiqueta de plantilla hace al extracto de la Entrada listo para los feeds y las salidas.

Parámetros

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

Utilización

Obtener y Mostrar el Título de la Entrada: get_the_title() y the_title()

Estás etiquetas de plantilla permiten imprimir (echo) o devolver (return) el título de tus Entradas.

Parámetros

get_the_title() acepta solo un parámetro:

  • $post_ID (opcional—integer u object):
    El ID de la Entrada.
    (Por defecto: entrada actual)

Y the_title() acepta tres parámetros:

  • $before (opcional—string):
    El texto o código HTML que se mostrara antes de la salida de la función.
    (Por defecto: Vacío)
  • $after (opcional—string):
    El texto o código HTML que se muestra después de la salida de la función.
    (Por defecto: Vacío)
  • $echo (opcional—boolean):
    Se imprime si se declara verdadero (TRUE) o se retorna si se declara falso (FALSE) la etiqueta.
    (Por defecto: TRUE)

Utilización

Obtener y Mostrar el título de la Entrada "Limpio": the_title_attribute()

Esta etiqueta de plantilla obtiene el título de la entrada y lo prepara para ser usado como valores de atributos HTML. Mira el ejemplo para entender mejor el concepto.

Parámetros

Está etiqueta de plantilla solo acepta un parámetro:

  • $args (opcional—array):
    Un vector de los siguientes parámetros:
    • 'begore' (string): agregar código HTML antes de la salida.
      (Por defecto: Vacío)
    • 'after' (string): agregar código HTML después de la salida.
      (Por defecto: Vacío)
    • 'echo' (boolean): si se imprime la etiqueta de plantilla o no.
      (Por defecto: TRUE)
    • 'post' (objeto): objeto de la Entrada actual para obtener el título.
      (Por defecto: 0)

Utilización

Vamos a tomar este título como un ejemplo:

Bill y Melinda Gates gastan miles de millones de caridad, y preguntan "¿¿¿Qué hacen???"

El título tiene dos comillas y un ampersand que se perderían en tu código HTML si los usarás en un atributo HTML, porque los atributos están construidos por comillas también. Aquí es donde the_title_attribute() se convierte en indispensable:

Ahora el atributo en el enlace del título (title) se ve de esta forma:

Bill &amp; Melinda Gates gastan miles de millones a la caridad, y preguntan &quot;¿¿¿Qué hacen???&quot;

Y de esta forma, no me preocupo porque se pierdan comillas o ampersand en mi código HTML.

Mostrando el Título de la Entrada por Feeds: the_title_rss()

Está etiqueta de plantilla te devuelve el título, lo prepara para usarlo en feeds y lo imprime también.

Parámetros

Está etiqueta de plantilla no acepta ningún parámetro

Utilización

Obtener y Mostrar la Fecha de la Entrada: get_the_date() y the_date()

Estas etiquetas de plantilla devuelven e imprimen la fecha de una Entrada.

Parámetros

get_the_date() acepta dos parámetros:

  • $date_format (opcional—string):
    El formato de la fecha.
    (Por defecto: el formato seteado en la página de Opciones Generales)
  • $post_ID (opcional—integer u object):
    El ID de la entrada.
    (Por defecto: Entrada actual)

Y the_date() acepta cuatro parámetros:

  • $date_format (opcional—string):
    El formato de la fecha.
    (Por defecto: el formato seteado en la página de Opciones Generales)
  • $before (opcional—string):
    El texto o código HTML que se muestra antes de la salida.
    (Por defecto: vacío)
  • 'after' (opcional—string):
    El texto o código HTML que se muestra después de la salida.
    (Por defecto: Vacío)
  • $echo (opcional—boolean):
    se imprime si es verdadero (TRUE) o se retorna si es falso (FALSE) la etiqueta
    (Por defecto: TRUE)

Utilización

Obtener y Mostrar la Fecha de la Entrada en el formato ISO 8601: the_date_xml()

Esta etiqueta de plantilla devuelve e imprime la fecha de una entrada en el formato ISO 8601.

Parámetros

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

Utilización

Obtener y Mostrar el Horario de una Entrada: get_the_time() y the_time()

Estás etiquetas de plantilla devuelven e imprimen el horario de una entrada.

Parámetros

get_the_time() acepta dos parámetros:

  • $time_format (opcional—string):
    El formato del horario.
    (Por defecto: el formato de horario seteado en la página de Opciones Generales)
  • $post_ID (opcional—integer u object):
    El ID de la entrada.
    (Por defecto: la entrada actual)

Y the_time() acepta solo un parámetro:

  • $time_format (opcional—string):
    El formato del horario.
    (Por defecto: el formato de horario seteado en la página de Opciones Generales)

Utilización

Obtener y Mostrar el Nombre de Autor: get_the_author() y the_autor()

Estás etiquetas de plantilla obtienen e imprimen el nombre del autor de la Entrada.

Parámetros

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

Utilización

Imprimir Todos los Meta Datos de la Entrada: the_meta()

Esta etiqueta de plantlla crea una lista de todos los meta datos de la entrada en una lista no ordenada.

Parámetros

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

Utilización

Obtener y Mostrar la Fecha de Modificación de la Entrada: get_the_modified_date() y the_modified_date()

Está etiqueta de plantilla obtiene e imprime la fecha de la última modificación a la Entrada.

Parámetros

get_the_modified_date() acepta solo un parámetro:

  • $date_format (opcional—string):
    El formato de la fecha.
    (Por defecto: el formato de Fecha seteado en la página de Opciones Generales)

Y the_modified_date() acepta cuatro parámetros:

  • $date_format (opcional—string):
    El formato de la fecha.
    (Por defecto: el formato de Fecha seteado en la página de Opciones Generales)
  • $before (opcional—string):
    El texto o código HTML que se muestra antes de la salida.
    (Por defecto: Vacío)
  • $after (opcional—string):
    El texto o código HTML que se muestra después de la salida.
    (Por defecto: Vacío)
  • $echo (opcional—boolean):
    se imprime si esta verdadero (TRUE) o se retorna si esta falso (FALSE) la etiqueta.
    (Por defecto: TRUE)

Utilización

Obtener y Mostrar el Horario de Modificación de una Entrada: get_the_modified_time() y the_modified_time()

Estás etiquetas de plantilla buscan e imprimen el horario de modificación de la entrada.

Parámetros

Ambas etiquetas de plantilla aceptan un solo parámetro:

  • $time_format (opcionl—string):
    El formato de horario.
    (Por defecto: el formato de Horario seteado en la página de Opciones Generales)

Utilización

Obtener y Mostrar el Autor que Editó una Entrada reciente: get_the_modified_author() y the_modified_author()

Estás etiquetas de plantilla buscan e imprimen el último autor que modificó una entrada específica.

Parámetros

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

Utilización

Obtener y Mostrar una lista de páginas para paginar las entradas: wp_link_pages()

Se pueden dividir tus posts en las páginas mediante el uso de <!--nextpage-->, y esta etiqueta de plantilla le ayuda a las páginas de la lista.

Parámetros

Está etiqueta de plantilla acepta un solo parámetro:

  • $args (opcional—array):
    Un vector con los siguientes argumentos:
    • 'before' (string): agregar código HTML antes de la salida.
      (Por defecto: '<p>Páginas:')
    • 'after' (string): agregar código HTML despúes de la salida.
      (Por defecto: '</p>')
    • 'link_before' (string): agregar código HTML antes de cada enlace.
      (Por defecto: ")
    • 'link_after' (string): agregar código HTML después de cada enlace.
      (Por defecto: ")
    • 'next_or_number' (string): si deseas mostrar en los enlaces números de páginas usar ('numer') o si muestras "Siguiente (o Anterior) página" usar ('next').
      (Por defecto: 'number')
    • 'sep' (string): Separador de texto.
      (Por defecto: ' ')
    • 'nextpagelink' (string): texto para el enlace de "siguiente página".
      (Por defecto: 'Siguiente página')
    • 'previouspagelink' (string): texto para el enlace de "página anterior".
      (Por defecto: 'Previous Page')
    • 'pagelink' (string): formato de los enlaces con anclas a texto, solo sí 'next_or_number' esta seteado en 'number'. El carácter "%" es el encargado de remplazar el número de página, por lo tanto puedes usar valores como "Página %" para generar enlaces como "Página 1, Página 2, Página 3".
      (Por defecto: '%')
    • 'echo' (integer): se imprime la salida si vale (1) o se retorna si vale (0)
      (Por defecto: 1)

Utilización

Conclusión

Espero que te haya gustado el primer conjunto de etiquetas de plantilla. Todavía hay siete conjuntos más por ver, así que estate atento para más artículos de etiquetas de plantilla.

Si tienes preguntas, comentarios o correcciones, puede compartir sus pensamientos con nosotros en la sección de comentarios. Y si te gustó el artículo, no olvides compartir con tus amigos!

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.