Troubleshoot Letter Manager PDF generation
Pixie CRM guidance. Follow the route for your workspace, check your role and enabled modules, and verify the result before moving on.
Resolve missing files, broken images, unwritable storage or malformed content.
Where to goAdmin Area → Letter Manager → create/resend test; server → uploads/letter_manager
Before you start
- Use an authorised account and confirm the customer, external recipient, template, letter or configuration is the intended one.
- Follow the exact route shown above and verify the stored record, generated file and delivery evidence instead of relying on an alert alone.
What this guide helps you do
Resolve missing files, broken images, unwritable storage or malformed content. These instructions follow the inspected module’s live hook, route, controller, model, installer, PDF helper and view flow.
Follow these steps
- Verify uploads/letter_manager is writable.
- Verify the company logo file exists if expected.
- Test with simple subject and plain content.
- Check PHP/TCPDF errors and module error logs through authorised diagnostics.
- Go to the generated path and verify file permissions.
Fields and options
Action scopeResolve missing files, broken images, unwritable storage or malformed content.
Module version1.0.0
Exact routeAdmin Area → Letter Manager → create/resend test; server → uploads/letter_manager
EvidenceVerify the history row, PDF, email metadata, open evidence, signature, public page, client view or postal fields produced by this flow.
Rules and limits
- PDF output is written before email is attempted.
- A missing target email does not explain a missing PDF.
- The supplied controller does not wrap the PDF generation sequence in a user-facing exception handler.
Check it worked
- The requested letter, template, setting, file or tracking detail is created or updated through the supported route.
- The history row, generated PDF, email/send metadata, public verification, signature evidence, client view or postal display agrees with the action.
- Any warning, missing file or failed send is investigated rather than bypassed.
Security, privacy and operational checks
- Apply least privilege and verify recipient identity before sending or exposing public links.
- Protect PDFs, enclosures, signatures, verification URLs, email-open metadata, IP addresses and customer data under organisational policy.
- Test configuration and deployment changes with controlled records before production-wide use.
- Interpret email opens and e-signatures according to their documented technical limitations.
Related guides
Was this guide useful?Your response is stored only in this browser.
