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,44 @@
# Brand
Odoo addon: brand
## Installation
```bash
pip install odoo-bringout-oca-brand-brand
```
## Dependencies
This addon depends on:
- base_setup
## Manifest Information
- **Name**: Brand
- **Version**: 18.0.1.0.1
- **Category**: N/A
- **License**: LGPL-3
- **Installable**: False
## Source
Based on [OCA/brand](https://github.com/OCA/brand) branch 16.0, addon `brand`.
## License
This package maintains the original LGPL-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
- 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,131 @@
.. image:: https://odoo-community.org/readme-banner-image
:target: https://odoo-community.org/get-involved?utm_source=readme
:alt: Odoo Community Association
=====
Brand
=====
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:aefb98870624360b290ccadfcf327b818e01d73f6ab5250b33ac82aa46618083
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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-LGPL--3-blue.png
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fbrand-lightgray.png?logo=github
:target: https://github.com/OCA/brand/tree/18.0/brand
:alt: OCA/brand
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/brand-18-0/brand-18-0-brand
: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/brand&target_branch=18.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
This is a base addon for brand modules. It adds the brand object and its
menu and define an abstract model to be inherited from branded objects.
**Table of contents**
.. contents::
:local:
Usage
=====
To use this module, you need to:
1. Go to Settings > General Settings
2. Select the brand use level
3. Go to Settings > Users & Companies > Brands
4. Add a new brand
5. Install one of branding module (e.g. account_brand)
6. Based on your choice for the brand use level, you will see a new
field added to the branded object
To make a branded object, you need to:
1. Inherit from the res.brand.mixin
.. code:: python
class YourModel(models.Model):
_name = 'your.model'
_inherit = ['your.model', 'res.brand.mixin']
2. Add the brand field to the object form or tree view. The mixin will
add the brand use level field automatically to the view and set the
modifiers to the brand field. This will define its visibility and if
it's required or not.
You can refer to the
`account_brand <https://github.com/OCA/brand/blob/18.0/account_brand>`__.
for more details.
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/brand/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/brand/issues/new?body=module:%20brand%0Aversion:%2018.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
-------
* ACSONE SA/NV
Contributors
------------
- Souheil Bejaoui <souheil.bejaoui@acsone.eu>
- `Obertix <https://www.obertix.net>`__:
- Vicent Cubells
- Ammar Officewala <aofficewala@opensourceintegrators.com>
Other credits
-------------
- ACSONE SA/NV <https://www.acsone.eu>
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-sbejaoui| image:: https://github.com/sbejaoui.png?size=40px
:target: https://github.com/sbejaoui
:alt: sbejaoui
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-sbejaoui|
This module is part of the `OCA/brand <https://github.com/OCA/brand/tree/18.0/brand>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

View file

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

View file

@ -0,0 +1,21 @@
# Copyright 2019 ACSONE SA/NV
# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0).
{
"name": "Brand",
"summary": """
This is a base addon for brand modules. It adds the brand object and
its menu and define an abstract model to be inherited from branded
objects""",
"version": "18.0.1.0.1",
"license": "LGPL-3",
"author": "Odoo Community Association (OCA), ACSONE SA/NV",
"website": "https://github.com/OCA/brand",
"depends": ["base_setup"],
"data": [
"views/res_config_settings.xml",
"security/res_brand.xml",
"views/res_brand.xml",
],
"maintainers": ["sbejaoui"],
}

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,4 @@
from . import res_brand
from . import res_brand_mixin
from . import res_company
from . import res_config_settings

View file

@ -0,0 +1,19 @@
# Copyright 2019 ACSONE SA/NV
# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0).
from odoo import fields, models
class ResBrand(models.Model):
_name = "res.brand"
_description = "Brand"
partner_id = fields.Many2one(
comodel_name="res.partner",
string="Partner",
required=True,
index=True,
auto_join=True,
delegate=True,
ondelete="restrict",
)

View file

@ -0,0 +1,85 @@
# Copyright 2019 ACSONE SA/NV
# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0).
from lxml.builder import E
from odoo import _, api, fields, models
from odoo.exceptions import ValidationError
from .res_company import BRAND_USE_LEVEL_NO_USE_LEVEL, BRAND_USE_LEVEL_REQUIRED_LEVEL
class ResBrandMixin(models.AbstractModel):
_name = "res.brand.mixin"
_description = "Brand Mixin"
brand_id = fields.Many2one(
comodel_name="res.brand",
string="Brand",
help="Brand to use for this sale",
)
brand_use_level = fields.Selection(
string="Brand Use Level",
related="company_id.brand_use_level",
)
company_id = fields.Many2one(
comodel_name="res.company",
)
def _is_brand_required(self):
self.ensure_one()
return self.company_id.brand_use_level == BRAND_USE_LEVEL_REQUIRED_LEVEL
@api.constrains("brand_id", "company_id")
def _check_brand_requirement(self):
for rec in self:
if rec._is_brand_required() and not rec.brand_id:
raise ValidationError(_("Brand is required"))
@api.constrains("brand_id", "company_id")
def _check_brand_company_id(self):
for rec in self:
if rec.brand_id.company_id and rec.brand_id.company_id != rec.company_id:
raise ValidationError(
_("Brand company must match document company for %s")
% rec.display_name
)
@api.onchange("brand_id")
def _onchange_brand_id(self):
for rec in self.filtered("brand_id.company_id"):
if rec.brand_id and rec.brand_id.company_id:
rec.company_id = rec.brand_id.company_id
def _get_view(self, view_id=None, view_type="form", **options):
"""set visibility and requirement rules"""
arch, view = super()._get_view(view_id, view_type, **options)
if view.type in ["form", "list"]:
brand_node = next(
iter(
arch.xpath(
'//field[@name="brand_id"][not(ancestor::*'
'[@widget="one2many" or @widget="many2many"])]'
)
),
None,
)
if brand_node is not None:
brand_node.addprevious(
E.field(
name="brand_use_level",
invisible="True",
column_invisible="True",
)
)
brand_node.set(
"invisible",
f"brand_use_level == '{BRAND_USE_LEVEL_NO_USE_LEVEL}'",
)
brand_node.set(
"required",
f"brand_use_level == '{BRAND_USE_LEVEL_REQUIRED_LEVEL}'",
)
return arch, view

View file

@ -0,0 +1,22 @@
# Copyright 2019 ACSONE SA/NV
# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0).
from odoo import fields, models
BRAND_USE_LEVEL_NO_USE_LEVEL = "no"
BRAND_USE_LEVEL_REQUIRED_LEVEL = "required"
BRAND_USE_LEVEL_SELECTION = [
(BRAND_USE_LEVEL_NO_USE_LEVEL, "Do not use brands on business document"),
("optional", "Optional"),
(BRAND_USE_LEVEL_REQUIRED_LEVEL, "Required"),
]
class ResCompany(models.Model):
_inherit = "res.company"
brand_use_level = fields.Selection(
selection=BRAND_USE_LEVEL_SELECTION,
default=BRAND_USE_LEVEL_NO_USE_LEVEL,
)

View file

@ -0,0 +1,14 @@
# Copyright 2019 ACSONE SA/NV
# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0).
from odoo import fields, models
class ResConfigSetting(models.TransientModel):
_inherit = "res.config.settings"
brand_use_level = fields.Selection(
string="Brand Use Level",
related="company_id.brand_use_level",
readonly=False,
)

View file

@ -0,0 +1,3 @@
[build-system]
requires = ["whool"]
build-backend = "whool.buildapi"

View file

@ -0,0 +1,4 @@
- Souheil Bejaoui \<<souheil.bejaoui@acsone.eu>\>
- [Obertix](https://www.obertix.net):
- Vicent Cubells
- Ammar Officewala \<<aofficewala@opensourceintegrators.com>\>

View file

@ -0,0 +1 @@
- ACSONE SA/NV \<<https://www.acsone.eu>\>

View file

@ -0,0 +1,2 @@
This is a base addon for brand modules. It adds the brand object and its
menu and define an abstract model to be inherited from branded objects.

View file

@ -0,0 +1,27 @@
To use this module, you need to:
1. Go to Settings \> General Settings
2. Select the brand use level
3. Go to Settings \> Users & Companies \> Brands
4. Add a new brand
5. Install one of branding module (e.g. account_brand)
6. Based on your choice for the brand use level, you will see a new
field added to the branded object
To make a branded object, you need to:
1. Inherit from the res.brand.mixin
``` python
class YourModel(models.Model):
_name = 'your.model'
_inherit = ['your.model', 'res.brand.mixin']
```
2. Add the brand field to the object form or tree view. The mixin will
add the brand use level field automatically to the view and set the
modifiers to the brand field. This will define its visibility and if
it's required or not.
You can refer to the
[account_brand](https://github.com/OCA/brand/blob/18.0/account_brand).
for more details.

View file

@ -0,0 +1,29 @@
<?xml version="1.0" encoding="utf-8" ?>
<!-- Copyright 2019 ACSONE SA/NV
License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0). -->
<odoo>
<record model="ir.model.access" id="res_brand_access_all">
<field name="name">res.brand access all</field>
<field name="model_id" ref="model_res_brand" />
<field name="perm_read" eval="1" />
<field name="perm_create" eval="0" />
<field name="perm_write" eval="0" />
<field name="perm_unlink" eval="0" />
</record>
<record model="ir.model.access" id="res_brand_access_manager">
<field name="name">res.brand manager access</field>
<field name="model_id" ref="model_res_brand" />
<field name="group_id" ref="base.group_system" />
<field name="perm_read" eval="1" />
<field name="perm_create" eval="1" />
<field name="perm_write" eval="1" />
<field name="perm_unlink" eval="1" />
</record>
<record id="res_brand_multi_company_rule" model="ir.rule">
<field name="name">Res Brand multi company rule</field>
<field name="model_id" ref="model_res_brand" />
<field name="domain_force">
['|',('company_id','=',False),('company_id', 'in', company_ids)]
</field>
</record>
</odoo>

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.2 KiB

View file

@ -0,0 +1,476 @@
<!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>README.rst</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">
<a class="reference external image-reference" href="https://odoo-community.org/get-involved?utm_source=readme">
<img alt="Odoo Community Association" src="https://odoo-community.org/readme-banner-image" />
</a>
<div class="section" id="brand">
<h1>Brand</h1>
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:aefb98870624360b290ccadfcf327b818e01d73f6ab5250b33ac82aa46618083
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<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/lgpl-3.0-standalone.html"><img alt="License: LGPL-3" src="https://img.shields.io/badge/license-LGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/brand/tree/18.0/brand"><img alt="OCA/brand" src="https://img.shields.io/badge/github-OCA%2Fbrand-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/brand-18-0/brand-18-0-brand"><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/brand&amp;target_branch=18.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
<p>This is a base addon for brand modules. It adds the brand object and its
menu and define an abstract model to be inherited from branded objects.</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="#other-credits" id="toc-entry-6">Other credits</a></li>
<li><a class="reference internal" href="#maintainers" id="toc-entry-7">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="usage">
<h2><a class="toc-backref" href="#toc-entry-1">Usage</a></h2>
<p>To use this module, you need to:</p>
<ol class="arabic simple">
<li>Go to Settings &gt; General Settings</li>
<li>Select the brand use level</li>
<li>Go to Settings &gt; Users &amp; Companies &gt; Brands</li>
<li>Add a new brand</li>
<li>Install one of branding module (e.g. account_brand)</li>
<li>Based on your choice for the brand use level, you will see a new
field added to the branded object</li>
</ol>
<p>To make a branded object, you need to:</p>
<ol class="arabic">
<li><p class="first">Inherit from the res.brand.mixin</p>
<pre class="code python literal-block">
<span class="k">class</span><span class="w"> </span><span class="nc">YourModel</span><span class="p">(</span><span class="n">models</span><span class="o">.</span><span class="n">Model</span><span class="p">):</span><span class="w">
</span> <span class="n">_name</span> <span class="o">=</span> <span class="s1">'your.model'</span><span class="w">
</span> <span class="n">_inherit</span> <span class="o">=</span> <span class="p">[</span><span class="s1">'your.model'</span><span class="p">,</span> <span class="s1">'res.brand.mixin'</span><span class="p">]</span>
</pre>
</li>
<li><p class="first">Add the brand field to the object form or tree view. The mixin will
add the brand use level field automatically to the view and set the
modifiers to the brand field. This will define its visibility and if
its required or not.</p>
</li>
</ol>
<p>You can refer to the
<a class="reference external" href="https://github.com/OCA/brand/blob/18.0/account_brand">account_brand</a>.
for more details.</p>
</div>
<div class="section" id="bug-tracker">
<h2><a class="toc-backref" href="#toc-entry-2">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/brand/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/brand/issues/new?body=module:%20brand%0Aversion:%2018.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">
<h2><a class="toc-backref" href="#toc-entry-3">Credits</a></h2>
<div class="section" id="authors">
<h3><a class="toc-backref" href="#toc-entry-4">Authors</a></h3>
<ul class="simple">
<li>ACSONE SA/NV</li>
</ul>
</div>
<div class="section" id="contributors">
<h3><a class="toc-backref" href="#toc-entry-5">Contributors</a></h3>
<ul class="simple">
<li>Souheil Bejaoui &lt;<a class="reference external" href="mailto:souheil.bejaoui&#64;acsone.eu">souheil.bejaoui&#64;acsone.eu</a>&gt;</li>
<li><a class="reference external" href="https://www.obertix.net">Obertix</a>:<ul>
<li>Vicent Cubells</li>
</ul>
</li>
<li>Ammar Officewala &lt;<a class="reference external" href="mailto:aofficewala&#64;opensourceintegrators.com">aofficewala&#64;opensourceintegrators.com</a>&gt;</li>
</ul>
</div>
<div class="section" id="other-credits">
<h3><a class="toc-backref" href="#toc-entry-6">Other credits</a></h3>
<ul class="simple">
<li>ACSONE SA/NV &lt;<a class="reference external" href="https://www.acsone.eu">https://www.acsone.eu</a>&gt;</li>
</ul>
</div>
<div class="section" id="maintainers">
<h3><a class="toc-backref" href="#toc-entry-7">Maintainers</a></h3>
<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>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p>
<p><a class="reference external image-reference" href="https://github.com/sbejaoui"><img alt="sbejaoui" src="https://github.com/sbejaoui.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/brand/tree/18.0/brand">OCA/brand</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>
</div>
</body>
</html>

View file

@ -0,0 +1,3 @@
from . import test_brand
from . import test_brand_mixin
from . import common

View file

@ -0,0 +1,24 @@
from odoo.tests import tagged
from odoo.tests.common import TransactionCase
@tagged("post_install", "-at_install")
class CommonCase(TransactionCase):
@classmethod
def setUpClass(cls):
super().setUpClass()
cls.env = cls.env(context=dict(cls.env.context, tracking_disable=True))
cls.brand_model = cls.env["res.brand"]
cls.company_model = cls.env["res.company"]
cls.partner_model = cls.env["res.partner"]
cls.company_no_brand = cls.company_model.create({"name": "No Brand Company"})
cls.company_optional_brand = cls.company_model.create(
{"name": "Optional Brand Company", "brand_use_level": "optional"}
)
cls.company_required_brand = cls.company_model.create(
{"name": "Required Brand Company", "brand_use_level": "required"}
)
cls.partner = cls.partner_model.create({"name": "Test Partner"})
cls.brand = cls.brand_model.create({"partner_id": cls.partner.id})

View file

@ -0,0 +1,8 @@
from .common import CommonCase
class TestBrandMixin(CommonCase):
def test_brand_creation(self):
"""Test creation of a brand."""
brand = self.brand_model.create({"partner_id": self.partner.id})
self.assertTrue(brand.exists())

View file

@ -0,0 +1,13 @@
from lxml import etree
from .common import CommonCase
class TestBrand(CommonCase):
def test_get_view(self):
view = self.env["res.config.settings"].get_view(
view_id=self.env.ref("base.res_config_settings_view_form").id,
view_type="form",
)
doc = etree.XML(view["arch"])
self.assertTrue(doc.xpath("//field[@name='brand_use_level']"))

View file

@ -0,0 +1,185 @@
<?xml version="1.0" encoding="utf-8" ?>
<!-- Copyright 2019 ACSONE SA/NV
License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0). -->
<odoo>
<record model="ir.ui.view" id="res_brand_form_view">
<field name="model">res.brand</field>
<field name="inherit_id" eval="False" />
<field name="mode">primary</field>
<field name="arch" type="xml">
<form string="Partners">
<sheet>
<div class="oe_button_box" name="button_box" />
<widget
name="web_ribbon"
title="Archived"
bg_color="bg-danger"
invisible="active == True"
/>
<field name="avatar_128" invisible="1" />
<field
name="image_1920"
widget="image"
class="oe_avatar"
options="{&quot;preview_image&quot;: &quot;avatar_128&quot;}"
/>
<div class="oe_title mb24">
<field name="active" invisible="1" />
<label for="name" class="oe_edit_only" />
<h1>
<field name="name" />
</h1>
</div>
<group>
<group>
<label for="street" string="Address" />
<div class="o_address_format">
<field
name="street"
placeholder="Street..."
class="o_address_street"
/>
<field
name="street2"
placeholder="Street 2..."
class="o_address_street"
/>
<field
name="city"
placeholder="City"
class="o_address_city"
/>
<field
name="state_id"
class="o_address_state"
placeholder="State"
options="{'no_open': True, 'no_quick_create': True}"
context="{'country_id': country_id, 'default_country_id': country_id, 'zip': zip}"
/>
<field
name="zip"
placeholder="ZIP"
class="o_address_zip"
/>
<div
name="partner_address_country"
class="d-flex justify-content-between"
>
<field
name="country_id"
placeholder="Country"
class="o_address_country"
options="{&quot;no_open&quot;: True, &quot;no_create&quot;: True}"
/>
</div>
</div>
<field name="vat" placeholder="e.g. BE0477472701" />
</group>
<group>
<field name="phone" widget="phone" />
<field name="mobile" widget="phone" />
<field name="email" widget="email" />
<field
name="website"
string="Website"
widget="url"
placeholder="e.g. https://www.odoo.com"
/>
</group>
</group>
</sheet>
</form>
</field>
</record>
<record model="ir.ui.view" id="res_brand_search_view">
<field name="model">res.brand</field>
<field name="inherit_id" ref="base.view_res_partner_filter" />
<field name="mode">primary</field>
<field name="arch" type="xml">
<xpath expr="//search" position="attributes">
<attribute name="string">Brands</attribute>
</xpath>
</field>
</record>
<record model="ir.ui.view" id="res_brand_kanban_view">
<field name="model">res.brand</field>
<field name="inherit_id" eval="False" />
<field name="mode">primary</field>
<field name="arch" type="xml">
<kanban class="o_res_partner_kanban" sample="1">
<field name="id" />
<field name="color" />
<field name="display_name" />
<field name="title" />
<field name="email" />
<field name="phone" />
<field name="street" />
<field name="street2" />
<field name="zip" />
<field name="city" />
<field name="country_id" />
<field name="mobile" />
<field name="state_id" />
<field name="category_id" />
<field name="image_128" />
<field name="type" />
<templates>
<t t-name="card" class="flex-row">
<t
t-set="placeholder"
t-value="'/base/static/img/company_image.png'"
/>
<field
name="image_128"
widget="image"
class="h-100"
options="{'img_class': 'object-fit-cover'}"
/>
<main class="ps-2 ps-md-0">
<div class="mb-1">
<field name="display_name" class="mb-0 fw-bold fs-5" />
</div>
<div
t-if="record.city.raw_value or record.country_id.raw_value"
>
<field name="city" />
<span
t-if="record.city.raw_value and record.country_id.raw_value"
>, </span>
<field name="country_id" />
</div>
<field name="email" class="text-truncate" />
<footer>
<div />
</footer>
</main>
</t>
</templates>
</kanban>
</field>
</record>
<record model="ir.ui.view" id="res_brand_list_view">
<field name="name">res.brand.list (in partner_brand)</field>
<field name="model">res.brand</field>
<field name="inherit_id" ref="base.view_partner_tree" />
<field name="mode">primary</field>
<field name="arch" type="xml">
<xpath expr="//list" position="attributes">
<attribute name="string">Brands</attribute>
</xpath>
</field>
</record>
<record model="ir.actions.act_window" id="res_brand_act_window">
<field name="name">Brands</field>
<field name="res_model">res.brand</field>
<field name="view_mode">kanban,list,form</field>
<field name="context">{'default_customer': 0, 'default_supplier': 0,}
</field>
</record>
<record model="ir.ui.menu" id="res_brand_menu">
<field name="name">Brands</field>
<field name="parent_id" ref="base.menu_users" />
<field name="action" ref="res_brand_act_window" />
</record>
</odoo>

View file

@ -0,0 +1,23 @@
<?xml version="1.0" encoding="utf-8" ?>
<!-- Copyright 2019 ACSONE SA/NV
License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl-3.0). -->
<odoo>
<record model="ir.ui.view" id="res_config_settings_view_form">
<field name="model">res.config.settings</field>
<field name="inherit_id" ref="base_setup.res_config_settings_view_form" />
<field name="arch" type="xml">
<xpath
expr="//block[@name='companies_setting_container']"
position="inside"
>
<setting
string="Brand"
help="Configure branding of customer facing business documents (SO, invoices, etc)."
company_dependent="1"
>
<field name="brand_use_level" required="1" />
</setting>
</xpath>
</field>
</record>
</odoo>

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 Brand Module - brand
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 brand. 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:
- [base_setup](../../odoo-bringout-oca-ocb-base_setup)

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 brand or install in UI.

View file

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

View file

@ -0,0 +1,15 @@
# Models
Detected core models and extensions in brand.
```mermaid
classDiagram
class res_brand
class res_brand_mixin
class res_company
class res_config_settings
```
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: brand. Provides features documented in upstream Odoo 16 under this addon.
- Source: OCA/OCB 16.0, addon brand
- License: LGPL-3

View file

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

View file

@ -0,0 +1,61 @@
# Security
Access control and security definitions in brand.
## Access Control Lists (ACLs)
Model access permissions defined in:
- **[CHANGELOG.md](../CHANGELOG.md)**
- 132 model access rules
- **[doc](../doc)**
- **[docker](../docker)**
- **[input](../input)**
- **[nix](../nix)**
- **[odoo.conf](../odoo.conf)**
- 58 model access rules
- **[odoo_packages_bez_l10n.txt](../odoo_packages_bez_l10n.txt)**
- 1947 model access rules
- **[odoo_packages_bringout.txt](../odoo_packages_bringout.txt)**
- 1947 model access rules
- **[odoo_packages.txt](../odoo_packages.txt)**
- 2085 model access rules
- **[output](../output)**
- **[packages](../packages)**
- **[PACKAGES.md](../PACKAGES.md)**
- 298 model access rules
- **[README.md](../README.md)**
- 338 model access rules
- **[scripts](../scripts)**
- **[temp](../temp)**
- **[TRANSLATION_BS_SUMMARY.md](../TRANSLATION_BS_SUMMARY.md)**
- 146 model access rules
## Record Rules
Row-level security rules defined in:
## Security Groups & Configuration
Security groups and permissions defined in:
- **[res_brand.xml](../brand/security/res_brand.xml)**
```mermaid
graph TB
subgraph "Security Layers"
A[Users] --> B[Groups]
B --> C[Access Control Lists]
C --> D[Models]
B --> E[Record Rules]
E --> F[Individual Records]
end
```
Security files overview:
- **[res_brand.xml](../brand/security/res_brand.xml)**
- Security groups, categories, and XML-based rules
Notes
- Access Control Lists define which groups can access which models
- Record Rules provide row-level security (filter records by user/group)
- Security groups organize users and define permission sets
- All security is enforced at the ORM level by Odoo

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 brand
```

View file

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

View file

@ -0,0 +1,45 @@
[project]
name = "odoo-bringout-oca-brand-brand"
version = "16.0.0"
description = "Brand -
This is a base addon for brand modules. It adds the brand object and
its menu and define an abstract model to be inherited from branded
objects"
authors = [
{ name = "Ernad Husremovic", email = "hernad@bring.out.ba" }
]
dependencies = [
"odoo-bringout-oca-ocb-base_setup>=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 = ["brand"]
[tool.rye]
managed = true
dev-dependencies = [
"pytest>=8.4.1",
]