Michael Bromley 3af21d5486 chore: Update github org name in links 1 hafta önce
..
scripts 60ce04918d chore: Reinstate changes from scheduled-tasks branch 9 ay önce
src 3af21d5486 chore: Update github org name in links 1 hafta önce
.eslintrc.json 60ce04918d chore: Reinstate changes from scheduled-tasks branch 9 ay önce
.gitignore 6083aefd71 Merge branch 'minor' into major 3 yıl önce
.npmignore 9e8bb6400e Merge branch 'minor' into major 3 yıl önce
README.md cb82eee7c9 docs(admin-ui): fix ngx-translate and unicode link (#3227) 1 yıl önce
angular.json 724e8498bd fix(ui-devkit): Silence sass warnings during compilation 9 ay önce
i18n-coverage.json 0fda4520d8 fix(admin-ui): Make product / variant cols link to detail pages in order table (#3552) 7 ay önce
package.json 3af21d5486 chore: Update github org name in links 1 hafta önce
tsconfig.json d376d834c4 feat(core): Update all major dependencies (#3445) 9 ay önce
tsconfig.lib.json 0c503b4389 feat(admin-ui): Update to Angular v15.x 2 yıl önce
tsconfig.lib.prod.json 3b49d23354 feat(admin-ui): Update to Angular v13 3 yıl önce

README.md

Vendure Admin UI

This is the administration interface for Vendure.

It is an Angular application built with the Angular CLI.

The UI is powered by the Clarity Design System.

Structure

Library

The Admin UI is structured as an Angular library conforming to the ng-packagr format. This library is what is published to npm as @vendure/admin-ui. The library consists of a set of modules which are accessible from consuming applications as sub-packages:

  • @vendure/admin-ui/core
  • @vendure/admin-ui/catalog
  • @vendure/admin-ui/orders

etc. These library packages are located at ./src/lib

When built with npm run build, the output will be located in the ./package sub directory. This is also the root of the published npm package.

Application

In addition to the library, there is also a full application located at ./src/app. This application is used both during development of the Admin UI, and also as the "default" Admin UI without any UI extensions, as provided as the default by the admin-ui-plugin.

Localization

Localization of UI strings is handled by ngx-translate. The translation strings should use the ICU MessageFormat.

Translation keys are automatically extracted by running:

npm run extract-translations

This scan the source files for any translation keys, and add them to each of the translation files located in ./src/lib/static/i18n-messages/.

A report is generated for each language detailing what percentage of the translation tokens are translated into that language:

Extracting translation tokens for "src\lib\static\i18n-messages\de.json"
de: 592 of 650 tokens translated (91%)

This report data is also saved to the i18n-coverage.json file.

To add support for a new language, create a new empty json file ({}) in the i18n-messages directory named <languageCode>.json, where languageCode is one of the supported codes as given in the LanguageCode enum type, then run npm run extract-translations

To verify localization changes add <languageCode>.json to ./src/lib/static/vendure-ui-config.json in the array availableLanguages. This will make the localization available in Admin UI development mode using npm run dev