OdooWiki OCA HUB
Custom License: AGPL-3

OCA VCP Customization

Module extending VCP for OCA-specific needs.

Features

Repositories

  • Add categories to repositories

Odoo Modules

  • must_have flag on modules
  • Extract and store README fragments and convert them to markdown
  • Extract icon URLs

Partners/Contributors

  • Add GitHub tab with main login and avatar sync option
  • Compute OCA collaboration index
  • Support organization history for accurate contribution attribution

Contributions

  • Reviews and comments use contributor's organization (not PR opener's)

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds OCA-specific tools to the VCP app: repository categories, a must-have flag on modules, README and icon extraction, GitHub login and avatar sync on contacts, an OCA collaboration index, and organization history for attributing contributions.

This module customises the VCP application for OCA needs. It adds a new "Repository Categories" screen under the VCP settings menu, where managers can create categories with a short description, a description and a list of repositories. Repositories get a Category field, visible on their form and list, and can be grouped by category in the search view.

On Odoo modules, a "Must have" checkbox is added next to the module name. Module versions now store extracted README fragments (converted from RST to Markdown) and an icon URL, with a known deprecated logo ignored.

On contacts, a new "Contributor" tab shows a GitHub section with a main login and an avatar sync option, plus a "Company History" list. The main GitHub login is unique per contact and links to a VCP user; if the login is already used by another contact, an error is raised. A computed "OCA collaboration index" is shown, based on merged requests, reviews, created requests and comments over the last 12 months. The current organization is computed from the company history, falling back to the parent company.

Reviews and comments now record the organization of the contributor who wrote them, based on the date of the review or comment. A new Organization History model stores, per contact, a start date and an organization.

Required by other modules

Menus it adds

vcp_repository_category_menu
Models and fields (9)
  • vcp.user · extends an existing modelis_github_main_login
  • vcp.review · extends an existing modelpartner_organization_id
  • res.partner · extends an existing modelgithub_main_login, github_sync_avatar, current_organization_id, oca_collaboration_index (OCA collaboration index), organization_member_ids, organization_history_ids
  • vcp.comment · extends an existing modelpartner_organization_id
  • vcp.repository · extends an existing modelcategory_id
  • vcp.odoo.module · extends an existing modelmust_have
  • vcp.odoo.module.version · extends an existing modelicon_url, readme_fragments
  • vcp.repository.category · new modelname, description, repository_ids, short_description
  • vcp.organization.history · new modeldate_start, partner_id, partner_organization_id

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

No verified information

Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.

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.