Login / Status
developer.Resource
Home . Documentation . Document Library . Tutorials
Sponsors
hosted by punkt.deTYPO3 and Open Source Magazine

1.6. Elementos de contenido especiales

Ya conoce los elementos de contenido de páginas en general. Así que ya sabe cómo trabajan. En esta sección nos gustaría mostrarle simplemente unos cuantos ejemplos de elementos de contenido especiales que no obstante son bastante populares. Por ejemplo ¿cómo puede hacer una forma de correo electrónico? ¿O un campo de búsqueda para buscar dentro del contenido de su sitio? ¿Qué tal un libro de registro de invitados?

Pues bien, simplemente siga leyendo y verá el uso de todos estos elementos.

Formulario de correo electrónico

Ya tenemos un campo definido para el correo electrónico en nuestro sitio Web. Si navega hasta la página "Contact" lo verá:

El elemento de contenido que crea el formulario dentro del “backend” se ve así en el módulo “Page” (página):

A propósito, note que la página "Thank you" es ¡una subalterna de "Contact"!  

Ahora, edite el elemento. Esto es lo que ve:

¡El contenido es aparentemente más del "estilo código" que al usar el elemento de contenido "Table" (tabla)! Pero, como de costumbre,  haga clic en el botón del icono del Asistente y podrá editar el contenido con una herramienta que hace todo ¡mucho más fácil!:

Como puede ver, los códigos se han transformado en un bonito formulario. Cada campo dentro del formulario se creó con controles visuales. Para un campo se debe determinar un nombre (nº 1), claro está, y un tipo de campo (nº 2). Estas son las partes visibles. También se debe dar al campo un nombre interno (nº 3) que es el que se mostrará en el correo electrónico que el destinatario recibe. En el caso de los tipos "Input field" (campo de entrada), también puede especificar un valor predefinido (nº 4).

Para los campos de correo electrónico existen tres valores comunes a definir: El nombre del botón de envío (nº 5), la línea del asunto (nº 6) y, finalmente, la dirección de correo electrónico del destinatario (nº 7). Esta persona es normalmente ¡usted! O cualquier otra persona de su equipo que deba recibir este tipo de correos.

Agregando un campo de selección

Ahora intentemos agregar una lista de selección donde se pueda seleccionar un elemento. En "FC Bigfeet" tenemos los artículos “calendarios”, “revista del club” y “lápiz” que podemos enviar por correo.

Sencillamente seleccione el tipo "Selector box" (caja de lista):

A continuación haga clic en el botón "Refresh without saving" (actualizar sin guardar) que no almacena el contenido, ¡sólo actualiza el formulario!

Posteriormente rellene esta información:

El contenido del campo es obvio (nº 1). El campo llamado "item_to_send" (artículo a enviar, nº 2) no está visible en la página Web, pero, como ya se explicó antes, es el nombre que el destinatario verá para identificar esta selección. Finalmente, cada valor que desee dentro de la lista de selección es una línea dentro de este campo de texto (nº 3) – así de simple. Guarde el contenido del asistente y despliegue la página:

¡Así de fácil!

Notas Adicionales

Ahora, dentro del “backend”, la nueva lista se agregó dentro de las líneas de código del campo "Configuration" (configuración).

Si quieres saber cómo se realiza, hecho un vistazo a la línea y podrá darse cuenta de la sintaxis pudiendo crear los campos del formulario sin necesidad de utilizar el asistente:

Si pierde la paciencia, siempre puede buscar ayuda en el documento TSref donde existe una sección que describe los detalles. Pero, le advertimos, ¡puede no estar acostumbrado al nivel técnico detallado que se emplea!

Otro detalle importante a notar es el campo "Jump to page" (ir a la página) que informa a TYPO3 la página que debe desplegar cuando se envía el formulario.

En otras palabras, cuando el usuario rellena el formulario y hace clic sobre el botón "Send form!" (¡enviar formulario!”), se le mostrará esta página que contiene... un elemento de contenido de página ordinario con esta información:

Muy sencillo- ¿verdad? Muy flexible.

Encontrando errores

