alchemy_cms 6.1.5 → 7.0.0.pre.b

data/Rakefile

@@ -48,9 +48,10 @@ namespace :alchemy do
           bin/rake db:create && \
           bin/rake db:environment:set && \
           bin/rake db:migrate:reset && \
+          bin/rails javascript:install:esbuild && \
           bin/rails g alchemy:install --skip --skip-demo-files --auto-accept --skip-db-create && \
           yarn link @alchemy_cms/admin && \
-          RAILS_ENV=test bin/webpack && \
+          bin/rails javascript:build && \
           cd -
         BASH
       ) || fail
@@ -63,13 +64,17 @@ namespace :alchemy do
       original_file = "./CHANGELOG.md"
       new_file = original_file + ".new"
       backup = original_file + ".old"
-      changes = `git rev-list v#{ENV["PREVIOUS_VERSION"]}..HEAD | bundle exec github_fast_changelog AlchemyCMS/alchemy_cms`
-      File.open(new_file, "w") do |fo|
-        fo.puts changes
-        File.foreach(original_file) do |li|
-          fo.puts li
+      changes = `git rev-list v#{ENV["PREVIOUS_VERSION"]}..HEAD | bundle exec github_fast_changelog AlchemyCMS/alchemy_cms`.split("\n")
+      changelog = File.read(original_file)
+      File.open(new_file, "w") do |file|
+        changes.each do |change|
+          next if changelog.include?(change)
+          file.puts change
         end
-        fo.puts ""
+        File.foreach(original_file) do |line|
+          file.puts line
+        end
+        file.puts ""
       end
       File.rename(original_file, backup)
       File.rename(new_file, original_file)

data/alchemy_cms.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |gem|
   gem.summary = "A powerful, userfriendly and flexible CMS for Rails"
   gem.description = "Alchemy is a powerful, userfriendly and flexible Rails CMS."
   gem.requirements << "ImageMagick (libmagick), v6.6 or greater."
-  gem.required_ruby_version = ">= 2.5.0"
+  gem.required_ruby_version = ">= 3.0.0"
   gem.license = "BSD New"
   gem.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^spec/}) }
   gem.require_paths = ["lib"]
@@ -45,14 +45,14 @@ Gem::Specification.new do |gem|
   gem.add_runtime_dependency "jquery-ui-rails", ["~> 6.0"]
   gem.add_runtime_dependency "kaminari", ["~> 1.1"]
   gem.add_runtime_dependency "originator", ["~> 3.1"]
-  gem.add_runtime_dependency "ransack", [">= 1.8", "< 4.0"]
+  gem.add_runtime_dependency "ransack", [">= 1.8", "< 5.0"]
   gem.add_runtime_dependency "request_store", ["~> 1.2"]
   gem.add_runtime_dependency "responders", [">= 2.0", "< 4.0"]
   gem.add_runtime_dependency "sassc-rails", ["~> 2.1"]
   gem.add_runtime_dependency "simple_form", [">= 4.0", "< 6"]
   gem.add_runtime_dependency "sprockets", [">= 3.0", "< 5"]
   gem.add_runtime_dependency "turbolinks", [">= 2.5"]
-  gem.add_runtime_dependency "webpacker", [">= 4.0", "< 6"]
+  gem.add_runtime_dependency "view_component", ["~> 3.0"]
 
   gem.add_development_dependency "capybara", ["~> 3.0"]
   gem.add_development_dependency "capybara-screenshot", ["~> 1.0"]

data/app/assets/javascripts/alchemy/admin.js

@@ -38,7 +38,6 @@
 //= require alchemy/alchemy.uploader
 //= require alchemy/alchemy.preview_window
 //= require alchemy/alchemy.spinner
-//= require alchemy/alchemy.tinymce
 //= require alchemy/alchemy.tooltips
 //= require alchemy/page_select
 //= require alchemy/node_select

data/app/assets/javascripts/alchemy/alchemy.dirty.js.coffee

@@ -20,7 +20,7 @@ $.extend Alchemy,
   setElementClean: (element) ->
     $element = $(element)
     $element.removeClass('dirty')
-    $element.find('> .element-content .dirty').removeClass('dirty')
+    $element.find('> .element-body .dirty').removeClass('dirty')
     window.onbeforeunload = undefined
 
   isPageDirty: ->

