geoblacklight 6.0.0.pre.alpha.7 → 6.0.0.pre.beta.2

data/lib/generators/geoblacklight/templates/settings.yml

@@ -18,15 +18,22 @@
 # # The bf boost value for overlap ratio
 # overlap_ratio_boost: "2"
 
+# # Services the item viewer should send cookies to when previewing restricted data a reader is
+# # allowed at, as URL prefixes - usually just the service's origin. List only services that
+# # require it: a credentialed request to one that doesn't expect it is refused by the browser
+# # rather than authorized, and the service has to answer with Access-Control-Allow-Credentials
+# # naming this application's origin. To authorize with a header or a proxy of your own instead,
+# # register a transform with Geoblacklight.onViewerRequest in your JavaScript entrypoint.
+# restricted_origins:
+#   - "https://geoserver-restricted.example.edu/"
+
 # # Homepage Map Geometry
 # # Leave null to default to entire world
 # # Add a stringified GeoJSON object to scope initial render (example from UMass)
 # homepage_map_geom: null
 # # homepage_map_geom: '{"type":"Polygon","coordinates":[[[-73.58,42.93],[-73.58,41.20],[-69.90,41.20],[-69.90,42.93]]]}'
 
-# # Non-search-field GeoBlacklight application permitted params.
-# # Values are left mixed-case on purpose: the uppercase symbols are WMS/OGC
-# # request parameter names (BBOX, WIDTH, etc.) and must match what clients send.
+# # Non-search-field GeoBlacklight application permitted params
 # gbl_params:
 #   - :bbox
 #   - :email
@@ -36,14 +43,6 @@
 #   - :logo
 #   - :provider
 #   - :type
-#   - :BBOX
-#   - :HEIGHT
-#   - :LAYERS
-#   - :QUERY_LAYERS
-#   - :URL
-#   - :WIDTH
-#   - :X
-#   - :Y
 
 # # Solr field mappings
 # fields:
@@ -100,9 +99,6 @@
 #   - "iso19139"
 #   - "html"
 
-# # (For WMS inspection) timeout and open_timeout parameters for Faraday
-# timeout_wms: 4
-
 # # Web services shown in tool panel
 # webservices_shown:
 #   - "wms"
@@ -142,145 +138,69 @@
 # relationships_shown:
 #   member_of_ancestors:
 #     field: pcdm_memberOf_sm
-#     icon: parent-item
 #     inverse: :member_of_descendants
 #     label: geoblacklight.relations.member_of_ancestors
 #     query_type: ancestors
 #   member_of_descendants:
 #     field: pcdm_memberOf_sm
-#     icon: child-item
 #     inverse: :member_of_ancestors
 #     label: geoblacklight.relations.member_of_descendants
 #     query_type: descendants
 #   part_of_ancestors:
 #     field: dct_isPartOf_sm
-#     icon: parent-item
 #     inverse: :part_of_descendants
 #     label: geoblacklight.relations.part_of_ancestors
 #     query_type: ancestors
 #   part_of_descendants:
 #     field: dct_isPartOf_sm
-#     icon: child-item
 #     inverse: :part_of_ancestors
 #     label: geoblacklight.relations.part_of_descendants
 #     query_type: descendants
 #   relation_ancestors:
 #     field: dct_relation_sm
-#     icon: nil
 #     inverse: :relation_descendants
 #     label: geoblacklight.relations.relation_ancestors
 #     query_type: ancestors
 #   relation_descendants:
 #     field: dct_relation_sm
-#     icon: nil
 #     inverse: :relation_ancestors
 #     label: geoblacklight.relations.relation_descendants
 #     query_type: descendants
 #   replaces_ancestors:
 #     field: dct_replaces_sm
-#     icon: nil
 #     inverse: :replaces_descendants
 #     label: geoblacklight.relations.replaces_ancestors
 #     query_type: ancestors
 #   replaces_descendants:
 #     field: dct_replaces_sm
-#     icon: nil
 #     inverse: :replaces_ancestors
 #     label: geoblacklight.relations.replaces_descendants
 #     query_type: descendants
 #   source_ancestors:
 #     field: dct_source_sm
-#     icon: parent-item
 #     inverse: :source_descendants
 #     label: geoblacklight.relations.source_ancestors
 #     query_type: ancestors
 #   source_descendants:
 #     field: dct_source_sm
