From 105f180806f4b2112b2952b04b79988b32bae65b Mon Sep 17 00:00:00 2001 From: Rosie Le Faive Date: Wed, 1 May 2024 13:03:02 -0300 Subject: [PATCH] Update README.md --- README.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 4767c39..f5ed3d2 100644 --- a/README.md +++ b/README.md @@ -298,19 +298,22 @@ and Search blocks provided by this module. See "Requirements" for a discussion of the use of `field_member_of`. -In this section we set up fields in our Solr index (using Search API) -that index a node's parent ("Member of") and all its parents' parents, -recursively ("Descendant of"), the latter achieved by using Search API's -"Index hierarchy" processor. +In this section we set up fields in our Solr index (using Search API). +The first Search API field ("Member of") indexes a node's parent(s) based +on the Drupal field `field_member_of`, and the second ("Descendant of") +indexes a node's parents and its parents' parents. This second field's +recursive behaviour is achieved by using Search API's "Index hierarchy" +processor. First ensure that your hierarchy field (assumed for convenience to be `field_member_of`) -is indexed at `admin/config/search/search-api/index/[your default index]/fields`. -We will assume that the Search API field's name is "Member of". The field type +is indexed at `admin/config/search/search-api/index/[your default index]/fields`. If +not, add the field using the "Add field" button. When you find "Member of (field_member_of)", +click the "Add" button - do not delve into the child properties under "(+)". +We will assume that the Search API field's name is also "Member of". The field type should be "Integer". -Next, create a second Search API field, based on the same Drupal field. We'll -call this one "Descendant of". It is also an Integer. - +Next, create a second Search API field, exactly the same as the first field +except for its name, so we can tell them apart. We'll call this one "Descendant of". ![Search fields Member of and Descendant of set up](./docs/field_descendant_of.png)