data/app/assets/javascripts/alchemy/alchemy.element_editors.js.coffee

@@ -15,7 +15,7 @@ Alchemy.ElementEditors =
   init: ->
     @element_area = $("#element_area")
     @bindEvents()
-    @expandContentGroups()
+    @expandIngredientGroups()
     return
 
   # Binds click events on several DOM elements from element editors
@@ -29,27 +29,25 @@ Alchemy.ElementEditors =
       @onDoubleClickElement(e)
     @element_area.on "click", "[data-element-toggle]", (e) =>
       @onClickToggle(e)
-    @element_area.on "click", '[data-create-missing-content]', (e) =>
-      @onClickMissingContent(e)
     # Binds the custom FocusElementEditor event
     @element_area.on "FocusElementEditor.Alchemy", '.element-editor', (e) =>
       @onFocusElement(e)
     # Binds the custom SaveElement event
     @element_area.on "SaveElement.Alchemy", '.element-editor', (e, data) =>
       @onSaveElement(e, data)
-    @element_area.on "click", '[data-toggle-content-group]', (e) =>
-      @onToggleContentGroup(e)
+    @element_area.on "click", '[data-toggle-ingredient-group]', (e) =>
+      @onToggleIngredientGroup(e)
     # Listen to postMessage messages from the preview frame
     window.addEventListener 'message', (e) =>
       @onMessage(e.data)
       true
     return
 
-  # Expands content groups that are stored in sessionStorage as expanded
-  expandContentGroups: ->
-    if $expanded_content_groups = sessionStorage.getItem('Alchemy.expanded_content_groups')
-      for header_id in JSON.parse($expanded_content_groups) then do (header_id) =>
-        $('#' + header_id).closest('.content-group').addClass('expanded');
+  # Expands ingredient groups that are stored in sessionStorage as expanded
+  expandIngredientGroups: ->
+    if $expanded_ingredient_groups = sessionStorage.getItem('Alchemy.expanded_ingredient_groups')
+      for header_id in JSON.parse($expanded_ingredient_groups) then do (header_id) =>
+        $('#' + header_id).closest('.ingredient-group').addClass('expanded');
 
   # Selects and scrolls to element with given id in the preview window.
   #
@@ -179,21 +177,21 @@ Alchemy.ElementEditors =
       Alchemy.Buttons.enable($element)
     true
 
-  # Toggle visibility of the content fields in the group
-  onToggleContentGroup: (event) ->
-    $group_div = $(event.currentTarget).closest('.content-group');
+  # Toggle visibility of the ingredient fields in the group
+  onToggleIngredientGroup: (event) ->
+    $group_div = $(event.currentTarget).closest('.ingredient-group');
     $group_div.toggleClass('expanded');
 
-    $expanded_content_groups = JSON.parse(sessionStorage.getItem('Alchemy.expanded_content_groups') || '[]');
-    # Add or remove depending on whether this content group is expanded
+    $expanded_ingredient_groups = JSON.parse(sessionStorage.getItem('Alchemy.expanded_ingredient_groups') || '[]');
+    # Add or remove depending on whether this ingredient group is expanded
     if $group_div.hasClass('expanded')
-      if $expanded_content_groups.indexOf(event.currentTarget.id) == -1
-        $expanded_content_groups.push(event.currentTarget.id);
+      if $expanded_ingredient_groups.indexOf(event.currentTarget.id) == -1
+        $expanded_ingredient_groups.push(event.currentTarget.id);
     else
-      $expanded_content_groups = $expanded_content_groups.filter (value) ->
+      $expanded_ingredient_groups = $expanded_ingredient_groups.filter (value) ->
         value != event.currentTarget.id
 
-    sessionStorage.setItem('Alchemy.expanded_content_groups', JSON.stringify($expanded_content_groups))
+    sessionStorage.setItem('Alchemy.expanded_ingredient_groups', JSON.stringify($expanded_ingredient_groups))
     false
 
   # Event handlers
@@ -248,22 +246,10 @@ Alchemy.ElementEditors =
     e.stopPropagation()
     false
 
-  # Handles the missing content button click events.
-  #
-  # Ensures that the links query string is converted into post body and send
-  # the request via a real ajax post to server, to allow long query strings.
-  #
-  onClickMissingContent: (e) ->
-    link = e.target
-    url = link.pathname
-    querystring = link.search.replace(/\?/, '')
-    $.post(url, querystring)
-    false
-
   # private
 
   _shouldUpdateTitle: (element, event) ->