-#     icon: child-item
 #     inverse: :source_ancestors
 #     label: geoblacklight.relations.source_descendants
 #     query_type: descendants
 #   version_of_ancestors:
 #     field: dct_isVersionOf_sm
-#     icon: parent-item
 #     inverse: :version_of_descendants
 #     label: geoblacklight.relations.version_of_ancestors
 #     query_type: ancestors
 #   version_of_descendants:
 #     field: dct_isVersionOf_sm
-#     icon: child-item
 #     inverse: :version_of_ancestors
 #     label: geoblacklight.relations.version_of_descendants
 #     query_type: descendants
 
-# # WMS Parameters. Keys are OGC WMS request parameter names and are sent to
-# # remote WMS servers, so they are intentionally left uppercase.
-# wms_params:
-#   SERVICE: "WMS"
-#   VERSION: "1.1.1"
-#   REQUEST: "GetFeatureInfo"
-#   STYLES: ""
-#   SRS: "EPSG:4326"
-#   EXCEPTIONS: "application/json"
-#   INFO_FORMAT: "application/json"
-
-# # Settings for leaflet
-# leaflet:
-#   # Keys below are consumed by the JS viewer via the page value
-#   # ("INDEX" / "SHOW" / "STATIC_MAP"), so they are intentionally left uppercase.
-#   boundsoverlay:
-#     INDEX:
-#       color: "#3388ff"
-#     SHOW:
-#       color: "#3388ff"
-#     STATIC_MAP:
-#       color: "#3388ff"
-#   selected_color: "#2C7FB8"
-#   sleep:
-#     sleep: true # set to false to disable
-#     margin_distance: 100 # set to zero / false if you want to disable this check
-#     sleeptime: 750
-#     waketime: 750
-#     hovertowake: false
-#     message: "Click to Wake"
-#     background: "rgba(214, 214, 214, .7)"
-#   sidebar: false # set to true to display attribute table as sidebar on map
-#   layers:
-#     detect_retina: true
-#     index:
-#       # DEFAULT / UNAVAILABLE / SELECTED are consumed by the JS viewer and the
-#       # index-map legend, so they are intentionally left uppercase.
-#       DEFAULT: &default
-#         color: "#7FCDBB"
-#         weight: 1
-#         radius: 4
-#         sr_color_name: "Green"
-#       UNAVAILABLE:
-#         <<: *default
-#         color: "#EDF8B1"
-#         sr_color_name: "Yellow"
-#       SELECTED:
-#         <<: *default
-#         color: "#2C7FB8"
-#         sr_color_name: "Blue"
+# iiif_drag_drop_link: "@manifest?manifest=@manifest"
 
-# # Toggle the help text feature that offers users context
-# help_text:
-#   viewer_protocol:
-#     - "cog"
-#     - "dynamic_map_layer"
-#     - "feature_layer"
-#     - "iiif"
-#     - "iiif_manifest"
-#     - "image_map_layer"
-#     - "index_map"
-#     - "oembed"
-#     - "pmtiles"
-#     - "tiled_map_layer"
-#     - "tilejson"
-#     - "tms"
-#     - "wms"
-#     - "wmts"
-#     - "xyz"
+# # Toggle thumbnail images in the search results (index) view
+# thumbnails_enabled: true
 
-# iiif_drag_drop_link: "@manifest?manifest=@manifest"
+# # The dct_references_s URI key to use as a document's thumbnail image URL
+# thumbnail_reference_key: "http://schema.org/thumbnailUrl"

data/lib/geoblacklight/configuration/display_note_shown_config.rb

@@ -4,6 +4,9 @@ module Geoblacklight
     class DisplayNoteShownConfig
       include ActiveModel::Model
       include ActiveModel::Attributes
+      include SettingsAttributes
+
+      self.settings_section = "DISPLAY_NOTES_SHOWN"
 
       attribute :bootstrap_alert_class, :string
       attribute :icon, :string

data/lib/geoblacklight/configuration/relationship_config.rb

@@ -4,9 +4,15 @@ module Geoblacklight
     class RelationshipConfig
       include ActiveModel::Model
       include ActiveModel::Attributes
+      include SettingsAttributes
+
+      # GeoBlacklight 5 drew a per-relationship icon next to each related record.
+      # GeoBlacklight 6 labels them with a resource-class badge instead, but every
+      # config/settings.yml generated since 4.0 still sets this.
+      self.removed_attributes = %w[icon].freeze
+      self.settings_section = "RELATIONSHIPS_SHOWN"
 
       attribute :field, :string
