magic_addresses 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: beb2e21a6fbf9f4f598bd5d134e5600904a727fe
+  data.tar.gz: c80f9082f1680764ba4f7261f833ea5a89c24736
+SHA512:
+  metadata.gz: 1a7776f89b502f208b03171daa36c34e5287f5ae37868538ee2dc769fe776023f9a214c064105ff6e8399cf8ebe4ec2097b7e1cecfc332f70f044b8d6569dae8
+  data.tar.gz: f6b7297fb37c484df43177548c36689b235b95b4aaf292903ca34f6365ee6f15022b0f01ebd78d4bfa4b05baebce694a17e2422a78ef0b818b19ec572a80ce64

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2015 Torsten Wetzel
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,76 @@
+# MagicAddresses
+
+An address gem for rails .. fetches *country*, *state*, *city*, *district* and *subdistrict* in seperated and translated models.
+
+This gives the great advantage, that each address can be displayed in each language. And not matter how you write an address it fetches the right one.
+For example the german city *munich* in german *München* .. both save a city-model with a name translated all app-locales. 
+
+```ruby
+rails g magic_addresses:install
+```
+
+- 1. **check the initialers** (*its important to first check the settings of the gem*)
+- 2. **check the migration file**
+- 3. **run `rake db:migrate`**
+- 4. **add to your models**
+
+
+#### Model methods
+
+```ruby
+  has_one_address     # => This model has one address associated with it. (ie: User)
+
+  has_addresses       # => This model has many addresses. (ie: Company)
+
+#   You can use `has_one_address` and `has_addresses` on the same model 
+#   `has_one_address` sets the default flag so could be major address.
+
+
+  # in Progress
+  has_nested_address  # => Has one directly nested addresses. (ie: User.street, User.city)
+
+```
+
+
+#### Structure
+
+Address:
+- street *(globalized)*
+- street_additional
+- number
+- postalcode
+- **country**
+- - name *(globalized)*
+- - iso_code
+- - dial_code *(phone)*
+- **state**
+- - name *(globalized)*
+- - short_name
+- **city**
+- - name *(globalized)*
+- - short_name
+- **district**
+- - name *(globalized)*
+- - short_name
+- **subdistrict**
+- - name *(globalized)*
+- - short_name
+
+
+#### Getter & Setter
+```ruby
+  :street
+  :number
+  :postalcode
+  :city
+  :district
+  :subdistrict
+  :state
+  :country
+```
+
+
+.. will more info, sometimes ...
+
+
+This project rocks and uses MIT-LICENSE.

data/Rakefile

@@ -0,0 +1,23 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'MagicAddresses'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+
+
+
+Bundler::GemHelper.install_tasks
+

data/app/controllers/magic_addresses/base_controller.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+class MagicAddresses::BaseController < ApplicationController
+  
+  # => layout proc { |controller| controller.request.xhr? ? false : "application" }
+  
+  include MgcaHelper
+  
+  before_action :authenticate_visitor
+  
+  
+  private
+
+    # overwrite for authentication
+    def authenticate_visitor
+      true
+    end
+
+end

data/app/controllers/magic_addresses/cities_controller.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+class MagicAddresses::CitiesController < MagicAddresses::BaseController
+  
+  def index
+    # @cities = ::MagicAddresses::City.includes(:translations).with_translations(I18n.locale).order( 'mgca_city_translations.name ASC' )
+    # @cities = ::MagicAddresses::City.includes(:translations).order("mgca_city_translations.name ASC")
+    @cities = ::MagicAddresses::City.includes(:translations).order(short_name: :asc)
+  end
+  
+  private
+
+    # Never trust parameters from the scary internet, only allow the white list through.
+    def instance_params
+      params.require(:city).permit(:name, :default_name, :short_name, :translations_attributes => [:id, :name, :locale])
+    end
+
+end

