> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/pdf-dokumenten-template-bearbeiten/english-documentation/erste-schritte.md).

# Getting started

## Where to find the settings

Customizations are not made in the plugin configuration, but directly at the respective document configuration:

**Settings > Documents > \[select document type]**

There, select e.g. **Invoice**, **Delivery note**, **Credit note** or **Cancellation invoice**. Below Shopware's standard settings, the plugin adds two additional cards:

| Card                                   | Content                                                                                                                                  |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Custom document (general settings)** | Content and CSS of the document blocks (letter header, receiver, sender, positions, summary, footer) and the "Hide delivery date" switch |
| **Custom document (Order items)**      | Twig template and CSS of the line items table as well as the summary template                                                            |

> **Important:** The editing fields only appear **after the document configuration has been saved once**. For a brand-new configuration you will first see the note "Since this is a new Document please save first." Save once – the editors will then be available.

## Interface structure

### "General settings" card

* **Hide delivery date** – Switch to hide the delivery date in the document.
* **Block selection** – A dropdown to choose the document section to edit (letter header, receiver, sender, positions, summary, footer).
* **Language switcher** – To the right of the block selection. Content and templates are stored per language.
* **Style editor (CSS)** – Code editor for the CSS of the selected block.
* **Content editor (rich text)** – Text editor for the content of the selected block.

### "Order items" card

* **Styles for the table of order items** – CSS editor for the line items table, including the **Load default CSS** button.
* **Table for order items (Twig template)** – Twig editor for the line items table (expert setting), including the **Load default template** button.
* **Twig template for the summary** – Twig editor for the totals/calculation display below the positions, including the **Load default template** button.

## Recommended workflow

1. Open the document type and – if it is new – save it once.
2. Select the desired language via the **language switcher**.
3. Adjust content and styles in the blocks, or load the default templates for table/summary and edit them.
4. Save.
5. Use the [preview](/pdf-dokumenten-template-bearbeiten/english-documentation/vorschau.md) to check the result as a PDF based on a real order.

> **Tip:** Start with the **Load default template** function for the line items table and the summary. This way you begin with the faithful Shopware layout and only adjust the parts you really want to change.