Giter Club home page Giter Club logo

filament-translations's Introduction

Screenshot of Login

Documentation

  1. Filament translations
  2. Screenshots
  3. Installation
  4. Use Language Switcher
  5. Usage
  6. Other Filament Packages
  7. Support
  8. Docs
  9. Changelog
  10. Security
  11. Credits
  12. License

Filament translations

Latest Stable Version PHP Version Require License Downloads

Manage your translation with DB and cache, you can scan your languages tags like trans(), __(), and get the string inside and translate them use UI.

this plugin is build in spatie/laravel-translation-loader

Screenshots

Screenshot of list Screenshot of edit Screenshot of settings

Installation

composer require tomatophp/filament-translations

Finally reigster the plugin on /app/Providers/Filament/AdminPanelProvider.php

$panel->plugin(\TomatoPHP\FilamentTranslations\FilamentTranslationsPlugin::make())

Allow ChatGPT Auto Translations

If you want to use ChatGPT to auto-translate your languages, you need to install OpenAI package by running:

composer require openai-php/laravel

now you need to add the following to your .env file:

OPENAI_API_KEY=
OPENAI_ORGANIZATION=

allow the feature on your panel provider by adding the following:

$panel->plugin(\TomatoPHP\FilamentTranslations\FilamentTranslationsPlugin::make()->allowGPTScan())

Allow Google Translate Auto Translations

If you want to use Google Translate for auto-translating your languages, you need to install the stichoza/google-translate package by running:

composer require stichoza/google-translate-php

Enable the feature on your admin panel provider file by adding the following:

$panel->plugin(\TomatoPHP\FilamentTranslations\FilamentTranslationsPlugin::make()->allowGoogleTranslateScan())

Allow Create Button to Create New Language

If you want to allow the user to create a new language, you need to add the following to your panel provider:

$panel->plugin(\TomatoPHP\FilamentTranslations\FilamentTranslationsPlugin::make()->allowCreate())

Allow Clear All Translations Button

If you want to allow the user to clear all translations, you need to add the following to your panel provider:

$panel->plugin(\TomatoPHP\FilamentTranslations\FilamentTranslationsPlugin::make()->allowClearTranslations())

Publish Resource

You can publish the resource to your project using:

php artisan vendor:publish --tag="filament-translations-migrations"

If you need to publish config run:

php artisan vendor:publish --tag="filament-translations-config"

Run migration:

php artisan migrate

and now clear cache running:

php artisan optimize:clear

Publish Assets

You can publish views file by use this command:

php artisan vendor:publish --tag="filament-translations-views"

You can publish languages file by use this command:

php artisan vendor:publish --tag="filament-translations-lang"

You can publish migrations file by use this command:

php artisan vendor:publish --tag="filament-translations-migrations"

Use Language Switcher

You can use the language switcher in your panel by using the following plugin:

$panel->plugin(\TomatoPHP\FilamentTranslations\FilamentTranslationsSwitcherPlugin::make())

NOTE your auth user table must have lang filed on the table to make this switch working fine.

Usage

Scan Using Command Line

You can scan your project to get all the languages tags and save them to the database

php artisan filament-translations:import

Change Scan to work on Queue

In your config file just change the use_queue_on_scan to true

'use_queue_on_scan' => true,

Custom Import Command

You can create your own command to import the translations, add your custom import class to the config file like this:

'path_to_custom_import_command' => ImportTranslations::class,

This command will automatically run when you click on the "Scan For New Languages" button in the UI.

Custom Excel Import

You can create your own Excel import to import the translations, add your custom import class to the config file like this:

'path_to_custom_excel_import' => CustomTranslationImport::class,

The import class is based on the Laravel Excel package. You can check the documentation here. This import will automatically run when you click on the "Import" button in the UI.

Custom Excel Export

You can create your own Excel export to export the translations in your own format, add your custom export class to the config file like this:

'path_to_custom_excel_export' => CustomTranslationExport::class,

The export class is based on the Laravel Excel package. You can check the documentation here. This import will automatically run when you click on the "Export" button in the UI.

Show or hide buttons in the UI

You can show or hide the buttons in the UI by changing the config file. By default, all buttons are shown.

    'show_import_button' => true,
    'show_export_button' => false,
    'show_scan_button' => false ,

Custom Resource

You can create your own resource to show the translations in the UI, add your custom resource class to the config file like this:

    'translation_resource' => CustomResource::class,

This is especially useful when you want to have complete control over the UI but still want to use the translations package. Think about implementing a check on user roles when using shouldRegisterNavigation in your custom resource.

Other Filament Packages

Support

you can join our discord server to get support TomatoPHP

Docs

you can check docs of this package on Docs

Changelog

Please see CHANGELOG for more information on what has changed recently.

Security

Please see SECURITY for more information about security.

Credits

License

The MIT License (MIT). Please see License File for more information.

filament-translations's People

Contributors

3x1io avatar baspa avatar udaberrico avatar karamnassar avatar cliche23 avatar mrvnklm avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.