dugway 1.1.0 → 1.2.0

data/lib/dugway/liquid/drops/translations_drop.rb

@@ -0,0 +1,122 @@
+require 'i18n'
+
+module Dugway
+  module Drops
+    class TranslationsDrop < BaseDrop
+      class MissingTranslationError < StandardError; end
+
+      # @param settings [Hash] Theme customization values (resolved settings).
+      # @param definitions [Hash] Raw theme setting definitions (from settings.json).
+      def initialize(settings, definitions = {})
+        @settings = settings || {}
+        @definitions = definitions || {} # Store definitions
+        # Read settings using both symbol and string keys for flexibility.
+        @translation_mode = (@settings[:translation_mode] || @settings['translation_mode'])&.to_s
+        # Use explicit theme setting for locale if present, otherwise default to current I18n.locale
+        @translation_locale = (@settings[:translation_locale] || @settings['translation_locale'])&.to_s.presence || I18n.locale.to_s
+        super()
+      end
+
+      # Liquid access: `{{ translations['key.name'] }}`
+      # Returns the translation string (which could be an empty string),
+      # or a "[MISSING TRANSLATION: ...]" string if the key is not found or its value is nil.
+      #
+      # @param key [String, Symbol] The translation key.
+      # @return [String, nil] The translation or missing translation indicator.
+      def [](key)
+        key_str = key.to_s
+        translation = find_translation(key_str)
+
+        if translation.nil?
+          # Key is missing, or explicitly nil in manual mode - treat both as missing.
+          log_missing_translation(key_str)
+          return missing_translation_message(key_str)
+        end
+
+        # Key found, return its value.
+        translation
+      end
+
+      private
+
+      def manual_mode?
+        @translation_mode == 'manual'
+      end
+
+      # Looks up translation using I18n.
+      # Returns nil if the key is not found or the locale is invalid.
+      def lookup_automatic_translation(key)
+        locale_to_use = @translation_locale
+        # `default: nil` prevents I18n from raising an error on missing keys.
+        I18n.t("storefront.#{key}", locale: locale_to_use, default: nil)
+      rescue I18n::InvalidLocale
+        nil # Treat invalid locale as a missing translation.
+      end
+
+      # Converts a canonical key ('a.b.c') to the theme setting key format (:a_b_c_tr_text).
+      def derive_manual_setting_key(key)
+        "#{key.tr('.', '_')}_tr_text".to_sym
+      end
+
+      # Finds the translation based on the current mode.
+      # In manual mode, respects the 'allow_blank' setting definition.
+      # Returns the translation string, or nil if not found or disallowed blank.
+      def find_translation(key_str)
+        if manual_mode?
+          manual_setting_key_sym = derive_manual_setting_key(key_str)
+          manual_setting_key_str = manual_setting_key_sym.to_s
+          custom_value = nil
+          setting_exists = false
+
+          # Check both symbol and string keys for manual overrides.
+          if @settings.key?(manual_setting_key_sym)
+            custom_value = @settings[manual_setting_key_sym]
+            setting_exists = true
+          elsif @settings.key?(manual_setting_key_str)
+            custom_value = @settings[manual_setting_key_str]
+            setting_exists = true
+          end
+
+          if setting_exists
+            # Find the corresponding definition to check allow_blank
+            # Assuming manual translations are defined similarly to 'options'
+            definition = find_setting_definition(manual_setting_key_str) || {}
+            allow_blank = definition['allow_blank'].to_s == 'true'
+
+            # Return custom value if it's present, or if it's blank but allowed
+            return custom_value if custom_value.present? || (allow_blank && custom_value == '')
+
+            # If we reach here, the value is blank but blank is not allowed.
+            # Fall through to automatic lookup.
+          end
+
+          # If setting key didn't exist, fall through to automatic lookup.
+
+        end # End manual_mode? check
+
+        # Automatic mode or fallback from manual mode
+        lookup_automatic_translation(key_str)
+      end
+
+      # Helper to find a setting definition by its variable name across common sections.
+      def find_setting_definition(variable_name)
+        # Look primarily in 'options' as manual translations often mimic them.
+        # Add other potential sections if needed in the future.
+        (@definitions['options'] || []).find { |d| d['variable'] == variable_name }
+      end
+
+      # Logs a warning message for a missing translation.
+      def log_missing_translation(key_str)
+        mode = manual_mode? ? 'manual' : 'automatic'
+        locale_info = manual_mode? ? '' : " locale='#{@translation_locale}'"
+        message = "Missing translation: key='#{key_str}'#{locale_info} mode='#{mode}'"
+        Dugway.logger.warn(message)
+      end
+
+      # Returns the standard string indicating a missing translation.
+      def missing_translation_message(key_str)
+        "[MISSING TRANSLATION: #{key_str}]"
+      end
+    end
+  end
+end

