Algolia


Query your Algolia data using Twig

About

Algolia for Craft CMS allows you to easily pull search results from Algolia into your Twig templates or through REST API endpoints.

Template Usage

Browse an index

Additional search parameters can be provided in the params object.

{% for result in craft.algolia.browse({
    index: "indexName",
    query: "optional query",
    params: {
      distinct: true,
      getRankingInfo: true
    }
  })
%}

{% endfor %}

Search an index

Additional search parameters can be provided in the params object.

{% set search = craft.algolia.search({
    index: "indexName",
    query: "optional query",
    params: {
      hitsPerPage: 5,
      page: 7
    }
  })
%}

{% for hit in search.hits %}

{% endfor %}

Perform a multiple query search

Additional search parameters can be provided in each queries object.

{% set search = craft.algolia.multipleQueries([
    {
      indexName: "indexName1",
      query: "optional query"
    },
    {
      indexName: "indexName2",
      query: "optional query"
    }
  ])
%}

{% for group in search.results %}
  {% for hit in group.hits %}

  {% endfor %}
{% endfor %}

Using JSON REST API controllers

In additional to Twig variables you can make a POST request to one of the following controller endpoints. The same index, query and optional attributes are available when you make your POST request.

NOTE: The following examples use Axios for making API requests

Browse an index

Additional search parameters can be provided in the params object.

axios.post("/actions/algolia/default/browse", {
  index: "indexName",
  query: "optional query",
  params: {
    distinct: true,
    getRankingInfo: true
  }
}, {
  headers: {
    "X-CSRF-Token": YOUR_CRAFT_CSRF_TOKEN
  }
});

Search an index

Additional search parameters can be provided in the params object.

axios.post("/actions/algolia/default/search", {
  index: "indexName",
  query: "optional query",
  params: {
    hitsPerPage: 5,
    page: 7
  }
}, {
  headers: {
    "X-CSRF-Token": YOUR_CRAFT_CSRF_TOKEN
  }
});

Perform a multiple query search

Additional search parameters can be provided in each queries object.

axios.post("/actions/algolia/default/multiple-queries", {
  queries: [
    {
      indexName: "indexName1",
      query: "optional query"
    },
    {
      indexName: "indexName2",
      query: "optional query"
    }
  ]
}, {
  headers: {
    "X-CSRF-Token": YOUR_CRAFT_CSRF_TOKEN
  }
});

Requirements

This plugin requires Craft CMS 3.0.0-beta.23 or later.

Attribution

This plugin is powered by the Algolia PHP API client. The client and icon/logo belong to Algolia.


Free

Package Name

To install this plugin, search for its package name on the Plugin Store and click “Install”.


Information

  • Version 2.0.0
  • Last Update 3/15/2019
  • Active Installs 53
  • Compatibility Craft 3
  • License MIT
  • Categories Templating, Integrations

Report an issue