# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hubyte.de/pdf-dokumenten-template-bearbeiten/english-documentation/erste-schritte.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.