data/lib/dugway/liquifier.rb

@@ -16,6 +16,7 @@ module Dugway
   class Liquifier
     def initialize(request)
       @request = request
+      load_theme_locales
     end
 
     def render(content, variables={})
@@ -41,7 +42,7 @@ module Dugway
 
     def self.render_styles(css)
       Liquid::Template.parse(css).render!(
-        { 'theme' => Drops::ThemeDrop.new(Dugway.theme.customization) },
+        { 'theme' => Drops::ThemeDrop.new(Dugway.theme.customization, Dugway.theme.settings) },
         :registers => { :settings => Dugway.theme.settings }
       )
     end
@@ -68,7 +69,8 @@ module Dugway
       {
         'store' => Drops::AccountDrop.new(store.account),
         'cart' => Drops::CartDrop.new(cart),
-        'theme' => Drops::ThemeDrop.new(theme.customization),
+        # Pass both customization and definitions to ThemeDrop
+        'theme' => Drops::ThemeDrop.new(theme.customization, theme.settings),
         'pages' => Drops::PagesDrop.new(store.pages.map { |p| Drops::PageDrop.new(p) }),
         'categories' => Drops::CategoriesDrop.new(store.categories.map { |c| Drops::CategoryDrop.new(c) }),
         'artists' => Drops::ArtistsDrop.new(store.artists.map { |a| Drops::ArtistDrop.new(a) }),
@@ -77,6 +79,10 @@ module Dugway
         'head_content' => [window_bigcartel_script, head_content].join,
         'bigcartel_credit' => bigcartel_credit,
         'powered_by_big_cartel' => powered_by_big_cartel,
+        'big_cartel_credit_logo' => big_cartel_credit_logo,
+        # Pass both customization and definitions to TranslationsDrop
+        'translations' => Drops::TranslationsDrop.new(theme.customization, theme.settings),
+        't' => Drops::TranslationsDrop.new(theme.customization, theme.settings),
       }
     end
 
@@ -109,17 +115,47 @@ module Dugway
       "<script>#{script}</script>"
     end
 
+    def read_svg_asset(filename)
+      File.read(File.join(File.dirname(__FILE__), 'assets', filename))
+    end
+
     def bigcartel_credit
       '<a href="http://bigcartel.com/" title="Start your own store at Big Cartel now">Online Store by Big Cartel</a>'
     end
 
     def powered_by_big_cartel