Si usa un servidor Windows siempre existe la posibilidad de que la función enviar correo no trabaje adecuadamente. Si envía el formulario y obtiene un mensaje de error de PHP, probablemente no cuente con el servidor SMTP o cualquier otro  requerido por PHP para enviar correos. En los sistemas UNIX normalmente esto funciona sin ninguna otra configuración.

Campo de búsqueda

El siguiente proyecto consiste en realizar un campo de búsqueda. Esto es aún mucho más sencillo y ya hemos creado uno para usted dentro de la página “Search” (búsqueda):

El evento es si mismo es extremadamente simple:

Básicamente consiste en un elemento de contenido cuyo tipo es “Search” (Búsqueda) -eso es todo. En este caso también existe un campo "Send to page" (Enviar a página) que no se utiliza. El campo realiza la misma función que "Jump to page" (Ir a la página) dentro de un formulario de correo electrónico. Esto es, informa al elemento la página que muestra la información de la petición de búsqueda (que contiene otro elemento de contenido “Search” para mostrar los resultados). Si no se le informa la página que debe mostrar al finalizar la búsqueda, se mostrará la página activa. Esto es el comportamiento “normal” de un campo de búsqueda.

Realizando una búsqueda

Si se realiza una búsqueda de la palabra “results” (resultados) se le mostrarán dos páginas:

Intente hacer clic en el título "Report results" (mostrar resultados):

Se desplegará la página de resultados con las palabras que busca resaltadas en rojo. Verdaderamente bonito, ¿verdad?

¿Búsqueda con índices?

El elemento de búsqueda predefinido que utilizó busca directamente dentro de la página y dentro de los registros de elementos de contenido de página. Esto es suficientemente eficiente para sitios Web pequeños

Puede obtener también una búsqueda más profesional basada en índices, si así lo desea. De hecho puede obtener cualquier función para la cual se haya escrito una extensión (hablaremos más tarde de ello). Por ahora puede intentar http://typo3.org como ejemplo de máquina de búsqueda con índices de ofrece TYPO3:

El conjunto de resultados desplegará algo similar a esto:

Note que el resultado se organiza en secciones y se ordena de acuerdo al porcentaje de importancia.

La extensión que realiza esto se llama "indexed_search" y puede encontrar su manual de uso y más información aquí.

Libro de visitas

Un libro de visitas es una adición fácil de realizar. Normalmente los elementos tales como libros de visitas, foros de mensajes, foros de noticias, etc. se realizan a través de extensiones - y las extensiones requieren instalarse primero. Algunas de ellas requieren importarse de un repositorio en línea, TER (TYPO3 Extension Repository) si aún no están disponibles en nuestro servidor.

Para instalar una extensión, tal como un libro de visitas, sencillamente se accede al Administrador de Extensiones, Extension Manager (EM), y se hace clic en el icono instalar extensión:

Dentro de la vista "Loaded extensions" (extensiones cargadas), podrá ver todas aquellas disponibles:

Insertando el libro de visitas en una página

Tal y como se realizó con el formulario de correo electrónico y el campo de búsqueda, un libro de visitas - y normalmente cualquier otra aplicación Web (llamada módulo o “plugin” dentro de la terminología de TYPO3) se inserta a través de un elemento de contenido de página que actúa como un marcador para la funcionalidad deseada:

El tipo "Insert plugin" es el selector principal, mientras que el secundario “Plugin” se usa para determinar el tipo de módulo. Esta opción muestra algunas de las extensiones instaladas:

Ya contamos con un libro de visitas general - creemos ahora uno para la sección "Team pages" (páginas del equipo) que requiere que el usuario se identifique con su nombre y contraseña:

Vaya al módulo Page (Páginas), haga clic sobre el título de la página "Team pages" dentro del árbol de páginas y seleccione el Asistente de nueva página "New page" (vea las secciones anteriores para más información):

Escriba el título de la página:

Guarde y cierre la página. Ahora cree el contenido:

Seleccione el módulo "Guestbook" (libro de visitas):

Y ahora adivine qué tan fácil es insertar noticias y foros de mensajería... :-)

Guarde el formulario obtenido:

Note el contenido del campo "CODE" (código). Verá que contiene algunos de los códigos de texto que hacen que el libro de visitas aparezca. ¡Una buena razón para utilizar el asistente de nuevo contenido ("New content") para insertar elementos! El asistente tiene los valores predefinidos.

