About this plugin
When someone fills in a contact form on your site, this plugin writes them into
partner ) and tags it with the Odoo
contact tag you choose, so web enquiries are easy to find and filter.
It talks to Odoo over the External JSON-2 API ( POST /json/2/{model}/{method}
with bearer-token authentication). It deliberately avoids the legacy XML-RPC and
/jsonrpc endpoints, which Odoo has deprecated.
What it does
- Field mapping you control. Point any Odoo contact field — name, email,
phone, mobile, company, website, job position, street, city, ZIP, notes — at
whichever field id your form sends. Nothing is hard-coded.
- Nothing is dropped. Form fields with no Odoo field to map to — a checkbox
group such as “I’m interested in”, a dropdown — are added to the contact’s
Notes as “Label: value” lines. This can be switched off.
- Contact tag. Enter the ID of an Odoo contact tag and every contact the
plugin creates or updates gets that tag. Tags already on a contact are kept.
- Duplicate handling. Matches on email, case-insensitively. Choose whether a
repeat submission updates the existing contact, is left alone, or always
creates a new record.
- Non-destructive updates. When it updates an existing contact it appends to
the Notes field rather than overwriting it, and never rewrites the contact’s
name. Your sales team’s notes survive.
- Divi Contact Form support. Detected automatically when Divi or the Divi
Builder is active. You design and edit the form in the Divi Builder as usual —
fields, labels, button, captcha — and the plugin sends each accepted
submission to Odoo from the server, so your API key never reaches the browser.
- Diagnostics. A read-only “Test connection” check (which also confirms the
tag ID exists) and a “Create a test contact” button, so you find out about a bad API key on the settings screen
rather than from a visitor’s lost enquiry.
- Safe by design. A sync failure is logged and swallowed — it never turns
into a broken-looking page for the person who filled in your form.
Requirements
- An Odoo server running version 19 or newer, reachable over HTTPS.
- An Odoo API key for a user with create/write access to res.partner and read
category ).
- PHP 8.1 or newer, WordPress 6.4 or newer.
Extending it
Form integrations are pluggable. Implement OdooConnector\Forms\FormIntegration
and add it through the odoo_connector_form_integrations filter to support
WPForms, Gravity Forms, Contact Form 7 or anything else.
External services
This plugin sends data to the Odoo server that you configure on its settings
screen. No data is sent anywhere else, and the plugin contacts no service
belonging to CandorLight LLC or to any third party.
What is sent, and when. Each time a visitor submits a connected form, the
plugin makes an HTTPS request to your Odoo server containing the form values you
have mapped. In a default setup that is the visitor’s name, email address, phone
number, company name, company website and message, plus a provenance line naming
the form, your site’s URL and the submission time, and the contact tag ID you
configured. Requests are also made
when you press “Test connection” (a read-only count of contacts and a lookup of
the configured tag) or “Create a
test contact” on the settings screen.
Where it goes. To the URL you enter as the Odoo URL — normally your own
self-hosted Odoo instance or your Odoo Online subscription. This plugin’s
authors do not operate, host or have access to that server.
Whose terms apply. If you use Odoo Online or another hosted Odoo service,
that provider’s terms and privacy policy govern the data once it arrives:
com/terms and their privacy policy at
com/privacy. If you self-host, the data stays on your own
infrastructure.
Because the plugin transmits personal data your visitors have submitted, make
sure your own privacy policy says so, and that you have a lawful basis for
sending it to your CRM.