DFX Parish Retreat Letters

DFX Parish Retreat Letters

0/5 (0 ratings) — active installs Updated Nov 14, 2026

DFX Parish Retreat Letters lets your parish manage the full lifecycle of confidential personal messages for retreat attendants — from collecting letters through a public web form to printing them securely in the admin, while keeping every piece of content fully encrypted and every action fully audited.

How it works

  1. Create a retreat and register your attendants.
  2. Share each attendant’s unique, private URL with the people who want to write to them — family, friends, spiritual directors.
  3. Writers fill in the form on a clean public page: they can type a rich-text message, attach images or documents, and agree to a legal disclaimer. A simple arithmetic CAPTCHA protects against bots.
  4. Messages are stored encrypted in the database. Nobody can read them by browsing the admin — they are only revealed at print time.
  5. Authorised staff print the messages from the admin panel. Each print is logged with the user’s name, timestamp, and IP address.
  6. Messages are handed to attendants during or after the retreat.

Retreat management

  • Create retreats with name, location, start and end dates, and a custom welcome message shown on the submission form.
  • Set a legal disclaimer text and an acceptance checkbox label that writers must tick before they can submit.
  • Enable or disable optional Notes and Internal Notes fields per retreat (Notes are exportable; Internal Notes are not).
  • Set custom body CSS classes on the message-form page per retreat, so each retreat can use a different visual style.
  • Choose a custom header block and footer block (any WordPress block or template part) to brand the submission form page.
  • Delete a retreat together with all its attendants and messages in one action.

Attendant management

  • Add attendants individually or import them from a CSV file (supports merge mode to add emergency-contact data without overwriting existing records).
  • Each attendant stores: name, surnames, date of birth, and the following optional fields — notes, internal notes, emergency-contact details (name, surnames, relationship, email), inviting person, and incompatibilities.
  • Export attendants to CSV including their unique message URL, message count, and all standard fields.
  • Sort and filter the attendant list by name, message count, notes, or any other available column.
  • The attendant list shows at a glance how many messages each person has received and how many have not yet been printed.
  • Delete individual attendants, or remove all attendants from a retreat at once.

Confidential message submission (public form)

  • Each attendant has a unique, cryptographically secure URL (based on a random token). Anyone with the link can submit a message without logging in to WordPress.
  • The submission form provides a rich-text editor (with formatting, images, and copy-paste from Word or Google Docs).
  • Writers can attach images and documents (PDF, DOCX, and other common types). If a message has multiple non-image files, they are bundled into a ZIP for printing.
  • An optional legal disclaimer with a configurable acceptance checkbox can be required before submission.
  • A simple arithmetic CAPTCHA prevents automated submissions. Logged-in WordPress users skip the CAPTCHA.
  • The form URL includes the attendant’s initials as a suffix for easy identification when sharing links, without exposing the full name.
  • Rate limiting (20 requests per hour per IP) prevents abuse.
  • The form is multilingual: senders see it in their browser’s language, or choose one from a selector, among Spanish, Catalan, Basque, Galician, English, Portuguese, French, Italian and German. Changing the language does not reload the page, so nothing written is lost. It can be disabled per retreat.
  • The retreat texts (custom message and legal disclaimer) can have a version written for each language, or be translated automatically with DeepL (optional; the free plan, DeepL API Free, is enough; each translation is cached and only those texts are sent to DeepL).

Secure message access and printing

  • The admin interface never displays message content — there is no content-preview panel. This protects confidentiality if a screen is visible to others.
  • Authorised users open a message and click Print. The plugin decrypts the content on the fly, renders it in a print-ready format with the recipient’s name and the sender’s name, and sends it to the printer.
  • Each print action is recorded in a print log (user, timestamp, IP address). The log is visible from the attendant’s message list.
  • Multiple images in a single message are laid out so they do not split across pages.

Permission system

The plugin uses four access levels, each scoped to specific retreats:

Plugin Administrators (WordPress users with the manage_retreat_plugin capability, automatically granted to WordPress Administrators):

  • Create and delete retreats.
  • Manage all attendants and all messages across all retreats.
  • Grant or revoke permissions for any retreat.
  • Access Global Settings and Privacy & Compliance pages.

Retreat Managers (assigned per retreat):

  • Full control of their assigned retreat: edit retreat details, manage attendants, access all messages.
  • Invite and assign Message Managers to their retreat.
  • Cannot access other retreats or global settings.

Message Managers (assigned per retreat):

  • Read-only access to attendant names for context.
  • Can open and print confidential messages for their retreat.
  • Cannot edit attendants, retreat details, or permissions.
  • All print actions are logged.

