1. What this module does
The module adds a Save cart as PDF button to the cart, and optionally to the order summary of the checkout, as soon as the cart is not empty. The customer gets a printable summary of the cart: the products with images, combinations and prices, the vouchers, shipping, tax and totals exactly as the cart shows them, and — once entered — the addresses, the carrier and the order message, plus a payment section with your text and the payment methods available for this cart. Companies attach it to a purchase request, other customers keep it to finish the purchase later. You decide in the configuration what the PDF contains. In the Back Office you can open the same PDF for the recent carts of a customer, on the customer page.
Works with PrestaShop 1.7.8, 8.x and 9.x (PHP 7.2.5 or newer), with the Classic and Hummingbird themes and with multistore.
2. Installation
- Download the module from My account → Order history at addonspresta.com.
- In your Back Office, open Modules → Module Manager and click Upload a module.
- Drop the
ap_cartpdf_v1.0.0.zipfile and wait for the confirmation. - Click Configure on the module card.
After installation the button already appears in the cart with the default settings.
3. How it works
The PDF is created at the moment the customer clicks the button, from the current cart. Lines and totals come from PrestaShop's own cart calculation, so they always match the cart: specific prices, catalog price rules, group discounts and vouchers included, with or without tax as the customer's group sees prices, in the cart's language and currency. The tax section adds the totals without and with tax.
Only the visitor's own cart can be printed: the address of the PDF contains no cart number, the cart comes from the visitor's session. When you hide the button (customer groups, logged-in customers only, minimum total), the PDF address stops working too, and in catalog mode there is neither a button nor a PDF. A PDF lists up to 150 products, with images for the first 50; a larger cart gets a note below the list, and the totals still cover the whole cart.
A cart has no payment method yet — the customer chooses it at the last step of the checkout. The payment section therefore shows your payment text (for example your bank details) and the payment modules allowed for the cart's country, customer group and currency in Payment → Preferences. A payment module's own conditions, such as an amount limit, may still hide it at checkout.
The addresses, the carrier and the message appear once the customer has entered them in the checkout; the customer's name, addresses and message only while the customer is signed in (or checking out as a guest). PDFs are never stored on the server, and the module does not connect to addonspresta.com or any other server.
4. Features and settings
Open Modules → Module Manager → Cart to PDF → Configure. The Help box at the top links to this manual and to the module page at addonspresta.com, in the language of your Back Office.
Button in the cart
- Enable the cart PDF — switched off, the button disappears and the PDF address stops working. The Back Office panel keeps working.
- Button position in the cart — below the checkout button, below the product list or above the cart summary. The exact place depends on your theme.
- Button in the order summary of the checkout — the same button next to the summary on the checkout page, where the PDF can already show the addresses, the carrier and the message.
- Button label — the text of the button in every language, up to 64 characters. Empty means the default label.
- Open the PDF — download the file, or open it in a new browser tab.
- Customer groups — only customers of the ticked groups see the button. Visitors who are not logged in belong to the Visitor group.
- Logged-in customers only — hides the button from visitors.
- Minimum cart total — tax included, in the default currency of your shop; 0 shows the button for every cart that is not empty.
Content of the PDF
Each switch adds one part of the PDF: product images (in the image size you choose), reference, attributes of the combination, customizations entered by the customer, unit price, availability of each product, vouchers and discounts, shipping cost and carrier, totals without tax, tax and with tax, delivery and invoice addresses, the customer's message, the available payment methods, a QR code with the shop address and the generation date.
Look
- Paper size — A4 or Letter.
- Accent colour — a hex colour such as
#333333for the lines, the headings and the table header. - Shop logo in the header — the invoice logo, or the shop logo when there is none.
- Shop details in the header — name, address, phone and e-mail from Shop Parameters → Contact → Stores.
- Page numbers in the footer.
Texts
For each language: the title of the document (default "Your cart"), the text above the products, the payment
information (for example your bank account), the note below the totals (default "Prices and availability valid on
{date}. This document is not an order.") and the footer. They are plain text; {shop_name}, {shop_url}, {date} and
{customer_name} are replaced with the values of the shop and the customer.
PDF in the Back Office
On the page of a customer in Customers → Customers, the Carts as PDF panel lists the last 10 carts of the customer that are not empty, with the date, the number of products, the shop and the order made from the cart. The PDF link opens the cart in its language and currency, whatever the button settings. Only employees whose profile has the View permission of the module and can open Customers see the panel; grant the module permission in Advanced Parameters → Team → Permissions.
5. Multistore
Settings are saved for the shop or shop group selected in the Back Office header. Select All shops to set the same values everywhere, or a single shop to give it its own button, content and texts. In the All shops or group context only an employee who manages every shop of it can save. A cart is always printed with the settings, logo and details of its own shop; the Back Office panel lists only carts of the shops the employee manages. One licence covers every shop of the installation.
6. Uninstall
Module Manager → Cart to PDF → Uninstall removes the module's settings and its hidden Back Office page. To keep the settings, use Disable instead.
7. FAQ and troubleshooting
The button does not appear. Check that Enable the cart PDF is on, that the cart is not empty and reaches the minimum total, that the visitor's group is ticked in Customer groups, and that your theme prints the chosen position. Try Below the checkout button, then clear the cache in Advanced Parameters → Performance.
The PDF shows prices without tax. The PDF follows the cart: the customer's group shows prices without tax (Customers → Groups). Switch on Totals without tax, tax and with tax to print both totals.
A payment method is missing from the PDF. Check its country, group and currency restrictions in Payment → Preferences. The list cannot know a payment module's own conditions, such as an amount limit.
There are no addresses or carrier in the PDF. They appear once the customer has entered them in the checkout. The button in the order summary of the checkout prints them.
Can I change the layout of the PDF?
Yes. Copy views/templates/pdf/cart.tpl (and header.tpl / footer.tpl) to
themes/<your-theme>/modules/ap_cartpdf/views/templates/pdf/ and edit the copies. A developer can also add data with
the actionApCartpdfData hook described in README.md.
A text is still in English in my Polish or French shop. Fill in the button label and the texts for that language in the module configuration. Other wording can be changed in International → Translations → Installed module translations.
8. Updates and support
Updates are free for life: download new versions from My account → Order history at addonspresta.com and upload them like a new module. Your settings are kept.
Support is included for 12 months from your order: write to mail@addonspresta.com or use the contact form at addonspresta.com (Monday to Friday, 10:00–16:00 CET; we usually answer within 2 business days). Please include your PrestaShop version, the module version and the steps that lead to the problem.