RecruitmentCopyClipboardChar

The standard copy-clipboard widgets copy whatever the field already holds. This recruitment variant generalizes the idea: its button component, GenerateContentAndCopyButton, accepts an optional content generation function, and when one is configured the click first calls that method on the server, then copies the returned string. The widget wires that up from an option naming a model method, called with the record's id.

Its second trick is display. When displayed_value is set, the template shows that static text instead of the field's value, so a list can render a tidy Email label per row while the actual address, possibly not even existing yet, stays behind the button. Without either option the widget degrades gracefully into the ordinary copy-char behavior.

The core use case explains the design. Recruitment sources, LinkedIn, a job board, a campaign, can each have their own inbound email alias so applications are tracked per source. Creating every alias up front would litter the mail system with unused addresses, so Odoo creates them lazily: the alias comes into existence the first time a recruiter clicks copy, via create_and_get_alias, and the clipboard receives a ready-to-paste address either way.

The pattern, generate on demand, copy immediately, show a stable label, fits any share-a-link workflow: signed portal URLs, tracking links, API keys. If your team builds one of those, this widget is the reference implementation to copy rather than a new invention.

The core pattern: lazy alias on recruitment sources

<field name="email"
       widget="RecruitmentCopyClipboardChar"
       invisible="not has_domain"
       options="{'content_generation_function_name': 'create_and_get_alias', 'displayed_value': 'Email'}"/>

Each row shows Email plus a copy icon; the click creates the alias if needed and copies the address. The column hides entirely when no alias domain is configured.

Plain mode: copy what is stored

<field name="tracking_url" widget="RecruitmentCopyClipboardChar"/>

Without options this is nearly the base widget, with one visible difference: no value text is rendered, only the button, since the template's span shows displayed_value and that is empty.

The generation callback is three lines that matter: it calls orm.call(resModel, functionName, [resId]) and hands the result to the base CopyButton, which writes it to the clipboard and shows the success tooltip. Two consequences follow. First, the method name is evaluated on the record's own model, so the widget is portable to any model that implements a matching method returning a string. Second, the browser clipboard API requires a secure context, so like every CopyClipboard widget it needs HTTPS or localhost, the returned content never appears on screen otherwise.

One more subtlety: the template renders displayed_value unconditionally, not the field's value. In generation mode that is the point, the stored field may be empty until the first click. In plain mode it means this widget shows only a button, which distinguishes it from base CopyClipboardChar, whose readonly template prints the value and renders nothing at all when the field is empty.

Odoo 20 is expected at Odoo Experience in Brussels, 24 to 26 September 2026, and the development branch is unstable until feature freeze; this section is provisional and re-verified after release.

The changes visible for this widget are purely mechanical: props migrate to the new Owl typing API on a shared copyClipboardFieldProps object, and the template updates its expressions to the new explicit this. style with t-esc becoming t-out. Options, behavior, the CamelCase name, and both core usages are unchanged at the time of writing.