addons/mail/mail_group.py

   1 # -*- coding: utf-8 -*-
   2 ##############################################################################
   3 #
   4 #    OpenERP, Open Source Management Solution
   5 #    Copyright (C) 2010-today OpenERP SA (<http://www.openerp.com>)
   6 #
   7 #    This program is free software: you can redistribute it and/or modify
   8 #    it under the terms of the GNU Affero General Public License as
   9 #    published by the Free Software Foundation, either version 3 of the
  10 #    License, or (at your option) any later version
  11 #
  12 #    This program is distributed in the hope that it will be useful,
  13 #    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 #    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 #    GNU Affero General Public License for more details
  16 #
  17 #    You should have received a copy of the GNU Affero General Public License
  18 #    along with this program.  If not, see <http://www.gnu.org/licenses/>
  19 #
  20 ##############################################################################
  21
  22 import openerp
  23 import openerp.tools as tools
  24 from openerp.osv import osv
  25 from openerp.osv import fields
  26 from openerp import SUPERUSER_ID
  27
  28
  29 class mail_group(osv.Model):
  30     """ A mail_group is a collection of users sharing messages in a discussion
  31         group. The group mechanics are based on the followers. """
  32     _description = 'Discussion group'
  33     _name = 'mail.group'
  34     _mail_flat_thread = False
  35     _inherit = ['mail.thread']
  36     _inherits = {'mail.alias': 'alias_id'}
  37
  38     def _get_image(self, cr, uid, ids, name, args, context=None):
  39         result = dict.fromkeys(ids, False)
  40         for obj in self.browse(cr, uid, ids, context=context):
  41             result[obj.id] = tools.image_get_resized_images(obj.image)
  42         return result
  43
  44     def _set_image(self, cr, uid, id, name, value, args, context=None):
  45         return self.write(cr, uid, [id], {'image': tools.image_resize_image_big(value)}, context=context)
  46
  47     _columns = {
  48         'name': fields.char('Name', size=64, required=True, translate=True),
  49         'description': fields.text('Description'),
  50         'menu_id': fields.many2one('ir.ui.menu', string='Related Menu', required=True, ondelete="cascade"),
  51         'public': fields.selection([('public', 'Public'), ('private', 'Private'), ('groups', 'Selected Group Only')], 'Privacy', required=True,
  52             help='This group is visible by non members. \
  53             Invisible groups can add members through the invite button.'),
  54         'group_public_id': fields.many2one('res.groups', string='Authorized Group'),
  55         'group_ids': fields.many2many('res.groups', rel='mail_group_res_group_rel',
  56             id1='mail_group_id', id2='groups_id', string='Auto Subscription',
  57             help="Members of those groups will automatically added as followers. "\
  58                  "Note that they will be able to manage their subscription manually "\
  59                  "if necessary."),
  60         # image: all image fields are base64 encoded and PIL-supported
  61         'image': fields.binary("Photo",
  62             help="This field holds the image used as photo for the group, limited to 1024x1024px."),
  63         'image_medium': fields.function(_get_image, fnct_inv=_set_image,
  64             string="Medium-sized photo", type="binary", multi="_get_image",
  65             store={
  66                 'mail.group': (lambda self, cr, uid, ids, c={}: ids, ['image'], 10),
  67             },
  68             help="Medium-sized photo of the group. It is automatically "\
  69                  "resized as a 128x128px image, with aspect ratio preserved. "\
  70                  "Use this field in form views or some kanban views."),
  71         'image_small': fields.function(_get_image, fnct_inv=_set_image,
  72             string="Small-sized photo", type="binary", multi="_get_image",
  73             store={
  74                 'mail.group': (lambda self, cr, uid, ids, c={}: ids, ['image'], 10),
  75             },
  76             help="Small-sized photo of the group. It is automatically "\
  77                  "resized as a 64x64px image, with aspect ratio preserved. "\
  78                  "Use this field anywhere a small image is required."),
  79         'alias_id': fields.many2one('mail.alias', 'Alias', ondelete="restrict", required=True,
  80             help="The email address associated with this group. New emails received will automatically "
  81                  "create new topics."),
  82     }
  83
  84     def _get_default_employee_group(self, cr, uid, context=None):
  85         ref = self.pool.get('ir.model.data').get_object_reference(cr, uid, 'base', 'group_user')
  86         return ref and ref[1] or False
  87
  88     def _get_default_image(self, cr, uid, context=None):
  89         image_path = openerp.modules.get_module_resource('mail', 'static/src/img', 'groupdefault.png')
  90         return tools.image_resize_image_big(open(image_path, 'rb').read().encode('base64'))
  91
  92     _defaults = {
  93         'public': 'groups',
  94         'group_public_id': _get_default_employee_group,
  95         'image': _get_default_image,
  96     }
  97
  98     def _generate_header_description(self, cr, uid, group, context=None):
  99         header = ''
 100         if group.description:
 101             header = '%s' % group.description
 102         if group.alias_id and group.alias_name and group.alias_domain:
 103             if header:
 104                 header = '%s<br/>' % header
 105             return '%sGroup email gateway: %s@%s' % (header, group.alias_name, group.alias_domain)
 106         return header
 107
 108     def _subscribe_users(self, cr, uid, ids, context=None):
 109         for mail_group in self.browse(cr, uid, ids, context=context):
 110             partner_ids = []
 111             for group in mail_group.group_ids:
 112                 partner_ids += [user.partner_id.id for user in group.users]
 113             self.message_subscribe(cr, uid, ids, partner_ids, context=context)
 114
 115     def create(self, cr, uid, vals, context=None):
 116         if context is None:
 117             context = {}
 118
 119         # get parent menu
 120         menu_parent = self.pool.get('ir.model.data').get_object_reference(cr, uid, 'mail', 'mail_group_root')
 121         menu_parent = menu_parent and menu_parent[1] or False
 122
 123         # Create menu id
 124         mobj = self.pool.get('ir.ui.menu')
 125         menu_id = mobj.create(cr, SUPERUSER_ID, {'name': vals['name'], 'parent_id': menu_parent}, context=context)
 126         vals['menu_id'] = menu_id
 127
 128         # Create group and alias
 129         create_context = dict(context, alias_model_name=self._name, alias_parent_model_name=self._name)
 130         mail_group_id = super(mail_group, self).create(cr, uid, vals, context=create_context)
 131         group = self.browse(cr, uid, mail_group_id, context=context)
 132         self.pool.get('mail.alias').write(cr, uid, [group.alias_id.id], {"alias_force_thread_id": mail_group_id, 'alias_parent_thread_id': mail_group_id}, context)
 133         group = self.browse(cr, uid, mail_group_id, context=context)
 134
 135         # Create client action for this group and link the menu to it
 136         ref = self.pool.get('ir.model.data').get_object_reference(cr, uid, 'mail', 'action_mail_group_feeds')
 137         if ref:
 138             search_ref = self.pool.get('ir.model.data').get_object_reference(cr, uid, 'mail', 'view_message_search')
 139             params = {
 140                 'search_view_id': search_ref and search_ref[1] or False,
 141                 'domain': [
 142                     ('model', '=', 'mail.group'),
 143                     ('res_id', '=', mail_group_id),
 144                 ],
 145                 'context': {
 146                     'default_model': 'mail.group',
 147                     'default_res_id': mail_group_id,
 148                 },
 149                 'res_model': 'mail.message',
 150                 'thread_level': 1,
 151                 'header_description': self._generate_header_description(cr, uid, group, context=context),
 152                 'view_mailbox': True,
 153                 'compose_placeholder': 'Send a message to the group',
 154             }
 155             cobj = self.pool.get('ir.actions.client')
 156             newref = cobj.copy(cr, SUPERUSER_ID, ref[1], default={'params': str(params), 'name': vals['name']}, context=context)
 157             mobj.write(cr, SUPERUSER_ID, menu_id, {'action': 'ir.actions.client,' + str(newref), 'mail_group_id': mail_group_id}, context=context)
 158
 159         if vals.get('group_ids'):
 160             self._subscribe_users(cr, uid, [mail_group_id], context=context)
 161         return mail_group_id
 162
 163     def unlink(self, cr, uid, ids, context=None):
 164         groups = self.browse(cr, uid, ids, context=context)
 165         # Cascade-delete mail aliases as well, as they should not exist without the mail group.
 166         mail_alias = self.pool.get('mail.alias')
 167         alias_ids = [group.alias_id.id for group in groups if group.alias_id]
 168         # Delete mail_group
 169         res = super(mail_group, self).unlink(cr, uid, ids, context=context)
 170         # Delete alias
 171         mail_alias.unlink(cr, SUPERUSER_ID, alias_ids, context=context)
 172         # Cascade-delete menu entries as well
 173         self.pool.get('ir.ui.menu').unlink(cr, SUPERUSER_ID, [group.menu_id.id for group in groups if group.menu_id], context=context)
 174         return res
 175
 176     def write(self, cr, uid, ids, vals, context=None):
 177         result = super(mail_group, self).write(cr, uid, ids, vals, context=context)
 178         if vals.get('group_ids'):
 179             self._subscribe_users(cr, uid, ids, context=context)
 180         # if description, name or alias is changed: update client action
 181         if vals.get('description') or vals.get('name') or vals.get('alias_id') or vals.get('alias_name'):
 182             cobj = self.pool.get('ir.actions.client')
 183             for action in [group.menu_id.action for group in self.browse(cr, uid, ids, context=context)]:
 184                 new_params = action.params
 185                 new_params['header_description'] = self._generate_header_description(cr, uid, group, context=context)
 186                 cobj.write(cr, SUPERUSER_ID, [action.id], {'params': str(new_params)}, context=context)
 187         # if name is changed: update menu
 188         if vals.get('name'):
 189             mobj = self.pool.get('ir.ui.menu')
 190             mobj.write(cr, SUPERUSER_ID,
 191                 [group.menu_id.id for group in self.browse(cr, uid, ids, context=context)],
 192                 {'name': vals.get('name')}, context=context)
 193
 194         return result
 195
 196     def action_follow(self, cr, uid, ids, context=None):
 197         """ Wrapper because message_subscribe_users take a user_ids=None
 198             that receive the context without the wrapper. """
 199         return self.message_subscribe_users(cr, uid, ids, context=context)
 200
 201     def action_unfollow(self, cr, uid, ids, context=None):
 202         """ Wrapper because message_unsubscribe_users take a user_ids=None
 203             that receive the context without the wrapper. """
 204         return self.message_unsubscribe_users(cr, uid, ids, context=context)
 205
 206     def get_suggested_thread(self, cr, uid, removed_suggested_threads=None, context=None):
 207         """Show the suggestion of groups if display_groups_suggestions if the
 208         user perference allows it."""
 209         user = self.pool.get('res.users').browse(cr, uid, uid, context)
 210         if not user.display_groups_suggestions:
 211             return []
 212         else:
 213             return super(mail_group, self).get_suggested_thread(cr, uid, removed_suggested_threads, context)