[NX-7] Filter taxons by taxonomies' permalinks

api/spec/requests/spree/api/v2/storefront/taxons_spec.rb

@@ -65,6 +65,18 @@
       end
     end
 
+    context 'by parent permalink' do
+      before { get "/api/v2/storefront/taxons?filter[parent_permalink]=#{taxonomy.root.permalink}" }
+
+      it_behaves_like 'returns 200 HTTP status'
+
+      it 'returns children taxons by parent' do
+        expect(json_response['data'].size).to eq(2)
+        expect(json_response['data'][0]).to have_relationship(:parent).with_data('id' => taxonomy.root.id.to_s, 'type' => 'taxon')
+        expect(json_response['data'][1]).to have_relationship(:parent).with_data('id' => taxonomy.root.id.to_s, 'type' => 'taxon')
+      end
+    end
+
     context 'by taxonomy' do
       before { get "/api/v2/storefront/taxons?taxonomy_id=#{taxonomy.id}" }
 

core/app/finders/spree/taxons/find.rb

@@ -3,16 +3,18 @@ module Taxons
     class Find
       def initialize(scope:, params:)
         @scope = scope
-        @ids      = String(params.dig(:filter, :ids)).split(',')
-        @parent   = params.dig(:filter, :parent_id)
-        @taxonomy = params.dig(:filter, :taxonomy_id)
-        @name     = params.dig(:filter, :name)
-        @roots    = params.dig(:filter, :roots)
+        @ids              = String(params.dig(:filter, :ids)).split(',')
+        @parent           = params.dig(:filter, :parent_id)
+        @parent_permalink = params.dig(:filter, :parent_permalink)
+        @taxonomy         = params.dig(:filter, :taxonomy_id)
+        @name             = params.dig(:filter, :name)
+        @roots            = params.dig(:filter, :roots)
       end
 
       def execute
         taxons = by_ids(scope)
         taxons = by_parent(taxons)
+        taxons = by_parent_permalink(taxons)
         taxons = by_taxonomy(taxons)
         taxons = by_roots(taxons)
         taxons = by_name(taxons)
@@ -22,7 +24,7 @@ def execute
 
       private
 
-      attr_reader :ids, :parent, :taxonomy, :roots, :name, :scope
+      attr_reader :ids, :parent, :parent_permalink, :taxonomy, :roots, :name, :scope
 
       def ids?
         ids.present?
@@ -32,6 +34,10 @@ def parent?
         parent.present?
       end
 
+      def parent_permalink?
+        parent_permalink.present?
+      end
+
       def taxonomy?
         taxonomy.present?
       end
@@ -60,6 +66,12 @@ def by_parent(taxons)
         taxons.where(parent_id: parent)
       end
 
+      def by_parent_permalink(taxons)
+        return taxons unless parent_permalink?
+
+        taxons.where(parent: { permalink: parent_permalink })
+      end
+
       def by_taxonomy(taxons)
         return taxons unless taxonomy?
 

core/lib/spree/permitted_attributes.rb

@@ -119,7 +119,7 @@ module PermittedAttributes
     @@taxonomy_attributes = [:name]
 
     @@taxon_attributes = [
-      :name, :parent_id, :position, :icon, :description, :permalink, :hide_from_nav,
+      :name, :parent_id, :parent_permalink, :position, :icon, :description, :permalink, :hide_from_nav,
       :taxonomy_id, :meta_description, :meta_keywords, :meta_title, :child_index
     ]