INCUNA-notificación es una aplicación de Django para integrar el apoyo de notificación en su aplicación es un simple proceso de tres pasos.
- Crear sus tipos de notificación
- Crear sus plantillas de aviso
- Enviar notificaciones
Creación de tipos de Confidencialidad
Usted necesita llamar create_notice_type (etiqueta, visualización, descripción) una vez para crear los tipos de notificación para su aplicación en la base de datos. etiqueta es sólo el nombre corto interno que se utilizarán para el tipo, la pantalla es lo que el usuario verá como el nombre del tipo de notificación y la descripción es una breve descripción.
Por ejemplo:
notification.create_notice_type ("friends_invite", "Invitación recibido", "ustedes han recibido una invitación")
Una buena manera de hacerlo automáticamente este tipo de creación aviso está en un archivo management.py para su aplicación, que se adjunta a la señal syncdb. He aquí un ejemplo:
desde django.conf ajustes de importación
desde django.utils.translation ugettext_noop importación como _
si "notificación" en settings.INSTALLED_APPS:
& Nbsp; a partir de modelos de importación notificación notificación
& Nbsp; def create_notice_types (app, created_models, verbosidad, ** kwargs):
& Nbsp; notification.create_notice_type ("friends_invite", _ ("invitación recibida"), _ ("que ha recibido una invitación"))
& Nbsp; notification.create_notice_type ("friends_accept", _ ("Aceptación Recibida"), _ ("una invitación que envió ha sido aceptada"))
& Nbsp; signals.post_syncdb.connect (create_notice_types, remitente = notificación)
otra cosa:
& Nbsp; print "Saltarse creación de NoticeTypes como aplicación notificación no encontrado"
Observe que el código está envuelto en una cláusula condicional por lo que si la notificación no está instalado, su aplicación va a continuar de todos modos.
Tenga en cuenta que la pantalla y la descripción argumentos están marcados para su traducción utilizando ugettext_noop. Eso le permitirá utilizar el comando gestión makemessages de Django y capacidades i18n uso de notificación.
Plantillas de notificación
Hay cuatro plantillas diferentes que pueden ser escritas para el contenido real de los anuncios:
- Short.txt es una versión muy corta, de sólo texto del anuncio (adecuado para cosas como sujetos de correo electrónico)
- Full.txt es una versión más larga, de sólo texto del anuncio (adecuado para cosas como cuerpos de correo electrónico)
- Notice.html es un corto, versión html de la notificación, que se muestra en la lista de notificación de un usuario en el sitio web
- Full.html es una versión larga, html del anuncio (no se utiliza en la actualidad para cualquier cosa)
Cada uno de ellos debe ser puesto en un directorio en la ruta de plantilla llamada de notificación /
Por ejemplo, la notificación / friends_invite / notice.html podría contener:
{% Load i18n%} {% url invitaciones como invitation_page%} {% url profile_detail username = invitation.from_user.username como user_url%}
{% blocktrans con invitation.from_user como invitation_from_user%} {{invitation_from_user}} ha solicitado agregarte como amigo (ver invitaciones ) {% endblocktrans%}
y la notificación / friends_full.txt podría contener:
{% Load i18n%} {% url invitaciones como invitation_page%} {% blocktrans con invitation.from_user como invitation_from_user%} {{}} invitation_from_user ha solicitado agregarte como amigo. Puede aceptar su invitación en:
http: // {{current_site}} {{}} invitation_page
{Endblocktrans%%}
Se proporcionan las variables de contexto cuando se envía la notificación.
Notificación Envío
Hay dos formas diferentes de envío de notificaciones. Tenemos el apoyo para el bloqueo y los métodos de envío de notificaciones de no bloqueo. La forma más sencilla de enviar una notificación, por ejemplo:
notification.send ([to_user], "friends_invite", {"from_user": from_user})
Una cosa a tener en cuenta es que el envío es un proxy alrededor ya sea send_now o cola. Todos ellos tienen la misma firma:
enviar (usuarios, etiqueta, extra_context, on_site)
Los parámetros son:
- Los usuarios es un iterable de objetos de usuario para enviar la notificación a.
- Etiqueta es la etiqueta que utilizó en el paso anterior para identificar el tipo de aviso.
- Extra_content es un diccionario para añadir entradas contextuales personalizados a la plantilla que se utiliza para hacer la notificación. Esto es opcional.
- On_site es una bandera booleana para determinar si se crea un objeto de anuncio en la base de datos.
send_now vs. cola vs. envío
Permite primero romper lo que hace cada uno.
envía ahora
Esta es una llamada de bloqueo que comprobará cada usuario para elgibility de la notificación y, de hecho peform el envío.
cola
Este es un llamado no-bloqueo que pondrá en cola de la llamada a send_now para ser ejecutado en un momento posterior. Para ejecutar más tarde la llamada es necesario utilizar el comando gestión emit_notices.
enviar
Un proxy alrededor send_now y cola. Recibe su comportamiento desde un entorno global llamada NOTIFICATION_QUEUE_ALL. Por defecto es Falso. Este ajuste está destinado a ayudar a controlar si desea hacer cola toda llamada para enviar.
enviar también acepta ahora y Cola argumentos de palabra clave. Por defecto cada opción se establece en False para honrar la configuración global que es falso. Esto le permite anular en una base por llamada si debe llamar send_now o cola.
Soporte notificación opcional
En caso de que quiera utilizar la notificación en su aplicación reutilizable, se puede envolver la importación de notificación en una cláusula condicional que comprueba si está instalado antes de enviar un aviso. Como resultado de su aplicación o proyecto sigue funcionando sin notificación.
Por ejemplo:
desde django.conf ajustes de importación
si "notificación" en settings.INSTALLED_APPS:
& Nbsp; a partir de modelos de importación notificación notificación
otra cosa:
& Nbsp; notificación = Ninguno
y luego, más tarde:
si la notificación:
& Nbsp; notification.send ([to_user], "friends_invite" {"from_user": from_user})
Requisitos :
- Python
- Django
Comentarios que no se encuentran