PHPackages vinou/translations - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Localization & i18n](/categories/localization) 4. / 5. vinou/translations ActiveLibrary[Localization & i18n](/categories/localization) vinou/translations ================== Vinou Translation files 4.1.0(1mo ago)11.3k2GPL-2.0+PHP Since Mar 8Pushed 1mo ago3 watchersCompare [ Source](https://github.com/vinou-platform/translations)[ Packagist](https://packagist.org/packages/vinou/translations)[ Docs](http://vinou.de)[ RSS](/packages/vinou-translations/feed)WikiDiscussions develop Synced 6d ago READMEChangelogDependenciesVersions (279)Used By (2) Vinou - Translations library ============================ [](#vinou---translations-library) > ***The Vinou platform itself depends on this library and therefore it is continuously integrated and right under development. Regarding this the translation files contains work on every period of our platform work.*** The following README documents the current status quo of translation definition rules. Regarding the huge amount of language keys and other webprojects that are depending on older coding guidelines the translation files looks sometimes really confusing. ### Table of contents [](#table-of-contents) - [1. Contribution](#1-contribution) - [2. Coding Guidelines](#2-coding-guidelines) - [3. Standard object keys](#3-standard-object-keys) - [4. Object example](#4-object-example) - [5. Twig extension](#5-twig-extension) - [Provider](#provider) 1. Contribution --------------- [](#1-contribution) If you want to contribute, feel free to join and create pull request. We want to be sure that most of depending web projects could easily be updated, therefore it could take some time that your work is added. Feel free to contact us via PN, mail to or phone call to +49 61316245390. 2. Coding Guidelines -------------------- [](#2-coding-guidelines) 1. If A key is used for an array of keys it is always plural, for example countries or wineRegions 2. If A key identifies an Object or only a String it is always singular, for example wine, product, bundle 3. All identifiers have to be lowerCamelCase. Hyphens, underscores or other separators are not allowed. In special cases ids may be used when translation represents static database objects like grapeTypes. 4. If an object is used in more than two other objects, it may be defined under the general object 5. If an object containes multiple static options the values should be defined in the parent object as array, for example: the product object has a field type with 3 static options, the options should be defined as "types" in object "product". 6. All keys should be in alpha numerical order, except properties of base objects (see below). ``` "product": { "fields": { "type": "Type of product" }, "types": { "optionOne": "Option 1", "optionTwo": "Option 2", "optionThree": "Option 3" } } ``` 3. Standard object keys ----------------------- [](#3-standard-object-keys) Each object may define certain standard keys shown below in preferred definition order. keydescriptionnameSingular and plural names of an entityactionsSpecial actions available for this object. Actions may be defined as single string or object of the following form:actions.\[ACTION\].mainFirst line of action button in applicationactions.\[ACTION\].subSecond line of action button in applicationfieldsField indentifiers normally a string directly used as labelfields.\[FIELD\].labelLabel for form field if more than a label is defined for a fieldfields.\[FIELD\].placeholderPlaceholder for form fieldfields.\[FIELD\].hintSpecial hint for a form fieldfieldSetsForm areas to devide fields into seperate sectionsviewsSpecial defined views like pages, tabs, ...filtersFilter properties used in view, tab oder fieldSetdialogsDialog texts regarding this objecttoastsToasts regarding this object. Toast keys shall be defined in past tense for standard toasts or present tense followed by "Error" for error toastshintsHints for this object in views, tabs, fieldsets\[xyzTypes\]Object related types or categories4. Object example ----------------- [](#4-object-example) ``` "bundle": { "name": { "singular": "Weinpaket", "plural": "Weinpakete" }, "actions": { "addItem": "+ Artikel hinzufügen", "create": { "main": "Neues Weinpaket", "sub": "anlegen" } }, "fields": { "active": "aktiv", "articleNumber": { "label": "Art.-Nr.", "placeholder": "SKU 000 - 0000000" }, "category": "Kategorie", "description": "Beschreibung", "sorting": "Manueller Sortierindex (z.B. für den Shop)" }, "fieldSets": { "facts": "Daten & Fakten", "general": "Allgemeines", "items": "Artikel" }, "views": { "create": { "title": "Neues Weinpaket erstellen" }, "files": { "title": "Dateien", "empty": "Es liegen keine {label} zu diesem Weinpaket vor." } }, "filters": { "category": { "label": "Kategorie auswählen", "none": "Pakete ohne Kategorie anzeigen" }, "search": { "placeholder": "z.B. Name, Beschreibung" }, }, "dialogs": { "delete": "Möchtest Du dieses Weinpaket wirklich löschen?" }, "toasts": { "changed": "Weinpaket geändert!", "changeError": "Weinpaket konnte nicht geändert werden!", "created": "Weinpaket angelegt!", "createError": "Weinpaket konnte nicht angelegt werden!", "deleted": "Weinpaket gelöscht!", "deleteError": "Weinpaket konnte nicht gelöscht werden!", "imageDeleted": "Bild zum Weinpaket gelöscht", "imageUploaded": "Bild zum Weinpaket hochgeladen!" }, "hints": { "imageSize": "Empfehlung für optimale DarstellungAbmessungen: 1500x1500pxDatei-Format: .png (freigestellt)" }, "packageTypes": { "mixed": "Gemischt", "surprise": "Überaschungspaket", "wineOnly": "Nur Wein", } } ``` 5. Twig Extension ----------------- [](#5-twig-extension) This library also contains a Twig extension. To implement this extension you can use this code. ``` $languageKey = 'de'; $twig = new \Twig\Environment(); $twig->addExtension(new \Vinou\Translations\TwigExtension($languageKey)); ``` Afterwards you can use the translate filter in your template like this: ``` {{ 'wine.actions.create.main' | translate }} {{ 'wine.actions.create.sub' | translate }} ``` Provider -------- [](#provider) This Library is developed by the Vinou GmbH. [![](https://camo.githubusercontent.com/53cb2da41d3fe518772a4592ce3e454de29aefc24c74f20aed61f4ca31273fe6/687474703a2f2f7374617469632e76696e6f752e696f2f6272616e642f6c6f676f2f7265642e737667)](https://camo.githubusercontent.com/53cb2da41d3fe518772a4592ce3e454de29aefc24c74f20aed61f4ca31273fe6/687474703a2f2f7374617469632e76696e6f752e696f2f6272616e642f6c6f676f2f7265642e737667) Vinou GmbH Mombacher Straße 68 55122 Mainz E-Mail: Phone: +49 6131 6245390 ### Health Score 55 — FairBetter than 98% of packages Maintenance94 Actively maintained with recent releases Popularity18 Limited adoption so far Community15 Small or concentrated contributor base Maturity80 Battle-tested with a long release history Bus Factor1 Top contributor holds 95% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~9 days Recently: every ~97 days Total 269 Last Release 30d ago Major Versions 1.1.1 → 2.0.02019-05-14 2.12.1 → 3.0.02020-09-09 3.7.12 → 4.0.02026-04-17 ### Community Maintainers ![](https://www.gravatar.com/avatar/f8ee5fd71f2d7a574536a3d2208fd54f1c1554fe7e58fdd515d347226b17dc5d?d=identicon)[t3agent](/maintainers/t3agent) --- Top Contributors [![ericwinter](https://avatars.githubusercontent.com/u/1107395?v=4)](https://github.com/ericwinter "ericwinter (436 commits)")[![cschwerdt](https://avatars.githubusercontent.com/u/1257416?v=4)](https://github.com/cschwerdt "cschwerdt (18 commits)")[![christianhaendel](https://avatars.githubusercontent.com/u/2510004?v=4)](https://github.com/christianhaendel "christianhaendel (5 commits)") --- Tags translationsVinou ### Embed Badge ![Health badge](/badges/vinou-translations/health.svg) ``` [![Health](https://phpackages.com/badges/vinou-translations/health.svg)](https://phpackages.com/packages/vinou-translations) ``` ### Alternatives [barryvdh/laravel-translation-manager Manage Laravel Translations 1.7k3.6M17](/packages/barryvdh-laravel-translation-manager)[gettext/languages gettext languages with plural rules 7530.3M11](/packages/gettext-languages)[kkomelin/laravel-translatable-string-exporter Translatable String Exporter for Laravel 3291.4M10](/packages/kkomelin-laravel-translatable-string-exporter)[punic/punic PHP-Unicode CLDR 1542.9M29](/packages/punic-punic)[outhebox/laravel-translations Manage your Laravel translations with a beautiful UI. Add, edit, delete, import, and export translations with ease. 80687.6k](/packages/outhebox-laravel-translations)[outl1ne/nova-translations-loader This Laravel Nova package helps developers load translations into their packages. 395.1M42](/packages/outl1ne-nova-translations-loader) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)