From cd03a36acef4f7f56247cbb9d3a09116046f5702 Mon Sep 17 00:00:00 2001 From: OCA-git-bot Date: Tue, 11 Feb 2020 15:49:58 +0000 Subject: [PATCH] [UPD] README.rst --- pos_customer_required/README.rst | 123 +++++ .../static/description/index.html | 472 ++++++++++++++++++ 2 files changed, 595 insertions(+) create mode 100644 pos_customer_required/README.rst create mode 100644 pos_customer_required/static/description/index.html diff --git a/pos_customer_required/README.rst b/pos_customer_required/README.rst new file mode 100644 index 00000000..06fd6a30 --- /dev/null +++ b/pos_customer_required/README.rst @@ -0,0 +1,123 @@ +============================== +Point of Sale Require Customer +============================== + +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |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%2Fpos-lightgray.png?logo=github + :target: https://github.com/OCA/pos/tree/12.0/pos_customer_required + :alt: OCA/pos +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/pos-12-0/pos-12-0-pos_customer_required + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png + :target: https://runbot.odoo-community.org/runbot/184/12.0 + :alt: Try me on Runbot + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module was written to extend the functionality of odoo pos +and allows you to require a customer for each pos order. In the +pos session configuration, you can choose to require the customer for pos +orders. + +If a customer is not selected, the pos ui will display an error message. +In the backend the customer field is required when needed. + +Two new options are available: + +* Customer 'Required before starting the order'; +* Customer 'Required before paying'; + +'Required before starting the order' Option +------------------------------------------- +In the frontend PoS, the default screen is the screen to select customers. + +* Users are not allowed to start selling before having selected a customer; +* Users can not 'deselect a customer', only select an other one; + +'Required before paying' Option +------------------------------- +In the frontend PoS, the user can start selling, but if the user tries to +make payment and if a customer is not selected, the pos ui will display an +error message. + + +.. image:: https://raw.githubusercontent.com/pos_customer_required/static/description/frontend_pos_error_message.png + +**Table of contents** + +.. contents:: + :local: + +Configuration +============= + +To configure this module, you need to: + +* go to point of sale -> configuration -> point of sales +* select the point of sales you want configure +* search for the "Require Customer" and choose between the following values: + * 'Optional'; (this module has no effect on this PoS config) + * 'Required before paying'; + * 'Required before starting the order'; + +Usage +===== + +.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas + :alt: Try me on Runbot + :target: https://runbot.odoo-community.org/runbot/184/9.0 + +Bug Tracker +=========== + +Bugs are tracked on `GitHub Issues `_. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us smashing it by providing a detailed and welcomed +`feedback `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +~~~~~~~ + +* Apertoso NV +* La Louve + +Contributors +~~~~~~~~~~~~ + +* Jos De Graeve +* Sylvain LE GAL +* Pedro M. Baeza ( reviews & feedback ) +* Druidoo + +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. + +This module is part of the `OCA/pos `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/pos_customer_required/static/description/index.html b/pos_customer_required/static/description/index.html new file mode 100644 index 00000000..892924d5 --- /dev/null +++ b/pos_customer_required/static/description/index.html @@ -0,0 +1,472 @@ + + + + + + +Point of Sale Require Customer + + + +
+

Point of Sale Require Customer

+ + +

Beta License: AGPL-3 OCA/pos Translate me on Weblate Try me on Runbot

+

This module was written to extend the functionality of odoo pos +and allows you to require a customer for each pos order. In the +pos session configuration, you can choose to require the customer for pos +orders.

+

If a customer is not selected, the pos ui will display an error message. +In the backend the customer field is required when needed.

+

Two new options are available:

+
    +
  • Customer ‘Required before starting the order’;
    • +
  • Customer ‘Required before paying’;
    • +
+
+

‘Required before starting the order’ Option

+

In the frontend PoS, the default screen is the screen to select customers.

+
    +
  • Users are not allowed to start selling before having selected a customer;
    • +
  • Users can not ‘deselect a customer’, only select an other one;
    • +
+
+
+

‘Required before paying’ Option

+

In the frontend PoS, the user can start selling, but if the user tries to +make payment and if a customer is not selected, the pos ui will display an +error message.

+https://raw.githubusercontent.com/pos_customer_required/static/description/frontend_pos_error_message.png +

Table of contents

+ +
+

Configuration

+

To configure this module, you need to:

+
    +
  • go to point of sale -> configuration -> point of sales
    • +
  • select the point of sales you want configure
    • +
  • +
    search for the “Require Customer” and choose between the following values:
    +
      +
    • ‘Optional’; (this module has no effect on this PoS config)
      • +
    • ‘Required before paying’;
      • +
    • ‘Required before starting the order’;
      • +
    +
    +
    +
    • +
+
+
+

Usage

+Try me on Runbot +
+
+

Bug Tracker

+

Bugs are tracked on GitHub Issues. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us smashing it by providing a detailed and welcomed +feedback.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Apertoso NV
    • +
  • La Louve
    • +
+
+
+

Contributors

+ +
+
+

Maintainers

+

This module is maintained by the OCA.

+Odoo Community Association +

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.

+

This module is part of the OCA/pos project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+
+ +