odoo-cooltools/dlv_fleetflow_base/README.md

dlv_fleetflow_base

Overview

dlv_fleetflow_base is the foundation addon for all FleetFlow-branded addons. It permanently owns the FleetFlow entry in the Odoo Settings sidebar (Settings → FleetFlow) and provides an empty settings block that feature addons extend. It contains no models and no business logic — its only job is to give every dlv_fleetflow_* addon a single, shared place to live in Settings.

How it works

This addon inherits the standard configuration form (base_setup.res_config_settings_view_form) and injects a FleetFlow app_settings_block carrying data-key="dlv_fleetflow_base" and an empty <notebook/>. It also creates the FleetFlow menu entry and the action that opens Settings directly on that block.

Feature addons (dlv_fleetflow_*) never create their own Settings entry. Instead, each one adds a tab by inheriting the same base configuration form and targeting the shared notebook with an xpath:

//div[@data-key='dlv_fleetflow_base']//notebook

Because every feature addon depends on dlv_fleetflow_base, its view is loaded first, so the notebook exists when the feature addon's xpath runs. The result is one FleetFlow settings page with one tab per installed feature addon.

Adding a new FleetFlow addon

1. Add dlv_fleetflow_base to your addon's depends.
2. Inherit the base configuration form and add a <page> to the shared notebook:

<record id="my_addon_config_settings_view_form" model="ir.ui.view">
    <field name="name">res.config.settings.view.form.inherit.my.addon</field>
    <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="//div[@data-key='dlv_fleetflow_base']//notebook" position="inside">
            <page string="My Addon">
                <!-- your settings content here -->
            </page>
        </xpath>
    </field>
</record>

3. That's it — your tab appears under Settings → FleetFlow alongside the others.

Dependencies

• base
• base_setup

Installation

Install dlv_fleetflow_base first, before any other dlv_fleetflow_* addon. It is a permanent dependency: do not uninstall it while any FleetFlow feature addon is still active, or those addons will lose their Settings tab and fail to load their configuration views.