-      %(<a class="bigcartel-credit" href="https://www.bigcartel.com/?utm_source=bigcartel&utm_medium=storefront&utm_campaign=123" title="Powered by Big Cartel">
-        <span class="bigcartel-credit__text" aria-hidden="true">Powered by</span>
-        <svg aria-hidden="true" class="bigcartel-credit__lockup" xmlns="http://www.w3.org/2000/svg" viewBox="1.99 2.05 124.96 24.95">
-          <path d="M46.18 4A1.91 1.91 0 1 1 50 4a1.91 1.91 0 1 1-3.81 0Zm78.76 14.35a.81.81 0 0 1-.25-.69V2.23h-4.52v2.68h1.58V18c0 2.14 1.11 3.28 3.2 3.28a6.56 6.56 0 0 0 2-.42v-2.78c-1.28.51-1.8.38-2.01.23Zm-75.27.05h1.43V21h-5.79v-2.64h1.43v-8h-1.61V7.7h4.54Zm-11.09-11a5.81 5.81 0 0 0-4.36 1.87V2.23H29.7v2.68h1.62v12.71a.81.81 0 0 1-.25.69c-.43.33-1.5 0-2.06-.23v2.76a6.59 6.59 0 0 0 2.05.42 2.92 2.92 0 0 0 2.74-1.32 6.86 6.86 0 0 0 4.27 1.34 6.66 6.66 0 0 0 6.86-7c-.01-4.06-2.68-6.97-6.35-6.97ZM38 18.57c-2.15 0-3.72-1.75-3.72-4.17s1.55-4.32 3.78-4.32a3.75 3.75 0 0 1 3.75 4.1c.02 2.55-1.58 4.39-3.81 4.39Zm68.86-.49v2.76a7.52 7.52 0 0 1-2 .42c-2.09 0-3.2-1.14-3.2-3.28V5.36l2.93-1.92V7.7h3.81l-1.91 2.68h-1.9v7.24a.77.77 0 0 0 .26.69c.53.4 2.03-.23 2.03-.23ZM58 7.31c-3.88 0-6.69 3-6.69 7.11s2.66 6.87 6.33 6.87A6.14 6.14 0 0 0 62 19.45v1.42c0 2.72-2.4 3.45-3.83 3.45a5.22 5.22 0 0 1-3.12-1.06l-2.36 1.83A7.78 7.78 0 0 0 58 27c3.21 0 6.95-1.63 6.95-6.21v-6.38A6.84 6.84 0 0 0 58 7.31Zm.12 11.29c-2.19 0-3.72-1.74-3.72-4.23s1.6-4.21 3.8-4.21a3.94 3.94 0 0 1 3.8 4.21 4 4 0 0 1-3.85 4.23ZM120.6 15c0-5.05-3.45-7.69-6.85-7.69a6.76 6.76 0 0 0-6.58 7.06 7.13 7.13 0 0 0 12.69 4.39l-2.22-1.71a4.24 4.24 0 0 1-3.44 1.69 3.86 3.86 0 0 1-3.94-3.11h10.28a3.09 3.09 0 0 0 .06-.63Zm-10.35-2.08a3.65 3.65 0 0 1 3.56-3.11 3.77 3.77 0 0 1 3.77 3.11ZM94.92 10V7.7h-4v2.68h1.62v8h-2.35a.83.83 0 0 1-.61-.19.91.91 0 0 1-.19-.64v-5.77c0-1.31-.65-4.47-5.52-4.47a7.85 7.85 0 0 0-4.14 1.18l1.17 2.23a5 5 0 0 1 3-.78 3.26 3.26 0 0 1 1.76.49 2.08 2.08 0 0 1 .81 1.78v1.25a6.58 6.58 0 0 0-3.21-.92c-2.58 0-3.91 1.62-5.19 3.2s-2.51 3-5 2.92c-2.27-.11-3.63-1.86-3.63-4.43 0-2.39 1.45-4 3.54-4a3.75 3.75 0 0 1 3.7 3.18l2.45-1.9a6.3 6.3 0 0 0-6.3-4.18 6.72 6.72 0 0 0-6.48 7c0 3.43 2.1 7.16 6.62 7.16a7.45 7.45 0 0 0 5.87-2.73 4.38 4.38 0 0 0 4.08 2.57 5.91 5.91 0 0 0 3.93-1.66 2.87 2.87 0 0 0 2.8 1.33h7.42v-2.64h-1.61v-3.21c0-3.3 1.09-4.77 3.56-4.77a3.68 3.68 0 0 1 1.45.31V8a4.81 4.81 0 0 0-1.74-.25A4.21 4.21 0 0 0 94.92 10Zm-8.47 7.48a4.93 4.93 0 0 1-3.16 1.41 1.9 1.9 0 0 1-2.05-1.91 2 2 0 0 1 2.18-2 5 5 0 0 1 3 1.18ZM11 14.52v-.89a1.78 1.78 0 0 1 .83-1.51l7.35-4.7A1.79 1.79 0 0 0 20 5.91V2.05L11 7.8 2 2.05V14.2a8.69 8.69 0 0 0 3.88 7.58L11 25.05l5.12-3.27A8.69 8.69 0 0 0 20 14.2V8.77Z" class="a"></path>
-        </svg>
-      </a>)
+      build_powered_by_link(include_text: true)
+    end
+
+    def big_cartel_credit_logo
+      build_powered_by_link(include_text: false)
+    end
+
+    def build_powered_by_link(include_text: true)
+      svg_content = read_svg_asset('big_cartel_logo.svg')
+      
+      text_span = include_text ? '      <span class="bigcartel-credit__text" aria-hidden="true">Powered by</span>' : ''
+      <<~HTML
+        <a class="bigcartel-credit" href="https://www.bigcartel.com/?utm_source=bigcartel&utm_medium=storefront&utm_campaign=123}" title="Powered by Big Cartel" data-bc-hook="attribution">
+        #{text_span}
+          #{svg_content}
+        </a>
+      HTML
+    end
+
+    # Load theme-specific override locales
+    def load_theme_locales
+      return unless Dugway.source_dir && Dir.exist?(File.dirname(Dugway.source_dir))
+      
+      parent_dir = File.dirname(Dugway.source_dir)
+      theme_locales_dir = File.join(parent_dir, 'locales')
+      
+      if Dir.exist?(theme_locales_dir)
+        theme_locales_path = File.expand_path(theme_locales_dir)
+        # Ensure theme locales are loaded *after* defaults to allow overrides
+        I18n.load_path |= Dir[File.join(theme_locales_path, 'storefront.*.yml')]
+        I18n.backend.reload!
+      end
     end
   end
 end

