module Globalize::ActiveRecord::InstanceMethods

Public Instance Methods

[](attr_name) click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 32
def [](attr_name)
  if translated?(attr_name)
    read_attribute(attr_name)
  else
    read_attribute(attr_name) { |n| missing_attribute(n, caller) }
  end
end
assign_attributes(attributes, *args) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 18
def assign_attributes(attributes, *args)
  with_given_locale(attributes) { super(attributes_without_locale(attributes)) }
end
attribute_names() click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 55
def attribute_names
  translated_attribute_names.map(&:to_s) + super
end
attributes() click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 10
def attributes
  super.merge(translated_attributes)
end
attributes=(attributes, *args) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 14
def attributes=(attributes, *args)
  with_given_locale(attributes) { super(attributes_without_locale(attributes)) }
end
available_locales() click to toggle source

Get available locales from translations association, without a separate distinct query

# File lib/globalize/active_record/instance_methods.rb, line 134
def available_locales
  translations.map(&:locale).uniq
end
cache_key() click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 165
def cache_key
  [super, translation.cache_key].join("/")
end
changed?() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 169
def changed?
  changed_attributes.present? || translations.any?(&:changed?)
end
column_for_attribute(name) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 159
def column_for_attribute name
  return super if translated_attribute_names.exclude?(name)

  globalize.send(:column_for_attribute, name)
end
globalize() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 6
def globalize
  @globalize ||= Adapter.new(self)
end
globalize_fallbacks(locale) click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 138
def globalize_fallbacks(locale)
  Globalize.fallbacks(locale)
end
initialize_dup(other) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 95
def initialize_dup(other)
  @globalize = nil
  @translation_caches = nil
  super
  other.each_locale_and_translated_attribute do |locale, name|
    globalize.write(locale, name, other.globalize.fetch(locale, name) )
  end
end
read_attribute(name, options = {}) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 40
def read_attribute(name, options = {})
  options = {:translated => true, :locale => nil}.merge(options)
  return super(name) unless options[:translated]

  if translated?(name)
    if !(value = globalize.fetch(options[:locale] || Globalize.locale, name)).nil?
      value
    else
      super(name)
    end
  else
    super(name)
  end
end
reload(options = nil) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 88
def reload(options = nil)
  translation_caches.clear
  translated_attribute_names.each { |name| @attributes.reset(name.to_s) }
  globalize.reset
  super(options)
end
rollback() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 142
def rollback
  translation_caches[::Globalize.locale] = translation.previous_version
end
save(*) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 146
def save(*)
  result = Globalize.with_locale(translation.locale || I18n.default_locale) do
    without_fallbacks do
      super
    end
  end
  if result
    globalize.clear_dirty
  end

  result
end
set_translations(options) click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 75
def set_translations(options)
  options.keys.each do |locale|
    translation = translation_for(locale) ||
                  translations.build(:locale => locale.to_s)

    options[locale].each do |key, value|
      translation.send :"#{key}=", value
    end
    translation.save
  end
  globalize.reset
end
translated_attribute_by_locale(name) click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 129
def translated_attribute_by_locale(name)
  translations_by_locale(&:"#{name}")
end
translated_attributes() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 61
def translated_attributes
  translated_attribute_names.inject({}) do |attributes, name|
    attributes.merge(name.to_s => send(name))
  end
end
translation() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 104
def translation
  translation_for(::Globalize.locale)
end
translation_caches() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 119
def translation_caches
  @translation_caches ||= {}
end
translation_for(locale, build_if_missing = true) click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 108
def translation_for(locale, build_if_missing = true)
  unless translation_caches[locale]
    # Fetch translations from database as those in the translation collection may be incomplete
    _translation = translations.detect{|t| t.locale.to_s == locale.to_s}
    _translation ||= translations.with_locale(locale).first unless translations.loaded?
    _translation ||= translations.build(:locale => locale) if build_if_missing
    translation_caches[locale] = _translation if _translation
  end
  translation_caches[locale]
end
translations_by_locale() { |t| ... } click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 123
def translations_by_locale
  translations.each_with_object(HashWithIndifferentAccess.new) do |t, hash|
    hash[t.locale] = block_given? ? yield(t) : t
  end
end
untranslated_attributes() click to toggle source

This method is basically the method built into Rails but we have to pass {:translated => false}

# File lib/globalize/active_record/instance_methods.rb, line 69
def untranslated_attributes
  attribute_names.inject({}) do |attrs, name|
    attrs[name] = read_attribute(name, {:translated => false}); attrs
  end
end
write_attribute(name, value, options = {}) click to toggle source
Calls superclass method
# File lib/globalize/active_record/instance_methods.rb, line 24
def write_attribute(name, value, options = {})
  return super(name, value) unless translated?(name)

  options = {:locale => Globalize.locale}.merge(options)

  globalize.write(options[:locale], name, value)
end

Protected Instance Methods

attributes_without_locale(attributes) click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 175
def attributes_without_locale(attributes)
  attributes.try(:except, :locale)
end
each_locale_and_translated_attribute() { |locale, name| ... } click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 179
def each_locale_and_translated_attribute
  used_locales.each do |locale|
    translated_attribute_names.each do |name|
      yield locale, name
    end
  end
end
save_translations!() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 193
def save_translations!
  globalize.save_translations!
  translation_caches.clear
end
used_locales() click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 187
def used_locales
  locales = globalize.stash.keys.concat(globalize.stash.keys).concat(translations.translated_locales)
  locales.uniq!
  locales
end
with_given_locale(_attributes) { || ... } click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 198
def with_given_locale(_attributes, &block)
  attributes = _attributes.dup
  attributes.symbolize_keys! if attributes.respond_to?(:symbolize_keys)

  if locale = attributes.try(:delete, :locale)
    Globalize.with_locale(locale, &block)
  else
    yield
  end
end
without_fallbacks() { || ... } click to toggle source
# File lib/globalize/active_record/instance_methods.rb, line 209
def without_fallbacks
  before = self.fallbacks_for_empty_translations
  self.fallbacks_for_empty_translations = false
  yield
ensure
  self.fallbacks_for_empty_translations = before
end