Skip to content

docs(addons): document expected Outlook prompts and popup-blocker workaround#206

Merged
rubenhensen merged 1 commit into
mainfrom
fix/outlook-doc-popup-prompts
May 9, 2026
Merged

docs(addons): document expected Outlook prompts and popup-blocker workaround#206
rubenhensen merged 1 commit into
mainfrom
fix/outlook-doc-popup-prompts

Conversation

@dobby-coder

@dobby-coder dobby-coder Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor

Addresses two recurring user-confusion points reported on 2026-05-08 about the PostGuard Outlook add-in. Both fixes are documentation on the public install page (/addons, Outlook tab), in English and Dutch.

Summary

Adds a new closing list item to the Outlook install instructions covering:

  1. Security/Yivi prompts are normal — Outlook surfaces a "PostGuard wants to open a dialog" prompt the first time the add-in opens its dialog, and the Yivi signing flow follows. Both are part of the standard process. Users were filing bugs because they did not realize this was expected.
  2. Popup-blocker troubleshooting — if nothing happens after clicking Send/Decrypt, popups are likely blocked. Pointer to allow popups for outlook.office.com (web) or the add-in domain (desktop).

The triggering issue suggested adding a screenshot. I did not add an image because I cannot capture one of the live Outlook UI; the textual note still resolves the underlying confusion. A screenshot can be added in a follow-up by anyone with an Outlook session.

Issues addressed

Scope note

This branch only adds the two doc items above. The other Outlook-related website issues filed on 2026-05-08 (#160, #161, #164, #165, #166, #169, #171, #172) were already shipped via #204 — those issues just need to be closed (will follow up with comments on each).

Reviewer quickstart

git fetch origin && git checkout fix/outlook-doc-popup-prompts && npm install --legacy-peer-deps && npm run dev

Open http://localhost:5173/addons, switch to the Outlook tab, scroll to the bottom of the install instructions to see the new "What to expect when sending or decrypting" list item. Toggle to Dutch and verify the same content appears.

Test plan

  • npm run build passes
  • npm run check passes (0 errors, 0 warnings)
  • Reviewer eyeballs the rendered list item in EN and NL on /addons

…p-blocker workaround

Adds a new closing list item to the Outlook install instructions (en + nl)
covering two recurring user-confusion points:

1. The "PostGuard wants to open a dialog" Outlook security prompt and the
   Yivi signing prompt are part of the standard flow — users should expect
   them and click Allow.
2. If nothing happens after clicking Send/Decrypt, popups are likely
   blocked; pointer to allow popups for the relevant domain.

Refs encryption4all/postguard-outlook-addon#60, encryption4all/postguard-outlook-addon#59

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@rubenhensen rubenhensen merged commit 8d17341 into main May 9, 2026
7 checks passed
@rubenhensen rubenhensen deleted the fix/outlook-doc-popup-prompts branch May 9, 2026 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document expected Outlook security prompts Add warning for browser popup blockers

1 participant