[Show and tell] paperless_attach – attach Paperless-ngx documents from the compose window

[dodjango]

I built a plugin that integrates Paperless-ngx (a self-hosted document management system) into the compose window: attach documents from Paperless directly while writing an email, instead of downloading and re-uploading them.

Typical use case: replying to an email and attaching a document you already have filed in Paperless — hit "Attach from Paperless", search, pick, send.

What it does

• "Attach from Paperless" button in the compose window
• Search & filter by tags, correspondent, document type and date
• Selected documents are fetched server-side and attached to the outgoing mail

Implementation notes

• Roundcube 1.6, Elastic skin only; PHP 7.4+
• Per-user API token stored encrypted (rcmail->encrypt/decrypt); the browser never sees the token or the Paperless base URL — all Paperless traffic is server-side
• Attach happens at send time via the message_ready hook, so the download-induced session reload does not drop the attachment

Install: composer require dodjango/paperless_attach
Code & docs (GPL-3.0): https://github.com/dodjango/roundcube-paperless-attach

Feedback welcome — issues and PRs appreciated.