data/lib/dugway/store.rb

@@ -8,8 +8,9 @@ module Dugway
     default_timeout 5
     headers 'User-Agent' => "Dugway #{ Dugway::VERSION }"
 
-    def initialize(subdomain)
+    def initialize(subdomain, store_options = {})
       self.class.base_uri "https://api.bigcartel.com/#{ subdomain }"
+      @store_options = store_options || {}
     end
 
     def account
@@ -124,7 +125,11 @@ module Dugway
     end
 
     def locale
-      currency['locale']
+      @store_options[:locale] || currency['locale']
+    end
+
+    def website
+      @store_options[:website] || account['website']
     end
 
     def instant_checkout?

data/lib/dugway/theme.rb

@@ -13,10 +13,12 @@ module Dugway
       File.join(__dir__, 'config', 'theme_color_attribute_mappings.yml')
     ).freeze
 
-    attr_reader :errors
+    attr_reader :errors, :warnings
 
     def initialize(overridden_customization={})
       @overridden_customization = overridden_customization.stringify_keys
+      @errors = []
+      @warnings = []
     end
 
     def layout
@@ -39,9 +41,13 @@ module Dugway
       customization_for_type('image_sets')
     end
 
+    def features
+      customization_for_type('features')
+    end
+
     def customization
       Hash.new.tap do |customization|
-        %w( fonts colors options images image_sets ).each do |type|
+        %w( fonts colors options images image_sets features).each do |type|
           customization.update(customization_for_type(type))
         end
 
@@ -95,6 +101,7 @@ module Dugway
 
     def valid?(validate_colors: true, validate_layout_attributes: true, validate_options: true)
       @errors = []
+      @warnings = []
 
       REQUIRED_FILES.each do |file|
         @errors << "Missing source/#{ file }" if read_source_file(file).nil?
@@ -117,7 +124,14 @@ module Dugway
 
       validate_required_color_settings if validate_colors
       validate_required_layout_attributes if validate_layout_attributes
-      validate_options_settings if validate_options
+
+      if validate_options
+        validate_options_settings # Validate descriptions, requires, defaults
+        # Validate sections for options, images, and image_sets
+        validate_setting_sections(settings['options'], 'options') if settings['options']
+        validate_setting_sections(settings['images'], 'images') if settings['images']
+        validate_setting_sections(settings['image_sets'], 'image_sets') if settings['image_sets']
+      end
 
       @errors.empty?
     end
@@ -164,15 +178,41 @@ module Dugway
       @errors << "layout.html must have exactly one `data-bc-hook=\"footer\"`" if footer_hooks != 1
     end
 
+    VALID_SECTIONS = %w(global_navigation homepage product_page general messaging social translations).freeze
+
     def validate_options_settings
       return unless settings['options']
 
       validate_options_descriptions
       validate_options_requires
+      validate_option_defaults
     end
 
     private
 
