알고리아 Managing Results(3-33)

https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/how-to/declaring-attributes-for-faceting/

How to declare attributes for faceting | Algolia

 

How to Declare Attributes for Faceting(faceting용 attribute 선언하기)

Algolia lets you create categories based on specific attributes so you can filter search results on them. For example, if you have an index of books, you may want to categorize them by author and genre. This way, your end users can filter on their favorite author or discover a new genre.

To do so, you first need to declare attributes genre and author as attributesForFaceting.

알고리아는 니가 특정한 attribute에 기반한 카테고리를 만들도록 한다. 그래서 너는 그들의 검색결과를 필터링할 수 있다. 예를 들어서, 만약 니가 책의 인덱스를 가지고 있으면, 너는 그것들을 저자와 장르로 카테고리화하고 싶을 수 있다. 이런 방식으로 최종 사용자는 자신이 좋아하는 작성자를 필터링하거나 새로운 장르를 검색할 수 있습니다.

 

Using the API#

To make genre and author attributes available for both faceting and filtering, you need to apply the following setting:

패싱 및 필터링에 장르 및 작성자 속성을 모두 사용하려면 다음 설정을 적용해야 합니다.

 

index.setSettings({
  attributesForFaceting: [
    'category',
    'author'
  ]
}).then(() => {
  // done
});

 

 

 

In some cases, you may have many facet values. In our example, if you have many books in your index, you may also have plenty of different authors. The engine can’t return more than 1000 values per facet, so if you have more, you may want to let your end users search into them. You can achieve this by leveraging the searchable modifier.경우에 따라 많은 facet 값을 가질 수 있습니다. 이 예제에서 인덱스에 책이 많으면 다양한 저자가 많을 수 있습니다. 엔진은 패싯당 1000개 이상의 값을 반환할 수 없으므로, 값이 더 많을 경우 최종 사용자가 검색하도록 할 수 있습니다. 검색 가능한 한정자를 사용하여 이 작업을 수행할 수 있습니다.

 

index.setSettings({
  attributesForFaceting: [
    'category',
    'searchable(author)'
  ]
}).then(() => {
  // done
});

 

 

If you only need the filtering feature, you can take advantage of filterOnly which reduces the index size and improves the speed of the search. Imagine you want to automatically filter what genre the end users can search into based on what section of your website they’re on, without displaying genres as clickable filters. In this case, you only need filtering capabilities.

필터링 기능만 필요한 경우 인덱스 크기를 줄이고 검색 속도를 향상시키는 filterOnly를 활용할 수 있습니다. 최종 사용자가 웹 사이트의 어느 섹션에 있는지 기준으로 검색할 수 있는 장르를 클릭 가능한 필터로 표시하지 않고 자동으로 필터링하려고 합니다. 이 경우 필터링 기능만 필요합니다.

 

index.setSettings({
  attributesForFaceting: [
    'filterOnly(category)',
    'author'
  ]
}).then(() => {
  // done
});

 

Make sure not to include colons (:) in attribute names that you want to use for faceting, because the filters syntax relies on that character as a delimiter.

필터 구문은 구분자로 해당 문자를 사용하므로 패싱에 사용할 attribute 이름에 콜론(:)을 포함하지 마십시오.

Using the dashboard

• Select the Search product icon on your dashboard and then select your index.
• Click the Configuration tab.
• Under the Filtering and Faceting category, click on Facets.
• In the Attributes for faceting section, click on Add an Attribute and select the attribute you wish to declare for faceting.
• For each attribute, click the dropdown on the right and set them as “searchable”, “filter only” or “not searchable”.
• Don’t forget to save your changes.