Connections: a plugin may offer links on its connection's card #889

Closed
opened 2026-10-10 16:35:02 +00:00 by tiagoagueda · 1 comment
Owner

A connection whose service has no usable API for a person can still save them a search: a link to their own space there, to the page where a monthly declaration is made, to its messages. Today a connection's card shows only a text summary(config).

What exists today

  • Optional connected-plugin methods: validate, summary, form_attributes, test, needs_consent (plugins/base.py:835-850).
  • The card: Settings → Connections (templates/plugins/…).

What would change

  • Optional links(config) -> list[tuple[str, str]] (label, https URL), drawn on the card as external links (rel="noopener noreferrer", target="_blank", the external-link icon), at most six.
  • URLs checked: https only, through the same check as JobPostingData.url (page_address); a bad one dropped and logged, never drawn.
  • Used first by tiagoagueda/postulo-francetravail#5. Documented in CONTRIBUTING.md and the wiki's Writing a plugin beside summary.

Checked against main at 8c3d03570. Needed by tiagoagueda/postulo-francetravail, an independent plugin outside Postulo's official repositories, but general to any country's employment service.

A connection whose service has no usable API for a person can still save them a search: a link to their own space there, to the page where a monthly declaration is made, to its messages. Today a connection's card shows only a text `summary(config)`. ## What exists today - Optional connected-plugin methods: `validate`, `summary`, `form_attributes`, `test`, `needs_consent` (`plugins/base.py:835-850`). - The card: *Settings → Connections* (`templates/plugins/…`). ## What would change - Optional `links(config) -> list[tuple[str, str]]` (label, `https` URL), drawn on the card as external links (`rel="noopener noreferrer"`, `target="_blank"`, the external-link icon), at most six. - URLs checked: `https` only, through the same check as `JobPostingData.url` (`page_address`); a bad one dropped and logged, never drawn. - Used first by tiagoagueda/postulo-francetravail#5. Documented in `CONTRIBUTING.md` and the wiki's *Writing a plugin* beside `summary`. Checked against `main` at `8c3d03570`. Needed by [tiagoagueda/postulo-francetravail](https://source.tiagoagueda.com/tiagoagueda/postulo-francetravail), an independent plugin outside Postulo's official repositories, but general to any country's employment service.
tiagoagueda added this to the 0.6.0 milestone 2026-10-10 16:35:02 +00:00
Author
Owner

Fixed in 5c6019214 on main.

Fixed in 5c6019214 on main.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Postulo/postulo#889
No description provided.