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 la Plantilla: Introduccion

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

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

Hemos dicho muchas veces en este sitio web que WordPress es un sistema de gestión de contenidos muy potente y que su poder proviene de su extensibilidad. Si un producto es extensible, la gente va a contribuir en él, y si las personas contribuyen en él, este producto crece y será conocido por más personas, que también contribuyan, y que ayudarán al crecimiento del producto aún más... Es este gran ciclo el que construye comunidades, y este ciclo es la razón de que WordPress sea el sistema de gestión de contenidos más popular en el mundo.

En esta serie de artículos, usted va a aprender sobre uno de los conceptos fundamentales de WordPress: las etiquetas de la plantilla.

¿Qué son las Etiquetas en una Plantilla?

Las dos principales características que demuestran la extensibilidad de WordPress son la posibilidad de desarrollar "plugins" (para incrementar las funcionalidades) y "temas" (para mejorar el diseño). Estás características son el resultado exitoso en los conceptos del núcleo de WordPress como APIs y subsistemas. Uno de estos conceptos es lo que ya has empezado a leer — las etiquetas de la plantilla. 

Las etiquetas de una plantilla son un concepto básico de WordPress, que se remonta incluso antes de WordPress: b2, la "herramienta web-blog" que Matt Mullenweng y Mike Little bifurcaron para crear WordPress, ya tenía las etiquetas en plantillas. Se podría decir que son unas de las características más antiguas de WordPress que existen, incluso antes de la capacidad de poder crear temas y plugins. Hay que mostrar algo de respeto por las etiquetas.

En el Codex, las etiquetas de plantilla se explican de la siguiente manera:

Las Etiquetas de plantilla se utilizan dentro de las plantillas de su blog para mostrar la información de forma dinámica, o de otra manera, personalizando su blog proporcionando las herramientas para que sea tan individual e interesante como es usted.

En síntesis, las Etiquetas de plantilla son funciones PHP que le permiten a WordPress hacer cosas por usted. Y créame, no será nada complicado ni confuso para usted sí conoce las bases de PHP y HTML.

¿Donde están estas Etiquetas de plantilla?

Usted puede encontrar los archivos que almacenan las funciones de todas las etiquetas de plantilla en la carpeta wp-includes. Hay nueve diferentes archivos con el sufijo -template.

  • wp-includes/author-template.php para las etiquetas de plantilla relacionadas con el autor.
  • wp-includes/bookmark-template.php para las etiquetas de plantillas relacionadas con los Marcadores.
  • wp-includes/category-template.php para las etiquetas de plantilla sobre todas las taxonomías y términos, incluyendo categorías y etiquetas.
  • wp-includes/comment-template.php para las etiquetas de plantillas de la sección de comentarios.
  • wp-includes/link-template.php para las etiquetas de plantilla sobre los enlaces (permalinks, enlaces adjuntos, enlaces de archivos, etc.)
  • wp-includes/nav-menu-template.php para las etiquetas de plantilla sobre los menús de navegación.
  • wp-includes/post-template.php para las etiquetas de plantilla relacionadas a las Entradas.
  • wp-includes/post-thumbnail-template.php para las etiquetas de plantilla sobre las miniaturas de las entradas.
  • wp-includes/general-template.php para otras etiquetas de plantilla que podría usar dondequiera.

Utilizando las Etiquetas de plantilla en WordPress

Como se dijo antes, el concepto de "Etiqueta de plantilla" no es tan complicado si tienes los conceptos básicos de PHP, HTML, y quizás CSS (pero fundamentalmente PHP). Partiendo desde el concepto de Etiquetas de plantilla, no son más que funciones de PHP, y el uso de ellas debería ser sencillo. Como sea, hay algunas cosas que se deben saber sobre ellas.

Funciones de Etiquetas de plantilla

Además de "Incluir Etiquetas" y "Etiquetas condicionales" (quienes son parte de la familia de "Etiquetas de plantillas"), las funciones de etiquetas de plantilla están divididas en dos grupos: las que imprimen (echo) resultados y las que retornan (return) resultados. Estos dos tipos de funciones forman la base de las Etiquetas de plantillas y te permiten desarrollar nuevos temas.

Se pueden distinguir las funciones return (que retornan resultados) por su nombre — estas tienen un prefijo en su nombre de función de la siguiente forma: get_.  Aunque se vean como funciones derivadas de una función original, estás contienen el llamado a la función original y return (retornan) el resultado. Las funciones que imprimen (echo) resultados suelen ser "alias" que imprimen (echo) el resultado de una función que retorna valores (get_). Aquí está el código fuente original de la función the_ID()

Por supuesto, hay funciones que le puedes pasar un parámetro booleano ($echo) — sí lo declaras verdadero (TRUE), se imprimirá el resultado y en cambio, retornara sí lo declaras falso (FALSE). No te preocupes si estas confundido — veremos todos los parámetros de todas las etiquetas de plantilla.

Parámetros en las Funciones de Etiquetas de plantilla

Esta es la "parte difícil" de las Etiquetas de plantilla, no obstante es muy sencillo.

Los Parámetros son tipos de datos que pueden cambiar el comportamiento de las funciones de etiquetas de plantilla. Con parámetros, puede agregar prefijos y sufijos a la salida, limitar el número de datos devueltos, excluir elementos de una lista y así sucesivamente. Sin saber los parámetros aceptados para una etiqueta de plantilla determinada, está limitada al comportamiento predeterminado.

Declaración de parámetros

Hay tres formas de declarar parámetros a una etiqueta de plantilla:

Usando parámetros regulares: la mayoría de las etiquetas de plantilla aceptan parámetros regulares, la forma de pasar parámetros en PHP es separándolos con comas:

Usando consultas de cadenas de texto: algunas funciones aceptan estos tipos de parámetros a partir de una cadena de texto, de esta forma:

Pero las consultas de cadenas de texto son complicadas de leer, y además necesitaras aprender como pasar correctamente las consultas de cadenas de texto como parámetros; por lo tanto te recomiendo que uses un vector (array) en lugar de consultas de cadenas de texto.

Usando vectores (arrays): Mucho mejor, una forma más clara de declarar parámetros, es usando un vector (array) en vez de consultas de cadenas de texto.

Recuerda que puedes usar vectores (arrays) en lugar de consultas de cadenas de texto o viceversa, pero no puedes usar parámetros regulares en lugar de consultas de cadenas de texto o usar un vector (array) en lugar de parámetros regulares. Si una etiqueta de plantilla acepta parámetros reculares, tú debes usar solo parametros regulares. Sí acepta consulta de cadenas de texto o un vector (array), tú puedes usar cualquiera de ellos.

Asegúrate de revisar una página entera dedicada a los parámetros en las funciones de etiquetas de plantilla, sí estas confundido.

Conclusión

Ahora que hemos completado las aspectos básicos de cómo usar las Etiquetas de plantilla en nuestros temas de WordPress, podemos ir aprendiendo uno a uno detalladamente. En las siguientes partes de esta serie de artículos, estaremos aprendiendo bien cada Etiqueta de plantilla (documentada en el Codex) con pequeñas descripciones, explicaciones de cada uno de sus parámetros, y pequeños fragmentos de código que nos permita aprender a usar cada una de las Etiquetas. Va a ser un viaje largo pero interesante.

¿Tienes algo para compartir con nosotros acerca de las etiquetas de plantilla? Dinos lo que piensas comentando más abajo y si te gustó este artículo, no olvides compartir con tus amigos!

¡Sé el primero en conocer las nuevas traducciones–sigue @tutsplus_es en Twitter!

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.