-    editors = element.find('> .element-content .element-content-editors, > .element-content .element-ingredient-editors').children()
+    editors = element.find('> .element-body .element-ingredient-editors').children()
     if @_hasParents(element)
       editors.length != 0
     else if @_isParent(element) && @_isFirstChild $(event.target)

data/app/assets/javascripts/alchemy/alchemy.elements_window.js.coffee

@@ -50,8 +50,8 @@ Alchemy.ElementsWindow =
     $.get @url, (data) =>
       @element_area.html data
       Alchemy.GUI.init(@element_area)
-      Alchemy.fileEditors(@element_area.find(".essence_file, .essence_video, .essence_audio, .ingredient-editor.file, .ingredient-editor.audio, .ingredient-editor.video").selector)
-      Alchemy.pictureEditors(@element_area.find(".essence_picture, .ingredient-editor.picture").selector)
+      Alchemy.fileEditors(@element_area.find(".ingredient-editor.file, .ingredient-editor.audio, .ingredient-editor.video").selector)
+      Alchemy.pictureEditors(@element_area.find(".ingredient-editor.picture").selector)
       if @callback
         @callback.call()
     .fail (xhr, status, error) =>

data/app/assets/javascripts/alchemy/alchemy.gui.js.coffee

@@ -23,5 +23,5 @@ Alchemy.GUI =
     Alchemy.ElementDirtyObserver($el)
     Alchemy.GUI.init($el && $el.selector)
     Alchemy.ImageLoader($el[0])
-    Alchemy.fileEditors($el.find(".essence_file, .essence_video, .essence_audio, .ingredient-editor.file, .ingredient-editor.audio, .ingredient-editor.video").selector)
-    Alchemy.pictureEditors($el.find(".essence_picture, .ingredient-editor.picture").selector)
+    Alchemy.fileEditors($el.find(".ingredient-editor.file, .ingredient-editor.audio, .ingredient-editor.video").selector)
+    Alchemy.pictureEditors($el.find(".ingredient-editor.picture").selector)

data/app/assets/javascripts/alchemy/alchemy.link_dialog.js.coffee

@@ -1,5 +1,5 @@
 # Represents the link Dialog that appears, if a user clicks the link buttons
-# in TinyMCE or on an Essence that has links enabled (e.g. EssencePicture)
+# in TinyMCE or on an Ingredient that has links enabled (e.g. Picture)
 #
 class window.Alchemy.LinkDialog extends Alchemy.Dialog
 
@@ -25,37 +25,29 @@ class window.Alchemy.LinkDialog extends Alchemy.Dialog
     # attach events we handle
     @attachEvents()
     # Store some jQuery objects for further reference
-    @$page_urlname = $('#page_urlname', @dialog_body)
+    @$internal_link = $('#internal_link', @dialog_body)
     @$element_anchor = $('#element_anchor', @dialog_body)
     @$anchor_link = $('#anchor_link', @dialog_body)
-    @$external_url = $('#external_url', @dialog_body)
-    @$public_filename = $('#public_filename', @dialog_body)
+    @$external_link = $('#external_link', @dialog_body)
+    @$file_link = $('#file_link', @dialog_body)
     @$overlay_tabs = $('#overlay_tabs', @dialog_body)
     @$page_container = $('#page_selector_container')
+    @initAnchorLinks()
     # if we edit an existing link
     if @link_object
       # we select the correct tab
       @selectTab()
     @initPageSelect()
-    @initAnchorLinks()
+    return
 
   # Attaches click events to several buttons in the link dialog.
   attachEvents: ->
     # The ok buttons
     $('.create-link.button', @dialog_body).click (e) =>
       @link_type = $(e.target).data('link-type')
-      switch @link_type
-        # get stored url for link type
-        when 'external'
-          url = @$external_url.val()
-        when 'file'
-          url = @$public_filename.val()
-        when 'anchor'
-          url = @$anchor_link.val()
-        else
-          url = @$page_urlname.val()
-          if @$element_anchor.val() != ''
-            url += "##{@$element_anchor.val()}"
+      url = $("##{@link_type}_link").val()
+      if @link_type == 'internal' && @$element_anchor.val() != ''
+        url += "##{@$element_anchor.val()}"
       # Create the link
       @createLink
         url: url