data/app/controllers/magic_addresses/countries_controller.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+class MagicAddresses::CountriesController < MagicAddresses::BaseController
+  
+  def index
+    @countries = ::MagicAddresses::Country.includes(:translations).with_translations(I18n.locale).order( 'mgca_country_translations.name ASC' )
+  end
+  
+  private
+
+    # Never trust parameters from the scary internet, only allow the white list through.
+    def instance_params
+      params.require(:country).permit(:name, :default_name, :iso_code, :translations_attributes => [:id, :name, :locale])
+    end
+
+end

data/app/controllers/magic_addresses/districts_controller.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+class MagicAddresses::DistrictsController < MagicAddresses::BaseController
+  
+  def index
+    # @districts = ::MagicAddresses::District.includes(:translations).with_translations(I18n.locale).order( 'mgca_district_translations.name ASC' )
+    # @districts = ::MagicAddresses::District.includes(:translations).order("mgca_district_translations.name ASC")
+    @districts = ::MagicAddresses::District.includes(:translations).order(short_name: :asc)
+  end
+  
+  private
+
+    # Never trust parameters from the scary internet, only allow the white list through.
+    def instance_params
+      params.require(:district).permit(:name, :default_name, :short_name, :translations_attributes => [:id, :name, :locale])
+    end
+
+end

data/app/controllers/magic_addresses/states_controller.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+class MagicAddresses::StatesController < MagicAddresses::BaseController
+  
+  def index
+    order_locales = [ I18n.locale ]
+    order_locales << :en unless I18n.locale == :en
+    @states = ::MagicAddresses::State.includes(:translations).with_translations(order_locales).order( 'mgca_state_translations.name ASC' )
+    # @states = ::MagicAddresses::State.includes(:translations).with_translations(I18n.locale).order( 'mgca_state_translations.name ASC' )
+    # @states = ::MagicAddresses::State.includes(:translations).order("mgca_state_translations.name ASC")
+    @states = ::MagicAddresses::State.includes(:translations).order(short_name: :asc)
+  end
+  
+  private
+
+    # Never trust parameters from the scary internet, only allow the white list through.
+    def instance_params
+      params.require(:state).permit(:name, :default_name, :short_name, :translations_attributes => [:id, :name, :locale])
+    end
+
+end

data/app/controllers/magic_addresses/subdistricts_controller.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+class MagicAddresses::SubdistrictsController < MagicAddresses::BaseController
+  
+  def index
+    # @subsubcities = ::MagicAddresses::Subdistrict.includes(:translations).with_translations(I18n.locale).order( 'mgca_subdistrict_translations.name ASC' )
+    # @subsubcities = ::MagicAddresses::Subdistrict.includes(:translations).order("mgca_subdistrict_translations.name ASC")
+    @subdistricts = ::MagicAddresses::Subdistrict.includes(:translations).order(short_name: :asc)
+  end
+  
+  private
+
+    # Never trust parameters from the scary internet, only allow the white list through.
+    def instance_params
+      params.require(:subdistrict).permit(:name, :default_name, :short_name, :translations_attributes => [:id, :name, :locale])
+    end
+
+end

data/app/models/concerns/address_builder.rb

