Cuando instalas Drupal Trademark 8, se instalan automáticamente 2 tipos de contenido que han sido definidos por el equipo que sostiene el núcleo Drupal: la página básica y el artículo. Si creas un contenido utilizando el tipo de contenido de página básica, verás que da dos campos básicos: un título y un cuerpo.
Un autor que usa el género de contenido de página básica simplemente introduce un título (un campo obligatorio como señala el asterisco colorado) y el texto de su contenido en el campo cuerpo. El campo cuerpo es flexible y puede contener todo cuanto el autor sienta que desea escribir. El autor podría:
• Redactar un libro completo en el campo cuerpo, incluyendo marcado HTML (encabezados, tablas, CSS, etc).
• Introducir imágenes.
• Escribir una sola frase.
El tipo de contenido artículo es similar a la página básica, excepto en que ofrece la posibilidad de cargar una imagen como elemento independiente, como una imagen de banner para el artículo (no engastada en el texto del cuerpo) y definir un conjunto de etiquetas que se pueden utilizar para categorizar el contenido (ver capítulo 4 para obtener detalles sobre cómo clasificar el contenido).
Al igual que una página básica, un artículo puede ser utilizado para crear contenido sobre cualquier tema y el área del cuerpo deja ingresar texto de forma libre.
Mientras que las clases de contenido “Página básica” y “Artículo” son perfectos para contenido general, seguramente habrá casos en los que desees administrar alguna forma de estructura cerca de la información que se atrapa. Es posible que desees:
Requerir que se ingrese cierta información antes que el creador envíe el elemento de contenido para su publicación; por poner un ejemplo, la fecha y la hora de inicio de un evento, la dirección del sitio donde se celebra el acontecimiento y un link al acontecimiento en un mapa de Google.
Tener la capacidad de realizar cálculos basados en la información que se captura en un factor de contenido.
Tener la capacidad de ordenar los elementos de contenido por “campos” específicos.
Tener la capacidad de “filtrar” o bien restringir qué elementos de contenido se muestran en una página basándose en un valor de un campo.
Hacer cumplir la estructura de cómo un elemento de contenido se representa en una página; por ejemplo, es posible que desees enseñar información sobre un libro y desees que el creador escriba el título seguido del ISBN, seguido del costo, seguido de la descripción del libro.
Si bien podrías publicar toda esta información en una página básica o un artículo, proporcionando las características para ordenar, filtrar, hacer los valores necesarios, calcular y vertebrar cómo se representa un elemento de contenido en una página, sería extremadamente difícil. A Dios gracias, la capacidad de Drupal Trademark para acotar tipos de contenido adaptado hace que todo lo anterior sea posible, y proporciona muchas más características que encontrarás invaluables con el tiempo.
Back to top1) 2. Definiendo un tipo de contenido personalizado
Un género de contenido adaptado es definido por el administrador del lugar, por encima de las clases de contenido página básica y artículo. La capacidad de crear géneros de contenido adaptado se incluye en el núcleo Drupal Trademark 8.
Para probar la potencia y flexibilidad de las clases de contenido personalizado, creemos un nuevo género de contenido personalizado para capturar información acerca de los próximos acontecimientos. Un evento puede ser un concierto, una obra de teatro, una clase, un jego o bien cualquier otra actividad programada con antelación.
• Al crear información sobre un acontecimiento, es posible que desees incluir los siguientes detalles:
• El nombre o título del evento
• La data y la hora en que comienza el evento
• La data y la hora en que acaba el evento
• El lugar o la dirección donde se llevará a cabo el evento
• Una descripción del evento
• El precio por asistir al evento
Como vamos a ver en unos instantes, Drupal proporciona una interfaz de administración fácil de utilizar para crear y modificar géneros de contenido personalizados. Tan pronto como se define un género de contenido personalizado, está de manera inmediata libre para los usuarios que tienen los privilegios convenientes para crear, editar, publicar y eliminar ese tipo de contenido específico (Drupal da la capacidad de restringir el acceso a tipos de contenido adaptado según el rol de cada usuario).
Back to top2) 3. Creando un tipo de contenido personalizado
La creación de un género de contenido personalizado toma 2 pasos: enumerar el género de información que quieres compendiar y crear el género de contenido personalizado mediante las pantallas de administración del tipo de contenido adaptado de Drupal.
Para este caso, creemos un género de contenido adaptado para un acontecimiento que incluya las clases de información enumerados previamente.
Para iniciar, haz clic en el link “Administrar” en la parte superior de la página y en el link “Estructura” del submenú. En la página “Estructura” (que se muestra en la figura cinco-1) haz clic en “Tipos de contenido”.
La pantalla “Tipos de contenido” (mostrada en la figura 5-2) enumera todos los géneros de contenido existentes, que en nuestro caso son los tipos de contenido de artículo y página básica que se incluyen en el núcleo Drupal ocho. La pantalla “Tipos de contenido también proporciona un link para crear nuevos tipos de contenido. Haz click en el botón “Añadir género de contenido” para empezar el proceso de creación de nuestro tipo de contenido “Evento”.
La primera pantalla que aparece al hacer click en el botón “Añadir tipo de contenido” es un formulario que define las características generales del nuevo tipo de contenido (ver figura 5-tres). Hay un campo para el nombre del género de contenido, un campo para una descripción que describe el género de contenido (la descripción se muestra al autor cuando crea nuevo contenido), un campo para la etiqueta del campo de título y varios otras alternativas de configuración que veremos detalladamente.
Para empezar el proceso, haz lo siguiente:
• Escribe el nombre del tipo de contenido, que en nuestro caso es “Evento”. El texto debajo del campo “Nombre” da un conjunto de indicaciones que debes proseguir al crear un nombre para un nuevo género de contenido.
• Proporciona una descripción de cómo se debe emplear esta clase de contenido, como “Un tipo de contenido usado para capturar los detalles sobre los próximos eventos”.
• Cambia la “etiqueta de campo de título” de “Título” a “Título de evento”, haciéndola más gráfica e intuitiva al autor que usará esta plantilla para crear información del acontecimiento.
• Deja la opción “Previsualizar antes de enviar” como opcional.
• Da una breve explicación de las pautas de envío para este género de contenido. Este es un valor opcional y es posible que no se aplique a tu tipo de contenido. Para nuestro tipo de contenido “Evento”, utilizaremos “Por favor, rellene todos los campos requeridos antes de mandar el evento” como pautas de envío. Puedes elegir utilizar o bien ignorar este campo al crear nuevos tipos de contenido.
Hay otros ajustes opcionales que debes estimar cuidadosamente al crear un nuevo género de contenido. Primero son las opciones de publicación. En el menú vertical izquierdo, haz click en la pestaña “Opciones de publicación” (ver figura 5-cuatro).
Dependiendo de si deseas que el contenido se publique automáticamente (se puede ver en su lugar inmediatamente después de guardarlo) y si quieres que el contenido aparezca automáticamente en la página principal de tu sitio web, puedes ajustar estas opciones.
Para nuestro género de contenido “Evento”, deseamos que un evento se publique automáticaente cuando se guarda, pero no deseamos que aparezcan automáticamente en la página principal. Así que vamos a desmarcar la casilla de verificación “Promocionar a la portada”. También podemos establecer si un acontecimiento se mantendrá arriba de las listas (lo que significa que en una lista de diversos tipos de contenido en una página, el contenido acontecimiento siempre y en todo momento estaría arriba) y si deseamos crear automáticamente una nueva versión de un factor de contenido creado como acontecimiento cuando el creador efectúa una actualización (generalmente una buena idea, mas depende de si deseas ver los cambios realizados en un elemento individual de contenido a lo largo del tiempo y la capacidad de regresar a publicar una versión precedente en el caso en que la versión actual sea incorrecta). Para nuestro tipo de contenido Evento vamos a marcar la casilla de verificación “Crear nueva revisión”.
El siguiente conjunto de opciones es para la configuración de pantalla. Haz click en la pestaña “Configuración de visualización” en la columna de la izquierda para mostrar la opción disponible con este parámetro de configuración (ver figura 5-5).
Puedes establecer si Drupal debe mostrar el nombre del autor que creó el factor de contenido de acontecimiento y la data en que se creó el elemento. Digamos que en nuestro caso no pensamos que tener el creador y la data publicada es relevante, así que desmarcaremos esa casilla. En dependencia del tipo de contenido que se está creando, puedes decidir que es importante enseñar el nombre del autor y la fecha en que se publicó el contenido. Si es así, deja la casilla marcada.
El conjunto final de parámetros define las opciones de menú que se presentan al autor. Haz click en la pestaña “Configuración de menú” para poder ver los parámetros del menú (ver figura 5-seis). La sección “Menús disponibles” muestra los menús en los que este elemento de contenido puede aparecer opcionalmente. Durante la creación de contenido utilizando este tipo de contenido, el autor tendrá la posibilidad de especificar si el elemento de contenido que se está creando aparecerá como un elemento en el menú escogido. En el ejemplo que se muestra en la figura 5-seis, el único menú que aparecerá disponible para el creador del contenido es el menú “Navegación principal”. Puedes desmarcar “Navegación principal” para ocultar todos los menús de la lista que se puede elegir, o puedes comprobar más de un menú para permitir al autor escoger entre múltiples menús. La opción “Elemento principal predeterminado” te permite establecer qué menú se selecciona automáticamente cuando se muestra la página “Configuración de menú” cuando un autor crea un nuevo elemento de contenido de tu nuevo tipo de contenido.
Para nuestro ejemplo, deja los valores predeterminados y haz click en el botón “Guardar y administrar campos”. Drupal Trademark ahora muestra la página “Administrar campos” (ver figura cinco-7).
Back to top3) 4. Personalización del género de contenido
En este punto, podríamos crear un nuevo elemento de contenido utilizando nuestro tipo de contenido acontecimiento. Sin embargo, el tipo de contenido acontecimiento sólo tiene dos campos, un título de acontecimiento y un cuerpo. Nuestros requisitos requieren una descripción del evento, data de comienzo, fecha de finalización, lugar/dirección, género de asiento, asistencia libre en el lugar, género de acontecimiento y la capacidad de proporcionar un fichero que puede ser descargado por el visitante del sitio (ej. un programa). Como se puede ver en la figura 5-ocho Drupal crea automáticamente un campo Cuerpo, que usaremos para la descripción del acontecimiento.
Comenzaremos con el cambio del campo Cuerpo modificando la etiqueta que aparece en la pantalla de “Cuerpo” a “Descripción del evento”, un mejor indicador del género de texto a introducir para la persona que crea el evento. Haz clic en el botón “Editar” para el campo Cuerpo. En el campo “Etiqueta” cambia “Cuerpo” por “Descripción del evento” (ver figura cinco-8) y luego haz click en “Guardar configuración” en la parte inferior del formulario.
Después de guardar la actualización en la etiqueta de cuerpo, Drupal Trademark regresa a la página “Administrar campos” con la Etiqueta actualizada, como se muestra en la figura cinco-9.
El siguiente paso es agregar el campo “Fecha de inicio”. Haz click en el botón “Agregar campo”. El próximo paso es escoger qué tipo de campo añadir o bien, de forma alternativa, qué campo existente añadir a este tipo de contenido. Un campo anteriormente creado puede residir en otro tipo de contenido y en lugar de recrearlo, podemos volver a usar la definición escogiendo ese campo de la lista de campos existentes (ver figura 5-10).
Después de hacer click en Data, verás un nuevo campo en la pantalla donde se introducirá la etiqueta para el nuevo campo.
Esta etiqueta se muestra en el formulario de edición de contenido para que el creador conozca el campo para el que está ingresando un valor y se muestra al usuario final cuando el factor de contenido se representa en el sitio. Puesto que creamos la data de inicio del acontecimiento, ingresa “Fecha de inicio” en el campo Etiqueta y haz click en “Guardar y continuar”.
El siguiente paso en el proceso de creación del campo es establecer el formato de nuestro campo de data, data y hora o bien sencillamente la fecha y el número de valores permitidos (ver figura 5-once). Puesto que los eventos por norma general tienen un tiempo asociado con ellos, vamos a dejar el valor establecido en “Fecha y hora” para la lista de selección “Tipo de fecha”. También dejaremos la opción “Número permitido de valores” establecida en “Limitado” y “1” porque nuestros acontecimientos sólo ocurren una vez.
Verás la opción de configuración “Número permitido de valores” en todos y cada campo que crees. Es posible que tengas situaciones en las que desees que el creador tenga la capacidad de crear varios valores para este campo. Por servirnos de un ejemplo, es posible que el mismo acontecimiento se acumule múltiples veces en el futuro. Al configurar el “Número tolerado de valores” por encima de 1, el formulario de edición de contenido mostrará exactamente el mismo número de campos de entrada que el que seleccionaste en la lista de selección “Número permitido de valores”. Si cambias de “Limitado” a “Ilimitado”, el autor puede crear tantos valores como sea preciso, con un botón “Añadir otro” que aparece bajo el campo para permitir al autor crear una nueva entrada. Piensa en cómo se usará el campo y luego establece la opción “Número tolerado de valores”. Puede haber casos en los que 1 no sea la mejor solución. No obstante, para este caso, vamos a dejar el valor en 1. Haz click en “Guardar configuración del campo” para continuar al siguiente paso.
El siguiente formulario que muestra Drupal (mostrado en la figura cinco-doce) te deja establecer parámetros auxiliares detallados para el campo “Fecha de inicio” del acontecimiento. En este formulario tienes la capacidad de:
Cambiar la etiqueta que definimos anteriormente para este campo. Salvo que hayas cometido un error o bien hayas alterado de opinión, puedes dejar el valor como se muestra.
Introduce el contenido en el campo “Texto de ayuda” que se mostrará debajo del campo de texto en la pantalla. Este es un enorme sitio para describir los requisitos de los datos que se ingresarán en este campo, como pedir que los autores escriban fechas como dd/mm/aaaa. Este campo es opcional.
Define si este campo es obligatorio. Un campo obligatorio se muestra con un asterisco colorado, y Drupal Trademark obliga al usuario a introducir un valor en este campo antes de que el elemento de contenido pueda guardarse. Debido a que nuestro género de contenido es sobre un acontecimiento y las datas son atributos esenciales de un acontecimiento, este campo debe ser obligatorio, así que marca la casilla de verificación.
Define si se asigna un valor predeterminado al campo antes de que la pantalla de creación de contenido se muestre al autor. Debido a que nuestro campo trata con datas futuras, suministrar un valor predeterminado carece de sentido. Puede haber casos en otros campos donde un valor predeterminado tenga sentido, como elegir una preferencia de asiento para el evento: puede que desees establecer un valor predeterminado como “mejor disponible”. En esos casos, este es el sitio donde introducirías el valor predeterminado.
Haz clic en “Guardar configuración” para completar los ajustes del campo Fecha de comienzo. Drupal Trademark volverá a mostrar la página general “Gestionar campos” con el nuevo campo “Fecha de inicio” añadido al tipo de contenido “Evento” (ver figura cinco-trece).
Ahora estamos listos para añadir los otros campos que definimos anteriormente: Fecha de finalización, Descripción del acontecimiento y lugar del acontecimiento. Sigue los mismos pasos descritos anteriormente para crear el campo Fecha de finalización. Al crear el campo “Lugar del evento”, selecciona “Text (formatted, long)” para el tipo de campo, en vez de “Date”, puesto que los valores introducidos para el lugar serán un párrafo o bien dos de texto. Cuando hayas terminado, tu lista de campos ha de ser similar al de la figura 5-14.
Nuestro género de contenido de evento ya está dispuesto para que los autores lo usen. Para probar nuestro nuevo género de contenido, haz clic en el enlace “Volver al sitio” en la esquina superior izquierda de la pantalla y luego haz clic en uno de los vínculos “Añadir contenido”, revelando la lista de géneros de contenido que tenemos libres en nuestro sitio.
Nuestro género de contenido de acontecimiento aparece en la lista de tipos de contenido libres. Haz click en Acontecimiento para enseñar la página de creación de contenido para nuestro género de contenido evento (ver figura 5-15). La página muestra los campos Título del evento, Descripción del acontecimiento, Data de inicio, Data final y Lugar del evento.
Crea un acontecimiento de ejemplo usando el formulario de creación de eventos. Cuando hayas terminado de ingresar valores, haz clic en “Guardar y publicar”. Drupal procesará tu nuevo elemento de contenido del evento usando los valores detallados. El ejemplo Evento ingresado en el formulario de la figura cinco-quince aparece como un nuevo acontecimiento en la figura cinco-16.
Back to top4) 5. Otros géneros de campo
En nuestro género de contenido Acontecimiento, hemos creado un conjunto de campos para que los autores ingresen valores de fecha y sitio. Puede haber casos en los que un campo de texto es menos eficiente que utilizar uno de los siguientes tipos de campo:
• Botones de radio: genial para proporcionar una lista de opciones al autor y solo permitir la selección de un solo elemento de la lista.
• Casillas de verificación: perfecto para proporcionar una lista de opciones al autor, en la que se deja seleccionar uno o bien más elementos de la lista.
• Seleccionar lista: excelente para lista larga de elementos para seleccionar; por servirnos de un ejemplo, todos y cada uno de los países del planeta.
• Carga de archivos: el campo a usar cuando se desea proporcional la posibilidad de cargar y adjuntar un archivo a un contenido.
• Carga de imagen: el género de campo que se utilizará cuando desees cargar y mostrar una imagen.
• Área de texto: el campo a emplear cuando se espera que el creador introduzca párrafos de contenido. Da una caja con múltiples líneas, mientras que un campo de texto sólo tiene una sola línea de texto.
• Campo numérico: perfecto cuando quieres que el autor ingrese sólo números.
• Campos de referencia de entidad: es el campo que se emplea cuando se quiere asociar y mostrar otro elemento de contenido con el factor que se está creando. Un caso podría ser que tu sitio tuviera un tipo de contenido llamado Biografía que contiene un headshot y también información biográfica sobre artistas intérpretes o ejecutantes. Si quieres incluir el retrato y la biografía de un artista en un elemento de contenido de acontecimiento, puedes emplear el campo de referencia de entidad para vincular el evento a la biografía del artista, mostrando el retrato y la biografía del elemento de contenido existente en lugar de tener que volver a ingresar manualmente información biográfica del acontecimiento.
• Campo de referencia de término: cuando deseas incluir términos taxonómicos como parte de tu elemento de contenido, este es el campo a usar.
Los tipos de campos enumerados aquí son parte de Drupal Trademark ocho. Hay otros tipos de campos adaptados que están disponibles como módulos aportados. Para obtener una lista de esos módulos, visita /project/modules, selecciona el elemento Campos en el filtro “Categorías de módulo” y haz clic en buscar. Encontrarás una lista de módulos complementarios que dan capacidades de valor agregado, como otros tipos de campos. Puedes instalar módulos auxiliares siguiendo el proceso descrito en el capítulo doce.
Es probable que te encuentres con la necesidad de emplear uno de los otros tipos de campo al crear nuevos tipos de contenido. Amliamos nuestro tipo de contenido Evento añadiendo varios campos adicionales utilizando otros tipos de campo.
4.1) 5.1. Botones de radio
Los botones de radio son útiles cuando se quiere presentar al autor una lista de valores desde la que pueden seleccionar solo un elemento (las casillas de verificación se usan cuando se desea que el autor tenga la posibilidad de seleccionar uno o más valores).
Ampliaremos nuestro tipo de contenido Acontecimiento para incluir la posibilidad de seleccionar el género de asiento de entre los disponibles: asientos reservados o bien admisión general. Para iniciar el proceso, haz clic en el link Regentar en la parte superior de la página, haz click en Estructura en el submenú, seguido por el link “Tipos de contenido” en la página Estructura y la pestaña “Administrar campos” para el género de contenido Acontecimiento. Haz click en el botón “Agregar campo” para comenzar el proceso. La figura 5-17 muestra la lista de géneros de campos. Puesto que estamos creando una lista basada en botones de radio, elige la opción “List (text)”. Aparecerá un campo para la Etiqueta después de elegir la opción Lista. Introduce “Tipo de asiento” en el campo Etiqueta y a continuación, haz click en el botón “Guardar y continuar”.
El siguiente paso en el proceso es suministrar los valores que aparecerán en la lista (ver figura 5-dieciocho). En esta pantalla tenemos que detallar la “Lista de valores permitidos”, que es la lista de opciones que se presentarán al autor. Drupal requiere que las opciones estén catalogadas como dos “etiqueta clave” donde key es un valor que representa la opción que se seleccionó (el valor clave se almacenará en la base de datos), seguido del carácter de canal “pipe” (presiona la tecla Mayus y / para introducir un carácter de canal) y la etiqueta es el valor que se mostrará en la pantalla. En el ejemplo de la figura 5-18 usa Reservado y Admisión general, lo cual resulta en los valores “reservado” o “general” que se almacenan en la base de datos. Al establecer el campo “Número permitido de valores” en “Limitado” y “1”, Drupal Trademark mostrará esta lista como botones de opción, en tanto que el usuario está limitado a elegir un solo valor. Si el número es mayor que 1, Drupal mostrará esta lista como casillas de verificación. Después de introducir los valores, haz click en el botón “Guardar configuración de campo” para proseguir el proceso.
Figura cinco-18.
El siguiente paso en el proceso de configuración para este campo se muestra en la figura 5-diecinueve. En este formulario podemos:
• Mudar la etiqueta;
• Crear texto de ayuda;
• Marcar el campo según sea necesario;
• Establecer la opción predeterminada que se mostrará en la página.
Figura cinco-diecinueve.
Introduce el texto de ayuda que ayudará al visitante a entender de qué se trata este campo y establece la opción Admisión general como valor predeterminado que se seleccionará automáticamente cuando se muestre la página Crear acontecimiento. Después de configurar los valores, haz click en el botón “Guardar configuración”.
El último paso del proceso es acotar cómo queremos que Drupal Trademark muestre la lista de valores, ya sea como una lista de selección o como casillas de verificación / botones de opción. Si estableces el “Número de valores permitidos” a 1, una lista de selección se mostrará como una lista desplegable, permitiendo al usuario seleccionar un solo elemento. Si el “Número de valores permitidos” se establece a más de uno, se mostrará la lista completa de valores en lugar de una lista de selección desplegable. Una lista se mostrará como botones de opción si estableces “Número tolerado de valores” en 1 y como casillas de verificación si el “Número permitido de valores” es mayor que uno. Para establecer qué tipo de widget se usará para mostrar la lista Tipo de asiento, haz clic en la pestaña “Administrar la visualización de formularios” en la parte superior de la página “Administrar campos” (ver figura cinco-20). Localiza el campo Tipo de asiento en la lista de campos para esta clase de contenido y cambia la columna de widget de “Seleccionar lista” a “Casillas de verificación / botones de opción”. Haz click en el botón Guardar para registrar tus cambios.
Figura cinco-20.
Después de hacer click en el botón Guardar, el nuevo campo está listo para su empleo, como se muestra en la figura cinco-veintiuno. Observa que Drupal Trademark agregó una tercera opción a nuestra lista, la opción N/A. Como no hemos marcado la casilla “Campo obligatorio” para este campo (ver figura 5-19) Drupal introduce automáticamente la opción N/A porque un visitante puede no desear seleccionar una opción. Si deseas suprimir la opción N/A activa la casilla de verificación “Campo obligatorio” y Drupal Trademark eliminará esa opción de la lista.
Figura cinco-21.
4.2) 5.2. Casillas de verificación
Las casillas de verificación son afines a los botones de radio, pero dejan al usuario elegir más de un valor de la lista.
Ahora expandiremos nuestro género de contenido Evento agregando una lista de casillas de verificación que aborda las adaptaciones singulares libres en este acontecimiento para los asistentes con discapacidades.
Crearemos cajas de verificación que especifiquen si hay dispositivos de ayuda auditiva, de asistencia visual y asientos para sillas de ruedas libres para este acontecimiento. Para definir la lista de casillas de verificación, vuelve a la página “Administrar campos” del género de contenido Acontecimiento y haz click en el botón “Agregar campo”. Escoge “Lista (texto)” en la lista de selección “agregar un nuevo campo” (ver figura cinco-diecisiete) e ingresa un título de “Asistencia” en el campo Etiqueta (ver figura 5-veintidos).
Figura 5-veintidos.
Después de hacer click en “Guardar y continuar”, introduce los valores de las 3 opciones, como se muestra en la figura cinco-23, y cambia el “Número permitido de valores” de Limitado a Ilimitado, dejando al visitante seleccionar uno o bien más valores de la lista. Haz clic en el botón “Guardar configuración de campo” para continuar el proceso.
Figura cinco-23.
El siguiente paso en el proceso es introducir el texto de ayuda para guiar al autor en qué hacer con el campo Asistencia, establecer el campo como obligatorio si es necesario, establecer el valor predeterminado si se quiere un valor predeterminado (ver figura cinco-24) y luego clica en “Guardar configuración”. Para nuestro ejemplo, no vamos a hacer que el campo Asistencia sea necesario, ni estableceremos un valor predeterminado, puesto que la mayoría de los visitantes de nuestros eventos probablemente no necesitarán asistencia.
Figura cinco-24.
Después de llenar la configuración de campo para el campo Asistencia, deberás señalar a Drupal que este campo se muestre como “Casillas de verificación / botones de opción”. Haz clic en la pestaña “Administrar presentación de formulario” en la parte superior del formulario de edición de contenido y cambia el valor del género de widget, de “Seleccionar lista” a “Casillas de verificación / botones de opción” y haz click en “Guardar”. Para poder ver el resultado de añadir este campo, haz clic en uno de los vínculos “Añadir contenido” y añade un nuevo acontecimiento. El nuevo campo de casilla de verificación aparecerá como se muestra en la figura 5-veinticinco.
Figura 5-25.
4.3) 5.3. Listas de selección
Las listas de selección se llaman frecuentemente listas desplegables. Para demostrar su funcionamiento, creemos un nuevo campo para el género de contenido Acontecimiento que cuente si el acontecimiento es un concierto, una obra teatral o bien una conferencia. La creación de una lista de selección es similar a la creación de los tipos de campos anteriormente cubiertos. En la página “Administrar campos” para el tipo de contenido Evento, haz click en el botón “Agregar campo”. Selecciona “Lista (texto)” para el género de campo (ver figura cinco-17) y también ingresa “Tipo de evento” en el campo Etiqueta. Después de configurar estos valores, haz click en el botón “Guardar y continuar” para continuar con la definición de tu nevo campo de lista de selección.
En la próxima pantalla, como en los ejemplos anteriores, ingresa un par clave / etiqueta para cada una de las opciones que se marchan a enumerar.
Introduce Concierto / concierto, juego / Juego y conferencia / Conferencia en la “Lista de valores permitidos”, con un conjunto de valores de etiqueta por línea (ver figura cinco-dieciocho). Deja el “Número tolerado de valores” establecido en “Limitado” y “1”. Para seguir, haz click en “Guardar configuración del campo”. En la siguiente pantalla de configuración, haz clic en “Guardar configuración” después de haber establecido los valores que deseas en el formulario.
En los ejemplos precedentes debimos hacer click en la pestaña “Manage form display” y cambiar el tipo de widget de “Lista de selección” a “Casillas de verificación / botones de radio”. Como deseamos enseñar una lista de selección no es necesario cambiar el valor. Ya estás listo para utilizar tu nuevo campo de lista de selección. La figura 5-veintiseis muestra lo que semeja la lista de selección definida en los pasos precedentes al crear un nuevo evento.
Figura cinco-26.
4.4) 5.4. Cargas de archivos
El tipo de campo de carga de archivos presenta un botón del explorador de ficheros que deja a un autor buscar en su equipo local un archivo para cargarlo en Drupal y admuntarlo al elemento de contenido que están creando. Crear un campo de carga de ficheros es prácticamente idéntico al procedimiento para crear otros géneros de campos. Ampliamos el tipo de contenido de Acontecimiento para incluir la capacidad de anexar el programa para el evento. Como con los campos anteriores, navega hasta la página “Administrar campos” del género de contenido del acontecimiento y haz click en el botón “Agregar campo”. En la pantalla “Agregar campo” (ver figura cinco-17) selecciona “Archivo” como género de campo e ingresa “Programa de eventos” en el campo Etiqueta. Haz click en “Guardar y continuar” para pasar al siguiente paso.
En la página “Ajustes de campo” (ver figura 5-veintisiete) activa la casilla de verificación “Activar campo de visualización” y la casilla de verificación “Archivos mostrados por defecto”. Al marcar estos cuadros el creador tiene la opción de mostrar un enlace al archivo cuando los visitantes estén viendo ese elemento de contenido. De manera predeterminada, el destino del fichero subido será el directorio “Archivos públicos” que es un destino configurable definido por el administrador del lugar.
A continuación, en el campo “Número tolerado de valores” establece el número de subidas de ficheros que se habilitarán para los autores de contenido.
Dejaremos la opción establecida en “Limitado” y “1”, ya que sólo prevemos la necesidad de permitir que un autor de contenido cargue un archivo de programa de evento único por evento. Dependiendo de tus necesidades, puedes mudar el número de subidas de ficheros toleradas. Después de configurar los valores en el formulario, haz click en el botón “Guardar configuración del campo”.
Figura cinco-veintisiete.
En la pantalla de configuración final (ver figura cinco-28) encontrarás campos y opciones para ingresar el texto de ayuda que explica por qué se utiliza este campo (“Cargar el programa del evento” en nuestro ejemplo), indicando si se requiere una carga del archivo al crear un acontecimiento (desmarcado en nuestro ejemplo), detallando las extensiones del archivo toleradas (en nuestro caso dejaremos a un autor cargar un archivo con una extensión de archivo txt, doc, docx, ppt, pptx o pdf), opcionalmente identificando el directorio dentro del directorio de ficheros públicos donde se cargarán estos ficheros (dejar en blanco), estableciendo el “tamaño máximo de carga” (para nuestro ejemplo vamos a dejar que los archivos hasta 1 MB) y habilitar una descripción que puede ser utilizada por el autor del contenido para describir el archivo. En el momento en que hayas actualizado los valores, haz click en “Guardar configuración” en la parte inferior del formulario.
Figura 5-28.
La figura 5-veintinueve muestra el nuevo campo de carga de archivo del formulario de creación de evento.
Figura cinco-29.
4.5) 5.5. Área de texto
Es probable que haya escenarios en los que desees suministrar un campo en un formulario de creación de contenido que permita a un autor introducir un párrafo o bien más de texto. Si bien puedes suministrar esta capacidad a través de un campo de texto (un cuadro de entrada de texto de una sola línea), la manera más aceptable y estándar es proporcionar un área de texto. Extendiendo nuestro ejemplo de acontecimiento, vamos a añadir un nuevo campo que se utilizará para capturar las indicaciones para llegar al lugar. Para crear un área de texto, prosigue los mismos pasos que empleamos para crear otros campos en las secciones anteriores. Haz clic en el botón “Agregar campo” en la página “Administrar cmapos” para nuestro género de contenido Evento y escoge “Texto (formato largo)” en la lista de opciones “Agregar un nuevo campo” (ver figura cinco-17). Introduce “Direcciones” en el campo Etiqueta y haz click en “Guardar y continuar”.
El siguiente formulario te permite establecer cuántos cuadros de texto se crearán para este campo. Deja el valor establecido en 1 y haz click en “Guardar configuración de campo”. El siguiente formulario te ofrece la opción de ingresar texto de ayuda, establecer el campo como obligatorio, precisar un valor predeterminado y acotar qué tipo de procesamiento de texto se habilitará para el autor. La elección de HTML completo deja a los autores utilizar todas y cada una de las funciones del editor WYSIWYG, al tiempo que HTML básico restringe el número de opciones de formato disponibles sólo a los conceptos básicos (consulta la figura cinco-treinta para las opciones de HTML limitado).
Selecciona HTML básico y haz clic en “Guardar configuración”. El nuevo campo ya está disponible para su empleo. Procura crear un nuevo acontecimiento y verás el nuevo área de texto en que puedes introducir las direcciones (ver figura 5-treinta).
4.6) 5.6. Campos numéricos y otros géneros de campos
Al recorrer los diferentes géneros de campos que se han enumerado anteriormente, puedes ver que hay un patrón y un conjunto común de parámetros para prácticamente todos los tipos de campos que creamos. Un campo numérico es esencialmente un campo de texto, pero limitado automáticamente por Drupal Trademark a fin de que sólo admita caracteres numéricos (0-nueve). Conforme expandes los modelos de campos que puedes crear al descargar y habilitar módulos de campos aportados, encontrarás pequeñas variaciones en el proceso debido a la estructura de los campos que estás creando. No obstante, el proceso global será el mismo. Si no lo has hecho, ahora es el instante perfecto para explorar la lista de módulos de campos que están libres para ampliar las capacidades de lo que está libre en Drupal Trademark 8.
Visita /project/modules, haz clic en el factor Campos en el filtro “Categorías de módulo” y haz click en Buscar. Al navegar, asegúrate de que te estás centrando en los módulos de campos que construyen para Drupal Trademark ocho, puesto que muchas de las capacidades inherentes a los campos son ahora parte del núcleo Drupal, al tiempo que en versiones precedentes de Drupal Trademark se deben descargar y también instalar CCK para hacer lo que terminamos de lograr usando Drupal Trademark.
Para limitar la lista a Drupal 8, selecciona 8.x en la lista desplegable “Compatibilidad de núcleo” y haz click en el botón Buscar.
Back to top5) 6. Formatear el formulario de entrada para un tipo de contenido personalizado
A veces puedes encontrar que la representación visual de tu nuevo formulario de creación de contenido no encaja con la manera en que quieres que aparezca. Posiblemente desees mudar el orden de los campos en el formulario, el tipo de widget usado para crear contenido en un camo o bien el formato del propio widget. Para cambiar la manera en que se muesstra el formulario, edita un tipo de contenido siguiendo los pasos que has realizado anteriormente. Haz click en la pestaña “Gestionar la presentación del formulario” en la parte superior de la página, lo que da como resultado la lista de campos con sus géneros de widgets y configuraciones de widgets (ver figura 5-31).
Para reordenar el orden de los campos en el formulario, haz click y mantén en el icono de flechas junto al campo que deseas desplazar, arrastra el campo a la posición donde deseas que aparezca y suelta el botón del ratón. Para cambiar el tipo de widget, sencillamente elige un nuevo valor en la lista de selección de widgets y para cambiar la apariencia de un widget (por poner un ejemplo, mudar un área de texto a fin de que muestre más de 5 líneas predeterminadas), haz clic en el icono de rueda dentada en la columna derecha (ver figura 5-31).
Por ejemplo, cambiemos el campo del área de texto para las direcciones de cinco a diez líneas de texto. Para esto, haz clic en el icono de rueda dentada en la columna derecha del campo “Direcciones”. El formulario se expandirá para enseñar un campo en el que puedes cambiar el número de filas, así como introducir texto de marcador de posición que aparecerá en el campo hasta que el creador empiece a introducir texto en ese campo.
Cambia el número de filas de 5 a 10 y luego haz clic en el botón Actualizar, seguido por el botón Guardar. El número de filas que se muestran al crear un nuevo acontecimiento es de diez, proporcionando al autor más espacio para ingresar direcciones.
Back to top6) 7. Formatear la salida de un género de contenido personalizado
Habrá momentos en los que la representación visual del nuevo tipo de contenido que se muestra al usuario final de un sitio no encaje con la manera en que desees que el contenido creado se muestre en pantalla.
En la sección anterior examinamos la reorganización de los campos en el formulario de entrada; en este caso, estamos reordenando el contenido tal y como aparece cuando se renderiza a un usuario.
Puedes ajustar el orden y la posición de las etiquetas en relación con el campo haciendo click en la pestaña “Administrar pantalla” en el formulario de edición de tipo de contenido adaptado.
Utilizaremos nuestro género de contenido Evento para demostrar las capacidades. Al hacer clic en la pestaña “Administrar pantalla” se muestra la página que se muestra en la figura 5-32.
Esta página cuenta todos y cada uno de los campos que están asociados con nuestro tipo de contenido y da la capacidad de delimitar atributos de visualización básicos para la etiqueta y el contenido de cada uno de los campos. Por defecto, hay dos conjuntos de valores que podemos establecer: uno para el predeterminado (nodo completo) y otro para el Teaser. La opción predeterminada muestra el elemento de contenido completo y Teaser muestra sólo el título del elemento de contenido y una versión recortada del campo del cuerpo. Puedes cambiar entre estos a través de los dos links en la parte superior izquierda de la página. Si haces clic en la lista de selección de la etiqueta de cada campo, encontrarás tres opciones:
• Arriba: la etiqueta se mostrará en una línea de forma inmediata superior al widget que seleccionaste para tu campo.
• Inline: la etiqueta se mostrará a la izquierda de tu widget, en exactamente la misma línea que el widget.
• Oculto: la etiqueta no se mostrará en pantalla.
Si haces click en la lista de selección para el formato de cada campo, encontrarás una selección de opciones en dependencia del género de campo. Para los campos relacionados con el texto, las opciones son:
• Predeterminado: el contenido se mostrará en la pantalla tal y como se especificó cuando creaste el campo.
• Resumen: si el género de campo tiene un valor de resumen y un valor de cuerpo, se mostrará el valor resumen. Si no hay un resumen, el valor del cuerpo se recortará a una longitud especificada.
• Recortado: el contenido se recortará a un número de caracteres detallado. Si el contenido es mayor que el número especificado de caracteres, se mostrará un link “Leer más”.
• Oculto: el contenido no aparecerá en pantalla.
Para otros géneros de campo las opciones dependen del género de contenido que se muestra.
Para cambiar la posición de un campo, haz clic y mantén presionado el icono de flechas junto a la etiqueta de campo del elemento que desees mover, arrastra el campo a la posición donde desees que aparezca y suelta el botón del ratón. Recuerda hacer clic en el botón Guardar después de haber movido todos los campos a su posición adecuada.
También podemos delimitar cómo se mostrará el contenido para otros modos que no sean el predeterminado y Teaser, como RSS, índice de búsqueda y resultado de la búsqueda. Para activar esos modos, simplemente haz clic en el link “Configuración de visualización personalizada” en la parte inferior de la página “Administrar” para expandir la lista y elegirla en la lista de modos.
Con los modos adicionales habilitados, puedes acotar cómo se mostrará tu contenido cuando, por poner un ejemplo, se muestre un acontecimiento en la página de resultados de búsqueda.
También puedes acotar tus propios modos que se pueden usar para enseñar contenido de forma diferente en múltiples escenarios. Para crear un nuevo modo de vista, visita Estructura ➤ Modos de visualización ➤ Modos de vista y haz clic en el botón “Añadir nuevo modo de vista”. Elige Contenido en la lista de opciones y, cuando se te pida, da un nombre a tu modo de vista (ej. MiVista). Una vez que se haya creado tu nuevo modo de vista, puedes emplear ese modo en la página Gestionar visualización para acotar la salida única para ese modo de vista.
Back to top
