OdooWiki OCA HUB

Configuration Helper

configuration_helper folder_open OCA/server-tools open_in_new
server License: AGPL-3

This module is intended for developer only. It does nothing used alone.

It helps to create config.settings by providing an abstract Class.

This class:

  • creates automatically related fields in 'res.config.settings' using those defined in 'res.company': it avoids duplicated field definitions.
  • company_id field with default value is created
  • onchange_company_id is defined to update all related fields
  • supported fields: char, text, integer, float, datetime, date, boolean, m2o

auto_awesome What this module does

AI-generated from the code · Odoo 14.0

This is a developer-only helper module that does not add any screen or feature for end users. It provides a reusable base model so other modules can build configuration settings screens with less duplicated code.

This module is a technical building block, not a business feature. It adds an abstract model named abstract.config.settings that other modules can inherit from when they want to create their own configuration settings screens.

What it does, based on the code:

  • It defines a company_id field pointing to res.company, marked as required, and automatically filled with the current user's company.
  • When a module inherits this abstract model, the module automatically creates related fields on the settings screen for the fields defined on res.company whose names start with the prefix setting_. The prefix is removed from the new field name, and each new field is linked to the matching company field.
  • A _filter_field method exists so that a module can decide which company fields should not get a matching related field; by default it keeps all of them.
  • The supported field types are those that can be copied from res.company fields, such as text, numbers, dates, booleans and many-to-one relations.

There are no menus, buttons, reports, scheduled jobs or emails in this module. It only touches the res.company model by reading its fields and the abstract abstract.config.settings model. Any visible effect in Odoo depends entirely on other modules that inherit this helper.

Depends on

base

Required by other modules

delivery_carrier_label_postlogisticsl10n_ch_delivery_carrier_label_quickpac
Models and fields (1)
  • abstract.config.settings · new modelcompany_id

Text generated by AI (DeepSeek) from reading the Odoo 14.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 3 confirmed, 6 with no information of 9 versions.

Sources · Odoo 14.0

Confirmed on 2026-11-03 in branch 14.0 of OCA/server-tools.

terminal Installation and usage

OCA documentation · Odoo 14.0

Usage

Source · Odoo 14.0
from . company import ResCompany

class WhatiwantConfigSettings(models.TransientModel):
    _inherit = ['res.config.settings', 'abstract.config.settings']
    _name = 'res.config.settings'
    # fields must be defined in ResCompany class
    # related fields are automatically generated from previous definitions
    _companyObject = ResCompany
    # all prefixed field with _prefix in res.company, will be available in 'res.config.settings' model
    _prefix = 'prefixyouchoose_'

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.