Manual de Formulario info@sagasoluciones.com C/ Salado, 11. Local 10. 41011 Sevilla +34 954 45 72 75
MANUAL DE FORMULARIO CONTROL DEL DOCUMENTOS Realizado (21/01/2010) Inmaculada Peña Ruiz Técnico Revisado (27/01/2010) Sergio Raposo Vargas Director Técnico Control de Modificaciones Rev. Fecha Autor/es Descripción Nº 0 21/01/2010 Inmaculada Peña Ruiz Redacción inicial del documento 2
MANUAL DE FORMULARIO 1 CREACIÓN DE UN RECURSO... 5 2 ELEMENTOS... 8 2.1 BARRA DE MENÚ DEL EDITOR 8 2.2 CORREO DE 9 2.3 CORREO PARA 10 2.4 ASUNTO 10 2.5 DATA DESTINO 10 2.5.1 transport... 10 2.5.2 Id del formulario... 10 2.6 TEXTO DEL CORREO 11 2.7 TEXTO 11 2.8 CAMPOS 11 2.8.1 Tipo... 12 2.8.2 Etiqueta... 12 2.8.3 Obligatorio... 12 2.8.4 Valor por defecto... 12 2.8.5 Validación... 12 2.8.6 Mensaje de error... 12 2.9 TIPOGRAFÍA DE LOS CAMPOS 13 2.9.1 Campo Text Input... 13 2.9.2 Campo Correo Electrónico... 13 2.9.3 Campo Text Area... 14 2.9.4 Campo Subida de archivos... 14 2.9.5 Campo Checkbox... 14 2.9.6 Campo enlace de confirmación... 15 2.9.7 Campo Radio Buttons... 15 2.9.8 Campo Select... 15 2.9.9 Campo Oculto... 16 2.9.10 Campo Vacío... 16 2.9.11 Campo Dinámico... 16 2.9.12 Campo Tabla... 16 2.10 FORM MIDDLE TEXT 16 3
MANUAL DE FORMULARIO 2.11 TEXTO AL PIE 16 2.12 URI DE DESTINO 17 2.13 TEXTO DE CONFIRMACIÓN 17 2.14 CAPTCHA FIELD 17 2.15 CONFIGURACIÓN AVANZADA: 17 2.15.1 Tipo del mail... 17 2.15.2 Copia a... 17 2.15.3 Copia oculta a... 18 2.15.4 Activar página de confirmación... 18 2.15.5 Texto de la página de comprobación... 18 2.15.6 Mostrar obligatorios... 18 2.15.7 Permite reseteado... 19 2.15.8 Atributos del formulario... 19 2.15.9 Atributos del campo... 19 2.15.10 Clases de campos dinámicos... 19 2.15.11 Style... 19 2.16 CORREO DE CONFIRMACIÓN 20 2.16.1 Activar correo de confirmación... 20 2.16.2 Confirmación seleccionable... 20 2.16.3 Etiqueta del campo de confirmación... 20 2.16.4 Número del campo de correo... 21 2.16.5 Asunto del correo de confirmación... 21 2.16.6 Texto del mail de confirmación... 21 4
1 CREACIÓN DE UN RECURSO El recurso de tipo Formulario nos va a permitir crear un formulario en nuestro portal por el cual los usuarios de nuestra web podrán enviarnos cualquier tipo de consulta. Para crear un recurso de tipo Formulario, pulsamos en la barra de herramientas sobre el botón Nuevo, situado en el lugar de trabajo de la vista Explorador. En este momento aparece una ventana en la que tenemos que elegir el tipo de recurso que deseemos. Elegimos la opción Contenido estructurado. 5
Le damos a continuar y elegimos el recurso Alkakon Webform. Volvemos a pulsar continuar. De esta forma aparece una nueva ventana donde escribimos el nombre del recurso formulario (sin espacios ni demás caracteres extraños). Le vamos a dar un nombre identificativo según su contenido. NOTA: Recordar que el nombre de un recurso de OpenCms no debe contener espacios en blanco, ñ, tildes, ni cualquier otro carácter especial. 6
En el caso de que se trate de la página principal de una sección su nombre deberá ser index.html para que el gestor lo reconozca como la página por defecto de dicha sección. Pulsamos Continuar y editamos las propiedades del texto (si en el primer paso habilitamos la casilla de Editar propiedades del nuevo fichero.) En el campo Title redactamos el epígrafe o un texto fácil de identificar por el usuario. Podemos describir brevemente el contenido del texto con el campo Description, así como marcar palabras clave (identificadoras) en el campo Keywords Si marcamos la casilla de Agregar a navegación, el recurso se incluirá en la navegación de la carpeta. Formará parte del menú de navegación. Es importante asignarle al campo Texto de navegación un epígrafe que lo identifique, ya que será el que aparezca en el menú de nuestra página. No podemos olvidarnos la posición que va a ocupar este recurso en la navegación. Para designar la posición del recurso empleamos el campo Inserte después de. Para finalizar pulsamos el botón Terminar. 7
Una vez creado el recurso lo editamos para introducir los contenidos pulsando el botón derecho del ratón y nos posicionamos en Editar para abrir el editor del recurso. 2 ELEMENTOS 2.1 BARRA DE MENÚ DEL EDITOR Conforme vamos activando los elementos podemos ir guardando la información mediante el botón Guardar. Si pulsamos el icono Guardar y aplicar salimos al Explorador del lugar de trabajo de OpenCms. guardamos la noticia con los cambios realizados y Si hacemos clic en Publicar, el recurso es publicado directamente, si no también lo podemos hacer en el Explorador del lugar de trabajo, posicionándonos sobre la noticia en cuestión y con el botón derecho elegir la opción publicar directamente. Para previsualizar el texto que estamos editando pulsamos en Previsualización. 8
Para salir del editor pulsamos en el icono Salir guardar los cambios realizados.. Antes de salir nos avisará si deseamos Por defecto el idioma seleccionado del editor es el español tiene la opción de editar los contenidos en otro idioma, podemos copiar recurso y exportarlo a otro idioma.. Si el portal el contenido del Para eliminar el contenido, seleccionamos el idioma y pulsamos el icono Eliminar. 2.2 CORREO DE Hemos de escribir la dirección de la persona que envía el email. Dicha dirección debe de ser válida. Este campo es obligatorio- Nota importante: En caso de cualquier duda, podemos situar nuestro ratón en el icono de interrogación, el cual nos indica qué debemos hacer 9
2.3 CORREO PARA Es el campo donde se van a definir los destinatarios del correo. Para añadir más de una dirección, han de separarse mediante ;. 2.4 ASUNTO Breve descripción del asunto del correo enviado. 2.5 DATA DESTINO Seleccionamos Mostrar todos los botones y Agregar Nuevo. En este campo definimos cómo y qué queremos que se hagan con la información que recibamos a través del formulario. El elemento Data destino consta de los siguientes campos: 2.5.1 TRANSPORT Permite elegir con el select el destino del envío de la información recibida: - Email: la información se envía como email. - Database. La información de almacena en la base de datos. Posteriormente el administrador podrá descargársela en formato CVS. - Email & database: La información se almacena de los dos modos anteriores. 2.5.2 ID DEL FORMULARIO Con este campo podremos asignar un nombre identificador al formulario. 10
2.6 TEXTO DEL CORREO Este campo nos permite introducir el texto del correo Podemos introducir dos etiquetas que van a incorporar automáticamente al formulario: %(date), la fecha actual y %(formdata), un dato concreto. 2.7 TEXTO Introducción editable que aparecerá al comienzo del formulario. 2.8 CAMPOS Seleccionamos Mostrar botones del elemento y Agregar Nuevo. Es el campo de un formulario cuya función es que sea relleno por el usuario, para enviarnos su información. Podemos agregar todos los campos que sean necesarios en nuestro formulario. Para crear un nuevo campo pulsamos en el icono Mostrar botones del elemento, símbolo Agregar Nuevo Con este elemento tenemos la posibilidad de publicar tantos como nos hicieran falta. Solo tenemos que pulsar el icono Agregar Nuevo 11
Si por alguna razón gustamos por modificar el orden de los campos solo tenemos que pulsar en la flecha bien arriba o abajo. Para eliminar campo hacemos clic en el icono Eliminar. Un campo posee una serie de propiedades. 2.8.1 TIPO Permite seleccionar el tipo de campo que queremos mostrar. 2.8.2 ETIQUETA Etiqueta o nombre del campo a rellenar. 2.8.3 OBLIGATORIO Si se activa su casillero, el campo tendrá que ser de obligatorio relleno por el usuario, mientras que si se deja inactivo, pasaría a ser opcional. 2.8.4 VALOR POR DEFECTO Seleccionamos Mostrar botones del elemento y Agregar Nuevo. Es el valor por defecto del campo a rellenar, o lista de opciones mostradas. 2.8.5 VALIDACIÓN Seleccionamos Mostrar botones del elemento y Agregar Nuevo. Expresión regular usada para validar el contenido del campo. 2.8.6 MENSAJE DE ERROR Seleccionamos Mostrar botones del elemento y Agregar Nuevo. Expresión regular o mensaje que se muestra en caso de fallar la validación del contenido del campo. 12
2.9 TIPOGRAFÍA DE LOS CAMPOS A continuación vamos a explicar los pasos para crear los distintos tipos de campos en el formulario: 2.9.1 CAMPO TEXT INPUT 2.9.2 CAMPO CORREO ELECTRÓNICO 13
2.9.3 CAMPO TEXT AREA 2.9.4 CAMPO SUBIDA DE ARCHIVOS 2.9.5 CAMPO CHECKBOX 14
2.9.6 CAMPO ENLACE DE CONFIRMACIÓN Un campo de privacidad que muestra una casilla de verificación y un vínculo en el lado derecho de la misma. Tiene la funcionalidad de permitir a que el usuario del sitio pueda confirmar que ha leído las declaraciones de privacidad o aceptar la licencia. Mientras que el enlace llevará a una explicación más detallada. El vínculo tiene que ser relativo al sitio. 2.9.7 CAMPO RADIO BUTTONS 2.9.8 CAMPO SELECT 15
2.9.9 CAMPO OCULTO Permite añadir un valor al formulario de uso interno, sin que este sea visible o editable por el usuario. Dicho valor se transmitirán en el correo electrónico y/o base de datos. 2.9.10 CAMPO VACÍO Los campos vacíos se pueden utilizar para disponer de espacio adicional entre las filas de formulario. 2.9.11 CAMPO DINÁMICO Permite expandir la funcionalidad que nos ofrece el módulo, integrando como campo otro tipo que no venga generado por OpenCms. 2.9.12 CAMPO TABLA Permite crear campos como si fueran tablas. En Valor por defecto definiremos sus columnas y filas: Tanto las columnas como las filas de la tabla se definen en el valor por defectos por palabras separadas por coma, sólo que para separar las columnas de las filas hemos de emplear una barra. Sería del siguiente modo: Columna 1, columna 2 fila 1, fila 2 Estos valores se almacenan en la base de datos en la forma: colname_rowname. 2.10 FORM MIDDLE TEXT Seleccionamos Mostrar botones del elemento y Agregar Nuevo. Texto o mensaje que aparece tras los datos del formulario. 2.11 TEXTO AL PIE Seleccionamos Mostrar botones del elemento y Agregar Nuevo. 16
Texto o mensaje mostrado al finalizar el formulario. 2.12 URI DE DESTINO Seleccionamos Mostrar botones del elemento y Agregar Nuevo. En lugar de mandar un email y mostrar una página de confirmación, el usuario es redirigido a la Uri que introduzcamos, tras rellenar satisfactoriamente el formulario. 2.13 TEXTO DE CONFIRMACIÓN Texto mostrado en la página de confirmación que aparece tras ser rellenado el formulario correctamente. 2.14 CAPTCHA FIELD Seleccionamos Mostrar botones del elemento y Agregar Nuevo. Campo de seguridad. Posee dos campos: - Label: Etiqueta del campo. - Preset: Tipo de batería de imágenes que el usuario ha de confirmar. 2.15 CONFIGURACIÓN AVANZADA: Corresponde a la configuración del email que se envía. 2.15.1 TIPO DEL MAIL En el select de esta opción podremos seleccionar la tipografía del email que se envía; que puede ser HTML, generado por un código fuente o Texto plano. 2.15.2 COPIA A Campo donde se definen los destinatarios a los que se enviará una copia del correo. Si queremos añadir más de una dirección, tendremos que separarlas con ;. 17
2.15.3 COPIA OCULTA A Campo donde se definen los destinatarios a los que se enviará una copia oculta del correo. Si queremos añadir más de una dirección, tendremos que separarlas con ;. 2.15.4 ACTIVAR PÁGINA DE CONFIRMACIÓN Si se activa la casilla se mostrará una pantalla previa al envío del correo donde el usuario podrá validar la información suministrada. 2.15.5 TEXTO DE LA PÁGINA DE COMPROBACIÓN Texto que se mostrará encima de los campos introducidos. 2.15.6 MOSTRAR OBLIGATORIOS Si se activa las marcas (*) de campo obligatorio serán mostradas. 18
2.15.7 PERMITE RESETEADO Si se activa la casilla se mostrará en el formulario un botón Resetear, para que el usuario antes de enviar la información pueda borrar todos los campos introducidos en los campos. 2.15.8 ATRIBUTOS DEL FORMULARIO Permite introducir de forma opcional un atributo al formulario, por ejemplo un nombre de clase para otorgar determinado estilo en la CSS. 2.15.9 ATRIBUTOS DEL CAMPO Permite introducir de forma opcional una clase de estilo genérica a todos los campos del formulario. 2.15.10 CLASES DE CAMPOS DINÁMICOS Permite introducir de forma opcional una clase de estilo genérica a todos los campos dinámicos del formulario. 2.15.11 STYLE Seleccionamos Mostrar botones del elemento y Agregar Nuevo. Podemos añadir un estilo concreto al formulario añadiendo el valor de una clase. 19
2.16 CORREO DE CONFIRMACIÓN Es el correo que recibe el usuario que ha enviado un formulario en nuestro sitio, confirmándole que se ha recibido correctamente y los datos que éste ha introducido. Cuenta de los siguientes campos: 2.16.1 ACTIVAR CORREO DE CONFIRMACIÓN Si se activa esta casilla el usuario recibirá el correo de confirmación en su dirección de email. 2.16.2 CONFIRMACIÓN SELECCIONABLE Si se marca la casilla, en el formulario, aparecerá una casilla de verificación con la que el usuario podrá seleccionar si quiere o no recibir en su email el correo de confirmación del envío. 2.16.3 ETIQUETA DEL CAMPO DE CONFIRMACIÓN Permite introducir el texto o etiqueta que acompañará a la casilla de verificación comentada en el punto anterior, en caso que se encuentre activada dicha opción. 20
2.16.4 NÚMERO DEL CAMPO DE CORREO Debemos introducir el número que corresponde al campo en el que el usuario debe introducir su correo electrónico, para que el sistema sepa que a esa dirección es a la que debe enviar el correo de confirmación. En este ejemplo se ha introducido el valor 4 ya que es el campo Correo Electrónico, el cuarto en aparecer en el formulario: 2.16.5 ASUNTO DEL CORREO DE CONFIRMACIÓN Describe el asunto del correo de confirmación que se va a enviar automáticamente al usuario. 2.16.6 TEXTO DEL MAIL DE CONFIRMACIÓN El texto que se enviará en el correo de confirmación: %(date), enviará la fecha y %(formdata) mostrará los campos del formulario. Para editar el correo de confirmación se recomienda acceder al Tutorial Normas para la creación de emails de confirmación, que podréis encontrar en la web de Template SAGA. 21