@@ -0,0 +1,169 @@
+# encoding: utf-8
+module AddressBuilder
+  extend ActiveSupport::Concern
+  
+
+  included do
+    before_validation :build_address_associations_if_needed
+  end
+
+  module ClassMethods
+    # => ...
+  end
+  
+  
+  def street_is_changed?
+    self.street_name.present? && self.street.blank? || self.street && (self.street.to_s.downcase != self.street_name.to_s.downcase.strip)
+  end
+  
+  def city_is_changed?
+    self.city_name.present? && !self.city || self.city && self.city.name && (self.city.name.to_s.downcase != self.city_name.to_s.downcase.strip)
+  end
+  
+  def country_is_changed?
+    self.country_name.present? && !self.country || self.country && self.country.name && (self.country.name.to_s.downcase != self.country_name.to_s.downcase.strip)
+  end
+  
+  def country_code_is_changed?
+    self.country_code.present? && !self.country || self.country && self.country.iso_code && (self.country.iso_code.to_s.downcase != self.country_code.to_s.downcase.strip)
+  end
+  
+  # =====> I N S T A N C E - M E T H O D S <================================================= #
+private
+
+  
+  def build_address_associations_if_needed
+    dev_log "address ... #{self.owner.class.name.to_s if self.owner} .. #{self.owner_type}"
+    # build_address_associations() if self.new_record? || self.street_number_changed? || self.zipcode_changed? || city_is_changed? || country_is_changed?
+    if self.new_record? || self.street_number_changed? || self.zipcode_changed? || street_is_changed? || city_is_changed? || country_is_changed?
+      dev_log
+      dev_log "build_address_associations needed !!!"
+      dev_log
+      build_address_associations
+    else
+      dev_log
+      dev_log "build_address_associations is not needed .. .. .."
+      dev_log
+    end
+  end
+  
+  
+  def build_address_associations
+    dev_log "triggered   A D D R E S S - B U I L D E R ! - - #{self.street_name} #{self.street_number} #{self.city_name} #{self.zipcode}"
+    
+    if self.address.present?
+      self.fetch_address = self.address
+    elsif (city_is_changed? || (self.zipcode.present? && self.zipcode_changed?)) && (self.country_name.present? || self.country_code.present?)
+      self.fetch_address = "#{self.street_name} #{self.street_number} #{self.city_name} #{self.zipcode} #{self.country_name} #{self.country_code}".strip
+    elsif (city_is_changed? || (self.zipcode.present? && self.zipcode_changed?)) || street_is_changed? || (self.street_number.present? && self.street_number_changed?)
+      street = self.street if self.street.present?
+      street = self.street_name if self.street_name.present?
+      self.fetch_address = "#{street} #{self.street_number} #{self.city_name} #{self.zipcode} #{self.country_name || 'Germany'}".strip
+    end
+    geo_data = {}
+    if self.fetch_address.present?
+      # => gd = Geocoder.search( self.fetch_address, params: { language: "en" })
+      gd = GeoCoder.search( self.fetch_address, "de" )
+      geo_data["de"] =  gd.first if gd.first
+      sleep 0.2
+      gd = GeoCoder.search( self.fetch_address, "en" )
+      geo_data["en"] = gd.first if gd.first
+    end
+    if geo_data.any?
+      dev_log "   geo_data  is present !!!"
+      # set default values
+      self.street_default = geo_data["en"].street if geo_data["en"] && geo_data["en"].street
+      self.zipcode = geo_data["de"].postal_code if geo_data["de"] && geo_data["de"].postal_code
+      self.street_number = geo_data["de"].street_number if geo_data["de"] && geo_data["de"].street_number
+      # set geo-position
+      self.latitude = geo_data["en"].latitude if geo_data["en"] && geo_data["en"].latitude
+      self.longitude = geo_data["en"].longitude if geo_data["en"] && geo_data["en"].longitude
+    end
+    complete_translated_attributes( geo_data )
+  end
+  
+  def complete_translated_attributes( geo_data = {} )
+    if geo_data.any?
+      # build street parameters
+      street_params = []
+      geo_data.each do |key, stuff|
+        street_params << { locale: key.to_s, street: stuff.street } if stuff.street && ((stuff.street != geo_data["en"].street) || ["en","de"].include?(key.to_s))
+      end
+      # set street parameters if present
+      if street_params.any?
+        dev_log "empty street translations"
+        # reset translations (avoid empty translation in default language)
+        # => self.translations = []
+        self.translations.delete_all
+        # set street parameters
+        self.translations_attributes = street_params
+        dev_log "set new street translations"
+      end
+      
+      self.street_default = geo_data["en"].street if geo_data["en"] && geo_data["en"].street
+      
+      # build country
+      if geo_data["de"].country_code.present?
+        connet_address_association( :country, geo_data )
+      end
+      # build state
+      if geo_data["de"].state_code.present? && self.country
+        connet_address_association( :state, geo_data )
+      end
+      # build city
+      if geo_data["de"].city.present? && self.country
+        connet_address_association( :city, geo_data )
+      end
+      # build district
+      if geo_data["de"].district.present? && self.city
+        connet_address_association( :district, geo_data )
+      end
+      # build subdistrict
+      if geo_data["de"].subdistrict.present? && self.city && self.district
+        connet_address_association( :subdistrict, geo_data )
+      end
+      
+    end
+  end
+  
+  ## Build Associations
+  
+  def connet_address_association( that, geo_data )
+    dev_log ">>> #{that.to_s.upcase}: #{ geo_data["en"].send(that) }"
+    that_params = { name_default: geo_data["en"].send(that).to_s }
+    that_params[ that == :country ? :iso_code : :short_name ] = geo_data["en"].send( "#{that}_code".to_sym ).to_s
+    that_params.merge!({ country_id: self.country.id })     if [:city, :state].include?(that) && self.country
+    that_params.merge!({ state_id: self.state.id })         if that == :city && self.state
+    that_params.merge!({ city_id: self.city.id })           if [:district, :subdistrict].include?(that) && self.city
+    that_params.merge!({ district_id: self.district.id })     if that == :subdistrict && self.district
+    
+    self.attributes = { that => "Location::#{that.to_s.classify}".constantize.unscoped.where( that_params ).first_or_create }# unless self.send(that)
+    
+    dev_log "#{that}"
+    
+    self.send(that).translations = []
+    self.send(that).translations_attributes = lng_params( that, geo_data )
+    self.send(that).save
+  end
+  
+  ## Build Association Params
+  
+  def lng_params( that, geo_data )
+    lng_params = []
+    geo_data.each do |key, stuff|
+      dev_log "#{that.to_s.titleize}-Params (#{key}) ... #{stuff.send(that)}"
+      lng_params << { locale: key.to_s, name: stuff.send(that) } if stuff.send(that) && ((stuff.send(that) != geo_data["en"].send(that)) || (key.to_s == "en"))
+    end
+    lng_params
+  end
+  
+  def dev_log( stuff = " " )
+    if !Rails.env.production?
+      Rails.logger.info "###"
+      Rails.logger.info "###   #{stuff}"
+      Rails.logger.info "###"
+    end
+  end
+
+
+end

