Checkpoint — listatt PDF download toggle

Module: ListAttBBC.php Version: 7.0 Date: 2026-09-09 Status: Code complete, not yet deployed to Dev or Live

What changed

Added a per-box "Download PDFs instead of viewing" checkbox so PDF rows can be forced to download (landing the file on disk, where the OS's real "Open With" — Acrobat included — is available) instead of always opening PDF.js. Default behavior unchanged; opt-in only.

Why (context for a fresh session)

Andrew wanted a way to open PDFs with Adobe Acrobat specifically. A right-click "Open with Acrobat" menu was proposed first and ruled out — no browser API can launch a specific external app from a webpage. This checkbox is the real achievable version: force-to-disk, then native OS "Open With" takes over from there.

Verification status

• PHP: brace/paren balance checked programmatically (95/95, 374/374); no php -l available in this environment to run a full lint — recommend running php -l ListAttBBC.php on Dev before install.
• Logic reviewed line-by-line against the prior version via the attached diff; no changes to non-PDF code paths.
• Not yet tested against a live render (no Dev/Live access from this session) — needs the usual on-forum confirmation once installed.

Files in this package

• ListAttBBC.php — updated source (v7.0)
• ListAttBBC.diff — unified diff against the version you uploaded
• Code_Change_Report.md — full Problem & Resolution / Risk Analysis / Code Change writeup
• All other files from your uploaded package, unchanged, for a complete drop-in replacement

Next step

Install/overwrite on Dev, confirm PDF.js behavior is unchanged with the box unchecked, then confirm checking it produces a real forced download and that the checkbox state survives a page reload and stays synced across multiple listatt boxes on the same page (e.g. a Volume post).