Initial commit: OCA Technical packages (595 packages)

This commit is contained in:
Ernad Husremovic 2025-08-29 15:43:03 +02:00
commit 2cc02aac6e
24950 changed files with 2318079 additions and 0 deletions

View file

@ -0,0 +1,46 @@
# POS Partner Location Google Map
Odoo addon: pos_partner_location_google_map
## Installation
```bash
pip install odoo-bringout-oca-pos-pos_partner_location_google_map
```
## Dependencies
This addon depends on:
- pos_partner_location_abstract
## Manifest Information
- **Name**: POS Partner Location Google Map
- **Version**: 16.0.1.0.1
- **Category**: Point Of Sale
- **License**: AGPL-3
- **Installable**: True
## Source
Based on [OCA/pos](https://github.com/OCA/pos) branch 16.0, addon `pos_partner_location_google_map`.
## License
This package maintains the original AGPL-3 license from the upstream Odoo project.
## Documentation
- Overview: doc/OVERVIEW.md
- Architecture: doc/ARCHITECTURE.md
- Models: doc/MODELS.md
- Controllers: doc/CONTROLLERS.md
- Wizards: doc/WIZARDS.md
- Reports: doc/REPORTS.md
- Security: doc/SECURITY.md
- Install: doc/INSTALL.md
- Usage: doc/USAGE.md
- Configuration: doc/CONFIGURATION.md
- Dependencies: doc/DEPENDENCIES.md
- Troubleshooting: doc/TROUBLESHOOTING.md
- FAQ: doc/FAQ.md

View file

@ -0,0 +1,32 @@
# Architecture
```mermaid
flowchart TD
U[Users] -->|HTTP| V[Views and QWeb Templates]
V --> C[Controllers]
V --> W[Wizards Transient Models]
C --> M[Models and ORM]
W --> M
M --> R[Reports]
DX[Data XML] --> M
S[Security ACLs and Groups] -. enforces .-> M
subgraph Pos_partner_location_google_map Module - pos_partner_location_google_map
direction LR
M:::layer
W:::layer
C:::layer
V:::layer
R:::layer
S:::layer
DX:::layer
end
classDef layer fill:#eef8ff,stroke:#6ea8fe,stroke-width:1px
```
Notes
- Views include tree/form/kanban templates and report templates.
- Controllers provide website/portal routes when present.
- Wizards are UI flows implemented with `models.TransientModel`.
- Data XML loads data/demo records; Security defines groups and access.

View file

@ -0,0 +1,3 @@
# Configuration
Refer to Odoo settings for pos_partner_location_google_map. Configure related models, access rights, and options as needed.

View file

@ -0,0 +1,3 @@
# Controllers
This module does not define custom HTTP controllers.

View file

@ -0,0 +1,5 @@
# Dependencies
This addon depends on:
- [pos_partner_location_abstract](../../odoo-bringout-oca-pos-pos_partner_location_abstract)

View file

@ -0,0 +1,4 @@
# FAQ
- Q: Which Odoo version? A: 16.0 (OCA/OCB packaged).
- Q: How to enable? A: Start server with --addon pos_partner_location_google_map or install in UI.

View file

@ -0,0 +1,7 @@
# Install
```bash
pip install odoo-bringout-oca-pos-pos_partner_location_google_map"
# or
uv pip install odoo-bringout-oca-pos-pos_partner_location_google_map"
```

View file

@ -0,0 +1,14 @@
# Models
Detected core models and extensions in pos_partner_location_google_map.
```mermaid
classDiagram
class base_geocoder
class pos_config
class res_partner
```
Notes
- Classes show model technical names; fields omitted for brevity.
- Items listed under _inherit are extensions of existing models.

View file

@ -0,0 +1,6 @@
# Overview
Packaged Odoo addon: pos_partner_location_google_map. Provides features documented in upstream Odoo 16 under this addon.
- Source: OCA/OCB 16.0, addon pos_partner_location_google_map
- License: LGPL-3

View file

@ -0,0 +1,3 @@
# Reports
This module does not define custom reports.

View file

@ -0,0 +1,8 @@
# Security
This module does not define custom security rules or access controls beyond Odoo defaults.
Default Odoo security applies:
- Base user access through standard groups
- Model access inherited from dependencies
- No custom row-level security rules

View file

@ -0,0 +1,5 @@
# Troubleshooting
- Ensure Python and Odoo environment matches repo guidance.
- Check database connectivity and logs if startup fails.
- Validate that dependent addons listed in DEPENDENCIES.md are installed.

View file

@ -0,0 +1,7 @@
# Usage
Start Odoo including this addon (from repo root):
```bash
python3 scripts/nix_odoo_web_server.py --db-name mydb --addon pos_partner_location_google_map
```

View file

@ -0,0 +1,3 @@
# Wizards
This module does not include UI wizards.

View file

@ -0,0 +1,87 @@
===============================
POS Partner Location Google Map
===============================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:05a1c37759a7b56aa56bc9399cdfc19f45e28234035a791aa2f4420b6ccb376f
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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/16.0/pos_partner_location_google_map
:alt: OCA/pos
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/pos-16-0/pos-16-0-pos_partner_location_google_map
: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=16.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
This module allows to select partner address directly on map.
**Table of contents**
.. contents::
:local:
Usage
=====
In POS open customer list, select a customer and click "Details".
On the customer form click on the "globe" icon and select a location on map.
Click "Save" to save the location.
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_partner_location_google_map%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
~~~~~~~
* Cetmix
Contributors
~~~~~~~~~~~~
* Cetmix <https://cetmix.com/>
* Ivan Sokolov
* Maksim Shurupov
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 <https://github.com/OCA/pos/tree/16.0/pos_partner_location_google_map>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

View file

@ -0,0 +1,20 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
{
"name": "POS Partner Location Google Map",
"version": "16.0.1.0.1",
"category": "Point Of Sale",
"summary": "POS Partner Location Google Map",
"author": "Cetmix, Odoo Community Association (OCA)",
"website": "https://github.com/OCA/pos",
"license": "AGPL-3",
"depends": ["pos_partner_location_abstract"],
"data": [],
"assets": {
"point_of_sale.assets": [
"pos_partner_location_google_map/static/src/js/*.js",
],
},
"installable": True,
}

View file

@ -0,0 +1,43 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_partner_location_google_map
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"
#. module: pos_partner_location_google_map
#. odoo-python
#: code:addons/pos_partner_location_google_map/models/base_geocoder.py:0
#, python-format
msgid ""
"API key for GeoCoding (Places) required.\n"
"Visit https://developers.google.com/maps/documentation/geocoding/get-api-key for more information."
msgstr ""
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_res_partner
msgid "Contact"
msgstr "Kontakt"
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_base_geocoder
msgid "Geo Coder"
msgstr "Geo koder"
#. module: pos_partner_location_google_map
#: model:ir.model.fields,field_description:pos_partner_location_google_map.field_pos_config__googlemap_api_key
msgid "Googlemap Api Key"
msgstr "Googlemap API ključ"
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_pos_config
msgid "Point of Sale Configuration"
msgstr "Postavke prodajnog mjesta"

View file

@ -0,0 +1,49 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_partner_location_google_map
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2024-04-03 13:34+0000\n"
"Last-Translator: mymage <stefano.consolaro@mymage.it>\n"
"Language-Team: none\n"
"Language: it\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
"X-Generator: Weblate 4.17\n"
#. module: pos_partner_location_google_map
#. odoo-python
#: code:addons/pos_partner_location_google_map/models/base_geocoder.py:0
#, python-format
msgid ""
"API key for GeoCoding (Places) required.\n"
"Visit https://developers.google.com/maps/documentation/geocoding/get-api-key for more information."
msgstr ""
"È richiesta la chiave API per GeoCoding (luoghi).\n"
"Visitare https://developers.google.com/maps/documentation/geocoding/get-api-"
"key per ulteriori informazioni."
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_res_partner
msgid "Contact"
msgstr "Contatto"
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_base_geocoder
msgid "Geo Coder"
msgstr "Geo Coder"
#. module: pos_partner_location_google_map
#: model:ir.model.fields,field_description:pos_partner_location_google_map.field_pos_config__googlemap_api_key
msgid "Googlemap Api Key"
msgstr "Chiave API Google Map"
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_pos_config
msgid "Point of Sale Configuration"
msgstr "Configurazione punto vendita"

View file

@ -0,0 +1,43 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_partner_location_google_map
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"
#. module: pos_partner_location_google_map
#. odoo-python
#: code:addons/pos_partner_location_google_map/models/base_geocoder.py:0
#, python-format
msgid ""
"API key for GeoCoding (Places) required.\n"
"Visit https://developers.google.com/maps/documentation/geocoding/get-api-key for more information."
msgstr ""
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_res_partner
msgid "Contact"
msgstr ""
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_base_geocoder
msgid "Geo Coder"
msgstr ""
#. module: pos_partner_location_google_map
#: model:ir.model.fields,field_description:pos_partner_location_google_map.field_pos_config__googlemap_api_key
msgid "Googlemap Api Key"
msgstr ""
#. module: pos_partner_location_google_map
#: model:ir.model,name:pos_partner_location_google_map.model_pos_config
msgid "Point of Sale Configuration"
msgstr ""

View file

@ -0,0 +1,4 @@
from . import address_google_struct
from . import base_geocoder
from . import pos_config
from . import res_partner

View file

@ -0,0 +1,140 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
from odoo.osv.expression import AND, OR
from odoo.addons.pos_partner_location_abstract.models.address_struct import (
AddressStruct,
)
class AddressGoogleStruct(AddressStruct):
ADDR_FIELDS = {
"number": ["street_number"],
"street": ["street_address", "route", "plus_code"],
"city": [
"locality",
"sublocality",
"sublocality_level_1",
"sublocality_level_2",
"sublocality_level_3",
"sublocality_level_4",
],
"state_id": [
"administrative_area_level_1",
"administrative_area_level_2",
"administrative_area_level_3",
"administrative_area_level_4",
"administrative_area_level_5",
],
"country_id": ["country"],
"zip": ["postal_code"],
}
SERVICE_URL = "https://maps.googleapis.com/maps/api/place/details/json"
def __init__(self, odoo_env):
super(AddressGoogleStruct, self).__init__(odoo_env)
self.api_key = (
self.env["ir.config_parameter"]
.sudo()
.get_param("base_geolocalize.google_map_api_key", False)
)
def has_token(self):
"""Checking exists Google API key in settings"""
return bool(self.api_key)
def _get_fields_value(self, addr_key):
"""
Get fields value for preparing values address
:param str addr_key: field name
:return list: list of fields values
"""
return [self._result.get(key, False) for key in self.ADDR_FIELDS[addr_key]]
@property
def street(self):
street_number = self._result.get("street_number")
result = []
if street_number:
result.append(street_number)
for address in self._get_fields_value("street"):
if address:
result.append(address)
return " ".join(result)
return ""
@property
def city(self):
for city in self._get_fields_value("city"):
if city:
return city
return False
@property
def state_id(self):
domain = []
codes = []
for state in self._get_fields_value("state_id"):
if state:
domain = OR([domain, [("name", "like", state.get("name"))]])
codes.append(state.get("code"))
if codes:
domain = OR([domain, [("code", "in", codes)]])
if len(domain) == 0:
return False
country_id = self.country_id
if country_id:
domain = AND([domain, [("country_id", "=", country_id[0])]])
state = self.env["res.country.state"].search(domain, limit=1)
return state.name_get()[0] if state else False
@property
def country_id(self):
country_item = self._result.get("country")
if not country_item:
return False
country = self.env["res.country"].search(
[
"|",
("name", "like", country_item.get("name")),
("code", "=", country_item.get("code")),
]
)
return country.name_get()[0] if country else False
@property
def zip(self):
return self._result.get("postal_code")
def query_addr(self, params, timeout=5):
params.update(key=self.api_key)
response = super(AddressGoogleStruct, self).query_addr(params, timeout=timeout)
if response:
if response.get("status") == "OK":
self._prepare_components_data(response["result"]["address_components"])
return True
return False
def _prepare_components_data(self, components):
"""
Preparing component values for class result
:param dict components: list of components
:return: None
:rtype: NoneType
"""
state_country_fields = [
*self.ADDR_FIELDS.get("state_id", []),
*self.ADDR_FIELDS.get("country_id", []),
]
for component in components:
for type_ in component["types"]:
if type_ in state_country_fields:
self._result[type_] = {
"code": component["short_name"],
"name": component["long_name"],
}
elif type_ in self.ADDR_FIELDS.get("street", []):
self._result[type_] = component["short_name"]
else:
self._result[type_] = component["long_name"]

View file

@ -0,0 +1,36 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
import logging
from odoo import _, api, models
from .address_google_struct import AddressGoogleStruct
_logger = logging.getLogger(__name__)
class GeoProvider(models.AbstractModel):
_inherit = "base.geocoder"
@api.model
def prepare_geo_address_googlemap(self, place_id):
"""
Prepare Address values by place id
:param str place_id: Google map place id
:return dict: address fields values
"""
google = AddressGoogleStruct(self.env)
if not google.has_token():
raise models.UserError(
_(
"API key for GeoCoding (Places) required.\n"
"Visit https://developers.google.com/maps/documentation/geocoding/get-api-key " # noqa
"for more information."
)
)
status = google.query_addr({"place_id": place_id})
if status:
return google.get_result()
_logger.warning("Google map place id is not found!")
return {}

View file

@ -0,0 +1,26 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
from odoo import api, fields, models
class PosConfig(models.Model):
_inherit = "pos.config"
googlemap_api_key = fields.Char(compute="_compute_geolocalize")
@api.model
def _set_extended_data(self):
data = super(PosConfig, self)._set_extended_data()
ICPSudo = self.env["ir.config_parameter"].sudo()
data.update(
api_key=ICPSudo.get_param("base_geolocalize.google_map_api_key", False)
)
return data
def _set_pos_config_parameter(self, tech_name, ext_vals=None):
super(PosConfig, self)._set_pos_config_parameter(tech_name, ext_vals)
key = ext_vals.get("api_key", "") if tech_name == "googlemap" else ""
for config in self:
config.googlemap_api_key = key
return

View file

@ -0,0 +1,28 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
from odoo import api, models
class ResPartner(models.Model):
_inherit = "res.partner"
@api.model
def _get_map_provider_tech_name(self):
"""Get map provider technical name"""
ICPSudo = self.env["ir.config_parameter"].sudo()
geo_provider_obj = self.env["base.geo_provider"]
geo_provider_id = ICPSudo.get_param("base_geolocalize.geo_provider")
provider = geo_provider_obj.browse(int(geo_provider_id))
return provider.tech_name
def _compute_qr_code_url(self):
if self._get_map_provider_tech_name() != "googlemap":
return super()._compute_qr_code_url()
map_url = "https://maps.google.com/maps?q={},{}"
for rec in self:
rec.qr_code_url = (
map_url.format(rec.partner_latitude, rec.partner_longitude)
if rec.partner_latitude and rec.partner_longitude
else ""
)

View file

@ -0,0 +1,2 @@
In General Settings -> Integrations enable the Geo Localisation checkbox.
Select provided and add API key. NB: only google maps are currently supported.

View file

@ -0,0 +1,5 @@
* Cetmix <https://cetmix.com/>
* Ivan Sokolov
* Maksim Shurupov

View file

@ -0,0 +1 @@
This module allows to select partner address directly on map.

View file

@ -0,0 +1,3 @@
In POS open customer list, select a customer and click "Details".
On the customer form click on the "globe" icon and select a location on map.
Click "Save" to save the location.

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.2 KiB

View file

@ -0,0 +1,434 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils: https://docutils.sourceforge.io/" />
<title>POS Partner Location Google Map</title>
<style type="text/css">
/*
:Author: David Goodger (goodger@python.org)
:Id: $Id: html4css1.css 9511 2024-01-13 09:50:07Z milde $
:Copyright: This stylesheet has been placed in the public domain.
Default cascading style sheet for the HTML output of Docutils.
Despite the name, some widely supported CSS2 features are used.
See https://docutils.sourceforge.io/docs/howto/html-stylesheets.html for how to
customize this style sheet.
*/
/* used to remove borders from tables and images */
.borderless, table.borderless td, table.borderless th {
border: 0 }
table.borderless td, table.borderless th {
/* Override padding for "table.docutils td" with "! important".
The right padding separates the table cells. */
padding: 0 0.5em 0 0 ! important }
.first {
/* Override more specific margin styles with "! important". */
margin-top: 0 ! important }
.last, .with-subtitle {
margin-bottom: 0 ! important }
.hidden {
display: none }
.subscript {
vertical-align: sub;
font-size: smaller }
.superscript {
vertical-align: super;
font-size: smaller }
a.toc-backref {
text-decoration: none ;
color: black }
blockquote.epigraph {
margin: 2em 5em ; }
dl.docutils dd {
margin-bottom: 0.5em }
object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
overflow: hidden;
}
/* Uncomment (and remove this text!) to get bold-faced definition list terms
dl.docutils dt {
font-weight: bold }
*/
div.abstract {
margin: 2em 5em }
div.abstract p.topic-title {
font-weight: bold ;
text-align: center }
div.admonition, div.attention, div.caution, div.danger, div.error,
div.hint, div.important, div.note, div.tip, div.warning {
margin: 2em ;
border: medium outset ;
padding: 1em }
div.admonition p.admonition-title, div.hint p.admonition-title,
div.important p.admonition-title, div.note p.admonition-title,
div.tip p.admonition-title {
font-weight: bold ;
font-family: sans-serif }
div.attention p.admonition-title, div.caution p.admonition-title,
div.danger p.admonition-title, div.error p.admonition-title,
div.warning p.admonition-title, .code .error {
color: red ;
font-weight: bold ;
font-family: sans-serif }
/* Uncomment (and remove this text!) to get reduced vertical space in
compound paragraphs.
div.compound .compound-first, div.compound .compound-middle {
margin-bottom: 0.5em }
div.compound .compound-last, div.compound .compound-middle {
margin-top: 0.5em }
*/
div.dedication {
margin: 2em 5em ;
text-align: center ;
font-style: italic }
div.dedication p.topic-title {
font-weight: bold ;
font-style: normal }
div.figure {
margin-left: 2em ;
margin-right: 2em }
div.footer, div.header {
clear: both;
font-size: smaller }
div.line-block {
display: block ;
margin-top: 1em ;
margin-bottom: 1em }
div.line-block div.line-block {
margin-top: 0 ;
margin-bottom: 0 ;
margin-left: 1.5em }
div.sidebar {
margin: 0 0 0.5em 1em ;
border: medium outset ;
padding: 1em ;
background-color: #ffffee ;
width: 40% ;
float: right ;
clear: right }
div.sidebar p.rubric {
font-family: sans-serif ;
font-size: medium }
div.system-messages {
margin: 5em }
div.system-messages h1 {
color: red }
div.system-message {
border: medium outset ;
padding: 1em }
div.system-message p.system-message-title {
color: red ;
font-weight: bold }
div.topic {
margin: 2em }
h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
margin-top: 0.4em }
h1.title {
text-align: center }
h2.subtitle {
text-align: center }
hr.docutils {
width: 75% }
img.align-left, .figure.align-left, object.align-left, table.align-left {
clear: left ;
float: left ;
margin-right: 1em }
img.align-right, .figure.align-right, object.align-right, table.align-right {
clear: right ;
float: right ;
margin-left: 1em }
img.align-center, .figure.align-center, object.align-center {
display: block;
margin-left: auto;
margin-right: auto;
}
table.align-center {
margin-left: auto;
margin-right: auto;
}
.align-left {
text-align: left }
.align-center {
clear: both ;
text-align: center }
.align-right {
text-align: right }
/* reset inner alignment in figures */
div.align-right {
text-align: inherit }
/* div.align-center * { */
/* text-align: left } */
.align-top {
vertical-align: top }
.align-middle {
vertical-align: middle }
.align-bottom {
vertical-align: bottom }
ol.simple, ul.simple {
margin-bottom: 1em }
ol.arabic {
list-style: decimal }
ol.loweralpha {
list-style: lower-alpha }
ol.upperalpha {
list-style: upper-alpha }
ol.lowerroman {
list-style: lower-roman }
ol.upperroman {
list-style: upper-roman }
p.attribution {
text-align: right ;
margin-left: 50% }
p.caption {
font-style: italic }
p.credits {
font-style: italic ;
font-size: smaller }
p.label {
white-space: nowrap }
p.rubric {
font-weight: bold ;
font-size: larger ;
color: maroon ;
text-align: center }
p.sidebar-title {
font-family: sans-serif ;
font-weight: bold ;
font-size: larger }
p.sidebar-subtitle {
font-family: sans-serif ;
font-weight: bold }
p.topic-title {
font-weight: bold }
pre.address {
margin-bottom: 0 ;
margin-top: 0 ;
font: inherit }
pre.literal-block, pre.doctest-block, pre.math, pre.code {
margin-left: 2em ;
margin-right: 2em }
pre.code .ln { color: gray; } /* line numbers */
pre.code, code { background-color: #eeeeee }
pre.code .comment, code .comment { color: #5C6576 }
pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
pre.code .literal.string, code .literal.string { color: #0C5404 }
pre.code .name.builtin, code .name.builtin { color: #352B84 }
pre.code .deleted, code .deleted { background-color: #DEB0A1}
pre.code .inserted, code .inserted { background-color: #A3D289}
span.classifier {
font-family: sans-serif ;
font-style: oblique }
span.classifier-delimiter {
font-family: sans-serif ;
font-weight: bold }
span.interpreted {
font-family: sans-serif }
span.option {
white-space: nowrap }
span.pre {
white-space: pre }
span.problematic, pre.problematic {
color: red }
span.section-subtitle {
/* font-size relative to parent (h1..h6 element) */
font-size: 80% }
table.citation {
border-left: solid 1px gray;
margin-left: 1px }
table.docinfo {
margin: 2em 4em }
table.docutils {
margin-top: 0.5em ;
margin-bottom: 0.5em }
table.footnote {
border-left: solid 1px black;
margin-left: 1px }
table.docutils td, table.docutils th,
table.docinfo td, table.docinfo th {
padding-left: 0.5em ;
padding-right: 0.5em ;
vertical-align: top }
table.docutils th.field-name, table.docinfo th.docinfo-name {
font-weight: bold ;
text-align: left ;
white-space: nowrap ;
padding-left: 0 }
/* "booktabs" style (no vertical lines) */
table.docutils.booktabs {
border: 0px;
border-top: 2px solid;
border-bottom: 2px solid;
border-collapse: collapse;
}
table.docutils.booktabs * {
border: 0px;
}
table.docutils.booktabs th {
border-bottom: thin solid;
text-align: left;
}
h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
font-size: 100% }
ul.auto-toc {
list-style-type: none }
</style>
</head>
<body>
<div class="document" id="pos-partner-location-google-map">
<h1 class="title">POS Partner Location Google Map</h1>
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:05a1c37759a7b56aa56bc9399cdfc19f45e28234035a791aa2f4420b6ccb376f
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/pos/tree/16.0/pos_partner_location_google_map"><img alt="OCA/pos" src="https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/pos-16-0/pos-16-0-pos_partner_location_google_map"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runboat.odoo-community.org/builds?repo=OCA/pos&amp;target_branch=16.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
<p>This module allows to select partner address directly on map.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#usage" id="toc-entry-1">Usage</a></li>
<li><a class="reference internal" href="#bug-tracker" id="toc-entry-2">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="toc-entry-3">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="toc-entry-4">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="toc-entry-5">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="toc-entry-6">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="usage">
<h1><a class="toc-backref" href="#toc-entry-1">Usage</a></h1>
<p>In POS open customer list, select a customer and click “Details”.
On the customer form click on the “globe” icon and select a location on map.
Click “Save” to save the location.</p>
</div>
<div class="section" id="bug-tracker">
<h1><a class="toc-backref" href="#toc-entry-2">Bug Tracker</a></h1>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/pos/issues">GitHub Issues</a>.
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
<a class="reference external" href="https://github.com/OCA/pos/issues/new?body=module:%20pos_partner_location_google_map%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
</div>
<div class="section" id="credits">
<h1><a class="toc-backref" href="#toc-entry-3">Credits</a></h1>
<div class="section" id="authors">
<h2><a class="toc-backref" href="#toc-entry-4">Authors</a></h2>
<ul class="simple">
<li>Cetmix</li>
</ul>
</div>
<div class="section" id="contributors">
<h2><a class="toc-backref" href="#toc-entry-5">Contributors</a></h2>
<ul class="simple">
<li>Cetmix &lt;<a class="reference external" href="https://cetmix.com/">https://cetmix.com/</a>&gt;<ul>
<li>Ivan Sokolov</li>
<li>Maksim Shurupov</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="maintainers">
<h2><a class="toc-backref" href="#toc-entry-6">Maintainers</a></h2>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org">
<img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" />
</a>
<p>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.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/pos/tree/16.0/pos_partner_location_google_map">OCA/pos</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>
</div>
</div>
</div>
</body>
</html>

View file

@ -0,0 +1,22 @@
/** @odoo-module **/
import PartnerDetailsEdit from "point_of_sale.PartnerDetailsEdit";
import Registries from "point_of_sale.Registries";
const PartnerDetailsMapGoogleEdit = (PartnerDetailsEdit) =>
class PartnerDetailsMapGoogleEdit extends PartnerDetailsEdit {
get accessToMap() {
this.config = this.env.pos.config;
if (
this.config.geolocalize_tech_name === "googlemap" &&
this.config.googlemap_api_key
) {
return true;
}
return super.accessToMap;
}
};
Registries.Component.extend(PartnerDetailsEdit, PartnerDetailsMapGoogleEdit);
export default PartnerDetailsMapGoogleEdit;

View file

@ -0,0 +1,116 @@
/** @odoo-module **/
/* global google */
import {onMounted, onWillStart} from "@odoo/owl";
import PartnerMapEdit from "pos_partner_location_abstract.PartnerMapEdit";
import Registries from "point_of_sale.Registries";
import {loadJS} from "@web/core/assets";
/* eslint no-undef: "warn"*/
const PartnerMapGoogleEdit = (PartnerMapEdit) =>
class PartnerMapGoogleEdit extends PartnerMapEdit {
onHandleMap() {
if (
this.config.geolocalize_tech_name === "googlemap" &&
this.config.googlemap_api_key
) {
this.provider = "googlemap";
onWillStart(async () =>
loadJS(
`https://maps.googleapis.com/maps/api/js?key=${this.config.googlemap_api_key}&libraries=places`
)
);
onMounted(() => this.googleMapConfigure());
} else {
super.onHandleMap();
}
}
googleMapConfigure() {
// Default latLng
// Config
this.geocoder = new google.maps.Geocoder();
const latLng = new google.maps.LatLng(this.lat, this.lng);
const mapOptions = {
zoom: 12,
center: latLng,
};
// Show Map
this.map = new google.maps.Map(this.mapContainerRef.el, mapOptions);
if (this.lat && this.lng) {
this.setAddressByLatLng(this.lat, this.lng);
} else {
this.setAddressByLocation(this.partner.contact_address);
}
this.marker = new google.maps.Marker({
position: latLng,
map: this.map,
draggable: true,
});
this.addrInput.el.value = this.partner.contact_address;
this.map.addListener("click", (event) => {
const lat = event.latLng.lat();
const lng = event.latLng.lng();
this.updateMarker(lat, lng);
this.setAddressByLatLng(lat, lng);
});
}
setAddressByLatLng(lat, lng) {
if (lat && lng) {
const latLng = new google.maps.LatLng(lat, lng);
this.geocoder.geocode({location: latLng}, (results, status) => {
if (status === google.maps.GeocoderStatus.OK) {
this.getFormattedAddress(results[0].place_id).then(() => {
this.addrInput.el.value = results[0].formatted_address;
});
}
});
}
}
updateMarker(lat, lng) {
super.updateMarker(lat, lng);
if (this.provider === "googlemap") {
const latLng = new google.maps.LatLng(lat, lng);
this.map.setCenter(latLng);
this.marker.setPosition(latLng);
google.maps.event.trigger(this.map, "resize");
}
}
setAddressByLocation(address) {
if (address && this.provider === "googlemap") {
this.geocoder.geocode({address: address}, (results, status) => {
if (status === google.maps.GeocoderStatus.OK) {
this.lat = results[0].geometry.location.lat();
this.lng = results[0].geometry.location.lng();
this.getFormattedAddress(results[0].place_id).then(() => {
this.addrInput.el.value = results[0].formatted_address;
this.updateMarker(this.lat, this.lng);
});
}
});
} else {
super.setAddressByLocation(address);
}
}
getFormattedAddress(place_id) {
return this.rpc({
model: "base.geocoder",
method: "prepare_geo_address_googlemap",
args: [place_id],
}).then((resp) => {
this.address = resp;
});
}
};
Registries.Component.extend(PartnerMapEdit, PartnerMapGoogleEdit);
export default PartnerMapGoogleEdit;

View file

@ -0,0 +1,4 @@
from . import common
from . import test_address_google_struct
from . import test_base_geocoder
from . import test_res_partner

View file

@ -0,0 +1,65 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
RESPONSE_MAP = {
"result": {
"address_components": [
{"long_name": "277", "short_name": "277", "types": ["street_number"]},
{
"long_name": "Bedford Avenue",
"short_name": "Bedford Ave",
"types": ["route"],
},
{
"long_name": "Williamsburg",
"short_name": "Williamsburg",
"types": ["neighborhood", "political"],
},
{
"long_name": "Brooklyn",
"short_name": "Brooklyn",
"types": ["sublocality", "political"],
},
{
"long_name": "Kings",
"short_name": "Kings",
"types": ["administrative_area_level_2", "political"],
},
{
"long_name": "New York",
"short_name": "NY",
"types": ["administrative_area_level_1", "political"],
},
{
"long_name": "United States",
"short_name": "US",
"types": ["country", "political"],
},
{"long_name": "11211", "short_name": "11211", "types": ["postal_code"]},
],
"formatted_address": "277 Bedford Avenue, Brooklyn, NY 11211, USA",
"geometry": {
"location": {"lat": 40.714232, "lng": -73.9612889},
"location_type": "ROOFTOP",
"viewport": {
"northeast": {"lat": 40.7155809802915, "lng": -73.9599399197085},
"southwest": {"lat": 40.7128830197085, "lng": -73.96263788029151},
},
},
"place_id": "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
"types": ["street_address"],
},
"status": "OK",
}
FORMATTED_RESULT = {
"street_number": "277",
"route": "Bedford Ave",
"neighborhood": "Williamsburg",
"political": "United States",
"sublocality": "Brooklyn",
"administrative_area_level_2": {"code": "Kings", "name": "Kings"},
"administrative_area_level_1": {"code": "NY", "name": "New York"},
"country": {"code": "US", "name": "United States"},
"postal_code": "11211",
}

View file

@ -0,0 +1,107 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
from unittest import mock
from odoo.tests import TransactionCase
from odoo.addons.pos_partner_location_google_map.models.address_google_struct import (
AddressGoogleStruct,
)
from .common import FORMATTED_RESULT, RESPONSE_MAP
class TestAddressGoogleStruct(TransactionCase):
def setUp(self):
super(TestAddressGoogleStruct, self).setUp()
self.env["ir.config_parameter"].set_param(
"base_geolocalize.google_map_api_key", "GoogleMapKey"
)
self.state_ny = self.env["res.country.state"].search(
[("code", "=", "NY")], limit=1
)
self.country_us = self.env["res.country"].search([("code", "=", "US")], limit=1)
self.google_struct = AddressGoogleStruct(self.env)
def test_init(self):
self.assertEqual(self.google_struct.api_key, "GoogleMapKey")
def test_has_token(self):
self.env["ir.config_parameter"].set_param(
"base_geolocalize.google_map_api_key", ""
)
google = AddressGoogleStruct(self.env)
self.assertFalse(google.has_token())
self.env["ir.config_parameter"].set_param(
"base_geolocalize.google_map_api_key", "GoogleMapKey"
)
google = AddressGoogleStruct(self.env)
self.assertTrue(google.has_token())
def test_get_fields_value(self):
result = self.google_struct._get_fields_value("number")
self.assertListEqual(result, [False])
result = self.google_struct._get_fields_value("street")
self.assertListEqual(result, [False, False, False])
@mock.patch("requests.get")
def test_query_addr_valid(self, mock_get):
mock_response = mock.Mock(status_code=200)
mock_response.json.return_value = {
"result": {"address_components": []},
"status": "OK",
}
mock_get.return_value = mock_response
response = self.google_struct.query_addr({})
self.assertTrue(response)
@mock.patch("requests.get")
def test_query_addr_invalid(self, mock_get):
mock_response = mock.Mock(status_code=200)
mock_response.json.return_value = {
"result": {"address_components": []},
"status": "ERR",
}
mock_get.return_value = mock_response
response = self.google_struct.query_addr({})
self.assertFalse(response)
def test_street(self):
self.assertEqual(self.google_struct.street, "")
self.google_struct._result.update(
street_number="1", street_address="Test Address"
)
self.assertEqual(self.google_struct.street, "1 Test Address")
def test_city(self):
self.assertFalse(self.google_struct.city)
self.google_struct._result.update(sublocality="Tallin")
self.assertEqual(self.google_struct.city, "Tallin")
def test_zip(self):
self.assertFalse(self.google_struct.zip)
self.google_struct._result.update(postal_code="524124")
self.assertEqual(self.google_struct.zip, "524124")
def test_prepare_components_data(self):
self.google_struct._prepare_components_data(
RESPONSE_MAP["result"]["address_components"]
)
self.assertDictEqual(self.google_struct._result, FORMATTED_RESULT)
def test_country_id(self):
self.assertFalse(self.google_struct.country_id)
self.google_struct._result.update(
country={"code": "US", "name": "United States"}
)
self.assertEqual(self.google_struct.country_id, self.country_us.name_get()[0])
def test_state_id(self):
self.assertFalse(self.google_struct.state_id)
self.google_struct._result.update(
country={"code": "US", "name": "United States"},
administrative_area_level_2={"code": "Kings", "name": "Kings"},
administrative_area_level_1={"code": "NY", "name": "New York"},
)
self.assertEqual(self.google_struct.state_id, self.state_ny.name_get()[0])

View file

@ -0,0 +1,40 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
from unittest import mock
from odoo.exceptions import UserError
from odoo.tests import TransactionCase
from .common import RESPONSE_MAP
class TestBaseGeocoder(TransactionCase):
def test_prepare_geo_address_googlemap_invalid(self):
self.env["ir.config_parameter"].set_param(
"base_geolocalize.google_map_api_key", ""
)
with self.assertRaises(UserError):
self.env["base.geocoder"].prepare_geo_address_googlemap("test_place")
@mock.patch("requests.get")
def test_prepare_geo_address_googlemap_valid(self, mock_get):
self.env["ir.config_parameter"].set_param(
"base_geolocalize.google_map_api_key", "GoogleMapKey"
)
self.state_ny = self.env["res.country.state"].search(
[("code", "=", "NY")], limit=1
)
self.country_us = self.env["res.country"].search([("code", "=", "US")], limit=1)
mock_response = mock.Mock(status_code=200)
mock_response.json.return_value = RESPONSE_MAP
mock_get.return_value = mock_response
response = self.env["base.geocoder"].prepare_geo_address_googlemap("test_place")
expected_value = {
"city": "Brooklyn",
"country_id": self.country_us.name_get()[0],
"state_id": self.state_ny.name_get()[0],
"street": "277 Bedford Ave",
"zip": "11211",
}
self.assertDictEqual(response, expected_value)

View file

@ -0,0 +1,44 @@
# Copyright (C) 2023 Cetmix OÜ
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
from odoo.tests import TransactionCase
from .common import RESPONSE_MAP
class TestResPartner(TransactionCase):
def setUp(self):
super().setUp()
self.provider_google_map = self.env.ref(
"base_geolocalize.geoprovider_google_map"
)
lat_long_struct = RESPONSE_MAP["result"]["geometry"]["location"]
self.partner = self.env["res.partner"].create(
{
"name": "Bob",
"partner_latitude": lat_long_struct["lat"],
"partner_longitude": lat_long_struct["lng"],
}
)
self.map_url = "https://maps.google.com/maps?q={},{}"
def test_compute_qr_code_url_provider(self):
"""Test flow that computes qr code url by provider"""
# Without provider
self.env["ir.config_parameter"].set_param(
"base_geolocalize.geo_provider", False
)
self.assertEqual(self.partner.qr_code_url, "", "QR URL must be empty")
# Google provider
self.env["ir.config_parameter"].set_param(
"base_geolocalize.geo_provider", self.provider_google_map.id
)
self.partner._compute_qr_code_url()
self.assertEqual(
self.partner.qr_code_url,
self.map_url.format(
self.partner.partner_latitude, self.partner.partner_longitude
),
"QR URL must be the same",
)

View file

@ -0,0 +1,42 @@
[project]
name = "odoo-bringout-oca-pos-pos_partner_location_google_map"
version = "16.0.0"
description = "POS Partner Location Google Map - POS Partner Location Google Map"
authors = [
{ name = "Ernad Husremovic", email = "hernad@bring.out.ba" }
]
dependencies = [
"odoo-bringout-oca-pos-pos_partner_location_abstract>=16.0.0",
"requests>=2.25.1"
]
readme = "README.md"
requires-python = ">= 3.11"
classifiers = [
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Topic :: Office/Business",
]
[project.urls]
homepage = "https://github.com/bringout/0"
repository = "https://github.com/bringout/0"
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[tool.hatch.metadata]
allow-direct-references = true
[tool.hatch.build.targets.wheel]
packages = ["pos_partner_location_google_map"]
[tool.rye]
managed = true
dev-dependencies = [
"pytest>=8.4.1",
]