# HG changeset patch
# User Lennard de Rijk <ljvderijk@gmail.com>
# Date 1248461768 -7200
# Node ID a7fabd1534f8b4290242184ea516ea95f61aff98
# Parent  49cf6a8af70af7924cadc74a8233b90107b468a2
Added sendNewRequestNotification to the Notifications helper.

This method will send out a notification upon arrival of a new Request to all users who have an active role for the Request's scope and the roles as specified by the getRoleLogicsToNotifyUponNewRequest.

Also renamed getRoleLogicsToNotifyUponeNewRequest to getRoleLogicsToNotifyUponNewRequest.

diff -r 49cf6a8af70a -r a7fabd1534f8 app/soc/logic/helper/notifications.py
--- a/app/soc/logic/helper/notifications.py	Fri Jul 24 20:49:59 2009 +0200
+++ b/app/soc/logic/helper/notifications.py	Fri Jul 24 20:56:08 2009 +0200
@@ -43,6 +43,9 @@
 DEF_INVITATION_MSG_FMT = ugettext(
     "Invitation to become a %(role_verbose)s for %(group)s.")
 
+DEF_NEW_REQUEST_MSG_FMT = ugettext(
+    "New Request Received from %(requester)s to become a %(role_verbose)s for %(group)s")
+
 DEF_NEW_GROUP_MSG_FMT = ugettext(
     "Your %(application_type)s for %(group_name)s has been accepted.")
 
@@ -54,6 +57,9 @@
 DEF_GROUP_INVITE_NOTIFICATION_TEMPLATE = 'soc/notification/messages/' \
     'invitation.html'
 
+DEF_NEW_REQUEST_NOTIFICATION_TEMPLATE = 'soc/notification/messages/' \
+    'new_request.html'
+
 DEF_NEW_REVIEW_NOTIFICATION_TEMPLATE = 'soc/notification/messages/' \
     'new_review.html'
 
@@ -96,6 +102,57 @@
   sendNotification(to_user, from_user, message_properties, subject, template)
 
 
+def sendNewRequestNotification(request_entity):
+  """Sends out a notification to the persons who can process this Request.
+
+  Args:
+    request_entity: an instance of Request model
+  """
+
+  from soc.logic.helper import notifications
+  from soc.logic.models.role import ROLE_LOGICS
+  from soc.logic.models.user import logic as user_logic
+
+  # get the users who should get the notification
+  to_users = []
+
+  # retrieve the Role Logics which we should query on
+  role_logic = ROLE_LOGICS[request_entity.role]
+  role_logics_to_notify = role_logic.getRoleLogicsToNotifyUponNewRequest()
+
+  # the scope of the roles is the same as the scope of the Request entity
+  fields = {'scope': request_entity.scope,
+            'status': 'active'}
+
+  for role_logic in role_logics_to_notify:
+    roles = role_logic.getForFields(fields)
+
+    for role_entity in roles:
+      # TODO: this might lead to double notifications
+      to_users.append(role_entity.user)
+
+  # get the user the request is from
+  properties = {'link_id': request_entity.link_id }
+  user_entity = user_logic.getForFields(properties, unique=True)
+
+  message_properties = {
+      'requester_name': user_entity.name,
+      'entity': request_entity,
+      'request_url': redirects.getProcessRequestRedirect(request_entity, None)}
+
+  subject = DEF_NEW_REQUEST_MSG_FMT % {
+      'requester': user_entity.name,
+      'role_verbose' : request_entity.role_verbose,
+      'group' : request_entity.scope.name
+      }
+
+  template = DEF_NEW_REQUEST_NOTIFICATION_TEMPLATE
+
+  for to_user in to_users:
+    notifications.sendNotification(to_user, None, message_properties,
+                                   subject, template)
+
+
 def sendNewGroupNotification(entity, params):
   """Sends out an invite notification to the applicant of the group.
 
diff -r 49cf6a8af70a -r a7fabd1534f8 app/soc/logic/models/club_member.py
--- a/app/soc/logic/models/club_member.py	Fri Jul 24 20:49:59 2009 +0200
+++ b/app/soc/logic/models/club_member.py	Fri Jul 24 20:56:08 2009 +0200
@@ -44,7 +44,7 @@
                                 role_name=role_name,
                                 disallow_last_resign=disallow_last_resign)
 
-  def getRoleLogicsToNotifyUponeNewRequest(self):
+  def getRoleLogicsToNotifyUponNewRequest(self):
     """Returns a list with ClubAdmin logic which can be used to notify all
     appropriate Club Admins.
     """
diff -r 49cf6a8af70a -r a7fabd1534f8 app/soc/logic/models/mentor.py
--- a/app/soc/logic/models/mentor.py	Fri Jul 24 20:49:59 2009 +0200
+++ b/app/soc/logic/models/mentor.py	Fri Jul 24 20:56:08 2009 +0200
@@ -117,7 +117,7 @@
 
     return super(Logic, self)._updateField(entity, entity_properties, name)
 
-  def getRoleLogicsToNotifyUponeNewRequest(self):
+  def getRoleLogicsToNotifyUponNewRequest(self):
     """Returns a list with OrgAdmin logic which can be used to notify all
     appropriate Organization Admins.
     """
diff -r 49cf6a8af70a -r a7fabd1534f8 app/soc/logic/models/role.py
--- a/app/soc/logic/models/role.py	Fri Jul 24 20:49:59 2009 +0200
+++ b/app/soc/logic/models/role.py	Fri Jul 24 20:56:08 2009 +0200
@@ -139,7 +139,7 @@
     # resignation is possible
     return None
 
-  def getRoleLogicsToNotifyUponeNewRequest(self):
+  def getRoleLogicsToNotifyUponNewRequest(self):
     """Returns a list with subclasses of Role Logic which should be notified
     when a new request to obtain this Role arrives.