> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Template types

There are 6 different types of templates, which can be distinguished by the prefix of their file name. The maximum length of a template file name must not exceed 128 characters. 

> [!NOTE]
>
> The template names listed here correspond to the initial delivery state of a WEBSALE shop. The names may vary depending on your individual configuration.
>
> The lists are not exhaustive, as further templates are required depending on the feature scope of your shop.

The following sections introduce the six types one after the other.

## Shop templates

Shop templates are marked in the template directory with the prefix "ws\_". These templates contain shop functions — for example the shopping cart, login, or the selection of payment and shipping methods — as well as product information that is displayed using tags and brackets (dynamic content).

They are defined in the shop configuration shop.config in the `<Templates>` section so that the shop can call them up in the corresponding areas.&#x20;

| Template | Parameter | Description |
| - | - | - |
| ws\_address\_combined.htm | CombinedAddress | Template for requesting the billing and delivery address on one template. Reference: Requesting billing and multiple delivery addresses |
| ws\_address\_manage.htm | AddressManage | Template for managing the billing address in the customer account. Reference: Requesting billing and multiple delivery addresses |
| ws\_bank\_manage.htm | BankManage | Template for managing bank details. Reference: Direct debit — requesting bank details |
| ws\_basket.htm | Basket | Template for the shopping cart page. Reference: Displaying the shopping cart |
| ws\_basket\_ajax\_error.htm | BasketAjaxError | Template for the error message: adding a product to the cart via AJAX. Reference: Adding a product to the cart via AJAX |
| ws\_basket\_ajax\_success.htm | BasketAjaxSuccess | Template for the success message: adding products to the cart via AJAX. Reference: Adding a product to the cart via AJAX |
| ws\_category.htm | Category | Template for the category page. Reference: Displaying the currently selected category |
| ws\_confirm.htm | Confirm | Template for the confirmation page after placing an order |
| ws\_connected\_externaccounts.htm | ConnectedExternAccountsOverview | Template for connected external accounts. Reference: External login with Facebook |
| ws\_creditcard\_manage.htm | CreditCardManage | Template for selecting or deleting stored credit card data. Reference: Payment method "credit card" |
| ws\_deliv\_address\_manage.htm | DelivAddressManage | Template for managing delivery addresses in the customer account. Reference: Requesting billing and multiple delivery addresses |
| ws\_direct\_order.htm | DirectOrder | Template for direct ordering. Reference: Direct ordering/ordering from catalogs |
| ws\_login.htm | Login | Template file for signing in to the shop. Guide: Secure sign-in process |
| ws\_login\_start.htm | LoginStart | Name of the template file for signing in at shop start for closed shops. Guide: Secure sign-in process |
| ws\_logout.htm | Logout | Name of the template file for logout. Guide: Logout |
| ws\_memolist.htm | MemoList | Template for the wish list. Reference: Displaying the wish list |
| ws\_notify.htm | Notify | Template for the notice page displaying important messages |
| ws\_order\_history.htm | OrderHistory | Template for displaying the order history. Reference: Integrating the order history |
| ws\_pay\_deliv.htm | PayDeliv | Template for entering payment/shipping method. Reference: Payment/shipping method combinations |
| ws\_place\_order.htm | PlaceOrder | Template for displaying the order overview. Reference: Accepting terms and conditions |
| ws\_product.htm | Product | Template for the product detail view. Reference: Displaying the selected product |
| ws\_product\_recmd.htm | ProductRecmd | Template for the product recommendation. Reference: Product recommendation function via AJAX |
| ws\_product\_recmd\_confirm.htm | ProductRecmdConfirm | Template for the confirmation page "Recommend product". Reference: Product recommendation function via AJAX |
| ws\_search.htm | Search | Template for displaying the search results and entering the advanced search criteria. Reference: ws\_search.htm |
| ws\_start.htm | Start | Start page of the shop |
| ws\_subshop\_access\_denied.htm | SubShopAccessDenied | This template is displayed when the buyer does not have permission for this subshop. Reference: Subshop access permissions |
| ws\_user\_account.htm | UserAccount | Name of the template file for the customer account |

## Information templates

Information templates are, for example, the "static" pages such as terms and conditions, privacy policy, "About us", and help. You can find detailed information on information pages under Creating information pages.&#x20;

The information templates listed below are already included in the initial delivery state and can quickly be tailored to your own wishes. In addition, you can create any number of new information templates that are populated with content using text maintenance.

In the template directory, these templates are marked with the prefix "tpl\_". Information templates are not managed in the shop configuration shop.config.

They are always linked via `~WS-LoadTpl()~` or `~WS-SSLLoadTpl()~`. It doesn't matter which of the two tags is used.&#x20;

| Template | Description |
| - | - |
| tpl\_agb.htm | Terms and conditions |
| tpl\_datenschutz.htm | Privacy notice |
| tpl\_frage\_zum\_produkt.htm | Question about the product |
| tpl\_impressum.htm | Legal notice |
| tpl\_kontakt.htm | Contact option |
| tpl\_versandkosten.htm | Information about shipping costs |
| tpl\_widerruf.htm | Information about the right of withdrawal |
| tpl\_zahlungsarten.htm | Information about payment methods |

