Download the PHP package mominalzaraa/filament-localization without Composer

Filament Localization Package

The first and only automatic Filament localization package with intelligent resource scanning, structured translation files, and comprehensive testing. This package eliminates the repetitive task of manually adding translation keys to every field, column, action, and component in your Filament application.

This is the original and only package that provides automatic localization with translation features for Filament.

Requirements: PHP ^8.3 · Laravel ^12.0 | ^13.0 · Filament ^5.0 (Livewire ^4.0, Tailwind ^4.0)

Supported: PHP ^8.3–^8.5, Laravel ^12.0 | ^13.0, Filament ^5.0, Livewire ^4.0 · Deprecated: PHP <8.3, Filament v4 (use v1.x), Livewire v3.

🆕 Latest Updates: v2.1.x — Laravel 13 support; extended resource, relation manager, and discovery localization; Filament 5 & Livewire 4; PHP 8.3+.

Features

• 🚀 Automatic Scanning: Scans all Filament resources, pages, and relation managers
• 🏗️ Smart Localization: Removes hardcoded labels and creates translation keys
• 🤖 DeepL Integration: Intelligent translation with smart detection of untranslated content
• 📊 Structured Organization: Creates organized translation files
• 🔄 Git Integration: Automatic commits for easy reverting
• ⚡ Zero Configuration: Works out of the box
• 🎯 Selective Processing: Process specific panels or all at once
• 🔒 Safe Operation: Backups and dry-run mode
• 🧠 Smart Detection: Automatically detects untranslated content
• 🚫 Skip Terms: Intelligently skips acronyms and technical terms

Supported Components

Form Components

• TextInput, Textarea, Select, DatePicker, DateTimePicker, TimePicker
• Checkbox, Toggle, Radio, FileUpload
• RichEditor, MarkdownEditor, ColorPicker
• KeyValue, Repeater, Builder, TagsInput
• CheckboxList, Hidden, ViewField

Table Columns

• TextColumn, IconColumn, ImageColumn, ColorColumn
• CheckboxColumn, ToggleColumn, SelectColumn, TextInputColumn

Infolist Entries

• TextEntry, IconEntry, ImageEntry, ColorEntry
• KeyValueEntry, RepeatableEntry

Layout Components

• Section, Fieldset, Grid, Tabs, Wizard, Step, Group

Filament Pages

• Dashboard pages with static properties
• Custom pages with hardcoded strings
• Page methods (getTitle, getHeading, getNavigationLabel)

Other Components

• Actions, Filters, Notifications, Relation Managers

Installation

Install the package via Composer (automatically installs all dependencies):

Publish the configuration file:

Configuration

The configuration file config/filament-localization.php provides customization options:

Commands

The package provides two commands for localization and translation:

1. filament:localize - Main Localization Command

Scans and localizes Filament resources with structured translation files.

Options:

• --panel=* - Specific panel(s) to localize
• --locale=* - Specific locale(s) to generate
• --force - Force localization even if labels exist
• --no-git - Skip git commit
• --dry-run - Preview changes without applying them

2. filament:translate-with-deepl - DeepL Translation Command

Intelligently translates Filament resources using the DeepL API with smart detection of untranslated content.

Prerequisites:

1. Get a DeepL API key from DeepL API
2. Add to your .env file: DEEPL_API_KEY=your_deepl_api_key_here

Features:

• Smart Detection: Automatically detects untranslated content
• Skip Terms: Intelligently skips acronyms and technical terms
• Force Mode: Overwrites existing translations when using --force
• Mixed Content: Processes files with both translated and untranslated content

Options:

• --source-lang=SOURCE-LANG - Source language code (default: "en")
• --target-lang=TARGET-LANG - Target language code (required)
• --panel=PANEL - Specific panel(s) to translate
• --force - Force translation and overwrite all existing translations
• --dry-run - Preview changes without applying them

Supported Languages: 40+ languages including English, Greek, French, German, Italian, Portuguese, Russian, Japanese, Chinese, Arabic, and more.

Quick Start

1. Generate translation files:

2. Translate with DeepL (optional):

3. Install language switcher:

4. Configure in your panel provider:

Translation File Structure

The package creates organized translation files based on your configuration:

Panel-Based Structure (Recommended):

Other Structures: Nested or flat structures available via configuration.

How It Works

1. Scans all Filament resources, pages, and relation managers
2. Identifies localizable components (fields, columns, actions, static properties, methods)
3. Removes hardcoded labels and replaces with translation keys
4. Creates organized translation files with default labels
5. Updates resource and page files to use dynamic translation keys
6. Intelligently translates using DeepL API with smart detection:
   • Missing keys (keys that don't exist in target language)
   • Untranslated content (identical to source language)
   • Skips acronyms and technical terms that should remain the same
7. Creates git commit for easy reverting

Key Features

Smart Label Management

Automatically removes hardcoded labels and replaces them with translation keys:

DeepL Integration

• Smart Detection: Automatically detects untranslated content
• Skip Terms: Intelligently skips acronyms and technical terms
• Force Mode: Overwrites existing translations when using --force
• Mixed Content: Processes files with both translated and untranslated content
• High accuracy translations with 40+ supported languages
• Context-aware processing with formatting preservation
• Batch processing with usage monitoring
• Graceful error handling and fallbacks

Page Localization Support

Now supports Filament pages with static properties and methods:

Smart Translation Detection

The DeepL translation command intelligently detects what needs to be translated:

Normal Mode (Default):

• Translates missing keys (keys that don't exist in target language)
• Translates keys with identical content to source (indicating untranslated content)
• Skips terms configured in skip_identical_terms (e.g., "SMS", "API", "URL")
• Preserves existing properly translated content

Force Mode (--force):

• Overwrites ALL existing translations with new ones from source language
• Useful for complete retranslation or when source language has been updated

Example Scenarios:

Language Switching

This package generates translation files. To enable language switching in your Filament panels, install a language switcher plugin:

Recommended: craft-forge/filament-language-switcher

Configure in your panel provider:

Other options: filament/spatie-laravel-translatable-plugin, awcodes/filament-language-switcher

Before and After

Visual Comparison

Before Localization

The Filament admin interface displays in English with hardcoded labels:

Users list page showing English labels

User edit form with English field labels

File structure showing only English translation files

After Localization

The same interface now supports multiple languages with proper translation keys:

Users list page with localized Greek labels

User edit form with localized Greek field labels

File structure showing organized translation files for multiple locales

Code Comparison

Before Localization:

After Localization:

Translation Files Created:

Safety Features

• Backups: Creates timestamped backups before modifying files
• Git Integration: Automatic commit for easy reverting (git reset --soft HEAD~1)
• Dry Run: Preview changes before applying
• Error Handling: Comprehensive error reporting

Testing

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

💖 Support & Funding

If this package has helped you, please consider supporting its development:

• ⭐ Star the repository on GitHub
• 🐛 Report bugs and suggest features
• 💰 Sponsor the project on GitHub Sponsors
• 📧 Email: [email protected]
• 🌐 Website: mominpert.com
• 💬 GitHub Issues: Report an issue

Support

• 📧 Email: [email protected]
• 🌐 Website: mominpert.com
• 💬 GitHub Issues: Report an issue

License

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