+    # Generic method to validate the 'section' property for any array of settings
+    def validate_setting_sections(settings_array, setting_type_name)
+      return unless settings_array.is_a?(Array)
+
+      settings_array.each do |setting|
+        variable = setting['variable'] || 'unknown'
+
+        unless setting.key?('section')
+          warning_msg = "Warning: Theme setting '#{variable}' is missing the 'section' property."
+          @warnings << warning_msg
+          Kernel.warn(warning_msg)
+          next # Skip further checks if section is missing
+        end
+
+        section_value = setting['section']
+        unless VALID_SECTIONS.include?(section_value)
+          warning_msg = "Warning: Theme setting '#{variable}' has an invalid 'section' value: '#{section_value}'. Allowed values are: #{VALID_SECTIONS.join(', ')}."
+          @warnings << warning_msg
+          Kernel.warn(warning_msg)
+        end
+      end
+    end
+
     def validate_preview
       preview = settings['preset_styles']['preview']
       if preview
@@ -254,6 +294,7 @@ module Dugway
     def validate_options_requires
       return unless settings['options']
       all_variables = settings['options'].map { |o| o['variable'] }
+      valid_operators = %w(eq neq gt lt gte lte present)
 
       settings['options'].each do |option|
         next unless option['requires']
@@ -277,22 +318,78 @@ module Dugway
         option['requires'].each do |rule|
           next if rule == 'inventory'
 
-          # Extract setting name from rule
-          # Handle both simple cases ("show_search") and complex cases ("show_search eq true")
-          setting_name = if rule.include?(' ')
-            rule.split(/\s+/).first
-          else
-            rule
+          # Extract setting name and optional operator/value
+          parts = rule.split(/\s+/)
+          setting_name = parts[0]
+          operator = parts[1]
+          value = parts[2]
+
+          if setting_name.start_with?('feature:')
+            # Validate feature flag format
+            unless setting_name =~ /^feature:[a-z_]+$/
+              @errors << "Option '#{option['variable']}' has invalid feature flag format"
+              next
+            end
+
+            # Only validate operator/value if they exist
+            if operator
+              is_valid_operator = ['eq', 'neq'].include?(operator)
+
+              @errors << "Option '#{option['variable']}' has invalid operator '#{operator}'. Feature flags can only use `eq` or `neq`." unless is_valid_operator
+
+              is_valid_value = ['visible'].include?(value)
+
+              @errors << "Option '#{option['variable']}' has invalid comparison value '#{value}'. Feature flags can only check for `visible`." unless is_valid_value
+            end
+            next
           end
 
-          # Verify the referenced setting exists
+          # --- Non-feature rule validation ---
           unless all_variables.include?(setting_name)
             @errors << "Option '#{option['variable']}' requires unknown setting '#{setting_name}'"
+            next # Skip further checks for this rule if setting is unknown
+          end
+
+          # Validate operator if present
+          if operator && !valid_operators.include?(operator)
+            @errors << "Option '#{option['variable']}' has invalid operator '#{operator}'. Allowed operators are: #{valid_operators.join(', ')}."
           end
         end
       end
     end
 
+    def validate_option_value(option, value_type)
+      value = option[value_type]
+      return unless value
+
+      case option['type']
+      when 'select'
+        validate_select_option(option, value, value_type)
+      when 'boolean'
+        @errors << "#{value_type.capitalize} '#{value}' is not a boolean for #{option['variable']}" unless [true, false].include?(value)
+      end
+    end
+
+    def validate_option_defaults
+      return unless settings['options']
+      settings['options'].each do |option|
+        validate_option_value(option, 'default')
+        validate_option_value(option, 'upgrade_default')
+      end
+    end
+
+    def validate_select_option(option, value, value_type)
+      if option['options'] == "product_orders"
+        valid_values = %w[position top-selling newest views updated_new_to_old]
+        @errors << "#{value_type.capitalize} '#{value}' is not a valid option for #{option['variable']}" unless valid_values.include?(value)
+      elsif option['options'].is_a?(String) && option['options'] =~ /^\d+\.\.\d+$/
+        range = eval(option['options'])
+        @errors << "#{value_type.capitalize} '#{value}' is out of range for #{option['variable']}" unless range.include?(value.to_i)
+      elsif option['options'].is_a?(Array)
+        valid_values = option['options'].map { |o| o.is_a?(Array) ? o[1] : o }
+        @errors << "#{value_type.capitalize} '#{value}' is not a valid option for #{option['variable']}" unless valid_values.include?(value)
+      end
+    end
 
     def source_dir
       Dugway.source_dir

data/lib/dugway/version.rb

@@ -1,3 +1,3 @@
 module Dugway
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

data/lib/dugway.rb

