Changes between Version 3 and Version 4 of suscripciones

Timestamp:

Jun 28, 2013, 1:57:04 PM (11 years ago)

Author:

Santos

Comment:

--

suscripciones

@@ -15 +15 @@
 [[Image(identificado y suscrito.png)]]
 
-== Cómo saber si un usuario está identificado ==
+== Cómo obtener información del usuario ==
 
-Podemos obtener los datos del usuario autenticado en un objeto javascript invocando la siguiente url http://www.ecliente.com/srv/users/getUserData un ejemplo de uso en una página podrría ser este:
+Podemos obtener los datos del usuario autenticado en un objeto javascript invocando la siguiente url http://www.ecliente.com/srv/users/getUserData un ejemplo de uso en una página podría ser este:
 {{{
 <script src="http://www.ecliente.com/srv/users/getUserData"></script>
+<script src="http://www.ecliente.com/users/js/userdata.js"></script>
 <script>
-  var userData;
-  if ( typeof __obj != 'undefined' && __obj.code == 0 ) // usuario autenticado
+  if ( isUserAuth() ) // usuario autenticado
   {
-    userData = __obj.data;
-    var nombre;
-    if ( typeof userData.nombre != 'undefined' )
+    var descripcion = getUserDescription(); // Cadena con "nombre apellidos" o "email"
+    var userData = getUserData(); // Hash con todos los datos del usuario
+    if ( isUserSubscribedBulletin ( bulletinId ) ) // Está el usuario suscrito a un boletín?
     {
-      nombre = userData.nombre;
     }
-    else if ( typeof userData.apellidos != 'undefined' )
+    if ( isUserSubscribedAlert ( alertaId ) ) // Está el usuario suscrito a una alerta web?
     {
-      nombre = userData.apellidos;
     }
-    else
+    if ( isUserTagged ( tagId ) ) // Tiene el usuario un tag?
     {
-      nombre = userData.mail;
     }
   }
@@ -47 +44 @@
 
 
-== Cómo saber si un usuario está suscrito ==
+== Formulario de alta ==
 
-Para recuperar las suscripciones de un usuario autenticado disponemos de la siguiente llamada http://www.ecliente.com/srv/subscriptions/getSubscriptions. Esta llamada devuelve una lista con todas las suscripciones del usuario. Hay además una biblioteca javascript para facilitar el manejo de la respuesta de este servicio. La librería es http://www.ecliente.com/subscriptions/js/subscriptions.js. Un ejemplo de uso sería el que sigue.
+El formulario de alta debe ejecutar la url http://www.ecliente.com/srv/registro/storeData
 
-{{{
-<script src="http://www.ecliente.com/srv/subscriptions/getSubscriptions"></script>
-<script src="http://www.ecliente.com/subscriptions/js/subscriptions.js"></script>
-<script>
-  var subscription = isUserSubscribed ( 1 ); // El parametro es el id del contenido al que queremos verificar si esta suscrito o no
-  if ( suscription ) // Esta suscrito
-  {
-    var periodicidad = suscription['periodicity'];
-    .
-    .
-    .
-  }
-  else // No esta suscrito
-  {
-  }
-</script>
-}}}
+Parámetros:
+* fileDescriptorId
+* urlOK: url a la que llevará después del doble opt-in (esta llamada redirige a la url que esté configurada en la tabla file_descriptors
+* value_<field_descriptor_id>: campos de la base de datos de usuarios
+* tag_<tag_id>: "1" poner tag, "0" quitar tag si el usuario ya existiera
+* subscribable_<subscribable_id>: "inmediate|daily|weekly|monthly" suscribir, "" dar de baja si el usuario ya existiera
+
+== Formulario de modificación ==
+
+El formulario de alta debe ejecutar la url http://www.ecliente.com/srv/registro/modifyData
+
+Parámetros:
+* fileDescriptorId
+* urlOK: url a la que redirige esta llamada si va bien
+* errorUrl: url a la que redirige esta llamada si va mal
+* value_<field_descriptor_id>: campos de la base de datos de usuarios
+* tag_<tag_id>: "1" poner tag, "0" quitar tag
+* subscribable_<subscribable_id>: "inmediate|daily|weekly|monthly" suscribir, "" dar de baja
+
+
+