-      attribute :icon, :string
       attribute :inverse, :string
       attribute :label, :string
       attribute :query_type, :string

data/lib/geoblacklight/configuration/relationships_config.rb

@@ -9,84 +9,72 @@ module Geoblacklight
       DEFAULT_RELATIONSHIPS = {
         member_of_ancestors: {
           field: "pcdm_memberOf_sm",
-          icon: "parent-item",
           inverse: :member_of_descendants,
           label: "geoblacklight.relations.member_of_ancestors",
           query_type: "ancestors"
         },
         member_of_descendants: {
           field: "pcdm_memberOf_sm",
-          icon: "child-item",
           inverse: :member_of_ancestors,
           label: "geoblacklight.relations.member_of_descendants",
           query_type: "descendants"
         },
         part_of_ancestors: {
           field: "dct_isPartOf_sm",
-          icon: "parent-item",
           inverse: :part_of_descendants,
           label: "geoblacklight.relations.part_of_ancestors",
           query_type: "ancestors"
         },
         part_of_descendants: {
           field: "dct_isPartOf_sm",
-          icon: "child-item",
           inverse: :part_of_ancestors,
           label: "geoblacklight.relations.part_of_descendants",
           query_type: "descendants"
         },
         relation_ancestors: {
           field: "dct_relation_sm",
-          icon: nil,
           inverse: :relation_descendants,
           label: "geoblacklight.relations.relation_ancestors",
           query_type: "ancestors"
         },
         relation_descendants: {
           field: "dct_relation_sm",
-          icon: nil,
           inverse: :relation_ancestors,
           label: "geoblacklight.relations.relation_descendants",
           query_type: "descendants"
         },
         replaces_ancestors: {
           field: "dct_replaces_sm",
-          icon: nil,
           inverse: :replaces_descendants,
           label: "geoblacklight.relations.replaces_ancestors",
           query_type: "ancestors"
         },
         replaces_descendants: {
           field: "dct_replaces_sm",
-          icon: nil,
           inverse: :replaces_ancestors,
           label: "geoblacklight.relations.replaces_descendants",
           query_type: "descendants"
         },
         source_ancestors: {
           field: "dct_source_sm",
-          icon: "parent-item",
           inverse: :source_descendants,
           label: "geoblacklight.relations.source_ancestors",
           query_type: "ancestors"
         },
         source_descendants: {
           field: "dct_source_sm",
-          icon: "child-item",
           inverse: :source_ancestors,
           label: "geoblacklight.relations.source_descendants",
           query_type: "descendants"
         },
         version_of_ancestors: {
           field: "dct_isVersionOf_sm",
-          icon: "parent-item",
           inverse: :version_of_descendants,
           label: "geoblacklight.relations.version_of_ancestors",
           query_type: "ancestors"
         },
         version_of_descendants: {
           field: "dct_isVersionOf_sm",
-          icon: "child-item",
           inverse: :version_of_ancestors,
           label: "geoblacklight.relations.version_of_descendants",
           query_type: "descendants"
@@ -94,9 +82,9 @@ module Geoblacklight
       }.freeze
 
       def initialize(relationships = DEFAULT_RELATIONSHIPS)
-        @relationships = relationships.to_h.transform_values do |attrs|
-          attrs.is_a?(RelationshipConfig) ? attrs : RelationshipConfig.new(attrs)
-        end
+        @relationships = relationships.to_h
+          .transform_keys { |name| normalize_name(name) }
+          .transform_values { |attrs| config_for(attrs) }
       end
 
       def each(&block)
@@ -118,6 +106,18 @@ module Geoblacklight
       def method_missing(name, *args, **kwargs, &block) # rubocop:disable Style/MissingRespondToMissing
         @relationships.key?(name) ? @relationships[name] : super
       end
+
+      private
+
+      def normalize_name(name)
+        name.to_s.downcase.to_sym
+      end
+
+      def config_for(attrs)
+        return attrs if attrs.is_a?(RelationshipConfig)
+
+        RelationshipConfig.new(attrs.to_h)
+      end
     end
   end
 end

data/lib/geoblacklight/configuration/settings_attributes.rb

@@ -0,0 +1,85 @@
+module Geoblacklight
+  class Configuration
+    # Shared behavior for the small ActiveModel value objects that are built by
+    # mass-assigning a section of config/settings.yml -- RelationshipConfig and
+    # DisplayNoteShownConfig.
+    #
+    # Because config/settings.yml is only written when GeoBlacklight is first
+    # installed, an upgrading application's copy is whatever the installer wrote
+    # years ago. Assigning that hash directly onto an ActiveModel raises
+    # ActiveModel::UnknownAttributeError, naming a class the maintainer has never
+    # heard of, for a key they did not choose. This module makes three changes:
+    #
+    # * keys are matched case-insensitively, so an uppercase +FIELD:+ resolves the
+    #   same way the section name itself does (see CaseInsensitiveSettings)
+    # * attributes named in +removed_attributes+ are dropped with one deprecation
+    #   warning each, rather than raising
+    # * anything else still raises, but with a message that names the file to edit
+    #   and lists the keys that are accepted
+    #
+    # Include it *after* ActiveModel::Model and ActiveModel::Attributes:
+    #
+    #   class RelationshipConfig
+    #     include ActiveModel::Model
+    #     include ActiveModel::Attributes
+    #     include SettingsAttributes
+    #
+    #     self.removed_attributes = %w[icon].freeze
+    #     self.settings_section = "RELATIONSHIPS_SHOWN"
+    #   end
+    #
+    # The ordering matters and fails silently if you get it wrong. This module
+    # overrides ActiveModel::AttributeAssignment#attribute_writer_missing, so
+    # ActiveModel has to be lower in the ancestor chain. Rewriting this as an
+    # ActiveSupport::Concern that includes ActiveModel from its +included+ block
+    # would put ActiveModel *ahead* of this module, and its raising default would
+    # win with no error to say so.
+    module SettingsAttributes
+      def self.included(klass)
+        # Attribute names (as strings) that this version of GeoBlacklight no longer
+        # has any use for, but which an older config/settings.yml may still set.
+        klass.class_attribute :removed_attributes, instance_writer: false, default: [].freeze
+
+        # The config/settings.yml section this object is built from, used in messages.
+        klass.class_attribute :settings_section, instance_writer: false
+
+        klass.extend ClassMethods
+      end
+
+      module ClassMethods
+        # Warns at most once per removed attribute per process. The whole
+        # configuration is built once and memoized on Geoblacklight, and the fix is
+        # "edit config/settings.yml", so one line per key is all you need to see.
+        def warn_removed_attribute(name)
+          @warned_removed_attributes ||= Set.new
+          return unless @warned_removed_attributes.add?(name)
+
+          Geoblacklight::Deprecation.warn(
+            "config/settings.yml sets #{name} on a #{settings_section} entry. GeoBlacklight no " \
+            "longer reads it and the line can be deleted; support for it will be removed in a " \
+            "future version."
+          )
+        end
+
+        # Lets a spec assert on the warning more than once.
+        def reset_removed_attribute_warnings!
+          @warned_removed_attributes = nil
+        end
+      end
+
+      # ActiveModel calls this instead of raising when #assign_attributes is handed
+      # a key with no matching setter.
+      def attribute_writer_missing(name, value)
+        key = name.to_s.downcase
+
+        return public_send(:"#{key}=", value) if self.class.attribute_names.include?(key)
+        return self.class.warn_removed_attribute(key) if self.class.removed_attributes.include?(key)
+
+        raise Geoblacklight::Exceptions::InvalidSettings,
+          "config/settings.yml: a #{self.class.settings_section} entry sets #{name.to_s.inspect}, " \
+          "which GeoBlacklight does not recognize. It accepts only " \
+          "#{self.class.attribute_names.join(", ")}."
+      end
+    end
+  end
+end

data/lib/geoblacklight/configuration/settings_builder.rb

@@ -18,18 +18,17 @@ module Geoblacklight
           assign(config, :overlap_ratio_boost, settings.OVERLAP_RATIO_BOOST)
           assign(config, :display_notes_shown, build_display_notes)
           assign(config, :institution, settings.INSTITUTION)
-          assign(config, :help_text, settings.HELP_TEXT&.to_h)
           assign(config, :iiif_drag_drop_link, settings.IIIF_DRAG_DROP_LINK)
+          assign(config, :thumbnails_enabled, settings.THUMBNAILS_ENABLED)
+          assign(config, :thumbnail_reference_key, settings.THUMBNAIL_REFERENCE_KEY)
           assign(config, :homepage_map_geom, settings.HOMEPAGE_MAP_GEOM)
           assign(config, :metadata_shown, settings.METADATA_SHOWN)
           assign(config, :webservices_shown, settings.WEBSERVICES_SHOWN)
           assign(config, :relationships_shown, build_relationships)
           assign(config, :gbl_params, settings.GBL_PARAMS)
-          assign(config, :wms_params, settings.WMS_PARAMS&.to_h)
-          assign(config, :timeout_wms, settings.TIMEOUT_WMS)
+          assign(config, :restricted_origins, settings.restricted_origins)
 
           build_fields(config)
-          build_leaflet_options(config)
         end
       end
 
@@ -53,16 +52,6 @@ module Geoblacklight
         RelationshipsConfig.new(settings.RELATIONSHIPS_SHOWN.to_h) if settings.RELATIONSHIPS_SHOWN
       end
 
-      def build_leaflet_options(config)
-        return unless settings.LEAFLET
-
-        assign(config.leaflet_options, :bounds_overlay, settings.LEAFLET.BOUNDSOVERLAY&.to_h)
-        assign(config.leaflet_options, :selected_color, settings.LEAFLET.SELECTED_COLOR)
-        assign(config.leaflet_options, :sleep, settings.LEAFLET.SLEEP&.to_h&.transform_keys(&:downcase))
-        assign(config.leaflet_options, :sidebar, settings.LEAFLET.SIDEBAR)
-        assign(config.leaflet_options, :layers, settings.LEAFLET.LAYERS&.to_h&.transform_keys(&:downcase))
-      end
-
       def build_fields(config)
         return unless settings.FIELDS
 

data/lib/geoblacklight/configuration.rb

@@ -15,40 +15,37 @@ module Geoblacklight
     # Institution deployed at
     attribute :institution, :string, default: "Stanford"
 
-    # (For WMS inspection) timeout and open_timeout parameters for Faraday
-    attribute :timeout_wms, :integer, default: 4
+    # Services the item viewer should send cookies to when previewing restricted data a reader is
+    # allowed at, as URL prefixes - usually just the service's origin, e.g.
+    #   config.restricted_origins = ["https://geoserver-restricted.example.edu/"]
+    # List only services that require it: a credentialed request to one that doesn't expect it is
+    # refused by the browser rather than authorized. The service has to answer with
+    # Access-Control-Allow-Credentials and name this application's origin, since a wildcard is
+    # invalid with credentials. See the viewer_requests initializer for the other ways to authorize
+    # a request - a header, or a rewrite to a proxy of your own.
+    attr_accessor :restricted_origins # typed as Array
 
     # Display Notes to display / Non-prefixed default bootstrap class is alert-secondary
     attr_accessor :display_notes_shown # typed as Hash
 
-    # Toggle the help text feature that offers users context
-    attr_accessor :help_text # typed as Hash
-
     # Non-search-field GeoBlacklight application permitted params
     attr_accessor :gbl_params # typed as Array
 
-    # WMS Parameters
-    attr_accessor :wms_params # typed as Hash
-
     attribute :iiif_drag_drop_link, :string, default: "@manifest?manifest=@manifest"
 
-    # Configure basemap provider for GeoBlacklight maps
-    # Valid basemaps include:
-    # 'positron'
-    # 'dark_matter'
-    # 'positron_lite'
-    # 'world_antique'
-    # 'world_eco'
-    # 'flat_blue'
-    # 'midnight_commander'
-    # 'openstreetmap_hot'
-    # 'openstreetmap_standard'
+    # Toggle thumbnail images in the search results (index) view
+    attribute :thumbnails_enabled, :boolean, default: true
+
+    # The dct_references_s URI key to use as a document's thumbnail image URL
+    attribute :thumbnail_reference_key, :string, default: "http://schema.org/thumbnailUrl"
 
-    # Basemap used in light mode
-    attribute :basemap_provider, :string, default: "positron"
+    # The basemap used in light mode, as a URL to a MapLibre style document.
+    # Leave blank to use the viewer's default.
+    attribute :light_basemap_url, :string
 
-    # Basemap used in dark mode
-    attribute :dark_basemap_provider, :string, default: "dark_matter"
+    # The basemap used in dark mode, as a URL to a MapLibre style document.
+    # Leave blank to use the viewer's default.
+    attribute :dark_basemap_url, :string
 
     # Homepage Map Geometry
     # Leave null to default to entire world
@@ -68,38 +65,9 @@ module Geoblacklight
     def initialize
       super
       @relationships_shown = RelationshipsConfig.new
-      @gbl_params = [
-        :bbox, :email, :file, :format, :id, :logo, :provider, :type,
-        :BBOX, :HEIGHT, :LAYERS, :QUERY_LAYERS, :URL, :WIDTH, :X, :Y
-      ]
-      @wms_params = {
-        SERVICE: "WMS",
-        VERSION: "1.1.1",
-        REQUEST: "GetFeatureInfo",
-        STYLES: "",
-        SRS: "EPSG:4326",
-        EXCEPTIONS: "application/json",
-        INFO_FORMAT: "application/json"
-      }
-      @help_text = {
-        viewer_protocol: %w[
-          cog
-          dynamic_map_layer
-          feature_layer
-          iiif
-          iiif_manifest
-          image_map_layer
-          index_map
-          oembed
-          pmtiles
-          tiled_map_layer
-          tilejson
-          tms
-          wms
-          wmts
-          xyz
-        ]
-      }
+      @gbl_params = [:bbox, :email, :file, :format, :id, :logo, :provider, :type]
+
+      @restricted_origins = []
 
       @metadata_shown = ["mods", "fgdc", "iso19139", "html"]
       @webservices_shown = %w[
@@ -145,12 +113,5 @@ module Geoblacklight
     def fields
       @fields ||= FieldsConfig.new
     end
-
-    ##
-    # Returns Leaflet plugin settings to pass to the viewer.
-    # @return[Geoblacklight::Configuration::LeafletConfig]
-    def leaflet_options
-      @leaflet_options ||= Geoblacklight::Configuration::LeafletConfig.new
-    end
   end
 end

data/lib/geoblacklight/exceptions.rb

@@ -4,5 +4,9 @@ module Geoblacklight
   module Exceptions
     class WrongBoundingBoxFormat < StandardError
     end
+
+    # Raised when config/settings.yml sets a key GeoBlacklight does not recognize.
+    class InvalidSettings < StandardError
+    end
   end
 end

data/lib/geoblacklight/reference.rb

@@ -34,8 +34,6 @@ module Geoblacklight
       {type => endpoint}
     end
 
-    private
-
     ##
     # The URI used for this instance's creation
     # Remove any trailing slashes

data/lib/geoblacklight/references.rb

@@ -43,6 +43,17 @@ module Geoblacklight
       @refs.find { |reference| reference.type == ref_type }
     end
 
+    ##
+    # Finds a reference by its literal dct:references URI key, rather than by
+    # its registered Constants::URI type. Needed for configurable URI keys
+    # (e.g. Geoblacklight.configuration.thumbnail_reference_key) that aren't
+    # necessarily registered in Constants::URI.
+    # @param [String] uri
+    # @return [Geoblacklight::Reference, nil]
+    def find_by_uri(uri)
+      @refs.find { |reference| reference.uri == uri }
+    end
+
     ##
     # Returns all of the Esri webservices for given set of references
     def esri_webservices
@@ -57,11 +68,12 @@ module Geoblacklight
     # Parses the references field of a document
     # @return [Hash]
     def parse_references
-      if @document[reference_field].nil?
-        {}
-      else
-        JSON.parse(@document[reference_field])
-      end
+      return {} if @document[reference_field].nil?
+
+      JSON.parse(@document[reference_field])
+    rescue JSON::ParserError
+      Geoblacklight.logger.warn("Could not parse #{reference_field} on document #{@document.id}: invalid JSON")
+      {}
     end
 
     ##

data/lib/geoblacklight/relations/ancestors.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Geoblacklight
+  module Relations
+    class Ancestors < Query
+      def create_search_params
+        {fq: ["{!join from=#{@field} to=#{Geoblacklight.configuration.fields.id}}#{Geoblacklight.configuration.fields.id}:#{@search_id}"]}
+          .merge(shared_search_params)
+      end
+    end
+  end
+end

data/lib/geoblacklight/relations/descendants.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Geoblacklight
+  module Relations
+    class Descendants < Query
+      def create_search_params
+        {fq: "#{@field}:#{@search_id}"}.merge(shared_search_params)
+      end
+    end
+  end
+end