Repository is archived
No release in over 3 years
Low commit activity in last 3 years
Library for translating Mongoid documents, based on Globalize3 principles
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 1.5
~> 2.4
 Project Readme

Mongoid::Globalize

Mongoid::Globalize is based on Globalize3, but targeted at Mongoid. As Globalize3, it is compatible with and builds on the new I18n API in Ruby on Rails and adds model translations to Mongoid::Document.

Mongoid::Globalize has to work with Rails3+ and other frameworks, that supports Mongoid (Sinatra, Padrino, and others).

Requirements

Mongoid 2.3. Mongoid 2.4 break some specs, so it’s not supported yet. Though you can use master branch of gem.

Installation

To install Mongoid::Globalize just use:


$ gem install mongoid_globalize

or, with bundler, in your Gemfile


gem 'mongoid_globalize'

Document translations

Document translations allow you to translate your document’ field values. In order to make this work, you’ll need to add include Mongoid::Globalize into your document class and define translatable fields in block of translates method, as you define usual fields. E.g.


class Post
  include Mongoid::Document
  include Mongoid::Globalize
  translates do
    field :title
    field :content
    field :published, type: Boolean
  end
end

This allows you to translate the fields :title, :text and :published per locale:


I18n.locale = :en
post.title # => Globalize rocks!

I18n.locale = :ru
post.title # => Глобалайз рулит!

I18n fallbacks for empty translations

It is possible to enable fallbacks for empty translations. It will depend on the configuration setting you have set for I18n translations in your config.

In Rails applications, for example, you can enable them by adding the next line to config/application.rb (or only config/environments/production.rb if you only want them in production)

config.i18n.fallbacks = true

By default, Mongoid::Globalize will only use fallbacks when your translation model does not exist or the translation value for the item you’ve requested is nil. However it is possible to also use fallbacks for blank translations by adding fallbacks_for_empty_translations! to the translates block.


  class Post
    include Mongoid::Document
    include Mongoid::Globalize
    translates do
      field :title
      field :content
    end
  end

  puts post.translations.inspect
  # => [#<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">, #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>]

  I18n.locale = :en
  post.title # => 'Globalize rocks!'
  post.name  # => 'Globalize'

  I18n.locale = :nl
  post.title # => ''
  post.name  # => 'Globalize'

  class Post
    include Mongoid::Document
    include Mongoid::Globalize
    translates do
      field :title
      field :content
      fallbacks_for_empty_translations!
    end
  end

  puts post.translations.inspect
  # => [#<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">, #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>]

  I18n.locale = :en
  post.title # => 'Globalize rocks!'
  post.name  # => 'Globalize'

  I18n.locale = :nl
  post.title # => 'Globalize rocks!'
  post.name  # => 'Globalize'

Scoping objects by those with translations

To only return objects that have a translation for the given locale we can use the `with_translations` scope. This will only return records that have a translations for the passed in locale.



Post.with_translations('en') # => [#<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">, #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>]

Post.with_translations(I18n.locale) # => [#<Post::Translation id: 1, post_id: 1, locale: "en", title: "Globalize rocks!", name: "Globalize">, #<Post::Translation id: 2, post_id: 1, locale: "nl", title: '', name: nil>]

Post.with_translations('de') # => []