Warp Print changelog
Update with composer update qalainau/filament-warp-print, then run php artisan filament:assets.
1.0.3 Nov 22, 2026
Fixed
- Starting a form entry or sending a form link now also asks your policy's
createfor form entries; the buttons are hidden and the calls refused for someone your policy does not allow to create one.
1.0.2 Nov 20, 2026
Fixed
- Filling in a PDF or paper form: an amount typed with thousands separators (
50,000) or in full-width digits no longer stops Submit with "Please write a number" (the server already accepted it). - Submitting a form with a missing signature or other required fields now scrolls to the list of what is missing, so it can be read next to the red frames.
- Designer: a table added from the left side fits inside the page margins instead of running off the right edge, and money columns start wider than quantity columns, so amounts stay on one line.
Changed
- The print window first selects a template in the document's language (the record's
documentLocale(), or the screen language for several records). Templates without a Document language match any language. Templates passed in a fixed order (->templates([...])) keep that order. - Filling in As a list: the field name comes first, and under it a small picture of where the field is on the form, marked in yellow with a short caption, instead of a red frame above the name.
1.0.1 Nov 20, 2026
Fixed
- Console error
warpPrint is not defined: on pages where Livewire re-renders a Print component inside another Alpine component, the browser console could showwarpPrint is not definedbefore the component's script had arrived. An empty component is now registered up front, and the real one replaces it as soon as it loads. No visible change.
1.0.0 Nov 20, 2026
Added
PrintSourceandField(text, number, money, date, datetime, boolean, image, table): the fields a template may use, with computed values, relations followed by dots and eager loaded, and dates as wall-clock text in the panel's timezone.WarpPrintPluginwith the Print templates resource: designed layouts, label sheets, Excel or Word files and PDF or paper forms, per tenant, with duplicates of shared templates.- The designer: text, fields, item tables, images, lines, boxes, barcodes and QR codes in millimetres; rulers, grid, snapping with guides, alignment and spacing, undo and redo, copy and paste, keyboard nudging; the first, next and last page views; a draft saved as you go, publishing with notes, earlier versions, warnings when someone else saved, and a preview that is the printed page.
- One renderer for the designer, the print window and server PDFs. Item tables continue over pages with the heading repeated, totals carried forward and brought forward, page subtotals, empty ruled rows, a fixed number of rows per page and a shorter last page above the totals; elements on chosen pages, under the last row, or only when a field matches.
- Heading rows for groups of items: a table adds a row across it wherever a chosen item field changes (one heading per delivery on a monthly invoice), never leaves a heading alone at the bottom of a page, and counts only items in row numbers and totals.
php artisan warp-print:check-pdf: makes one PDF with the configured driver and reports the time, the pages, the embedded fonts (and whether Japanese, Chinese or Korean text has a font), or the cause of a failure with a hint.PrintsOnlyApproved::approvalRequired(): records that need no approval print without one.PrintSource::currency(): money fields without a currency of their own are shown in each record's currency (£, $, ¥ …) in the designer, the print window, PDFs, Excel forms and email text.- Formats: numbers, money in the currency's own decimals, dates with patterns including Japanese eras, yes/no, capitals;
{{field|format}}in text; page numbers. PrintActionandPrintBulkAction: a print window with the preview and page count, the browser's print dialog, PDF and Excel downloads; labels with used labels skipped and copies of each.PrintTableAction: the table as it is filtered, searched and sorted, printed as a list.- Server PDFs with Browsershot or Gotenberg (
WarpPrint::pdf()), andWarpPrint::xlsx()/WarpPrint::html(). - Excel forms:
{{fields}}in the user's own .xlsx, item rows filled into ruled rows and then added, with merged cells, formulas, conditional formats, data validation, page breaks, images and the print area following. - The print log, with a reprint mark from the second print of a record.
- Translations in English, Japanese, German, French, Spanish, Italian, Brazilian Portuguese, Korean, and simplified and traditional Chinese.
- Multi-tenancy:
PrintSource::scopedQuery()reads only the current tenant's records (printing, designer samples, Excel), following the panel's ownership relationship (BelongsTo,MorphToor many-to-many), with$isScopedToTenantand$tenantOwnershipRelationshipNameon the source.canManageTemplates()receives the$tenant. - Remote images are off by default:
WarpPrintPlugin::remoteImages()/remote_images.allowallow every host, a list of hosts (*.example.org) or a closure per tenant and user. Allowed images are downloaded by Warp Print — internal addresses refused, the checked address pinned, redirects checked again, size, time and image type limited — and embedded as data, so the PDF engine gets no URLs. The designer has an image URL box that says why a URL cannot be used, and does not save a template with a refused image URL; when printing, a refused image is left empty. Field::image()->directory(): keep image paths inside one folder (one per tenant).- Browsershot's Chrome may only look up the font stylesheet hosts and
pdf.browsershot.allow_hosts. - Starter templates (From a starter): Japanese invoice, quote, delivery note and receipt; English invoice, quote and receipt; address labels, price tags, a postcard and a Naga 3 envelope. Their fields are matched to the source by path, common names and type, or by
PrintSource::starterFields(), and the fields that were not found are reported.WarpPrint::fromStarter(). EmailPrintActionandEmailPrintBulkAction: send the PDF (or the Excel file) by email, with the recipients fromPrintSource::mailRecipients()and a subject and message with fields set per template; the bulk action sends each record to its own recipients in the background.->modifyMailUsing(),WarpPrint::send(),mail.mailer. Emails are logged with their recipients.- Copies (original and copy, up to five per record,
{{copy.label}}) and watermarks shown always, on reprints, from the second copy, on test prints of the draft or when a field matches. - Calculated fields: formulas over the fields (arithmetic,
round,sum(items.amount),if,addDays,endOfMonth,concat, …), per document or per item row, read by a small parser that runs no code; the result for the sample is shown while typing. - Conditional styles on elements and table columns (colour, background, bold when a field matches), and greater than, at least, less than, at most and contains for conditions.
- Text blocks with headings, bold, italic, underline and lists, continuing onto added pages when they are long.
- Postal code boxes for Japanese postcards and envelopes, kanji numerals and upright letters for vertical addresses, Naga 4 and Kaku 2 envelope sizes, and red name and date stamps.
- Large batches in the background: above
batch_limitthe print window offers one PDF (split into parts in a ZIP when long), one PDF per record or Excel files; a queued job makes them as the user who asked (panel, tenant, language) and sends a Filament notification with a signed download for that user.WarpPrint::queue(),exports.*config,PrintExportpruned afterexports.keep_hours. - Issued documents (
archive.enabled, per template Keep the issued PDFs): every server PDF is kept unchanged with its SHA-256 hash and the date, amount and counterparty fromPrintSource::archiveMeta(); the Issued documents page searches, downloads and checks them, the print window downloads the issued PDF again, and the same data is not stored twice.WarpPrintPlugin::canViewArchive(),->archive(),archive.keep_years. - Export and import of templates as JSON (with Excel files inside), from the templates page and with
php artisan warp-print:export/warp-print:import. - Warp Flow approvals:
Field::approval()(status, applicant, approvers and dates of the latest round) and thePrintsOnlyApprovedsource trait. - Word documents: the Excel or Word file kind also takes a
.docx.{{fields}}anywhere in the text, tables, header and footer are replaced (also when Word saved a field in pieces), a table row with item fields is repeated for every item ({{items.#}}numbers the rows), values of several lines become lines, and the settings page lists the fields found and where. Download from the print window (Download Word; a ZIP for several records), email attachments, background exports andWarpPrint::docx(); PDF through the Gotenberg driver (GotenbergDriver::officeToPdf()). WarpPrint::office()fills an Excel or a Word template, whichever the template holds.- Charts: a Chart element draws bars, a line or a pie from the rows of a table of the source — up to four values side by side, a title with
{{fields}}, values written like their column (money, numbers), a legend, round axis steps. Vector shapes from the same renderer in the designer, the print window and server PDFs. - Starter templates: purchase order (発注書), statement of account (取引明細書), payslip (給与明細書) and a 100 × 150 mm shipping label (送り状), each in Japanese and English. Their fields are matched to common names of purchasing, ledger and payroll data (
vendor.name,deliver_by,previous_balance,net_pay, …), and only to fields of a fitting type. - Subtotals for groups of items: with a heading field chosen, Subtotal under each group adds a row under each group with the totals of the Add up columns and a text that may use
{{fields}}; the subtotal never moves to the next page without the item above it, and is left out of row numbers, page subtotals and carried totals. In layouts kept in code:group.subtotal. A source can also put heading and total rows of its own among the rows (__row,__label). PrintTableAction::totals()andPrintTableAction::groupBy(): a Total row at the end of a printed list, formatted by the column, and a heading (and Subtotal) for each group — by a column, a field of the record, the table'sSumsummarizers or the group chosen on screen.- Labels for item rows: a label template can print one label for each row of a table (One label for → Each row of Items) and as many labels as a number field says (Labels of each; quantity 3 gives 3 labels, 0 none). The row's columns become fields of the label (
{{items.name}}),{{label.number}} / {{label.count}}prints 1 / 3, the print window shows the number of labels, and one print stops at 5,000 labels and says so. In layouts kept in code:labels.eachandlabels.copiesField. - The designer reports a table column placed outside a table (where it prints nothing) as a field that cannot be used.
- Barcodes: Code 128, EAN-13 / JAN, GS1-128 (application identifiers in brackets, FNC1 added), UPC-A, Code 39, ITF / ITF-14, NW-7 (Codabar), DataMatrix (ECC 200, 10 × 10 to 48 × 48) and the Japan Post customer barcode. The designer says under Type what each value must look like and warns while the sample value does not fit; the number under the bars shows the added check digit. Each type is read back with a decoder in the tests, on screen and in the server PDF.
- PDF and paper forms (template type PDF or paper form): upload a PDF or scans of a paper form, read its fillable (AcroForm) fields, or let Find boxes on this page suggest fields on a scan; fields for text, numbers, amounts, dates (also split into era / year / month / day boxes), one character per box, check boxes, choices that are circled or ticked, lists, signatures, photos, seals, calculated values and item rows that continue on an extra sheet.
FillFormActionfills a form in on the page (or as a list on phones) with the record's values, saves drafts, checks required fields and formats in the browser and on the server, and saves writable fields back to the record (Field::writable()).SendFormLinkActionemails a link that people without an account can fill in and sign; the page gets only the values the form uses, it expires and closes once submitted, and the result is saved to the record after review. Filled forms lists every entry with Download PDF, Save to record, Allow changes again and Send a new link;FormEntrySubmittedis dispatched. Values are written on the original page with pdf-lib, the same code in the browser and in Node.js 18+ on the server (no Chrome):WarpPrint::pdf(), emails and background exports work for forms.php artisan warp-print:fontsinstalls Noto Sans / Serif JP for embedding,php artisan warp-print:check-formschecks the server. - Document language:
PrintSource::documentLocale(Model $record)andWarpPrintPlugin::documentLocale()(a code or a closure receiving$recordand$source) choose the language of a document separately from the screen. While a record is rendered, the app, Carbon andNumberlocales switch to it and are put back afterwards (also on errors):state()values, number, money and date formats, translations, email subject and message, archived PDFs, Excel and PDF forms. Previews, PDFs, background exports and bulk emails use each record's own language. WarpPrint::syncTemplate()creates and publishes a template kept in code, and publishes a new version only when the layout changed (element IDs are ignored).WarpPrint::syncTemplate(..., shared: true)keeps the template shared by all tenants, also when called inside a tenant's panel.tenant:together withshared: truethrows.- Photos over several pages: a Photos element lays out the photos of a table's rows (an image column and a caption with
{{fields}}) in a grid of 1–6 across with a fixed photo height, and the photos that do not fit continue on added pages after the item table. Rows without a photo are skipped, no photos print nothing, page numbers count the added pages, and Last page elements move to the last photo page. At most 200 photos and 50 added pages per record. The same in the designer, the print window and server PDFs. DocumentEmailedevent after each email sent — fromEmailPrintAction,WarpPrint::send()and once per email in background batches — with the template, record,to,cc, the user and the attachment kind. Use it to note on the record that the document was sent.- Document language for each template (
localeonwarp_print_templates; a Document language field in the template's settings; "Match the screen or the customer" by default, or one of the 10 languages). Month and weekday names (MMM,MMMM,ddd,dddd) and AM / PM in dates are then always in that language, on the page, in Excel and Word cells and in email. Templates made from a starter get the starter's language, and the language is exported and imported with the template. - Text sections in templates:
{{#name}}…{{/name}}is shown only whennameis not empty (null, empty or only spaces hides it), and what is inside can use{{name}}as usual. Use it in a photo caption to leave out the separator when there is no caption:{{#}}{{#caption}}. {{caption}}{{/caption}}.{{#}}(the number) is unchanged, a section can contain one more section, and a section that is never closed is printed as written. Works the same in the preview, print window, PDFs and in e-mail subjects and bodies. canAccessUsing()andcanWriteUsing()onWarpPrintPluginfor the template designer and filling in. The lists of templates, entries and issued documents ask your app's policy (viewAny) when you have one; the designer and filled forms checkviewandupdate(read only withoutupdate), and printing checks the policy with the signed-in user.