EctoGettext

EctoGettext - library for localization Ecto validation errors with using Gettext

Installation

The package can be installed as:

Add ecto_gettext to your list of dependencies in mix.exs and run mix deps.get:

  def deps do
    [{:ecto_gettext, "~> 0.1.6"}]
  end

Usage

1. Create Gettext module (if it is not):

  defmodule MyApp.Gettext do
    use Gettext, otp_app: :my_app
  end

1. Add this line into "view" section in the web/web.ex (if you use phoenix framework):

  import EctoGettext

1. Create attributes.po and errors.po files in priv/gettext/locale/LC_MESSAGES/

  # attributes.po - file with Ecto attributes such as username, email, password, etc.
  msgid "Username"
  msgstr "Имя пользователя"

  msgid "Password"
  msgstr "Пароль"

  # errors.po - file with Ecto validation errors
  # Please use only %{count} interpolation, because it is a hard rule
  msgid "can't be blank"
  msgstr "не может быть пустым"

  msgid "should be at least %{count} characters"
  msgstr "не может быть короче %{count} символов"

  msgid "should be at most %{count} characters"
  msgstr "не может быть длиннее %{count} символов"

  msgid "has invalid format"
  msgstr "имеет неверный формат"

1. Use it in your forms:

  # Example with slim templates

  = for {attr, message} <- localize_validations(MyApp.Gettext, f.errors) do
    li
      = humanize(attr) <> " "
      = message

Also, you can localize attributes and messages separately:

1. For localize attributes:

   localize_attribute(MyApp.Gettext, :username)

It's can be useful in forms, for example:
  ```elixir
  = form_for @changeset, registration_path(@conn, :create), fn f ->
    = text_input f, :username, placeholder: localize_attribute(MyApp.Gettext, :username)

    = email_input f, :email, placeholder: localize_attribute(MyApp.Gettext, :email)

    ...
  ```

1. For localize messages:

   localize_message(MyApp.Gettext, {"can't be blank", []})