Translations

The bundle leverages on Symfony Translation component if available. The texts you pass for almost all names, short names, descriptions, labels... are translation keys.

/config/packages/pwa.yaml

pwa:
    manifest:
        enabled: true
        name: "app.name"
        short_name: "app.short_name"
        start_url: "/index.html"
        displa": "standalone"
        background_color: "#ffffff"
        theme_color: "#4285f4"
        shortcuts:
            - name: "app.feature1.shorcut.name"
              short_name: "app.feature1.shorcut.short_name"
              description: "app.feature1.shorcut.description"
              url: "/start-chat"
              icons":          
                - src: "icons/feature1-96x96.png"
                  sizes: [96]

This feature is still in development stage and may not work as expected. Use with caution.

BC is not guaranteed.

Translatable values

The following values are translation keys. The domain is pwa.

Component

Values

Manifest

name
short_name
description
categories
start_url

Screenshot

label

Share Target

title
text

Shortcut

name
short_name
description

Widget

name
short_name
description

How To?

This feature relies on the framework.enabled_locales to generate static manifest files. Please refer to the Symfony documentation for more information.

To enable it, the manifest public URL shall contain the placeholder {locale}.

Example:

/config/packages/pwa.yaml

pwa:
    manifest:
        enabled: true
        public_url: "/site.{locale}.webmanifest"

When done, the Twig function should get the locale to serve the translated version of the manifest.

<!DOCTYPE html>
<html lang="en">
<head>
  {{ pwa(locale=app.request.locale) }}
</head>
<body>
  ...
</body>
</html>

Now you can have translation files for each locale you support:

translations/pwa+intl-icu.en_US.xlf

<?xml version="1.0" encoding="utf-8"?>
<xliff xmlns="urn:oasis:names:tc:xliff:document:1.2" version="1.2">
  <file source-language="en-US" target-language="en-US" datatype="plaintext" original="file.ext">
    <header>
      <tool tool-id="symfony" tool-name="Symfony"/>
    </header>
    <body>
      <trans-unit id="f3U2Gqw" resname="app.name">
        <source>app.name</source>
        <target>TODO!</target>
      </trans-unit>
      <trans-unit id="q2FYgid" resname="app.short_name">
        <source>app.short_name</source>
        <target>TODO!</target>
      </trans-unit>
      ...
    </body>
  </file>
</xliff>

PreviousEDGE Side Panel NextWidgets (Win10+)

Last updated 2 years ago