@@ -14,6 +14,33 @@ require 'i18n'
 require 'bigcartel-currency-locales'
 require 'bigcartel/theme/fonts'
 
+# Configure I18n to load locale files from the gem's locales directory.
+# This allows for easy addition and management of translations.
+gem_locales_pattern = File.expand_path('../locales/storefront.*.yml', File.dirname(__FILE__))
+gem_locale_files = Dir.glob(gem_locales_pattern)
+
+# Add these locale files to the I18n load path, ensuring no duplicates and preserving existing paths.
+I18n.load_path = (I18n.load_path + gem_locale_files).uniq
+
+# Determine available locales from the filenames (e.g., 'storefront.en-US.yml' -> :'en-US').
+available_locales = gem_locale_files.map do |file|
+  # Extracts 'en-US' from 'storefront.en-US.yml' or 'de' from 'storefront.de.yml'
+  locale_string = File.basename(file, '.yml').split('storefront.').last
+  locale_string.to_sym if locale_string
+end.compact.uniq
+
+# Ensure :en is an available locale if any 'en-XX' variant exists (e.g., :en-US, :en-GB),
+# as I18n can use :en as a fallback.
+if available_locales.any? { |loc| loc.to_s.start_with?('en-') } && !available_locales.include?(:en)
+  available_locales << :en
+end
+
+# Set available locales. Provide a default if no locale files are found (e.g., during initial setup or in case of an error).
+I18n.config.available_locales = available_locales.empty? ? [:'en-US', :en] : available_locales
+
+# Reload I18n to apply changes and load the translations from the files.
+I18n.backend.reload!
+
 require 'rack/builder'
 require 'rack/commonlogger'
 require 'better_errors'
@@ -52,7 +79,9 @@ module Dugway
     end
 
     def store
-      @store ||= Store.new(options && options[:store] && options[:store][:subdomain] || 'dugway')
+      store_options = options && options[:store] ? options[:store] : {}
+      subdomain = store_options[:subdomain] || 'dugway'
+      @store ||= Store.new(subdomain, store_options)
     end
 
     def theme
@@ -74,5 +103,6 @@ module Dugway
     def options
       @options
     end
+
   end
 end

data/locales/storefront.de.yml

@@ -0,0 +1,79 @@
+de:
+  storefront:
+    navigation:
+      all: "Alle"
+      all_products: "Alle Produkte"
+      back_to_site: "Zurück zur Seite"
+      cart: "Warenkorb"
+      categories: "Kategorien"
+      contact: "Kontakt"
+      home: "Startseite"
+      item: "Artikel" # capitalized as it is proper grammar in German
+      items: "Artikel" # capitalized as it is proper grammar in German
+      more: "Mehr"
+      next: "Weiter"
+      newest: "Neueste"
+      pages: "Seiten"
+      previous: "Zurück"
+      products: "Produkte"
+      quick_view: "Schnellansicht"
+      search: "Suche"
+      shop: "Shop"
+      social: "Folge uns"
+      subscribe: "Abonnieren"
+      top_selling: "Meistverkauft"
+      view: "Ansehen"
+      view_all: "Alle anzeigen"
+      # "Sort By" translations are used in very few themes, and are not exposed in theme settings for sellers to configure
+      sort_by: Sortieren nach
+      sort_by_featured: Empfohlen
+      sort_by_on_sale: Im Angebot
+      sort_by_top_selling: Bestseller
+      sort_by_alphabetically_a_to_z: Alphabetisch (A bis Z)
+      sort_by_alphabetically_z_to_a: Alphabetisch (Z bis A)
+      sort_by_date_new_to_old: Datum (neu zu alt)
+      sort_by_date_old_to_new: Datum (alt zu neu)
+      sort_by_price_low_to_high: Preis (niedrig zu hoch)
+      sort_by_price_high_to_low: Preis (hoch zu niedrig)
+    home:
+      all_products: "Alle Produkte"
+      featured: "Empfohlen"
+      featured_categories: "Empfohlene Kategorien"
+      featured_products: "Empfohlene Produkte"
+      featured_video: ""
+    products:
+      add_to_cart: "Hinzufügen"
+      added: "Hinzugefügt!" # Used in few themes, intentionally not exposed in theme settings
+      adding: "Hinzufügen..." # Used in few themes, intentionally not exposed in theme settings
+      almost_sold_out: "Nur noch wenige!"
+      coming_soon: "Demnächst verfügbar"
+      in_stock: "auf Lager"
+      description: "Beschreibung"
+      inventory: "Lagerbestand"
+      low_inventory: "Begrenzte Menge"
+      no_products: "Keine Produkte gefunden"
+      on_sale: "Im Angebot"
+      related_products: "Das gefällt dir vielleicht"
+      reset: "Zurücksetzen"
+      search_results: "Suchergebnisse"
+      select: "Wählen"
+      select_variant: "Option wählen"
+      sold_out: "Ausverkauft"
+    cart:
+      checkout: "Zur Kasse"
+      continue_shopping: "Weiter einkaufen"
+      empty_cart: "Dein Warenkorb ist leer"
+      quantity_abbreviated: "Anz."
+      quantity: "Anzahl"
+      remove: "Entfernen"
+      share_this_cart: "Diesen Warenkorb teilen"
+      share_this_cart_link_copy_success: "Link kopiert!"
+      subtotal: "Zwischensumme"
+      view_cart: "Warenkorb ansehen"
+    contact:
+      email: "E-Mail"
+      form_success: "Danke! Deine Nachricht wurde gesendet und wir werden uns bald bei dir melden."
+      message: "Nachricht"
+      name: "Name"
+      send_button: "Nachricht senden"
+      subject: "Betreff"

