[MIG] partner_portal_extra_links: migrate to 18.0

partner_portal_extra_links/README.md

@@ -0,0 +1,99 @@
+# Partner Portal Extra Links
+
+Add extra links (visio room URL, wiki homepage URL) to the partner form and
+display them in the portal user's home page.
+
+## Description
+
+### Extra Fields on Partner (Company)
+
+The module adds two fields on the partner form, visible only for companies
+(`is_company = True`):
+
+| Field | Description |
+|---|---|
+| **Visio URL** | URL for the visio meeting room associated with the company |
+| **Wiki Homepage URL** | URL for the wiki homepage associated with the company |
+
+These fields appear in the backend partner form, right after the *Tags*
+(`category_id`) field.
+
+### Portal Display
+
+When a portal user visits their home page (`/my`), the module displays their
+**parent company's** extra links in the contact details section:
+
+- **Salle de visio** — clickable link to the company's visio room
+- **Gare centrale** — clickable link to the company's wiki homepage
+
+Each link is only shown if the corresponding URL is set on the parent company,
+and only if the portal user belongs to a company (has a `parent_id`).
+
+## How It Works
+
+1. The module inherits `res.partner` and adds two `Char` fields: `visio_url`
+   and `wiki_homepage_url`.
+2. The backend partner form view is extended to show these fields after the tags
+   field, hidden for individual contacts (non-company partners).
+3. The portal layout template (`portal.portal_layout`) is extended to inject
+   clickable links into the "My Details" section. The links are read from
+   `user_id.partner_id.parent_id` (the portal user's parent company).
+
+## Dependencies
+
+This module depends on:
+
+- `base`: Odoo base module
+
+No external Python dependencies are required.
+
+## Installation
+
+Use the standard Odoo module installation procedure to install
+`partner_portal_extra_links`.
+
+## Configuration
+
+1. Go to **Contacts** and open a company form.
+2. Fill in the **Visio URL** and/or **Wiki Homepage URL** fields.
+3. Portal users belonging to that company will see the links on their portal
+   home page.
+
+No other configuration is required.
+
+## Known Issues / Limitations
+
+- The extra links are only displayed for portal users that have a parent company
+  (`parent_id`). Individual portal contacts without a parent company will not
+  see any links.
+- The portal labels ("Salle de visio", "Gare centrale") are currently
+  hardcoded in French in the template.
+
+## Bug Tracker
+
+Bugs are tracked on
+[Elabore Git Issues](https://git.elabore.coop/Elabore/partner-tools/issues).
+
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us smash it by providing a detailed and welcomed
+feedback.
+
+## Credits
+
+### Authors
+
+- [Elabore](https://elabore.coop)
+
+### Contributors
+
+- Boris Gallet <boris.gallet@elabore.coop>
+
+### Funders
+
+The development of this module has been financially supported by:
+
+- [Elabore](https://elabore.coop)
+
+### Maintainer
+
+This module is maintained by Elabore.