data/app/models/concerns/has_address.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+module HasAddress
+  
+  def self.included(base)
+    base.send :extend, ClassMethods
+  end
+  
+  ##   C L A S S - M E T H O D S   # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # 
+  module ClassMethods
+    
+    def has_addresses
+      # => send :include, InstanceMethods
+      has_many    :addresses,
+                  :as => :owner,
+                  :class_name => "Location::Address",
+                  :dependent => :destroy
+      accepts_nested_attributes_for :addresses, allow_destroy: true, reject_if: :all_blank
+    end
+    
+    def has_one_address
+      has_one     :address, -> { where(default: true) },
+                  :as => :owner,
+                  :class_name => "Location::Address",
+                  :autosave => true,
+                  :dependent => :destroy
+      # => delegate    :street, :street_number, :zipcode, :city, :district, :subdistrict, :state, :country, 
+      # =>             to: :address, allow_nil: true
+      accepts_nested_attributes_for :address, allow_destroy: true # => , reject_if: :all_blank
+    end
+    
+    
+    
+    # => def has_nested_address
+    # =>   send :include, InstanceMethods
+    # =>   has_one     :address,
+    # =>               :as => :owner,
+    # =>               :class_name => "Address",
+    # =>               :autosave => true,
+    # =>               :dependent => :destroy
+    # =>   delegate    :street, :number, :zip, :city, :district, :state, :country, 
+    # =>               :street=, :number=, :zip=, :city=, :district=, :state=, :country=, 
+    # =>               to: :address, allow_nil: true
+    # =>   accepts_nested_attributes_for :address, allow_destroy: true, reject_if: :all_blank
+    # =>   alias_method_chain :address, :build
+    # => end
+    
+  end #> ClassMethods
+  
+  ##   I N S T A N C E - M E T H O D S   # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # 
+  module InstanceMethods
+    
+    # http://stackoverflow.com/a/4033761
+    def address_with_build
+      self.address_without_build || self.build_address
+    end
+    
+    # => def check_for_location_stuff
+    # =>   if self.locations && !self.locations.blank?
+    # =>     self.locations.each do |key, value|
+    # =>       # bla
+    # =>     end
+    # =>   end
+    # => end
+  
+  end #> InstanceMethods
+  
+end