data/locales/storefront.en-CA.yml

@@ -0,0 +1,79 @@
+en-CA:
+  storefront:
+    navigation:
+      all: "All"
+      all_products: "All products"
+      back_to_site: "Back to site"
+      cart: "Cart"
+      categories: "Categories"
+      contact: "Contact"
+      home: "Home"
+      item: "item"
+      items: "items"
+      more: "More"
+      next: "Next"
+      newest: "Newest"
+      pages: "Pages"
+      previous: "Previous"
+      products: "Products"
+      quick_view: "Quick view"
+      search: "Search"
+      shop: "Shop"
+      social: "Follow us"
+      subscribe: "Subscribe"
+      top_selling: "Best-selling"
+      view: "View"
+      view_all: "View all"
+      # "Sort By" translations are used in very few themes, and are not exposed in theme settings for sellers to configure
+      sort_by: Sort by
+      sort_by_featured: Featured
+      sort_by_on_sale: On Sale
+      sort_by_top_selling: Top Selling
+      sort_by_alphabetically_a_to_z: Alphabetically (A to Z)
+      sort_by_alphabetically_z_to_a: Alphabetically (Z to A)
+      sort_by_date_new_to_old: Date (New to Old)
+      sort_by_date_old_to_new: Date (Old to New)
+      sort_by_price_low_to_high: Price (Low to High)
+      sort_by_price_high_to_low: Price (High to Low)
+    home:
+      all_products: "All products"
+      featured: "Featured"
+      featured_categories: "Featured categories"
+      featured_products: "Featured products"
+      featured_video: ""
+    products:
+      add_to_cart: "Add to cart"
+      adding: "Adding..." # Used in few themes, intentionally not exposed in theme settings
+      added: "Added!" # Used in few themes, intentionally not exposed in theme settings
+      almost_sold_out: "Only a few left!"
+      coming_soon: "Coming soon"
+      description: "Description"
+      in_stock: "in stock"
+      inventory: "Inventory"
+      low_inventory: "Limited quantities available"
+      no_products: "No products found"
+      on_sale: "On sale"
+      related_products: "You might also like"
+      reset: "Reset"
+      search_results: "Search results"
+      select: "Select"
+      select_variant: "Select option"
+      sold_out: "Sold out"
+    cart:
+      checkout: "Checkout"
+      continue_shopping: "Continue shopping"
+      empty_cart: "Your cart is empty"
+      quantity_abbreviated: "Qty"
+      quantity: "Quantity"
+      remove: "Remove"
+      share_this_cart: "Share this cart"
+      share_this_cart_link_copy_success: "Link copied!"
+      subtotal: "Subtotal"
+      view_cart: "View cart"
+    contact:
+      email: "Email"
+      form_success: "Thanks! Your message has been sent and we'll get back to you soon."
+      message: "Message"
+      name: "Name"
+      send_button: "Send message"
+      subject: "Subject"