@@ -67,12 +59,17 @@ class window.Alchemy.LinkDialog extends Alchemy.Dialog
   initPageSelect: ->
     pageTemplate = HandlebarsTemplates.page
     element_anchor_placeholder = @$element_anchor.attr('placeholder')
-    @$page_urlname.select2
+    if @link_object.dataset.languageId
+      api_url = "#{Alchemy.routes.api_pages_path}?language_id=#{@link_object.dataset.languageId}"
+    else
+      api_url = Alchemy.routes.api_pages_path
+
+    @$internal_link.select2
       placeholder: Alchemy.t('Search page')
       allowClear: true
       minimumInputLength: 3
       ajax:
-        url: Alchemy.routes.api_pages_path
+        url: api_url
         datatype: 'json'
         quietMillis: 300
         data: (term, page) ->
@@ -142,7 +139,7 @@ class window.Alchemy.LinkDialog extends Alchemy.Dialog
       @setLink(options.url, options.title, options.target)
     @close()
 
-  # Sets the link either in TinyMCE or on an Essence.
+  # Sets the link either in TinyMCE or on an Ingredient.
   setLink: (url, title, target) ->
     Alchemy.setElementDirty(@$link_object.closest('.element-editor'))
     if @link_object.editor
@@ -162,7 +159,7 @@ class window.Alchemy.LinkDialog extends Alchemy.Dialog
     editor.selection.collapse()
     true
 
-  # Sets a link on an Essence (e.g. EssencePicture).
+  # Sets a link on an Ingredient (e.g. Picture).
   setLinkFields: (url, title, target) ->
     @link_value_field.value = url
     @link_value_field.dispatchEvent(new Event("change"))
@@ -176,10 +173,10 @@ class window.Alchemy.LinkDialog extends Alchemy.Dialog
 
   # Selects the correct tab for link type and fills all fields.
   selectTab: ->
-    # Creating an temporary anchor node if we are linking an EssencePicture or EssenceText.
+    # Creating an temporary anchor node if we are linking an Picture Ingredient.
     if (@link_object.nodeType)
       @$link = @createTempLink()
-    # Restoring the bookmarked selection inside the TinyMCE of an EssenceRichtext.
+    # Restoring the bookmarked selection inside the TinyMCE of an Richtext.
     else if (@link_object.node.nodeName == 'A')
       @$link = $(@link_object.node)
       @link_object.selection.moveToBookmark(@link_object.bookmark)
@@ -192,27 +189,33 @@ class window.Alchemy.LinkDialog extends Alchemy.Dialog
     if @$link.hasClass('external')
       # Handles an external link.
       tab = $('#overlay_tab_external_link')
-      @$external_url.val(@$link.attr('href'))
+      @$external_link.val(@$link.attr('href'))
     else if @$link.hasClass('file')
       # Handles a file link.
       tab = $('#overlay_tab_file_link')
-      @$public_filename.select2('val', @$link[0].pathname + @$link[0].search)
+      @$file_link.select2('val', @$link[0].pathname + @$link[0].search)
     else if @$link.attr('href').match(/^#/)
       # Handles an anchor link.
       tab = $('#overlay_tab_anchor_link')
       @$anchor_link.select2('val', @$link.attr('href'))
-    else
+    else if @$link.hasClass('internal')
       # Handles an internal link.
       tab = $('#overlay_tab_internal_link')
       @initInternalLinkTab()
-    # activate the tab jquery ui 1.10 style o.O
-    @$overlay_tabs.tabs('option', 'active', $('#overlay_tabs > div').index(tab))
+    else
+      # Emit an event to allow extensions hook into the link overlay.
+      @$overlay_tabs.trigger 'SelectLinkTab.Alchemy',
+        link: @$link
+    if tab
+      # activate the tab jquery ui 1.10 style o.O
+      @$overlay_tabs.tabs('option', 'active', $('#overlay_tabs > div').index(tab))
+    return
 
   # Handles actions for internal link tab.
   initInternalLinkTab: ->
     url = @$link.attr('href').split('#')
     # update the url field
-    @$page_urlname.val(url[0])
+    @$internal_link.val(url[0])
     # store the anchor
     @$element_anchor.val(url[1])
 
@@ -251,7 +254,7 @@ class window.Alchemy.LinkDialog extends Alchemy.Dialog
 
   # Public class methods
 
-  # Removes link from Essence.
+  # Removes link from Ingredient.
   @removeLink = (link, parent_selector) ->
     parent = document.querySelector(parent_selector)
     link_value_field = parent.querySelector("[data-link-value]")

data/app/assets/stylesheets/alchemy/elements.scss

@@ -275,11 +275,10 @@
       }
     }
 
