La clase dms_class.php

La clase class_dms.php, le permite integrar un su página Web el envío de mensajes SMS a teléfonos móviles. La clase tiene las propiedades y funciones necesarias para poder llevar a cabo está labor.

¿Como llamar a la Clase?

Incluiremos en nuestro código una llamada a la clase:

include ("PATH/class_dms.php");

Siendo PATH, el directorio donde se encuentre la clase class_dms.php

Para crear una instancia de la clase, lo haremos de la siguiente forma:

$dms=new dms_send;

En este caso el objeto dms, tendrá todas la propiedades necesarias para realizar el envío.

Métodos y funciones de la Clase

Métodos y Funciones de la Clase

Métodos

• mailError; en caso de un error, la clase nos enviará un mail a la cuenta que especifiquemos en este campo, indicandonos este hecho. Dejelo vacio si no requiere de estas notificaciones.
• MaxSizeMessage; Es el tamaño máximo del mensaje que la clase va a manejar. Dejelo a Cero para no limitar el tamaño del mensaje.
• autentificacion; Le permite configurar los datos de su cuenta y obtenr información de está.
• mensajes; Este método le permite agregar los mensajes a enviar por SMS y tras ser enviado, revisar su estado.
• SupportSSL; se le pasa como argumento true o false, dependiento si queremos activar la conexión Segura o no. Le recomndamos que active está opción si su servidor lo permite.
• SupportXML; se le pasa como argumento true o false, dependiento si queremos activar el parseo con objetos XML.

Método Autentificacion

Este método, a su vez tiene los siguientes sub métodos:

• username; donde le especificaremos el nombre de usuario de la cuenta en Descom con la que deseamos enviar los SMS.
• autentificacion; es la contraseña de la cuenta con la que realizaremos el envío.
• saldo; trás enviar los mensajes u obtener el saldo, en esta propiedad podremos ver el saldo actual de la cuenta.
• error; Una variable Booleana que nos devolverá si la cuenta a autenticado o no en la plataforma de envíos de SMS.
• mensajeerror; En caso de error, este campo nos devuelve la descripción del error.

Método Mensajes

Este método, nos permite agregar los mensajes en el envío y su posterior analisis de los resultados acarecidos.

Para agregar un mensaje, empleramos la siguiente función del método mensajes:

mensaje.add key, destino, mensaje, remitente

Esta es la explicación de los argumento de está función:

• key; debe ser una clave única que nosotros asignemos, en cada envío solo podrá haber una única clave para cada mensaje.
• destino;Teléfono destino con formato internacional "0034666555888"
• mensajes; Texto del mensaje que deseamos enviar.
• remitente; nos permite definir el remitente del mensaje, dejelo vación si quiere que aparezca el predeterminado. más información.

Una vez enviemos los mensajes, si deseamos ver el resultado del envío de cada mensajes, llamaremos a la función mensajes.enviados.

Está función nos retornará una matriz con todos los mensajes que hemos intentado enviar. Cada elemento de está matriz, dispone de las siguiente propiedades:

• key; será la misma key que asignamos al agregar el mensaje.
• destino;Teléfono destino con formato internacional "0034666555888"
• mensajes; Texto del mensaje que deseamos enviar.
• error; Una variable Booleana que nos devolverá siel mensaje ha sido enviado o no.
• mensajeerror; En caso de error, este campo nos devuelve la descripción del mismo.

Funciones

La clase proporciona las siguientes funciones:

• Send; está función se encargará de enviar los mensjaes que previamente hemos agregado.
• getSaldo; si únicamente queremos conocer el saldo actual sin enviar ningún mensaje, llamaremos a está función.

Ejemplo

A continuación exponemos un pequeño ejemplo de uso de la clase:

<?
include ("class_dms.php");

$dms=new dms_send;

#Datos de acceso a la plataforma
$dms->autentificacion->username=$_POST["usuario"];
$dms->autentificacion->passwd=$_POST["clave"];
$dms->autentificacion->mailError="";
$dms->autentificacion->MaxSizeMessage=0;

$dms->SupportSSL(true);

$dms->SupportXML(true);

#Mensajes a enviar
$dms->mensajes->add("1",$_POST["destino"],$_POST["texto"],$_POST["remitente"]);

#Enviar mensajes a plataforma
$dms->send();

#Verificar Resultado
if ($dms->autentificacion->error){
    #Error de autentificacion con la plataforma
    echo "<font class='textoERR'>Error: ".$dms->autentificacion->mensajeerror . "</font>";

}else{
    #Autentificacion correcta
     echo "<font class='texto1'>Saldo: ".$dms->autentificacion->saldo."<br>";
     echo "Mensajes enviados: " . (count($dms->mensajes->get())-$dms->mensajes->errores) . "<br></font>";
     if ($dms->mensajes->errores>0){
          echo "<font class='textoERR'>Mensajes con errores: ".$dms->mensajes->errores."<br>";
          echo "Destalles:<br>";
          foreach ($dms->mensajes->get() as $msg){
               if ($msg->error){
                    echo "&nbsp;&nbsp; - " . $msg->destino . "->" . $msg->mensajeerror . "<br>";
               }
          }
     echo "</font>";
     }
}

?>

Inicio - Contacto - Datos Identificativos - Aviso Legal - copyright: Descom SL.