Translations

Craftable PRO comes with a complex built-in system which is able to scan through the files and load translatable strings into the Translations Manager.

Translation manager

The Database structure of Craftable PRO Translations is based on Spatie Laravel Translatable (opens in a new tab) package. On top of it, Craftable PRO brings a nice UI for editing translation strings.

Actions

Within this Translation page are available several actions detaily described on this page below.

Scanners

You can use several functions in your frontend views. When working with JS or Vue files $t/$tChoice/trans/transChoice/wTrans/wTransChoice are automatically available. More information on how to work with these functions is available in Frontend/Translations.

When working with PHP files, you can use all the basic Laravel functions. In addition, we introduced function ___ which enables you to specify the group. For example in ___('posts', 'Title') word "posts" represents the group.

After you successfully defined all translatable strings in your templates, our scanners come to help. Scanners are divided into Internal and External.

Internal Scanners

By default, Craftable PRO comes with PhpScanner and JsScanner. In Craftable PRO config, you can define paths to be scanned. The default setting is below.

'translations' => [
    'scanners' => [
        [
            'class' => PHPScanner::class,
            'paths' => [
                base_path('vendor/brackets/craftable-pro/src/Http/Controllers'),
                resource_path('views')
            ]
        ],
        [
            'class' => JsScanner::class,
            'paths' => [
                base_path('vendor/brackets/craftable-pro/resources/js'),
                resource_path('js'),
            ]
        ],
        [
            'class' => JsonScanner::class,
            'group' => 'permissions',
            'paths' => [
                resource_path('translations/permissions'),
            ]
        ],
 
        [
            'class' => PHPScanner::class,
            'paths' => [
                resource_path('translations/permissions'),
            ]
        ],
 
    ],
 
    //-----------------------------------------------------
    // Example of publishing of json file with translations
    //-----------------------------------------------------
 
    'publish' => [
        'craftable-pro' => [
            'groups' => ['craftable-pro', 'permissions', 'locales'],
            'path' => public_path('lang/'),
        ],
    ]
],

As you can see, it is very straightforward. You just have to define the scanner and paths to be scanned.

The next step is to run actual scanning by visiting Localization in the admin. Re-scan button can be found in the top-right button submenu.

You can run re-scan also by calling the artisan command:

php artisan craftable-pro:scan-translations

All translations are then available on the Translations page, where you can edit them.

Digging deeper

You can prepare your own scanners. For your convenience, we prepared interfaces ScannerInterface.php and ExternalScannerInterface.php. You can implement these interfaces and use your own scanner in the config file.

You can also use the abstract class BaseScanner.php. After extending this class all you need is to define your own regex patterns and the scanner will be working out of the box. You can get inspiration from PhpScanner.php.

Publishing

When working with Vue components we use Json files as a source of translated strings. This approach is, however, applicable also in other use cases. If you had for example mobile app, you would need to somehow publish your translations to enable the mobile app to use them. That's why we developed publish functionality. You can specify in the Craftable PRO config which groups should be published and where to publish Json files.

'publish' => [
    'craftable-pro' => [
        'groups' => ['craftable-pro', 'permissions', 'locales'],
        'path' => public_path('lang/'),
    ],
]

After that, you have to publish translations by clicking the "Publish Translations" button on the Translations page or by calling the artisan command:

php artisan craftable-pro:publish-translations

Your translated strings will be then saved in the public/lang folder. Files will be named after the translation group. Given locales de, en and sk, the result would be:

public/lang
├── de
|    └── craftable-pro.json
├── en
|    └── craftable-pro.json
└── sk
     └── craftable-pro.json

Adding new locales

You are able to create a new locale on the Settings page (see Settings). All you need to do is to add a new locale to multiselect and hit enter.

Export

Translation Manager provides the ability to export data in selected languages as .xlsx file as shown below.

Import

Translation Manager provides the ability to import data in a selected language from .xlsx file.

If you check Do not override existing translations option only new translations will be imported. Otherwise, if your import file contains conflicts with the current version of translations, the import will ask you to resolve conflicts to choose which version of translations you want to store.