Spanish (Español) translation by Eva Collados Pascual (you can also view the original English article)
Una de las mayores fortalezas de WordPress es la extensibilidad de su núcleo. Con los plugins y los temas, los usuarios de WordPress han sido capaces de moldear sus webs durante casi una década. (WordPress fué lanzado en 2003, pero los plugins no fueron introducidos hasta 2004 y los temas hasta 2005.) Y para crear una estructura tan sólida, WordPress incluye multitud de subsistemas (funciones, clases o APIs completas). Uno de estos lo constituyen las "Etiquetas Condicionales", las cuales permiten que nuestro código funcione de manera diferente en situaciones concretas.
En estas series, vamos a aprender sobre estas "Etiquetas Condicionales". Empezaremos este artículo con la definición y la importancia de las Etiquetas Condicionales. Y en la próxima parte, seguiremos con las Etiquetas Condicionales a través de una descripción y algunos ejemplos.
¡Comencemos!
¿Qué son las Etiquetas Condicionales?
En el Codex, las Etiquetas Condicionales se describen como sigue:
Las Etiquetas Condicionales se pueden usar en los archivos de tu Plantilla para cambiar el contenido que se muestra y como es mostrado en una página en particular dependiendo de qué condiciones se cumplan en dicha página.
Coges la idea: Con el fin de que tu código use/o altere el contenido, empleas Etiquetas Condicionales y le indicas a tu código el tipo, estado y lugar para el contenido. Imagina que tu código y WordPress están manteniendo una conversación:
- Tu Código: Hey, necesito algo de ayuda.
- WordPress: Claro, Soy todo oidos. ¿Qué necesitas?
- Tu Código: Voy a incluir estos títulos de artículos dentro de algunos DIVs, pero necesito saber si aquellos están en la página de archivos de categoría. ¿Están en una página de archivos de categoría?
- WordPress:
TRUE - Tu Código: Um... ¿Qué?
- WordPress: Quiero decir que sí.
- Tu Código: ¡Genial, gracias!
- WordPress: ¡Adios!
Abreviando, La Etiquetas Condicionales son declaraciones boleanas que dirigen tu código a donde corresponda, cuando se emplean en una declaración del tipo if/else. Sólo devuelven TRUE o FALSE, y tu código sólo necesita estos dos valores boleanos.
Como Usar Etiquetas Condicionales
Al tiempo que las Etiquetas Condicionales son una parte muy importante de WordPress, su uso es increíblemente fácil. Como sólo devuelven TRUE o FALSE, las puedes usar dentro de una declaración if sin ningún problema. (En realidad, sólo existen tres excepciones en las Etiquetas Condicionales en las que devuelven o bien TRUE o un valor, y llegaremos a ellas en las próximas partes, no obstante, también puedes seguir usándolas en declaraciones if.)
Veamos un ejemplo rápido de como funciona una Etiqueta Condicional:
1 |
<?php
|
2 |
|
3 |
if ( is_home() ) { |
4 |
|
5 |
_e( 'Welcome to my humble blog!', 'translation-domain' ); |
6 |
|
7 |
}
|
8 |
|
9 |
?>
|
¿Lo pillas? Hemos usado la Etiqueta Condicional para la declaración if y le hemos indicado a WordPress que si estamos en la página de inicio, este pedazo de código reproduzca un mensaje de bienvenida—un poco aburrido. No es para nada complicado.
Veamos otro ejemplo, con un código más "limpio":
1 |
<?php
|
2 |
|
3 |
// $author_check is TRUE or FALSE
|
4 |
$author_check = is_author( 'baris-unver' ); |
5 |
|
6 |
if ( $author_check ) { |
7 |
|
8 |
_e( 'Barış has some really good tutorials, along with a few cheesy ones!', 'translation-domain' ); |
9 |
|
10 |
}
|
11 |
|
12 |
?>
|
¿Has visto lo que hemos hecho? Hemos creado una variable y definido una Etiqueta Condicional en la misma; de manera que seamos capaces de usar la variable para la declaración if. ¡Una porción de tarta!
Ejemplo de Contextos para el Uso de Etiquetas Condicionales
Créeme cuando digo que existen infinitas situaciones en las que usar las Etiquetas Condicionales. Me vienen a la cabeza cinco escenarios en los que puedes hacer uso de las Etiquetas Condicionales:
- Imagina que estás desarrollando un plugin de compartir en medios sociales para WordPress y quieres dar a tus usuarios la opción de mostrar u ocultar el widget bajo las entradas y artículos. Mediante una combinación de
is_single(),is_page()yis_singular(), puedes crear una función que compruebe los ajustes del usuario en el plugin, por ejemplo, esconder el widget en las páginas pero los muestra bajo cada entrada. - Ponte en la situación de que estás desarrollando un tema para una pequeña empresa. Estás trabajando en la página de "Noticias" (la parte del "blog" del tema) y has diseñado un sencillo listado de las entradas con thumbnails... pero sabes que ellos olvidarán o elegirán no hacer uso del thumbnail en algunos artículos. Aquí es donde nos es útil
has_post_thumbnail(): Úsalo y tu tema comprobará si la entrada no tiene thumbnail de manera que muestre una imagen por defecto. - Supón que estás creando un add-on plugin para un popular plugin de WordPress. Necesitas detectar que el plugin principal está instalado y siendo usado ya que de lo contrario tu plugin podría causar problemas si un usuario novato lo instala sin hacer uso del plugin principal. La solución es simple: Usando
is_plugin_active(), puedes deshabilitar la funcionalidad de tu plugin, y utilizandois_plugin_inactive(), puedes mostrar un mensaje de advertencia en el área de administración. - Has creado un tema para otro cliente y quieren subir imágenes, documentos PDF y archivos ZIP a sus entradas—pero también quieren mostrar todas las imágenes bajo cada entrada. Simplemente usando la Etiqueta Condicional
wp_attachment_is_image()te permitirá recoger las imágenes y mostrarlas bajo las entradas. - Digamos que estás haciendo un plugin para blogs en los que colaboran múltiples autores y quieres detectar si la web de un usuario tiene más de un autor. La Etiqueta Condicional
is_multi_author()te proporciona la respuesta.
Conclusión
Como puedes ver, las Etiquetas Condicionales son una de las características de WordPress más fáciles de usar, pero además uno de los aspectos más importantes en el desarrollo de temas y plugins.
El propósito de estas series es introducirte en las Etiquetas Condicionales y este es sólo el comienzo. En los próximos cinco artículos, vamos a ver 65 Etiquetas Condicionales diferentes con descripciones, casos de uso, y algunos ejemplos delos mismos.
¡Nos vemos en la siguiente parte!
¡Sé el primero en conocer las nuevas traducciones–sigue @tutsplus_es en Twitter!
By
