Guía V.2 Insertación de Qwidgets Múltiples redactada: 9/15/13 Contenido

Transcripción

1 Guía V.2 Insertación de Qwidgets Múltiples redactada: 9/15/13 Contenido I. Como funciona... 2 II. Qwidgets V4 (posterior al 25 de agosto de 2013)... 2 III. Qwidget Anteriores... 3 A. Analizar la o las páginas que hospedarán los Qwidgets adicionales IV. Instrucciones para modificar fragmentos de código de Qwidget original o copiado de Qwidgets muy antiguos (previos a octubre del 2012)... 3 B. A. Identificar el código original del Qwidget... 3 C. B. Editar el código de Qwidget original de la siguiente forma:... 4 D. C. Agregar javascript adicional:... 4 V. Insertar Qwidgets adicionales no tan antiguos (de entre octubre de 2012 y agosto de 2013) en la página destino II. Soporte... 5

2 I. Como funciona Hasta 5 Qwidgets de QuestionPoint pueden ahora co-existir en la misma página Web. Los Qwidgets pueden ser una combinación de fragmentos de código ya existentes de Qwidget, creados recientemente, o copiados. Cada Qwidget en la página (pre-existente o nuevo) debe contener el identificador único incrustado dentro del fragmento de código específicamente identificado como se describe enseguida. II. Qwidgets V4 (posterior al 25 de agosto de 2013) Si su Qwidget fue creado o ha sido actualizado desde el 25 de agosto de 2013, se conoce como el Qwidget V4 y la fuente del código en su página Web luce de la siguiente forma: Figura 1: Qwidget V4 Felicidades! Su trabajo será más fácil. El fragmento de código ya contiene la sección nueva y necesaria de javascript resaltada en la parte superior: Simplemente siga las instrucciones en el código y numere de forma única cada fragmento de Qwidget como lo muestra la figura 2: Figura 2: instrucciones del Qwidget V4 Page 2

3 III. Qwidget Anteriores Si su Qwidget no contiene Qwidget V4 en el código, siga las instrucciones en la sección IV o sección V como se describe abajo, dependiendo del tiempo de antigüedad del Qwidget. Cada página nueva debe usar una nueva etiqueta de script HTML adicional, para permitir que los múltiples Qwidgets se muestren. A. Analizar la o las páginas que hospedarán los Qwidgets adicionales. Puede ser posible que el Qwidget original antiguo en su página no contiene todavía el identificador único necesario. Por eso debe usted de identificar la forma en que el Qwidget inicial es implementado en su página destino. Qué versión es, y cómo se muestra: está en un banner o menú de opciones que muestra una o más páginas diferentes de su sitio Web o está incrustado directamente en esa página destino? Si el Qwidget está en un banner o menú de opciones que se muestra en páginas múltiples, localice la página que contiene ese código de Qwidget y edite ese fragmento de código primeramente, por lo regular usando el número 1 como el identificador único en los pasos de instalación abajo mencionados. Una vez que ese Qwidget potencialmente omnipresente sea identificado como Número 1, ese número no pude usarse en Qwidgets subsecuentes. Si el Qwidget no está en una sección de página reusada como un banner o menú de opciones, edite ahí mismo en la página destino el fragmento de código de Qwidget existente; de nuevo, típicamente identificando el Qwidget original como número 1, usando los pasos que se mencionan abajo. IV. Instrucciones para modificar fragmentos de código de Qwidget original o copiado de Qwidgets muy antiguos (previos a octubre del 2012) A. Identificar el código original del Qwidget Actualmente hay tres formatos de códigos históricos aceptados y en uso. Figura 3 : (1ra Generación de código Qwidget introducido en el 2006.) Page 3

4 Figura 4: (2da Generación de código Qwidget introducido en el 2008) B. Editar el código de Qwidget original de la siguiente forma: Independientemente del tipo de código que compone su Qwidget original, usted debe insertar las siguientes dos líneas de código dentro del código de Qwidget original, reemplazando la X roja con un número único de entre 1 al 5 (por lo regular usted nombraría el Qwidget original 1 ): 1. <div id="qpchatwidget" qwidgetno="x" ></div> [insertado al comienzo del fragmento de código de Qwidget original]; 2. qwidgetno="x" [insertado en el cuerpo mismo del código de Qwidget] Su código de Qwidget original resultante debe lucir así: Figura 5: Nótese la inserción de #2 como un elemento dentro del cuerpo de la pestaña del guión. C. Agregar javascript adicional: Se debe también agregar un fragmento de javascript adicional a las páginas Web que contienen Qwidgets originales V1 o V2: NOTA: 1. Esta última etiqueta de script HTML adicional necesita aparecer una vez por cada página destino, independientemente de cuantos Qwidgets adicionales (de 1 a 5) aparezcan en la página. Page 4

5 V. Insertar Qwidgets adicionales no tan antiguos (de entre octubre de 2012 y agosto de 2013) en la página destino. Si usted inserta un fragmento de código Qwidget creado después del 13 de octubre de 2012 pero antes del 25 de agosto de 2013, (conocida ahora como Versión 3), tendrá algo de código adicional que debe incluirse en la página destino por lo menos una vez y tendrá un número de Qwidget que debe ser editado por usted, reemplazando el 1 con un número diferente del 2-5. El nuevo código que usted debe agregar está ya incluido en la figura 6 de abajo. La función es: Figura 6: (3ra Generación de Código posterior a 10/2012 y previo al 25/8/2013) VI. Soporte Antes de introducir su nueva página con Qwidgets múltiples, le recomendamos que la verifique para asegurarse de que ha seguido los pasos y de que ha ingresado todo el código necesario. Si tiene todo el código, usted deberá ver 2 Qwidgets en la página. Si no, ninguno de los códigos aparecerá. Si tiene dificultades en colocar los dos o más Qwidgets en una sola página, sírvase por favor contactar a David Leslie (leslied@oclc.org) o a Carol Bonnefil (bonnefilc@oclc.org), y envíe por correo electrónico la página HTML que contiene los Qwidgets múltiples tal como los ha armado hasta ahora para poder examinar el código con el fin de identificar el punto de falla. Page 5