diff --git a/document_page_approval/__init__.py b/document_page_approval/__init__.py new file mode 100644 index 00000000..bd56742e --- /dev/null +++ b/document_page_approval/__init__.py @@ -0,0 +1,24 @@ +# -*- encoding: utf-8 -*- +############################################################################## +# +# OpenERP, Open Source Management Solution +# Copyright (C) 2013 Savoir-faire Linux (). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Affero General Public License as +# published by the Free Software Foundation, either version 3 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Affero General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see . +# +############################################################################## + +import document_page_approval + +# vim:expandtab:smartindent:tabstop=4:softtabstop=4:shiftwidth=4: diff --git a/document_page_approval/__openerp__.py b/document_page_approval/__openerp__.py new file mode 100644 index 00000000..22a9559e --- /dev/null +++ b/document_page_approval/__openerp__.py @@ -0,0 +1,42 @@ +# -*- encoding: utf-8 -*- +############################################################################## +# +# OpenERP, Open Source Management Solution +# Copyright (C) 2013 Savoir-faire Linux (). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Affero General Public License as +# published by the Free Software Foundation, either version 3 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Affero General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see . +# +############################################################################## + +{ + 'name': 'Document Page Approval', + 'version': '1.0', + "author" : "Savoir-faire Linux", + "website" : "http://www.savoirfairelinux.com", + "license" : "AGPL-3", + 'category': 'Knowledge Management', + 'description': """ +Add a workflow to approve page modification and show the approved version by default + """, + 'depends': ['document_page', 'email_template'], + 'update_xml': ['document_page_wkfl.xml','document_page_view.xml'], + 'installable': True, + 'auto_install': False, + 'images': [], + 'data': [ + 'security/document_page_security.xml', + 'security/ir.model.access.csv', + ] +} +# vim:expandtab:smartindent:tabstop=4:softtabstop=4:shiftwidth=4: diff --git a/document_page_approval/document_page_approval.py b/document_page_approval/document_page_approval.py new file mode 100644 index 00000000..20d8af0a --- /dev/null +++ b/document_page_approval/document_page_approval.py @@ -0,0 +1,197 @@ +# -*- encoding: utf-8 -*- +############################################################################## +# +# OpenERP, Open Source Management Solution +# Copyright (C) 2013 Savoir-faire Linux (). +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Affero General Public License as +# published by the Free Software Foundation, either version 3 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Affero General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see . +# +############################################################################## +from openerp.osv import fields, orm +from datetime import * + +class document_page_history_wkfl(orm.Model): + _inherit = 'document.page.history' + + def page_approval_draft(self, cr, uid, ids): + self.write(cr, uid, ids, { 'state' : 'draft' }) + + template_id = self.pool.get('ir.model.data').get_object_reference(cr, uid, 'document_page_approval', 'email_template_new_draft_need_approval')[1] + for page in self.browse(cr, uid, ids): + if page.is_parent_approval_required: + self.pool.get('email.template').send_mail(cr, uid, template_id, page.id, force_send=True) + + return True + + def page_approval_approved(self, cr, uid, ids): + self.write(cr, uid, ids, { 'state' : 'approved', + 'approved_date' : datetime.now().strftime('%Y-%m-%d %H:%M:%S'), + 'approved_uid': uid + }) + return True + + def can_user_approve_page(self, cr, uid, ids, name, args, context=None): + user = self.pool.get('res.users').browse(cr,uid,uid) + res = {} + for page in self.browse(cr, uid, ids, context=context): + res[page.id]= self.can_user_approve_this_page(page.page_id, user) + + return res + + def can_user_approve_this_page(self, page, user): + if page: + res = page.approver_gid in user.groups_id + res = res or self.can_user_approve_this_page(page.parent_id, user) + else: + res=False + + return res + + def get_approvers_guids(self, cr, uid, ids, name, args, context=None): + res = {} + for page in self.browse(cr, uid, ids, context=context): + res[page.id]= self.get_approvers_guids_for_page(page.page_id) + + return res + + def get_approvers_guids_for_page(self, page): + if page: + if page.approver_gid: + res = [page.approver_gid.id] + else: + res=[] + res.extend(self.get_approvers_guids_for_page(page.parent_id)) + else: + res=[] + + return res + + def get_approvers_email(self, cr, uid, ids, name, args, context): + res = {} + for id in ids: + emails = '' + guids = self.get_approvers_guids(cr, uid, ids, name, args, context=context) + uids = self.pool.get('res.users').search(cr, uid, [('groups_id','in',guids[id])]) + users = self.pool.get('res.users').browse(cr, uid, uids) + + for user in users: + if user.user_email: + emails += user.user_email + emails += ',' + else: + empl_id = self.pool.get('hr.employee').search(cr, uid,[('login','=',user.login)])[0] + empl = self.pool.get('hr.employee').browse(cr, uid, empl_id) + if empl.work_email: + emails += empl.work_email + emails += ',' + + emails = emails[:-1] + res[id] = emails + return res + + def get_page_url(self, cr, uid, ids, name, args, context): + res = {} + for id in ids: + base_url = self.pool.get('ir.config_parameter').get_param(cr, uid, 'web.base.url', default='http://localhost:8069', context=context) + + res[id] = base_url + '/#db=%s&id=%s&view_type=form&model=document.page.history' % (cr.dbname, id); + + return res + + _columns = { + 'state': fields.selection([ + ('draft','Draft'), + ('approved','Approved')], 'Status', readonly=True), + 'approved_date': fields.datetime("Approved Date"), + 'approved_uid': fields.many2one('res.users', "Approved By"), + 'is_parent_approval_required': fields.related('page_id', 'is_parent_approval_required', string="parent approval", type='boolean', store=False), + 'can_user_approve_page': fields.function(can_user_approve_page, string="can user approve this page", type='boolean', store=False), + 'get_approvers_email': fields.function(get_approvers_email, string="get all approvers email", type='text', store=False), + 'get_page_url': fields.function(get_page_url, string="get page url", type='text', store=False), + } + +class document_page_approval(orm.Model): + _inherit = 'document.page' + def _get_display_content(self, cr, uid, ids, name, args, context=None): + res = {} + for page in self.browse(cr, uid, ids, context=context): + content="" + if page.type == "category": + content = self._get_page_index(cr, uid, page, link=False) + else: + history = self.pool.get('document.page.history') + if self.is_approval_required(page): + history_ids = history.search(cr, uid,[('page_id', '=', page.id), ('state', '=', 'approved')], limit=1, order='create_date DESC') + for h in history.browse(cr, uid, history_ids): + content = h.content + else: + content = page.content + res[page.id] = content + return res + + def _get_approved_date(self, cr, uid, ids, name, args, context=None): + res = {} + for page in self.browse(cr, uid, ids, context=context): + if self.is_approval_required(page): + history = self.pool.get('document.page.history') + history_ids = history.search(cr, uid,[('page_id', '=', page.id), ('state', '=', 'approved')], limit=1, order='create_date DESC') + approved_date = False + for h in history.browse(cr, uid, history_ids): + approved_date = h.approved_date + res[page.id] = approved_date + else: + res[page.id] = "" + + return res + + def _get_approved_uid(self, cr, uid, ids, name, args, context=None): + res = {} + for page in self.browse(cr, uid, ids, context=context): + if self.is_approval_required(page): + history = self.pool.get('document.page.history') + history_ids = history.search(cr, uid,[('page_id', '=', page.id), ('state', '=', 'approved')], limit=1, order='create_date DESC') + approved_uid = False + for h in history.browse(cr, uid, history_ids): + approved_uid = h.approved_uid.id + res[page.id] = approved_uid + else: + res[page.id] = "" + + return res + + def _is_parent_approval_required(self, cr, uid, ids, name, args, context=None): + res = {} + for page in self.browse(cr, uid, ids, context=context): + res[page.id]= self.is_approval_required(page) + + return res + + def is_approval_required(self, page): + if page: + res = page.approval_required + res = res or self.is_approval_required(page.parent_id) + else: + res=False + + return res + + _columns = { + 'display_content': fields.function(_get_display_content, string='Displayed Content', type='text'), + 'approved_date': fields.function(_get_approved_date, string="Approved Date", type='datetime'), + 'approved_uid': fields.function(_get_approved_uid, string="Approved By", type='many2one', obj='res.users'), + 'approval_required': fields.boolean("Require approval"), + 'is_parent_approval_required': fields.function(_is_parent_approval_required, string="parent approval", type='boolean'), + 'approver_gid': fields.many2one("res.groups", "Approver group"), + } +# vim:expandtab:smartindent:tabstop=4:softtabstop=4:shiftwidth=4: diff --git a/document_page_approval/document_page_view.xml b/document_page_approval/document_page_view.xml new file mode 100644 index 00000000..afaa9fbf --- /dev/null +++ b/document_page_approval/document_page_view.xml @@ -0,0 +1,50 @@ + + + + + document.page.history.form + document.page.history + + + +
+ +
+
+
+
+ + + document.page.form + document.page + + + + + + + + + + + + + + + document.page.history.tree + document.page.history + + + + + + + + +
+
diff --git a/document_page_approval/document_page_wkfl.xml b/document_page_approval/document_page_wkfl.xml new file mode 100644 index 00000000..4ee782c7 --- /dev/null +++ b/document_page_approval/document_page_wkfl.xml @@ -0,0 +1,66 @@ + + + + + document.page.history.aproval.wkf + document.page.history + True + + + + + True + draft + function + page_approval_draft() + + + + + approved + function + page_approval_approved() + True + + + + + + page_approval_approve + + + + + + edit + + + + Automated new draft need approval Notification Mail + ${object.create_uid.company_id.email or 'noreply@localhost.com'} + New version of "${object.page_id.name}" to approve + ${object.get_approvers_email} + + + ${object.employee_id.partner_id.lang} + + Hello,

+ +

The page "${object.page_id.name}" has been modified and need aprobation.

+ +

You can view the new version there: ${object.get_page_url}

+ + ]]> +
+ + +
+
+
diff --git a/document_page_approval/security/document_page_security.xml b/document_page_approval/security/document_page_security.xml new file mode 100644 index 00000000..7192d3f8 --- /dev/null +++ b/document_page_approval/security/document_page_security.xml @@ -0,0 +1,9 @@ + + + + + Document approver + + + + diff --git a/document_page_approval/security/ir.model.access.csv b/document_page_approval/security/ir.model.access.csv new file mode 100644 index 00000000..e4835836 --- /dev/null +++ b/document_page_approval/security/ir.model.access.csv @@ -0,0 +1,2 @@ +id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink +document_page_history,document.page.history,model_document_page_history,base.group_document_approver_user,1,1,1,0 \ No newline at end of file