Claro está que puede escribir el título y otros elementos de contenido de la página - pero el objetivo principal de este ejercicio es insertar el elemento libro de visitas:

Y - ¡voila! - ¡aparece el libro de visitas! (vera datos de prueba en esta imagen...)

¿Dónde se almacena el contenido del libro de visitas?

Si quiere administrar su libro de visitas - por ejemplo para eliminar registros falsos, tal como el del ejemplo anterior - sencillamente diríjase al módulo Page (página) para la página correspondiente y verá todos los elementos de libro de visitas además de los elementos de contenido de página normales:

¿Se está preguntando cómo editar los datos? Sólo haga clic en el icono del libro de visitas (recuerde, ¡tome en cuenta los conceptos de consistencia!):

Lo mismo se aplica a un foro de mensajes. Pero no todos los módulos listan sus elementos dentro del módulo Page (página), por lo que generalmente debemos de utilizar el de List (lista) para administrar los elementos si deseamos un método consistente:

Esto nos lleva al punto principal - los registros de un libro de visitas también forman elementos de la base de datos de TYPO3 al igual que las páginas, los elementos de contenido de páginas, usuarios, etc.. Podemos editarlos, ocultarlos, borrarlos y copiarlos o pegarlos utilizando el conjunto de herramientas del sistema ya conocidos -el concepto de consistencia ¡muy pronto se enamorará de él!

Mapa del sitio

No invertiremos mucho tiempo explicando la forma de insertar un mapa de sitio - ya conoce el principio. Un elemento de contenido de un cierto tipo con ciertos parámetros adicionles:

Note el campo "Starting point" (punto de inició) - que determina el lugar a partir del cual comienza el mapa. De forma similar, los otros parámetros del "Menu type" (tipo de menú) utilizan este valor. En lugar de insertar un mapa de sitio, también se pueden usar otros tipos de listas de vínculos basados el la estructura de la página y los elementos de contenido de las páginas:

Le invitamos a que juegue con todas las alternativas. Recuerde - cuando requiera ayuda la encontrará siempre al alcance:

Módulo de Noticias

El módulo de noticias usado en el sitio Web es el de la extensión "mininews". Asegúrese de que está instalado (Extension Manager, Administrador de Extensiones):

Puesto que ya se encuentra instalado, podemos proceder ahora a investigar cómo se utiliza el módulo. A diferencia importante del libro de visitas, el módulo mininews se inserta tanto en la página principal como en la de noticias. La primera página muestra solamente las tres primeras líneas de la noticias:

Ya al hacer clic sobre el vínculo "[more...]" (más...), se muestra al usuario la página de noticias con todo el contenido:

Los elementos de contenido en el “backend”

En la parte inferior de la página principal encontrará este elemento de contenido si procede al módulo Page (Página):

El contenido es:

Primero que nada, note que el "Listing mode" (modo listado) - una lista de selección específicamente prevista para el elemento del módulo – tiene seleccionado "Frontpage teaser" (invitación en la primera página) de forma tal que sólo se inserta la invitación y no el archivo. Como segundo punto, el campo "Starting point" (punto de inicio) se utiliza para indicar la página donde el archivo - que contiene toda la información - se encuentra.

Dentro de la página “News” (noticias) se inserta un elemento similar, solamente el campo "Listing mode" es distinto:

Y, ¿dónde se almacenan los elementos de noticias?

Recuerde el libro de visitas. Los nuevos elementos forman parte, como cualquier otro, de los registros de las bases de datos que TYPO3 utiliza. La mejor forma de obtener un panorama general de los elementos que se encuentran en una página es utilizando el módulo Lista (listar). Intentémoslo:

¿Y cómo se editan?

¿Y cómo se crea uno nuevo?

Creemos que las imágenes hablan por si mismas...

Flujograma de noticias

¿Qué pasa si deseo que otra persona escriba los artículos de noticias? Y ¿qué pasa si deseo revisar estos artículos antes de que se publiquen? ¿Puede hacer esto TYPO3? Esto es una situación en la cual se requiere un flujo de trabajo. Explicaremos esto un poco más adelante dentro de este tutor utilizando una situación sencilla tal como ésta. Un poco de paciencia.