You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

99 lines
3.3 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  3. :alt: License: AGPL-3
  4. ==========
  5. Base Phone
  6. ==========
  7. This module validate phone numbers using the *phonenumbers* Python library,
  8. which is a port of the library used in Android smartphones. For example, if
  9. your user is linked to a French company and you update the form view of a
  10. partner with a badly written French phone number such as '01-55-42-12-42',
  11. Odoo will automatically update the phone number to E.164 format '+33155421242'
  12. and display in the form and tree view of the partner the readable equivalent
  13. '+33 1 55 42 12 42'.
  14. This module also adds *tel:* links on phone numbers and *fax:* links on fax
  15. numbers. If you have a softphone or a client software on your PC that is
  16. associated with *tel:* links, the softphone should propose you to dial the
  17. phone number when you click on such a link.
  18. This module also updates the format() function for reports and adds 2
  19. arguments :
  20. * *phone* : should be True for a phone number, False (default) otherwize.
  21. * *phone_format* : it can have 3 possible values :
  22. * *international* (default) : the report will display '+33 1 55 42 12 42'
  23. * *national* : the report will display '01 55 42 12 42'
  24. * *e164* : the report will display '+33155421242'
  25. For example, in the Sale Order report, to display the phone number of the
  26. Salesman, you can write : o.user_id and o.user_id.phone and
  27. format(o.user_id.phone, phone=True, phone_format='national') or ''
  28. This module is independant from the Asterisk connector.
  29. Please contact Alexis de Lattre from Akretion <alexis.delattre@akretion.com>
  30. for any help or question about this module.
  31. Installation
  32. ============
  33. There is no specific installation procedure for this module.
  34. Configuration
  35. =============
  36. There is no specific configuration procedure for this module.
  37. Usage
  38. =====
  39. There is no specific usage procedure for this module.
  40. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  41. :alt: Try me on Runbot
  42. :target: https://runbot.odoo-community.org/runbot/{repo_id}/9.0
  43. Known issues / Roadmap
  44. ======================
  45. * ...
  46. Bug Tracker
  47. ===========
  48. Bugs are tracked on `GitHub Issues
  49. <https://github.com/OCA/{project_repo}/issues>`_. In case of trouble, please
  50. check there if your issue has already been reported. If you spotted it first,
  51. help us smashing it by providing a detailed and welcomed `feedback
  52. <https://github.com/OCA/connector-telephony/issues/new?body=module:%20base_phone%0Aversion:%209.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  53. Credits
  54. =======
  55. Images
  56. ------
  57. * Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.
  58. Contributors
  59. ------------
  60. * Alexis de Lattre <alexis.delattre@akretion.com>
  61. Maintainer
  62. ----------
  63. .. image:: https://odoo-community.org/logo.png
  64. :alt: Odoo Community Association
  65. :target: https://odoo-community.org
  66. This module is maintained by the OCA.
  67. OCA, or the Odoo Community Association, is a nonprofit organization whose
  68. mission is to support the collaborative development of Odoo features and
  69. promote its widespread use.
  70. To contribute to this module, please visit https://odoo-community.org.