Metadata-Version: 2.1
Name: odoo-addon-pos_customer_display_monitor
Version: 17.0.1.0.0.4
Requires-Python: >=3.10
Requires-Dist: odoo>=17.0a,<17.1dev
Summary: Select the monitor used by the POS customer display
Home-page: https://github.com/OCA/pos
License: AGPL-3
Author: APSL-Nagarro, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 17.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

============================
POS Customer Display Monitor
============================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:28026f24a6ca8d81f05420d255bf142cd4f98c84982544e203fb5b8b03dd01d2
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/license-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/17.0/pos_customer_display_monitor
    :alt: OCA/pos
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/pos-17-0/pos-17-0-pos_customer_display_monitor
    :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/pos&target_branch=17.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module allows Point of Sale users to select the monitor where the
local customer display should be opened.

The selected monitor is stored in the browser for each Point of Sale
configuration. When the customer display is opened again, the module
automatically places and resizes the window on the previously selected
monitor.

The module uses the browser Window Management API when available and
keeps the standard Odoo customer display rendering and synchronization.

**Table of contents**

.. contents::
   :local:

Configuration
=============

To use this module:

1. Go to ``Point of Sale > Configuration > Settings``.

2. Open the Point of Sale configuration that you want to use.

3. Enable the ``Customer Display`` option and save the configuration.

   The monitor selection option is only available for local customer
   displays. It is not shown when ``Customer Facing Display via Proxy``
   is enabled.

4. Open the Point of Sale using a recent Chromium-based browser.

5. Make sure Odoo is served over HTTPS.

6. Open the Point of Sale menu.

7. Click on ``Select customer display screen``.

8. Grant the browser permission to manage windows and screens.

9. Select the monitor that should be used for the customer display.

The selected monitor is stored locally in the browser and is associated
with the current Point of Sale configuration.

The permission and monitor selection are specific to the browser profile
and device being used. They may need to be configured again if the
browser site data, permissions, or local storage are cleared.

Usage
=====

Once a monitor has been selected, use the standard Odoo customer display
button to open the customer display.

The module will:

- Detect the screens currently connected to the device.
- Find the screen that best matches the saved selection.
- Open the Odoo customer display on that screen.
- Move and resize the window to occupy the available screen area.

If the previously selected monitor cannot be found, the module falls
back to a secondary monitor when available, or to the primary monitor.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/pos/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/pos/issues/new?body=module:%20pos_customer_display_monitor%0Aversion:%2017.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
-------

* APSL-Nagarro

Contributors
------------

- [APSL-Nagarro](https://apsl.tech):

  - Bernat Obrador <bernat.obrador@nagarro.com>

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-BernatObrador| image:: https://github.com/BernatObrador.png?size=40px
    :target: https://github.com/BernatObrador
    :alt: BernatObrador

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-BernatObrador| 

This module is part of the `OCA/pos <https://github.com/OCA/pos/tree/17.0/pos_customer_display_monitor>`_ project on GitHub.

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