-    .element-content {
+    .element-body {
       margin: 4px 8px;
     }
 
-    .content_editor,
     .ingredient-editor,
     .picture_thumbnail {
       width: 100%;
@@ -303,7 +302,7 @@
     }
   }
 
-  .element-content {
+  .element-body {
     margin: 2 * $default-padding;
   }
 
@@ -414,7 +413,7 @@
   }
 }
 
-.content-group {
+.ingredient-group {
   width: 100%;
   padding: $default-padding 0;
   position: relative;
@@ -425,7 +424,7 @@
     padding-bottom: 0;
   }
 
-  .content-group-header {
+  .ingredient-group-header {
     display: flex;
     align-items: center;
     justify-content: space-between;
@@ -434,22 +433,21 @@
     padding: $default-padding 1px;
   }
 
-  .content-group-contents {
+  .ingredient-group-ingredients {
     display: none;
   }
 
   &.expanded {
-    .content-group-contents {
+    .ingredient-group-ingredients {
       display: block;
     }
 
-    .content-group-expand {
+    .ingredient-group-expand {
       @extend .fa-angle-up;
     }
   }
 }
 
-.element-content-editors,
 .element-ingredient-editors {
   display: flex;
   flex-wrap: wrap;
@@ -467,7 +465,7 @@
   min-height: 100px;
 }
 
-.linkable_essence_tools {
+.ingredient_link_buttons {
   display: flex;
   position: absolute;
   bottom: 2 * $default-margin;
@@ -495,7 +493,7 @@
       background-color: $form-field-disabled-bg-color;
     }
 
-    &.linked.link-essence {
+    &.linked.link-ingredient {
       @include linked-button(
         $border-radius: 0,
         $line-height: 30px,
@@ -507,7 +505,7 @@
       }
     }
 
-    &.linked.unlink-essence {
+    &.linked.unlink-ingredient {
       @include linked-button(
         $border-radius: 0 $default-border-radius $default-border-radius 0,
         $line-height: 30px,
@@ -519,7 +517,7 @@
       }
     }
 
-    &.unlink-essence {
+    &.unlink-ingredient {
       border-left-width: 0;
       @extend .right-rounded-border;
     }
@@ -561,7 +559,6 @@
   }
 }
 
-.essence_picture,
 .ingredient-editor.picture {
   position: relative;
 
@@ -586,7 +583,7 @@
     }
   }
 
-  .essence_picture_css_class {
+  .picture_ingredient_css_class {
     position: absolute;
     z-index: 1;
     bottom: 24px;
@@ -639,9 +636,6 @@
   }
 }
 
-.content_editor.essence_audio,
-.content_editor.essence_file,
-.content_editor.essence_video,
 .ingredient-editor.audio,
 .ingredient-editor.file,
 .ingredient-editor.video {
@@ -681,8 +675,7 @@
   }
 }
 
-.file_tools,
-.essence_file_tools {
+.file_tools {
   display: flex;
   align-items: center;
   margin-left: auto;
@@ -717,7 +710,6 @@ select.long {
   padding: 0;
 }
 
-.content_editor,
 .ingredient-editor {
   width: 100%;
   padding: $default-padding 0;
@@ -828,7 +820,6 @@ select.long {
     }
   }
 
-  &.essence_select,
   &.select {
     label {
       margin-bottom: 2 * $default-margin;
@@ -843,8 +834,7 @@ select.long {
     }
   }
 
-  select.ingredient-editor-select,
-  select.essence_editor_select {
+  select.ingredient-editor-select {
     border-radius: $default-border-radius;
     background: white;
     border: 1px solid $button-border-color;
@@ -871,13 +861,11 @@ select.long {
     }
   }
 
-  &.essence_picture,
   &.picture {
     width: 50%;
     padding-left: 1px; // Compensate the box shadow
     padding-right: $default-padding;
 
-    + .essence_picture,
     + .picture {
       padding-left: $default-padding;
       padding-right: 1px; // Compensate the box shadow
@@ -885,10 +873,6 @@ select.long {
   }
 }
 
-.content_rtf_text_area {
-  display: none;
-}
-
 div.pictures_for_element {
   overflow: auto;
   margin-top: 4px;
@@ -898,7 +882,7 @@ textarea.has_tinymce {
   visibility: hidden;
 }
 
-.essence_html textarea {
+.ingredient-editor.html textarea {
   font-family: $mono-font-family;
   resize: vertical;
   font-size: $form-field-font-size;
@@ -928,8 +912,6 @@ textarea.has_tinymce {
   }
 }
 
-.content_editor .hint-with-icon,
-.content_editor .with-hint,
 .ingredient-editor .hint-with-icon,
 .ingredient-editor .with-hint,
 .element-handle .hint-with-icon {
@@ -946,7 +928,7 @@ textarea.has_tinymce {
 }
 
 .is-fixed {
-  &.with-contents {
+  &.with-ingredients {
     > .element-footer {
       border-top: 0;
       border-bottom: 1px solid $medium-gray;
@@ -992,7 +974,6 @@ textarea.has_tinymce {
 }
 
 .ingredient-date--label,
-.essence_date--label,
 .edit-ingredient-anchor-link {
   position: absolute;
   right: 2 * $default-padding;

data/app/assets/stylesheets/alchemy/forms.scss

@@ -249,10 +249,6 @@ form {
   }
 }
 
-textarea#essence_picture_caption {
-  height: 61px;
-}
-
 // styles for link overlay selects
 .window_form {
   td.checkbox {

data/app/assets/stylesheets/alchemy/node-select.scss

@@ -35,9 +35,9 @@
 }
 
 // The container of the rendered node is slightly larger than other a line of
-// text, as it would be for the Alchemy::EssencePage. Reducing the padding here from 0.6em
+// text, as it would be for the Alchemy::Ingredients::Page. Reducing the padding here from 0.6em
 // to 0.4em centers the content nicely.
-.essence_node {
+.ingredient-editor.node {
   .select2-container.alchemy_selectbox .select2-choice {
     padding: 0.4em 0.75em;
   }

data/app/components/alchemy/ingredients/audio_view.rb

@@ -0,0 +1,37 @@
+module Alchemy
+  module Ingredients
+    class AudioView < BaseView
+      def call
+        content_tag(:audio, **html_options) do
+          tag(:source, src: src, type: type)
+        end
+      end
+
+      def render?
+        !!ingredient.attachment
+      end
+
+      private
+
+      def src
+        alchemy.show_attachment_path(
+          ingredient.attachment,
+          format: ingredient.attachment.suffix
+        )
+      end
+
+      def type
+        ingredient.attachment.file_mime_type
+      end
+
+      def html_options
+        {
+          controls: ingredient.controls,
+          autoplay: ingredient.autoplay,
+          loop: ingredient.loop,
+          muted: ingredient.muted
+        }
+      end
+    end
+  end
+end

data/app/components/alchemy/ingredients/base_view.rb

@@ -0,0 +1,38 @@
+module Alchemy
+  module Ingredients
+    class BaseView < ViewComponent::Base
+      attr_reader :ingredient, :html_options
+
+      delegate :alchemy, to: :helpers
+      delegate :settings, :value, to: :ingredient
+
+      # @param ingredient [Alchemy::Ingredient]
+      # @param html_options [Hash] Options that will be passed to the wrapper tag.
+      def initialize(ingredient, html_options: {})
+        raise ArgumentError, "Ingredient missing!" if ingredient.nil?
+
+        @ingredient = ingredient
+        @html_options = html_options
+      end
+
+      def call
+        value
+      end
+
+      def render?
+        value.present?
+      end
+
+      private
+
+      # Fetches value from ingredient settings and allows to merge a value on top of it
+      #
+      # @param key [Symbol] - The settings key you want to fetch the value from
+      # @param value [Object] - A optional value that can override the setting.
+      #   Normally passed as into the ingredient view.
+      def settings_value(key, value: nil, default: nil)
+        value.nil? ? settings.fetch(key, default) : value
+      end
+    end
+  end
+end