Phoenix LiveDashboard integration for GettextTranslator.

This module provides functions to register the GettextTranslator dashboard with your Phoenix application.

Setup

1. Add the required dependencies to your mix.exs:

def deps do
  [
    {:gettext_translator, "~> 0.2.0"},
    {:phoenix_live_dashboard, ">= 0.6.0"},
    {:phoenix_live_view, ">= 0.17.0"}
  ]
end

2. Add the GettextTranslator supervisor to your application:

# lib/my_app/application.ex
def start(_type, _args) do
  children = [
    # ... other children
    GettextTranslator.Supervisor
  ]

  opts = [strategy: :one_for_one, name: MyApp.Supervisor]
  Supervisor.start_link(children, opts)
end

3. Add the dashboard page to your Phoenix router:

# lib/my_app_web/router.ex
import Phoenix.LiveDashboard.Router

scope "/" do
  pipe_through [:browser, :admin_auth] # replace with your actual pipeline

  live_dashboard "/dashboard",
    metrics: MyAppWeb.Telemetry,
    additional_pages: GettextTranslator.Dashboard.page_config(gettext_path: "priv/gettext")
end

Usage

Once set up, you can access the Gettext Translations page from your Phoenix LiveDashboard. The dashboard allows you to:

• View all translations across all language files
• Filter translations by language, domain, and status
• Edit translations directly in the UI
• Commit changes back to PO files
• Create Git commits and PRs (if the git_cli dependency is available)

You can also continue to use the mix task for batch translation:

mix gettext_translator.run