InstalarTwittsms
De Open movilforum wiki
Tabla de contenidos |
[editar] Instalación de Twittsms
A continuación se va a explicar cuáles son los pasos y los requisitos para realizar la instalación de twittsms.
Se entiende que el atrevido que intente instalar twittsms en su sistema tiene conocimientos básicos de
- Lenguaje PHP
- Configuración de PHP
- Configuración de Apache
- Configuración de MySQL
- Programación de tareas (cron o similar)
[editar] Requisitos
[editar] Antes de nada
Para poder crear una instalación de twittsms hay que disponer de un número de la [API_Recepci%C3%B3n_de_mensajes_de_texto] (de Open.Movilforum). Es decir tienes que darte de alta primero.
También comentar que, teóricamente, puesto que twittsms usa la extensión PEAR:Net_SMS, puede emplearse con cualquiera de los gateways de Net_SMS que soporten recepción de mensajes. No obstante, hasta el momento sólo ha sido probada con la de movilforum desarrollada por el mismo autor en el proyecto OSAP
En lo que sigue, se supondrá que se está empleando el gateway de Open.Movilforum
[editar] Requisitos del Servidor
Debes de disponer de disponer de un servidor web Apache con PHP5 y MySQL
Dado que los SMS son reenviados por el gateway a una cuenta POP3, debes de asegurarte que tu servidor tiene las políticas de cortafuegos que permitan conexiones salientes a POP3.
Este requisito es posiblemente el más complejo de obtener en un hosting de los económicos. Si prentendes instalar twittsms asegúrate de que el hosting que elijas cumple este requisito.
Otra opción es que el servidor de correo POP3 en el que se reciben los SMS sea el mismo que el servidor web.
Puesto que twittsms genera imágenes CAPTCHA, PHP debe de tener la GD activa (gd.2so o php_gd2.dll)
Por otro lado, si el servidor de correo POP emplea SSL deberá tener activa no sólo la extensión de sockets (sockets.so o php_sockets.dll), sino también la de SSL (openssl.so o php_openssl.dll)
Puedes activar estas extensiones modificando el fichero php.ini de tu PHP.
[editar] Descarga
* http://code.google.com/p/twittsms/downloads/list
[editar] Código fuente
El código fuente tiene los siguientes directorios principales:
- twittsms-web Código fuente de la interfaz web.
- twittsms Código fuente de la tarea encargada de convertir los emails procedentes de un SMS enviados por Openmoviforum en actualizaciones twitter.
- common Repositorio de aspectos comunes
- osap Instalación del Proyecto OSAP
- sql Ficheros con la estructura de la base de datos SQL
Se ha intentado dividir el código fuente en dos partes bien diferenciadas e independientes. Una la parte es la interfaz
web y otra la parte es la tarea que convierte los SMS en actualizaciones twitter.
[editar] Creación de la base de datos
twittsms emplea una base de datos para almacenar la información de cada usuario. La estructura se encuentra en el directorio sql/ donde existe un fichero llamado users.sql.
Deberemos importar ese fichero a una base de datos. Por ejemplo, podemos usar el comando:
# mysql twittsms < users.sql
También podemos usar PhpMyAdmin.
[editar] .htaccess
Establecer la directiva RewriteBase. Si por ejemplo, tienes twittsms instalado en www.tudominio.com/twittsms/ rewrite base debería ser /twittsms/
[editar] Ficheros de configuración
Existen dos ficheros de configuración. Uno ubicado en twittsms/config.php y otro en twittsms-web/config.php
El primero corresponde con el programa encargado de convertir emails a actualizaciones en twitter.com. El segundo corresponde con la configuración de la configuración del interfaz web de twittsms.
[editar] twittsms/config.php
En este fichero los parámetros más comunes a editar son:
[editar] twittsms-web/config.php
Este fichero alberga los parámetros de configuración del interfaz web.
Los parámetros más comunes a editar son:
- mobileNumber número de móvil de twittsms (es el que te da open.movilforum.com)
- dbuser nombre del usuario de la base de datos
- dbPass password del usuario de la base de datos
- dbServer servidor de base de datos
- webRoot debe de terminar en /. Por ejemplo, si la url para acceder a twittsms es www.tudominio.com/twittsms/ webRoot
es /twittsms/
- appRootDir es eld directorio Físico en el que has instalado twittsms.
- contactMail email de la persona de contacto
- pressMail email del contacto de prensa.
[editar] twittsms/config.php
Este fichero alberga los parámetros de configuración de la tarea encargada de convertir los emails procedentes de SMS en actualizaciones Twitter.
- POP3User Usuario de la cuenta de correo en la que se reciben los SMS de OpenMovilforum.
- POP3Pass Contraseña del usuario de correo en el que se reciben los SMS de OpenMovilforum.
- POP3Server Nombre del Servidor de correo
- POP3Port Puerto del servidor de correo
- DefaultTwitterUser Se establece si se quier
- DefaultTwitterPassword Se establece si se quiere que todos los SMS recibidos sean post a este usuario
- EnableTestUser activar el usuario de pruebas? true/false
- TestUser Nombre del usuario de pruebas en twitter
- TestPassword Contraseña real del usuario twitter de pruebas
- $_LANG Idioma por defecto (es o en)
- dbUser Usuario de la base de datos
- dbPass Contraseña de la base de datos
- dbServer Nombre del servidor de la base de datos
- dbDatabase Nombre de la base de datos (twittsms)
- dbType tipo de base de datos (mysql). Cualquiera de los tipos soportados por PEAR::DB
- appRootDir Directorio en el que está la aplicación instalada
[editar] Permisos
Hay que dar permisos de escritura al usuario que ejecute el servidor web en los siguientes directorios:
- twittsms-web/tmp/
- twittsms-web/cache/
- twittsms-web/templates_c/
Ejemplo: chmod 777 twittsms-web/tmp/
[editar] Codificación de caracteres
Un problema que puede surgir, dependiendo de la configuración del servidor en el que alojes twittsms es que se vean mal los caracteres con acentos. Twittsms está hecho en iso-8859-1, si tu servidor usa UTF-8, tendrás que configurarlo para que use ISO-8859-1 o convertir el código fuente a UTF-8 empleando iconv.
[editar] Programación de la tarea
Por último, y no por ello menos importante, llega el turno de programar la tarea. Twittsms funciona revisando de forma periódica la cuenta de correo asociada al número de teléfono de OpenMovilforum. El script que hay que lanzar es runme.php
Por ejemplo, en el caso de usar crontab en Linux la tarea sería la siguiente:
*/5 * * * * /path/al/fichero/runme.php > /tmp/twittsms.log
Inicio del Wiki de twittsms