Read Only (assigned per retreat):

  • Can see the retreat’s attendants, the custom fields open to message managers, the letter counts and the contact log.
  • Can get each attendant’s letters URL and invitation message to share them. An existing URL is never replaced; an attendant without one gets it generated.
  • Can never change anything else: no editing, withdrawing or deleting attendants, no contact log entries, no CSV import or export.
  • Cannot open, print or download letters, and cannot see the retreat settings or permissions.

User invitations

  • Invite any email address to become a Retreat Manager, Message Manager or Read Only user for a specific retreat directly from the retreat’s Access Management tab.
  • The invitee receives an email with a secure, time-limited token link.
  • If the email address already belongs to a WordPress user, they are granted the role immediately on acceptance. If not, a new WordPress account is created for them.
  • Pending invitations can be cancelled at any time. Expired invitations are cleaned up automatically.

Encryption and data security

  • All message content and file attachments are encrypted with AES-256-CBC and authenticated with HMAC-SHA256 before being written to the database or disk.
  • The encryption key is generated automatically on first activation and stored in the database. An admin notice prompts you to move it to wp-config.php by defining the constant DFXPRL_ENCRYPTION_KEY for better security. If the constant and the database key ever differ, the plugin detects the mismatch and offers a one-click resolution.
  • Every sensitive admin action (permission grants, revocations, invitation events) is written to a permission audit log.

GDPR and privacy compliance

  • Right to Erasure (GDPR Article 17): delete all personal data for a specific email address or attendant in one action.
  • Data Portability (GDPR Article 20): export all personal data associated with an email address as a structured file.
  • IP address anonymisation: sender IP addresses are automatically anonymised after a configurable retention period (default 30 days). A daily WordPress cron job handles the cleanup.
  • Configurable data retention: set how long messages and audit log entries are kept before automatic deletion.
  • Spanish privacy law (LOPD-GDD): the plugin was designed with Spanish data-protection requirements in mind, in addition to GDPR.
  • All settings are found under Retreats > Privacy & Compliance.

Global settings

Under Retreats > Global Settings you can configure:

  • Default header and footer blocks for the message submission form (overridable per retreat).
  • Default body CSS classes for the submission form page.
  • Encryption key management (including the option to remove a database-stored key in favour of the wp-config.php constant).
  • The DeepL API key for the automatic translation of the retreat texts (it can also be defined in wp-config.php as DFXPRL_DEEPL_API_KEY). A key of the free plan, DeepL API Free (up to 500,000 characters a month), is enough.

User manual

  • A user manual is built into the admin, with a version for each access level: plugin administrator, retreat manager, message manager and read only. Each user opens the one for their highest access level, and can switch to the others they hold; plugin administrators can read all four, and retreat managers also those of the access levels they give their team. Every page of the plugin has a Manual link at the top right, and the plugin row in the Plugins screen links to it too. The complete manual covers every screen: retreats, access management and invitations, attendants, CSV import and export, the letters form, printing and returning letters, withdrawals and emptying a retreat, global settings, privacy and security, and a step-by-step retreat calendar.
  • It is shown in the language of each user: English, Spanish, Catalan, Basque, Galician, Portuguese, French, Italian or German (other variants of those languages use the closest one, and any other language gets the English manual).

Internationalisation

  • The plugin ships with complete translations into Spanish, Catalan, Basque, Galician, Portuguese (Portugal), French, Italian and German. The Spanish one matches the translation approved on translate.wordpress.org; the others were machine-generated following the wordpress.org glossary of each language and are open to review on translate.wordpress.org.
  • When the site has a language pack from translate.wordpress.org, its translations take precedence, and the files bundled with the plugin fill in any texts the pack does not translate yet.
  • A .pot template file is included so you can add your own language.
  • The public submission form uses informal Spanish (“tú”) for a friendlier tone.

External services

This plugin can connect to the DeepL API to translate the texts configured for each retreat (custom message, legal disclaimer and its acceptance text) into the language of the visitor of the letters form. It is optional and only used when a DeepL API key is configured in the global settings (or in wp-config.php).

  • What is sent and when: the original text of those retreat fields and the target language, the first time a visitor views the letters form in a language for which the retreat has no version written (or when a manager presses “Translate automatically”). The result is cached, so each text is sent once per language and again only if it changes. Letters, names, email addresses and any other personal data are never sent.
  • Service provider: DeepL SE. Terms and conditions · Privacy policy.