Download the PHP package hamza-rico/laravel-pingen-letter without Composer
On this page you can find all versions of the php package hamza-rico/laravel-pingen-letter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hamza-rico/laravel-pingen-letter
More information about hamza-rico/laravel-pingen-letter
Files in hamza-rico/laravel-pingen-letter
Package laravel-pingen-letter
Short Description Turn any PDF into a Pingen-ready A4 letter (generated address cover page + A4 normalisation + safe margins) and send it through the Pingen print & mail API. Laravel-first.
License MIT
Homepage https://github.com/hamza-rico/laravel-pingen-letter
Informations about the package laravel-pingen-letter
Laravel Pingen Letter
Turn any PDF into a Pingen-ready A4 letter and send it through the Pingen print & mail API — with a generated address cover page, automatic A4 normalisation, and safe print margins.
Pingen reads the recipient address off the first page of the PDF (the window-envelope zone) and rejects non-A4 pages or content in the protected border/postage areas. This package handles all of that for you:
- Draws an address cover page (recipient in the window zone).
- Merges cover + your documents into one file (via a pluggable driver).
- Re-lays every page to A4 with safe margins — Letter, legal, or compressed source PDFs all come out clean.
Then it uploads, creates and sends the letter via Pingen.
Requirements
- PHP 8.2+
- Laravel 10, 11 or 12
- A Pingen account + a Developer-App (OAuth2
client_credentials) - A PDF merge driver — one of:
- ConvertAPI (recommended, no server binary) —
composer require convertapi/convertapi-php - Ghostscript (
gsinstalled on the server) - FPDI (pure PHP, only for simple/uncompressed inputs)
- ConvertAPI (recommended, no server binary) —
Installation
Configuration
Add to your .env:
Pingen offers a free staging environment that mails nothing — keep
PINGEN_STAGING=trueuntil you're ready to go live.
Usage
Just build the print-ready PDF (no sending)
Low-level API access
Page limits
Pingen enforces per-country page limits — tightest are Netherlands (14) and
India (16); most others allow 120–500. Check the page count from build()
before sending if you mail to those countries.
Delivery products
cheap (default), fast, bulk, premium, registered. Pingen maps these to
each destination country's real postal product. Only registered provides a
carrier tracking number; standard letters give status updates only.
Testing
License
MIT.
All versions of laravel-pingen-letter with dependencies
ext-iconv Version *
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
setasign/fpdi Version ^2.6
setasign/fpdf Version ^1.8
symfony/process Version ^6.0|^7.0