mensajitos versi�n 2.x contenidos: 1-acerca de mensajitos 2-requerimientos 3-instalaci�n 3.1 - instalaci�n independiente 3.2 - instalaci�n Incrustada 4-configuraci�n 4.1 - configuraci�n de la plantilla wap 4.2 - mas opciones de configuraci�n 5-anexos 5.1 - mapa de operadores de telefon�a m�vil en e.s. 1 - acerca de mensajitos mensajitos es un software de env�o de mensajes cortos de texto(sms) a dispositivos m�viles. su funci�n b�sica, es la de identificar el operador al que corresponde el n�mero de tel�fono del destinatario, y redireccionar los datos a la p�gina del operador. la versi�n 2.0, utiliza un sistema de plantillas para dibujar el formulario de env�o de mensajes, esto es, para facilitar la instalaci�n del script en cualquier sitio web, y para evitar el tener que modificar c�digo de php para cambiar el aspecto del programa. el software puede ser utilizado tambi�n en modo wap, se puede cargar una plantilla escrita en wml para que pueda ser visto en cualquier m�vil que posea un navegador wap. debido a que mensajitos es de libre distribuci�n, su c�digo fuente es accesible a todo el que quiera modificarlo, sin embargo es propiedad intelectual de mario enrique g�mez argueta y est� protegido bajo la licencia gnu/gpl versi�n 2.0 o posterior, que puede ser descargada del sitio web http://www.fsf.org/, o puede verla tambi�n en el archivo licencia.txt mensajitos hace uso de la clase snoopy, un micronavegador que permite el env�o de los datos del usuario a cada operador. snoopy esta protegido bajo la licencia gnu/gpl, y puede ser obtenido desde la siguiente direcci�n http://snoopy.sourceforge.net/ nota: debido a que no se agrega de ninguna informaci�n del software en los mensajes, es necesario agregar la informaci�n de los copyrights en la plantilla del formulario de mensajitos. si por cuestiones de dise�o no es posible agregar toda la l�nea de copyrights, es necesario al menos, agregar un v�nculo como el siguiente, o un vinculo con imagen visible como el siguiente:
mensajitos v2.1.0 2 - requerimientos para instalar mensajitos necesitar� un servidor web con soporte para php. la librer�a snoopy requiere php con soporte para pcre (expresiones regulares), que deber�an estar en cualquier versi�n de php posterior a la 3.0.9. mensajitos ha sido probado y desarrollado en php 4.3.7, cualquier versi�n 4.x posterior deber�a de ser compatible. 3 - instalaci�n mensajitos puede funcionar de manera independiente, o incrustado en otra p�gina php. en ambos casos la instalaci�n es la misma, en lo �nico que difieren es en la forma en que se invoca al script. 3.1 - instalaci�n independiente para instalar de manera independiente, solo es necesario descomprimir el archivo mensajitos-2.x.x.zip en el directorio del servidor en que lo deseemos instalar. si se va a instalar de manera independiente, se recomienda crear un directorio exclusivo para mensajitos. por ejemplo, si descomprimimos mensajitos en: /sms lo podremos accesar como http://direccion.com/sms/mensajitos.php algunos servidores admiten el archivo "index.php" como la p�gina principal de un directorio. si tiene planeado instalar mensajitos individualmente, usted puede renombrar "mensajitos.php" a "index.php" para acceder directamente al formulario, al acceder a un directorio. por ejemplo. si descomprimi� Mensajitos en el directorio /mensajes, podr� accederlo directamente como: http://direccion.com/mensajes/ 3.2 - instalaci�n Incrustada es probable que desee agregar el formulario de mensajitos como parte de una p�gina mayor, o
simplemente no quiera tener que abrir otra direcci�n para enviar los mensajes de texto. si este es el caso, lo m�s recomendable es que utilice la instalaci�n incrustada. la instalaci�n incrustada la haremos de la siguiente manera: a) descomprimimos mensajitos, en el directorio donde se encuentra la p�gina en la que lo deseamos incrustar. por ejemplo. si nuestro dominio se llama: http://dominio.com/ y nuestra p�gina principal tiene el nombre "index.php", descomprimiremos el archivo en el directorio ra�z / b) editamos la p�gina principal del directorio e incluimos mensajitos. si tuvi�ramos un archivo principal como el siguiente:
mi página web contenido
espacio libre
debemos agregar la siguiente l�nea en el lugar donde queremos que aparezca el formulario de mensajitos: la p�gina modificada deber�a quedar m�s o menos as�:
mi página web contenido
con esto, el formulario de mensajitos se mostrar� como parte del contenido de la p�gina principal. 4 - configuraci�n el script mensajitos.php tiene varias opciones de configuraci�n. sin embargo para simplificar su uso solo se explicaran en este archivo, las dos opciones principales. las dem�s pueden ser consultadas leyendo los comentarios en el archivo "mensajitos.php". $plantilla esta variable define la ubicaci�n del archivo plantilla, que se mostrar� en la salida de mensajitos. un archivo plantilla simple, tiene una estructura como la siguiente:
los valores entre "{" y "}" son sustituidos antes de ser mostrados y toman los siguientes valores: {script} : direcci�n en el servidor del script de mensajitos. {estado} : estado de env�o del �ltimo n�mero de tel�fono al cual se le envi� un mensaje de texto. {ultimo} : �ltimo n�mero de tel�fono al cual se le envi� un mensaje. una vez que se ha creado la plantilla, la establecemos cambiando el valor de la variable $plantilla. por ejemplo: $plantilla = "plantillas/principal.htm"; **nota importante: si esta usando mensajitos de modo incrustado, y descomprimi� el script en otro directorio diferente al de la p�gina en la cual se esta incluyendo. es muy probable que se muestre un
mensaje de error. por ejemplo: la p�gina en la que queremos incluir mensajitos es: http://dominio.com/principal.php y mensajitos se encuentra en: http://dominio.com/sms/mensajitos.php entonces se mostrar� un error indic�ndonos que no se puede abrir la plantilla. para evitar este inconveniente es necesario corregir la ruta de acceso, para poder acceder al archivo plantilla. si la p�gina desde donde estamos incluyendo a mensajitos con , entonces la plantilla deber� incluir tambi�n este subdirectorio: $plantilla = "sms/plantilla/mensajitos.htm"; con esto se deber� solucionar el error. 4.1 - configuraci�n de la plantilla wap mensajitos v2.1 incluye una plantilla escrita en wml lista para usarse con dispositivos m�viles. una ves expandido, se puede habilitar esta plantilla estableciendo los siguientes valores en la configuraci�n: $plantilla = "plantilla/mensajitos.wml"; $mime = "text/vnd.wap.wml"; **nota: si configura mensajitos con la plantilla wml no podr� utilizar el modo inscrustado en p�ginas html, ni tampoco podr� ser accesado directamente a menos que sea con un navegador que soporte wml. 4.2 - mas opciones de configuraci�n mensajitos es capaz de recibir formularios externos, enviar a m�ltiples destinatarios, sustituir comodines de plantilla para la creaci�n de interfaces mas complicadas. para acceder estas opciones, es recomendable lea los comentarios que se encuentran en "mensajitos.php", estos le guiaran para elegir las opciones de configuraci�n m�s adecuadas para su caso. 5 - anexos
5.1 - mapa de operadores de telefon�a m�vil en e.s. cte telecom personal, s.a. de c.v. ______________________________________________ url: http://www.telecom.com.sv/ url mensajes: http://www.navegante.com.sv/servicios/notipersonal.asp rangos asignados desde: 7-000-0000 7-740-0000 7-750-0000 7-805-0000 7-840-0000 7-850-0000 7-950-0000 7-985-0000
hasta: 7-029-9999 7-749-9999 7-759-9999 7-809-9999 7-844-9999 7-869-9999 7-969-9999 7-989-9999
digicel, s.a. de c.v. ______________________________________________ url: http://www.digicel.com.sv/ url mensajes: http://www.digicel.com.sv/ rangos asignados desde: 7-760-0000 7-970-0000
hasta: 7-779-9999 7-979-9999
telefonica moviles el salvador, s.a. de c.v. ______________________________________________ url: http://www.telefonica.com.sv/ url mensajes: http://216.184.96.114/sms/mensaje.php rangos asignados desde: 7-100-0000 7-700-0000 7-780-0000 7-790-0000 7-810-0000 7-845-0000 7-990-0000
hasta: 7-119-9999 7-719-9999 7-784-9999 7-794-9999 7-839-9999 7-849-9999 7-998-9999
telemovil el salvador, s.a. (tigo) ______________________________________________
url: http://www.tigo.com.sv/ url mensajes: http://mail.telemovil.com/sms/sms_new.php rangos asignados desde: 7-200-0000 7-720-0000 7-785-0000 7-795-0000 7-870-0000 7-930-0000 7-940-0000
hasta: 7-209-9999 7-739-9999 7-789-9999 7-799-9999 7-899-9999 7-939-9999 7-949-9999
intelfon, s.a. de c.v. (red) ______________________________________________ url: http://red.com.sv/ url mensajes: http://red.com.sv/redsms/index.php rangos asignados desde: 7-980-0000 7-983-0000
hasta: 7-982-5999 7-983-9999
globalstar el salvador, s.a. de c.v. ______________________________________________ url: http://www.telecom.com.sv/ url mensajes: ---------------------------rangos asignados desde: 7-801-0000
hasta: 7-803-9999