Diferencia entre revisiones de «Instrucciones del webchat HTML»

De ChatHispano
Saltar a: navegación, buscar
(Página creada con «== Introducción == ChatHispano utiliza el webchat programado en HTML5 [https://kiwiirc.com/ KiwiIrc]. Este Chat tiene varias ventajas respecto a sus equivalentes en Flash...»)
(Sin diferencias)

Revisión del 22:11 31 mar 2014

Introducción

ChatHispano utiliza el webchat programado en HTML5 KiwiIrc. Este Chat tiene varias ventajas respecto a sus equivalentes en Flash pudiéndose destacar la posibilidad de definir el tamaño a voluntad del webmaster, la menor carga de recursos en los equipos de los usuarios o la total compatibilidad con las últimas versiones de sistemas operativos móviles como Android o iOS. Nota: Deben ser sistemas actualizados pues es necesaria la compatibilidad plena con HTML5 .

Integrar el webchat

Existen dos sistemas de integración para el webchat HTML de ChatHispano. La primera es incrustar o embeber el webchat dentro de la página web mediante un iframe lo que tiene como ventaja la posibilidad de chatear sin abandonar la web de origen y la segunda es la de generar un enlace directo con los datos de nick y canal por defecto definidos. Las ventajas de este sistema son que el entorno del chat es más grande y por lo tanto más cómodo para el usuario y que de esta forma el chat se adaptará siempre a la resolución del dispositivo desde el cual se chatee. Nota: Se recomienda encarecidamente utilizar el sistema del enlace si el servicio de chat está orientado a dispositivos móviles, ya que de esta forma se integra a la perfección con el terminal, adaptándose a la posición del mismo.

Incrustar el webchat

Para generar el código del iframe para incrustar o enlazar el webchat en una página web, disponemos de un formulario que lo genera de forma automática y transparente que puedes encontrar en http://www.chathispano.com/generador-de-iframe. En este formulario existen los siguientes campos:

  • Canal: Se trata del canal al que acceder desde el webcht de la web, si se quiere que haya varios canales en una lista desplegable para escoger uno, se pueden poner separados poner comas. La # es necesaria. Por ejemplo poniendo el canal #opers_help es usuario entrará a dicho canal.
  • Nick: Se trata del nick o alias por defecto. Dado que distintos usuarios se van a conectar desde el mismo webchat y sólo se puede utilizar un nick al mismo tiempo, recomendamos encarecidamente utilizar el formato nick? lo que hará que el ? sea sustituido por 5 cifras aleatorias. Por ejemplo si se pone miweb? el usuario entrará al chat con un nick similar a miweb12345.
  • Tema: Se trata del aspecto visual que tendrá el webchat. Existen 4 opciones
    • Default o relaxed: Se trata del tema normal con lista de nicks en los canales, en tonos verdes y ocupando todo el espacio disponible. Este es el tema recomendado en la mayoría de las situaciones.
    • Mini: Se trata de un tema compacto, ocupa una altura de aproximadamente un 25% de la pantalla, y no muestra la lista de usuarios en los canales.
    • CLI: Es similar al tema Relaxed, ocupando todo el espacio disponible y con lista de nicks en los canales pero de color negro.
    • Basic: Es similar al tema Relaxed, ocupando todo el espacio disponible y con lista de nicks en los canales pero de color gris neutro.
  • Ancho: Se trata del ancho en pixels que tendrá el webchat incrustado (si se enlaza no es necesario). Se recomienda asignar el máximo posible para garantizar una buena experiencia a los usuarios del webchat.
  • Alto: Se trata del ancho en pixels que tendrá el webchat incrustado (si se enlaza no es necesario).

Tras cubrir todos los datos y a medida que se introducen se van generando tanto el código del iframe com el enlace o link que habrá que copiar y pegar donde proceda en función del sistema escogido.

Consideraciones técnicas

Este formulario ha sido implementado con el fin de facilitar la inclusión de nuestro webchat en las páginas webs de cualquier webmaster independientemente de su nivel técnico, pero no existen limitaciones por nuestra parte a la hora de generar vuestros propios sistemas de acceso en función de vuestras necesidades particulares, para ello os vamos a proporcionar la sintaxis de los parámetros que acepta el KiwiIrc.

La url para inyectar los datos debe tener el siguiente formato:

 http://kiwi.chathispano.com/?nick=elnick&theme=eltema&chan=#elcanal1

Si se quiere inyectar un nick registrado, la url acepta el formato nick:contraseña o nick!contraseña pero hay que tener en cuenta que en este caso, dichos datos se mostrarán en la barra de direcciones del navegador del usuario, lo cual es inseguro. Nota: estamos trabajando en implementar un cifrado sencillo que enmascare estos datos en la url generada, cuando esté disponible lo anunciaremos y actualizaremos este documento.

KiwiIrc dispone de otros parámetros como el cotejamiento, el servidor o el puerto, pero por diversos motivos técnicos estos están fijados en el archivo de configuración del webchat por lo que no pueden ser modificados.

KiwiIrc tiene licencia AGPL y puede ser modificado y mejorado, el código fuente se encuentra en https://github.com/prawnsalad/KiwiIRC y si te gustaría disponer de un tema personalizado a tus gustos o a la imagen de tu canal o web, te animamos a diseñarlo y si es estable y cumple con la licencia, lo publicaremos en la lista de temas para que pueda ser utilizado por el resto de los webmasters y por vosotros mismos.