Merge pull request #170 from OCA/16.0

Syncing from upstream OCA/connector-telephony (16.0)

README.md

@@ -21,6 +21,7 @@ Available addons
 ----------------
 addon | version | maintainers | summary
 --- | --- | --- | ---
+[asterisk_click2dial](asterisk_click2dial/) | 16.0.1.0.0 | [![alexis-via](https://github.com/alexis-via.png?size=30px)](https://github.com/alexis-via) | Asterisk-Odoo connector
 [base_phone](base_phone/) | 16.0.1.0.0 | [![alexis-via](https://github.com/alexis-via.png?size=30px)](https://github.com/alexis-via) | Validate phone numbers
 
 [//]: # (end addons)

asterisk_click2dial/README.rst

@@ -0,0 +1,144 @@
+==================
+Asterisk connector
+==================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:70c4fbe57dbcfd18cf15685ed8361c0af932e8f5c65668c39a947eeccfd1cc1e
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fconnector--telephony-lightgray.png?logo=github
+    :target: https://github.com/OCA/connector-telephony/tree/16.0/asterisk_click2dial
+    :alt: OCA/connector-telephony
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/connector-telephony-16-0/connector-telephony-16-0-asterisk_click2dial
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/connector-telephony&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+The technical name of this module is **asterisk_click2dial**, but this module
+implements much more than a simple *click2dial* ! This module adds 3
+functionalities:
+
+1. It adds a *Dial* button in the partner form view so that users can directly
+   dial a phone number through Asterisk. This feature is usually known as
+   *click2dial*. Here is how it works :
+
+   * In Odoo, the user clicks on the *Dial* button next to a phone number
+     field in the partner form view (or any form view with a phone number).
+
+   * Odoo connects to the Asterisk Manager Interface and Asterisk makes the
+     user's phone ring.
+
+   * The user answers his own phone (if he doesn't, the process stops here).
+
+   * Asterisk dials the phone number found in Odoo in place of the user.
+
+   * If the remote party answers, the user can talk to his correspondent.
+
+2. It adds the ability to show the name of the calling party on the screen of
+   your IP phone on incoming phone calls if the presented phone number is
+   present in the partner/leads/employees/... of Odoo. Here is how it works:
+
+   * On incoming phone calls, the Asterisk dialplan executes an AGI script
+     **set_name_incoming_timeout.sh**.
+
+   * The *set_name_incoming_timeout.sh* script calls the *set_name_agi.py*
+     script with a short timeout.
+
+   * The *set_name_agi.py* script will make an XML-RPC request on the Odoo
+     server to try to find the name of the person corresponding to the phone
+     number presented by the calling party.
+
+   * If it finds the name, it is set as the CallerID name of the call, so as
+     to be presented on the IP phone of the user.
+
+   It also works on outgoing calls, so as to display the name of the callee on
+   the SIP phone of the caller. For that, you should use the script
+   *set_name_outgoing_timeout.sh*.
+
+3. It adds a phone icon (*Open Caller*) in the top menu bar
+   to get the partner/lead/candidate/event registrations
+   corresponding to the calling party in one click. Here is how it works :
+
+   * When the user clicks on the phone icon, Odoo sends a query to the
+     Asterisk Manager Interface to get a list of the current phone calls.
+
+   * If it finds a phone call involving the user's phone, it gets the phone
+     number of the calling party.
+
+   * It searches the phone number of the calling party in the
+     Partners/Leads/Candidates/Event Registrations of Odoo. If a record matches,
+     it takes you to the form view of this record. If no record matchs, it
+     opens a wizard which proposes to create a new Partner with the presented
+     phone number as *Phone* or *Mobile* number or update an existing Partner.
+
+   It is possible to get a pop-up of the record corresponding to the calling
+   party without any action from the user via the module *base_phone_popup*.
+
+A detailed documentation for this module is available on `this page <http://www.akretion.com/products-and-services/openerp-asterisk-voip-connector>`_ of Akretion's Web site.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/connector-telephony/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/connector-telephony/issues/new?body=module:%20asterisk_click2dial%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+~~~~~~~
+
+* Akretion
+
+Contributors
+~~~~~~~~~~~~
+
+* Alexis de Lattre <[email protected]>
+
+Maintainers
+~~~~~~~~~~~
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+.. |maintainer-alexis-via| image:: https://github.com/alexis-via.png?size=40px
+    :target: https://github.com/alexis-via
+    :alt: alexis-via
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-alexis-via| 
+
+This module is part of the `OCA/connector-telephony <https://github.com/OCA/connector-telephony/tree/16.0/asterisk_click2dial>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

asterisk_click2dial/__init__.py

@@ -0,0 +1,2 @@
+from . import models
+from . import controller

asterisk_click2dial/__manifest__.py

@@ -0,0 +1,33 @@
+# Copyright 2010-2021 Akretion France (http://www.akretion.com/)
+# @author: Alexis de Lattre <[email protected]>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Asterisk connector",
+    "version": "16.0.1.0.0",
+    "category": "Phone",
+    "license": "AGPL-3",
+    "summary": "Asterisk-Odoo connector",
+    "author": "Akretion,Odoo Community Association (OCA)",
+    "maintainers": ["alexis-via"],
+    "website": "https://github.com/OCA/connector-telephony",
+    "depends": ["base_phone"],
+    "external_dependencies": {"python": ["requests"]},
+    "data": [
+        "views/asterisk_server.xml",
+        "views/res_users.xml",
+        "security/ir.model.access.csv",
+        "security/asterisk_security.xml",
+    ],
+    "demo": ["demo/asterisk_click2dial_demo.xml"],
+    "qweb": ["static/src/xml/asterisk_click2dial.xml"],
+    "application": True,
+    "installable": True,
+    "assets": {
+        "web.assets_backend": [
+            "asterisk_click2dial/static/src/scss/*.scss",
+            "asterisk_click2dial/static/src/components/**/*.js",
+            "asterisk_click2dial/static/src/components/**/*.xml",
+        ],
+    },
+}

asterisk_click2dial/controller.py

@@ -0,0 +1,15 @@
+# Copyright 2014-2021 Akretion France (http://www.akretion.com/)
+# @author: Alexis de Lattre <[email protected]>
+# Copyright 2015-2018 Juris Malinens (port to v9)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from odoo import http
+
+
+class AsteriskClick2dialController(http.Controller):
+    @http.route(
+        "/asterisk_click2dial/get_record_from_my_channel", type="json", auth="user"
+    )
+    def get_record_from_my_channel(self, **kw):
+        res = http.request.env["asterisk.server"].get_record_from_my_channel()
+        return res

asterisk_click2dial/demo/asterisk_click2dial_demo.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!--
+  Copyright 2010-2021 Akretion France (http://www.akretion.com/)
+  @author: Alexis de Lattre <[email protected]>
+  License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+-->
+<odoo noupdate="1">
+
+
+<record id="demo_ast_server" model="asterisk.server">
+    <field name="name">My Asterisk</field>
+    <field name="ip_address">localhost</field>
+    <field name="login">odoo</field>
+    <field name="password">mypassword</field>
+    <field name="context">from-internal</field>
+    <field name="alert_info">info=&lt;Bellcore-dr5&gt;</field>
+    <field name="company_id" ref="base.main_company" />
+</record>
+
+<record id="base.user_admin" model="res.users">
+    <field name="internal_number">11</field>
+    <field name="resource">11</field>
+    <field name="callerid">Administrator &lt;0141981242&gt;</field>
+    <field name="asterisk_server_id" ref="demo_ast_server" />
+</record>
+
+<record id="base.user_demo" model="res.users">
+    <field name="internal_number">12</field>
+    <field name="resource">12</field>
+    <field name="callerid">Demo user &lt;0141984212&gt;</field>
+    <field name="asterisk_server_id" ref="demo_ast_server" />
+</record>
+
+
+</odoo>