OpenInviter en Flash. Extrae tus contactos de gmail, hotmail, msn, yahoo…

OpenInviter es un interesante proyecto open source que permite extraer los contactos con sus cuentas de correo de cada uno de los proveedores más importantes de internet: gmail, hotmail, msn, yahoo, facebook, xing, linkedin, youtube…

Puede ser muy útil para campañas de invita a un amigo (ahora muy típicas por navidad) y para conseguir que el viral se expanda a gran velocidad, en el post vamos a ver como conectarlo en Flash mediante XML.

Podemos ver una demo de OpenInviter en su propia web y ver así todos los proveedores con los que trabaja en la documentación oficial (todos los archivos que acaban plg.php)

Veamos nuestro ejemplo en flash funcionando:

Interfaz
1. La interfaz permitirá enviar el usuario y password del perfil así como su provider. Devolverá una lista ordenada de amigos/contactos en una lista con checkbox para permitir la selección al usuario. Una vez escogidos los amigos en concreto mostraremos los emails de los seleccionados con los cuales podríamos hacer ya la acción necesaria, por ejemplo, enviar el email de invitación.

XML
2. Definimos cual va a ser el XML de datos de contactos que obtendremos y mostraremos en la interfaz.

<xml>
    <ok>1</ok>
  	<contacto>
  		<nombre><![CDATA[Nombre 1]]></nombre>
        <email><![CDATA[email1@email.com]]></email>
     </contacto>
     
     <contacto>
     	<nombre><![CDATA[Nombre 2]]></nombre>
        <email><![CDATA[email2@email.com]]></email>
     </contacto>
     
     	<contacto>
     		<nombre><![CDATA[Nombre 3]]></nombre>
        <email><![CDATA[email3@email.com]]></email>
     </contacto>
</xml>

OpenInviter PHP
2. Mediante la utilización de la clase de OpenInviter en el PHP getcontactos.php obtenemos un array con todos los contactos y pintamos por el buffer de salida el XML dinámico. Para esto recibirá por POST 3 variables: username, password, provider.

<?php

include_once("openInviter/openinviter.php");

//post vars
$username = $_POST['username'];
$password = $_POST['password'];
$provider = $_POST['provider'];

$oi = new OpenInviter();
//
$oi->getPlugins();

//inicia proveedor
$oi->startPlugin($provider);

$isOk = 1;

$xml = '<xml>';

//check username & password
if($oi->login($username,$password))
{
	//array con los contactos
	$contactos = $oi->getMyContacts();
	
	if(is_array($contactos) && count($contactos)>=1)
	{
		//ordenar contactos por nombre
	    ksort($contactos);
	    
	    //crear xml
	    foreach($contactos as $key=>$value)
	    {
	    	$nombre =  utf8_decode(utf8_decode($value));  
	        
	        $xml .= '	<contacto>';
	        $xml .= '		<nombre><![CDATA['.$nombre.']]></nombre>';
	        $xml .= '		<email><![CDATA['.$key.']]></email>';
	        $xml .= '	</contacto>';
	    }            
	}
	else {
		$isOk = 0;
	}
}
else {
	$isOk = 0;
	//echo $oi->internalError;
}

$xml .= '
	<ok>'.$isOk.'</ok>
</xml>';

//mostrar resultado XML
echo $xml;
?>

Flash ActionScript 3.0
3. Flash hará la petición al PHP mediante URLLoader pasando por POST las variables que espera el PHP y obtendrá la lista. Después con la selección de los usuarios al pinchar enviar pintamos en un campo de texto los emails seleccionados.

En el siguiente código tan sólo muestra la llamada a OpenInviter y su posterior carga, en el ejemplo podéis ver el resto:

//datos de carga
var datos:URLLoader = new URLLoader();
datos.addEventListener(Event.OPEN,open_handler);
datos.addEventListener(Event.COMPLETE,complete_handler);

var xml:XML;

[...]

function importclick_handler(event:MouseEvent):void
{
	
	//si se han rellenado los datos
	if(provider_cb.selectedItem != null &&
	   username_ti.text != "" &&
	   password_ti.text != "")
	
	{
		var path:String = "http://www.lostiemposcambian.com/blog/posts/openinviter-flash-as3/getcontactos.php";
		
		//se realiza la solicitud enviando por POST: username, password, provider
		var url:URLRequest = new URLRequest(path);
		var vars:URLVariables = new URLVariables();
		
		vars.username = username_ti.text;
		vars.password = password_ti.text;
		vars.provider = provider_cb.selectedItem;
		
		url.method = URLRequestMethod.POST;
		url.data = vars;
		
		datos.load(url);
		
	}
}

/**
 * Funcion que se ejecuta al iniciar la carga del XML de OpenInviter
 */
function open_handler(event:Event):void
{
	cargando_lb.text = "Cargando...";
	cargando_lb.visible = true;
	
	scroll_bar.visible = false;
	select_bt.visible = false;
	
	emails_lb.visible = false;
	emails_ta.visible = false;
	listado_contactos_sp.visible = false;
	emails_ta.text = "";
}

/**
 * Funcion que se ejecuta al completar la carga del XML de OpenInviter
 * con todos los contactos
 */
function complete_handler(event:Event):void
{
	
	
	//dejar el listado vacío para pintar los checkbox
	var i:int = listado_contactos_sp.numChildren;
	while(i--)
	{
		listado_contactos_sp.removeChildAt( i );
	}
	
	xml = new XML(event.target.data);
	
	//username & password correctos
	if(xml.ok == 1)
	{
		cargando_lb.visible = false;
		
		//crea todos los checkbox, uno por contacto
		var contador:Number = 0;
		for each(var nodo:XML in xml.contacto)
		{
			var cb:CheckBox = new CheckBox(this,0,contador*20,nodo.nombre+" <"+nodo.email+">");
		
			listado_contactos_sp.addChild(cb);
			contador++;
		}
		
		//check si se necesita scroll
		scroll_bar.value = 100;
		if(listado_contactos_sp.height > mask_sp.height)
		{
			scroll_bar.visible = true;
		} else 
		{
			scroll_bar.visible = false;
		}
		scroll_handler(null);
		
		select_bt.visible = true;
		emails_lb.visible = true;
		emails_ta.visible = true;
		
		listado_contactos_sp.visible = true;
	
	} else {
		cargando_lb.visible = true;
		cargando_lb.text = "Datos incorrectos o no hay contactos para esa cuenta";
	}

}

Gracias a @kroniksan por su ayuda con el PHP, a ver si se anima y nos postea alguna cosilla 😉

Update: Openinviter con ActionScript 2.0 (AS2.0)

Pese a que ActionScript 2.0 esta muy mayor y hace tiempo que quedó desfasado, muchos diseñadores y flasheros lo siguen utilizando. De hecho en el blog nos pidieron poner este mismo ejemplo en AS2. Dicho y hecho, aqui os lo dejamos 🙂

Esta realizado con componentes UIComponent de ActionScript 2.0, como podéis apreciar la eficiencia es bastante mala :S

El código os lo podéis descargar desde aquí: Openinviter con ActionScript 2.0. Espero que te sirva noya 😉

Etiquetas: as3, facebook, flash, gmail, hotmail, openinviter, php, yahoo