## Include templates

In the initial delivery state of the shop, include templates are located in the directory "benutzer/templates/translation" and are marked with the prefix "incl\_". These are templates that are not displayed in their entirety on shop pages. Only their contents, or parts of them, are integrated into existing pages or other templates.

For general information on the include concept of WEBSALE V8s, see Reuse: includes.&#x20;

| Template |
| - |
| incl\_ajax\_submenu.htm |
| incl\_emarketing\_manager.htm |
| incl\_emarketing\_manager\_onlineview\.htm |
| incl\_fast\_includes.htm |
| incl\_prodrating\_changenickname.htm |
| incl\_prodrating\_confirm.htm |
| incl\_prodrating\_edit.htm |
| incl\_prodrating\_list.htm |
| incl\_prodrating\_mailvalidation.htm |
| incl\_product\_seo.htm |

## INQUIRY templates

In the template directory, INQUIRY templates are marked with the prefix "inquiry\_". With INQUIRY templates you can generate both forms and the incoming notifications for the customer (in the shop or by email) and the transmission of the data to the shop operator.

The templates belong to the "INQUIRY4" module and are assigned separately in the INQUIRY configuration files.

| Template | Description |
| - | - |
| inquiry\_frage\_zum\_produkt.htm | Form for "Question about the product" |
| inquiry\_frage\_zum\_produkt\_antwort.htm | Success message for a submitted "Question about the product" |
| inquiry\_frage\_zum\_produkt\_confirmemail.htm | Confirmation email to the customer |
| inquiry\_frage\_zum\_produkt\_inquiryemail.htm | Email of the "Question about the product" to the merchant |
| inquiry\_kontakt.htm | Contact form |
| inquiry\_kontakt\_antwort.htm | Success message for a submitted contact request |
| inquiry\_kontakt\_confirmemail.htm | Confirmation email to the customer |
| inquiry\_kontakt\_inquiryemail.htm | Email of the contact request to the merchant |
| inquiry\_widerruf.htm | Form for the withdrawal |
| inquiry\_widerruf\_antwort.htm | Success message for a submitted withdrawal form |
| inquiry\_widerruf\_confirmemail.htm | Confirmation email to the customer |
| inquiry\_widerruf\_inquiryemail.htm | Email of the withdrawal to the merchant |

For more information, see Forms for customer inquiries.&#x20;

## Email templates

In the template directory, email templates are marked with the prefix "mail\_". Dedicated HTML templates are used for all emails that the shop uses (for example the order acknowledgement or a password change).

These must be assigned in the respective email sections in the shop configuration shop.config.

| Template | Description |
| - | - |
| mail\_change\_mail\_double\_opt\_in.htm | Change email address via double opt-in. Reference: ChangeEmailDoubleOptInMail |
| mail\_customer\_order.htm | Order acknowledgement email. Reference: CustomerMail |
| mail\_delete\_account\_double\_opt\_in.htm | Delete customer account via double opt-in. Reference: DeleteAccountDoubleOptInMail |
| mail\_newcustomer\_double\_opt\_in.htm | New customer registration via double opt-in. Reference: NewCustomerDoubleOptInMail |
| mail\_product\_recmd.htm | Email "Recommend product". Reference: ProdRecmdMail |
| mail\_set\_password.htm | Email "Forgot password"/"Set new password". Reference: SetPasswordMail |

### Structure of email templates

For correct output, CSS properties must be defined as inline styles, since some email clients do not support external stylesheets.

## PDF templates

In the template directory, PDF templates are marked with the prefix "pdf\_". PDF files, such as order confirmations or SEPA mandate documents, are generated with these templates.

| Template | Description |
| - | - |
| pdf\_confirm.htm | Order acknowledgement. Guide: PDF attachment of the order acknowledgement |
| pdf\_sepa\_company.htm | Company direct debit. Materials: pdf\_sepa\_company.htm |
| pdf\_sepa\_customer.htm | Basic direct debit. Materials: pdf\_sepa\_customer.htm |
| pdf\_product.htm | Printing the product detail page. Guide: PDF display of the product detail view |

### Structure of PDF templates

To design print layouts, appropriate CSS properties can be used in the template. The following example forces a page break:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
   <title>Meine Firma - Druckansicht Ihrer Bestellung</title>
   <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
   <base href="~URL-Template~">
</head>
<body>
   ...
   <div style="page-break-after:always;"></div>
   ...
</body>
</html>
```


## Related topics

- [Templates: fundamentals](https://dokumentation.websale.de/en/v8s/grundlagen-templates/templates-grundlagen.md)
- [API reference template options](https://dokumentation.websale.de/en/schnittstellen/admin-interface-api/api-referenz-template-optionen.md)
- [Forms for customer inquiries](https://dokumentation.websale.de/en/v8s/formulare-fuer-kundenanfragen/formulare-fuer-kundenanfragen.md)
- [Data types](https://dokumentation.websale.de/en/frontend/referenz/datentypen.md)
- [Template theme](https://dokumentation.websale.de/en/frontend/die-basics/template-theme.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.