OdooWiki OCA HUB

OCA Membership Groups (custom)

oca_membership_groups folder_open OCA/oca-custom open_in_new
Custom License: AGPL-3

This module manages the mailing lists inside the OCA. It relies on the native Odoo model Mailing Group mail.group.

Main features

This module allows:

  • to distinguish Working Groups from other Mail Groups, so they are published on the website on members' page
  • to keep up-to-date the Mail Groups compared to Members roles in the association (like Members and Delegate mailing list)
  • removes the expired members with a grace period
  • retain the wish of the members who unsubscribed, to prevent spamming them by re-adding them to the mailing lists

Notes

  • Any Mailing Group member, being a portal or internal Odoo users, may subscribe or unsubscribed from /groups controller
  • The Board Members mailing list is managed manually (not automatized)
  • The Contributor mailing list too, and is public

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Links mailing groups to membership categories so members are automatically subscribed to the right mailing lists, with a grace period before expired members are removed and unsubscriptions remembered.

This module connects Odoo's mailing groups (mailing lists) with the association's membership categories, so mailing lists follow membership automatically.

  • On each mailing group you can mark it as a Working Group (shown on the members' website page), link it to one or more membership categories, and set a grace period in days (default 90).
  • On each membership category you can choose the mailing groups its members should join automatically. Members of that category are subscribed automatically and can still unsubscribe themselves.
  • When a member leaves a category, a grace period starts; the member stays in the list until the deadline (start date plus the group's grace days). A daily scheduled job removes members whose grace period has ended.
  • If a member unsubscribes from the portal, the subscription is archived rather than deleted, so the system remembers the choice and does not re-add them automatically. If they subscribe again, the existing record is reactivated instead of duplicated.
  • A new 'Groups' menu appears under the Membership app, and the mailing group screens (kanban, form, search) gain the new fields, a 'Working Groups' filter and 'Membership' badges.
  • The member list shows grace start and deadline dates, with filters for 'Unsubscribed (archived)' and 'In grace period'.
  • The contact form gets a smart button counting the contact's mailing groups.
  • Public mailing group pages are marked noindex so search engines do not index them.

Depends on

mail_groupoca_membership

Required by other modules

oca_search_engine

Menus it adds

menu_membership_mail_group
Models and fields (4)
  • mail.group · extends an existing modelgrace_days, is_working_group (Is a Working Group), membership_category_ids (Membership Categories)
  • res.partner · extends an existing modelmail_group_count (Mail Groups), mail_group_member_ids
  • mail.group.member · extends an existing modelactive, grace_date_start, grace_date_deadline (Grace Deadline)
  • membership.membership_category · extends an existing modelmail_group_ids (Mail Groups)

Text generated by AI (DeepSeek) from reading the Odoo 18.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: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 18.0

Confirmed on 2026-11-03 in branch 18.0 of OCA/oca-custom.

terminal Installation and usage

OCA documentation · Odoo 18.0

Usage

Source · Odoo 18.0

Set up synchronization between Mail Groups and Member Categories

On Member's form:

  • On Member Categories change, the Mail Groups are updated
  • To view it: open the Mail Groups smart button
  • If needed, filter with Unsubscribed (archived) or In grace period

Disable a grace period

If a member is in a Grace Period but you want to keep he/her on a Mail Group:

  • Browse to "Members / Groups" and click on the "Members" smart button
  • Filter on In grace period
  • Manually set Grace date end to a far date in the future. It will not be overriden by the automated mechanism.

Send Email Marketting (Mass Mailing) based on Member Categories

  • Browse to "Email Marketing / [+ New]"
  • Recipients: select "Contact"
  • In the Mail Body, replace the Unsubscribe link with this one:

A default domain helps filtering on all active members. You may save this domain as favorite filter, and / or modify it.

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.