Translations

The app ships with default English text for all widget labels and messages. You can override any or all of these with your own translations for Czech, Slovak, German, or any other language your store uses.

How the Translation System Works

Translations are stored as a Shopify metaobject of type zasilkovna_translations. When the widget renders, it applies this fallback chain to determine which text to display:

1. Locale-specific metaobject translations — if a locale-specific version of the translation metaobject exists (added via Shopify’s Translate & Adapt app), those values are used first.
2. Base metaobject values — if no locale-specific translation exists, the base values you configured in the app’s Translations section are used.
3. Built-in English defaults — if no custom translation metaobject exists at all, the built-in English defaults are used.

The fallback chain applies at the metaobject level, not per field. If the translation metaobject exists, all 6 fields must be filled in.

Translation Fields

There are 6 text fields you can customize:

Field Key	Default English Text	Where It Appears
title	”Packeta / Zasilkovna pickup point”	Widget heading on the Thank You page
confirmationTitle	”Packeta / Zasilkovna pickup point”	Heading shown after a pickup point is selected
textChoosePickupPoint	”Please select the pickup point where your order will be delivered.”	Instructional text shown before a point is selected
textChoosenPickupPoint	”Selected pickup point”	Label shown next to the name of the selected point
btnChoosePickupPoint	”Select Pickup point”	Button text before a point is selected
btnChoosenPickupPoint	”Change pickup point”	Button text after a point is selected (allows changing)

The {{carrierName}} Placeholder

Any of the text fields above can include the {{carrierName}} placeholder. At render time, this is replaced with the actual carrier name (e.g., “Zásilkovna”, “GLS”, “DPD”).

This is useful when you want generic text that works for all carriers:

Select your {{carrierName}} pickup point

Renders as:

Select your GLS pickup point

or:

Select your Zásilkovna pickup point

How to Configure Translations

1. Open the app in your Shopify admin.
2. Go to the Translations section.
3. You will see a form with all 6 translation fields, pre-filled with the current values (or English defaults if not yet configured).
4. Fill in all 6 fields with your desired text. All fields are required — the UI enforces this with validation.
5. Click Save.

Changes take effect immediately for new customer sessions.

Czech Translation Example

Here is a sample Czech translation for all 6 fields:

Field	Czech Translation
title	Výdejní místo {{carrierName}}
confirmationTitle	Výdejní místo {{carrierName}}
textChoosePickupPoint	”Vyberte prosím výdejní místo, kam má být vaše objednávka doručena.”
textChoosenPickupPoint	”Vybrané výdejní místo”
btnChoosePickupPoint	”Vybrat výdejní místo”
btnChoosenPickupPoint	”Změnit výdejní místo”

Slovak Translation Example

Field	Slovak Translation
title	Výdajné miesto {{carrierName}}
confirmationTitle	Výdajné miesto {{carrierName}}
textChoosePickupPoint	”Vyberte prosím výdajné miesto, kam má byť vaša objednávka doručená.”
textChoosenPickupPoint	”Vybrané výdajné miesto”
btnChoosePickupPoint	”Vybrať výdajné miesto”
btnChoosenPickupPoint	”Zmeniť výdajné miesto”

Multilingual Stores

If your store serves customers in multiple languages, you can provide per-locale widget text using Shopify’s Translate & Adapt app.

How it works:

• The zasilkovna_translations metaobject is configured as Translatable: true with PublicRead storefront access.
• Shopify’s Translate & Adapt app can add locale-specific versions of the 6 translation fields.
• At render time, the widget uses the customer’s active locale to select the correct translation automatically.

To add per-locale translations:

1. Install the Translate & Adapt app from the Shopify App Store (free).
2. In Translate & Adapt, find the zasilkovna_translations metaobject entry.
3. Add translations for each locale you support — all 6 fields per locale.
4. The app will serve the correct locale’s text to each customer automatically.

Caution

Do not create multiple zasilkovna_translations metaobject records. The app expects exactly one record and uses Shopify’s native translation system for per-locale values. Creating additional records will cause unpredictable behaviour. If you accidentally created duplicates, delete the extras and keep only one.

Tip

For stores that only serve Czech or Slovak customers, entering a single set of translations in the Translations section of the app is the simplest approach and covers most cases.

Technical Details

• Metaobject type: zasilkovna_translations
• Storefront access: PublicRead (required for the widget to read translations)
• Translatable: Yes (supports Shopify’s native translation system)
• Translations are fetched at render time, so changes take effect without any cache clearing.