data/app/models/location/address.rb

@@ -0,0 +1,111 @@
+# encoding: utf-8
+class Location::Address < ActiveRecord::Base
+  
+  # =====> R E W R I T E S <================================================================= #
+  include AddressBuilder
+  
+  
+  # =====> C O N S T A N T S <=============================================================== #
+  MODEL_PARAMS = [      :street_name, :street_number, :street_additional, :zipcode, :city_name, :district_name, :subdistrict_name,
+                        :state_name, :country_name, :country_code, :address, :latitude, :longitude, :visibility,  :id, :check, :_destroy        ]
+  
+  
+  # =====> A S S O Z I A T I O N S <========================================================= #
+  translates :street, fallbacks_for_empty_translations: true
+  accepts_nested_attributes_for :translations
+  
+  belongs_to :owner,    polymorphic: true
+  belongs_to :context,  polymorphic: true
+  
+  belongs_to :subdistrict,  class_name: "Location::Subdistrict",  foreign_key: :subdistrict_id
+  belongs_to :district,     class_name: "Location::District",     foreign_key: :district_id
+  belongs_to :city,         class_name: "Location::City",         foreign_key: :city_id
+  belongs_to :state,        class_name: "Location::State",        foreign_key: :state_id
+  belongs_to :country,      class_name: "Location::Country",      foreign_key: :country_id
+  
+  
+  belongs_to :patient, -> { where(location_addresses: {owner_type: 'Patient'}) }, foreign_key: 'owner_id'
+  
+  
+  # =====> A T T R I B U T E S <============================================================= #
+  attr_accessor :address, :street_name, :subdistrict_name, :district_name, :city_name, :state_name, :state_short_name, :country_name, :country_code
+  
+  acts_as_geolocated lat: 'latitude', lng: 'longitude'
+  
+  
+  # =====> V A L I D A T I O N <============================================================= #
+  validates_presence_of :city, :country, unless: :is_patient_address
+  validates_presence_of :city_name, :street_name, :street_number, :zipcode, if: :is_patient_address
+  
+  
+  # =====> C A L L B A C K S <=============================================================== #
+  
+  # =====> S C O P E S <===================================================================== #
+  
+  # =====> C L A S S - M E T H O D S <======================================================= #
+  def self.search(search)
+    if search
+      with_translations.where('street LIKE ?', "%#{search}%")
+    else
+      with_translations
+    end
+  end
+  
+  
+  # =====> I N S T A N C E - M E T H O D S <================================================= #
+  def with_translations(*locales)
+    locales = translated_locales if locales.empty?
+    includes(:translations).with_locales(locales).with_required_attributes
+  end
+  
+  def presentation( type = "full" )
+    adr = []
+    adr << street if street.present?
+    adr << street_number if street_number.present? && street.present? && type != "secure"
+    adr = ["#{adr.join(" ")},"] if adr.count > 0
+    adr << zipcode if zipcode.present?
+    adr << city.name if city.present?
+    if adr.count == 0
+      I18n.t("addresses.no_address_given")
+    else
+      adr.join(" ")
+    end
+  end
+  
+  def street!
+    self.street ? self.street : self.street_default
+  end
+  
+  def country!
+    self.country ? self.country.name : nil
+  end
+  
+  def state!
+    self.state ? self.state.name : nil
+  end
+  
+  def city!
+    self.city ? self.city.name : nil
+  end
+  
+  def district!
+    self.district ? self.district.name : nil
+  end
+  
+  def subdistrict!
+    self.subdistrict ? self.subdistrict.name : nil
+  end
+  
+  
+  # =====>  P  R  I  V  A  T  E  !  <======================================================== # # # # # # # #
+private
+  def is_patient_address
+    Rails.logger.info "------"
+    Rails.logger.info "#{self.owner && self.owner.class.name.to_s == "Patient"}  ..  #{self.owner.class.name if self.owner}"
+    Rails.logger.info "#{self.owner_type && self.owner_type == "Patient"}  ..  #{self.owner_type if self.owner_type}"
+    Rails.logger.info "------"
+    # self.owner && self.owner.class.name.to_s == "Patient"
+    self.owner_type && self.owner_type == "Patient"
+  end
+  
+end

data/app/models/location/city.rb

@@ -0,0 +1,39 @@
+# encoding: utf-8
+class Location::City < ActiveRecord::Base
+  
+  # =====> R E W R I T E S <================================================================= #
+  include GlobalizedName
+  
+  # =====> C O N S T A N T S <=============================================================== #
+  
+  # =====> A S S O Z I A T I O N S <========================================================= #
+  belongs_to :state,      class_name: "Location::State",    foreign_key: :state_id
+  belongs_to :country,    class_name: "Location::Country",  foreign_key: :country_id
+  
+  has_many :addresses,    class_name: "Location::Address",  foreign_key: :city_id
+  has_many :districts,    class_name: "Location::District",  foreign_key: :city_id
+  has_many :subdistricts, through: :districts,              source: :subdistricts
+  
+  
+  # =====> A T T R I B U T E S <============================================================= #
+  
+  
+  # =====> V A L I D A T I O N <============================================================= #
+  
+  # =====> C A L L B A C K S <=============================================================== #
+  
+  # =====> S C O P E S <===================================================================== #
+  # => default_scope { includes(:translations).with_translations(I18n.locale).order( 'location_city_translations.name ASC' ) }
+  
+  
+  # =====> C L A S S - M E T H O D S <======================================================= #
+  
+  
+  # =====> I N S T A N C E - M E T H O D S <================================================= #
+  
+  
+  # =====>  P  R  I  V  A  T  E  !  <======================================================== # # # # # # # #
+# private
+  
+  
+end

data/app/models/location/country.rb

@@ -0,0 +1,39 @@
+# encoding: utf-8
+class Location::Country < ActiveRecord::Base
+  
+  # =====> R E W R I T E S <================================================================= #
+  include GlobalizedName
+  
+  # =====> C O N S T A N T S <=============================================================== #
+  
+  # =====> A S S O Z I A T I O N S <========================================================= #
+  has_many :addresses,    class_name: "Location::Address",  foreign_key: :country_id
+  
+  has_many :states,       class_name: "Location::State",    foreign_key: :country_id
+  has_many :cities,       through: :states,                 source: :cities
+  has_many :districts,    through: :cities,                 source: :districts
+  has_many :subdistricts, through: :districts,              source: :subdistricts
+  
+  
+  # =====> A T T R I B U T E S <============================================================= #
+  
+  
+  # =====> V A L I D A T I O N <============================================================= #
+  
+  # =====> C A L L B A C K S <=============================================================== #
+  
+  # =====> S C O P E S <===================================================================== #
+  # => default_scope { includes(:translations).with_translations(I18n.locale).order( 'location_country_translations.name ASC' ) }
+  
+  
+  # =====> C L A S S - M E T H O D S <======================================================= #
+  
+  
+  # =====> I N S T A N C E - M E T H O D S <================================================= #
+  
+  
+  # =====>  P  R  I  V  A  T  E  !  <======================================================== # # # # # # # #
+# private
+  
+  
+end