strapi-plugin-meilisearch 0.13.0 → 0.13.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2021-2024 Meili SAS
3
+ Copyright (c) 2021-2025 Meili SAS
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -31,9 +31,8 @@ Add your Strapi content-types into a Meilisearch instance. The plugin listens to
31
31
  ## Table of Contents <!-- omit in TOC -->
32
32
 
33
33
  - [📖 Documentation](#-documentation)
34
- - [⚡ Supercharge your Meilisearch experience](#-supercharge-your-meilisearch-experience)
35
34
  - [🔧 Installation](#-installation)
36
- - [🎬 Getting Started](#-getting-started)
35
+ - [🚀 Getting started](#-getting-started)
37
36
  - [💅 Customization](#-customization)
38
37
  - [💡 Run the Playground](#-run-the-playground)
39
38
  - [🤖 Compatibility with Meilisearch and Strapi](#-compatibility-with-meilisearch-and-strapi)
@@ -47,13 +46,9 @@ To understand Meilisearch and how it works, see the [Meilisearch's documentation
47
46
 
48
47
  To understand Strapi and how to create an app, see [Strapi's documentation](https://strapi.io/documentation/developer-docs/latest/getting-started/introduction.html).
49
48
 
50
- ## ⚡ Supercharge your Meilisearch experience
51
-
52
- Say goodbye to server deployment and manual updates with [Meilisearch Cloud](https://www.meilisearch.com/cloud?utm_campaign=oss&utm_source=github&utm_medium=strapi-plugin-meilisearch). Get started with a 14-day free trial! No credit card required.
53
-
54
49
  ## 🔧 Installation
55
50
 
56
- This package version works with the [v4 of Strapi](https://docs.strapi.io/developer-docs/latest/getting-started/introduction.html). If you are using [Strapi v3](https://docs-v3.strapi.io/developer-docs/latest/getting-started/introduction.html), please refer to [this README](https://github.com/meilisearch/strapi-plugin-meilisearch/tree/v3_main).
51
+ This package version works with the [v5 of Strapi](https://docs.strapi.io/dev-docs/intro). If you are using [Strapi v4](https://docs-v4.strapi.io/), refer to versions under [`v0.12`](https://github.com/meilisearch/strapi-plugin-meilisearch/tree/v0.12.0), if you are using [Strapi v3](https://docs-v3.strapi.io/), consider [this README](https://github.com/meilisearch/strapi-plugin-meilisearch/tree/v3_main).
57
52
 
58
53
  Inside your Strapi app, add the package:
59
54
 
@@ -75,18 +70,13 @@ To apply the plugin to Strapi, a re-build is needed:
75
70
  strapi build
76
71
  ```
77
72
 
78
- You will need both a running Strapi app and a running Meilisearch instance. For [specific version compatibility see this section](#-compatibility-with-meilisearch-and-strapi).
79
-
80
- ### 🏃‍♀️ Run Meilisearch <!-- omit in toc -->
73
+ You will need both a running Strapi app and a running Meilisearch instance. For [specific version compatibility, see this section](#-compatibility-with-meilisearch-and-strapi).
81
74
 
82
- There are many easy ways to [download and run a Meilisearch instance](https://www.meilisearch.com/docs/reference/features/installation.html#download-and-launch).
75
+ ### Run Meilisearch <!-- omit in toc -->
83
76
 
84
- For example, if you use Docker:
77
+ ⚡️ **Launch, scale, and streamline in minutes with Meilisearch Cloud**—no maintenance, no commitment, cancel anytime. [Try it free now](https://cloud.meilisearch.com/login?utm_campaign=oss&utm_source=github&utm_medium=strapi-plugin-meilisearch).
85
78
 
86
- ```bash
87
- docker pull getmeili/meilisearch:latest # Fetch the latest version of Meilisearch image from Docker Hub
88
- docker run -it --rm -p 7700:7700 getmeili/meilisearch:latest meilisearch --master-key=masterKey
89
- ```
79
+ 🪨 Prefer to self-host? [Download and deploy](https://www.meilisearch.com/docs/learn/self_hosted/getting_started_with_self_hosted_meilisearch?utm_campaign=oss&utm_source=github&utm_medium=strapi-plugin-meilisearch) our fast, open-source search engine on your own infrastructure.
90
80
 
91
81
  ### 🏃‍♂️ Run Strapi <!-- omit in toc -->
92
82
 
@@ -112,11 +102,11 @@ yarn develop
112
102
 
113
103
  ### Run Both with Docker
114
104
 
115
- To run Meilisearch and Strapi on the same server you can use Docker. A Docker configuration example can be found in the directory [`resources/docker`](resources/docker/) of this repository.
105
+ You can use Docker to run Meilisearch and Strapi on the same server. A Docker configuration example can be found in the directory [`resources/docker`](resources/docker/) of this repository.
116
106
 
117
107
  To run the Docker script add both files `Dockerfile` and `docker-compose.yaml` at the root of your Strapi project and run it with the following command: `docker-compose up`.
118
108
 
119
- ## 🎬 Getting Started
109
+ ## 🚀 Getting started
120
110
 
121
111
  Now that you have installed the plugin, a running Meilisearch instance and, a running Strapi app, let's go to the plugin page on your admin dashboard.
122
112
 
@@ -318,7 +308,7 @@ For example, given two content-types:
318
308
 
319
309
  The index `product` has both the entries of shoes and shirts. If the index `product` has `350` documents in Meilisearch, it is not possible to know how many of them are from `shoes` or `shirts`.
320
310
 
321
- When removing `shoes` or `shirts` from Meilisearch, both are removed as it would require to much processing to only remove one. You can still re-index only one after that.
311
+ When removing `shoes` or `shirts` from Meilisearch, both are removed as it would require too much processing to only remove one. You can still re-index only one after that.
322
312
 
323
313
  <p align="center">Example with two single types:</p>
324
314
  <p align="center">
@@ -437,9 +427,9 @@ The options you can set are described in the [`findMany` documentation](https://
437
427
 
438
428
  **Common use cases**
439
429
 
440
- If you are using the [🌍 Internationalization (i18n)](https://docs.strapi.io/developer-docs/latest/plugins/i18n.html) plugin, an additional field `locale` should also be added in `entriesQuery`.
430
+ If you are localizing your Strapi content, an additional field `locale` should also be added in `entriesQuery`.
441
431
 
442
- ⚠️ Warning: if you do not specify `locale: "all"` in `entriesQuery`, you may not index all available entries, potentially leading to missing products in your search results. To ensure all entries in every language are indexed in Meilisearch, include the `locale` field with the value 'all'.
432
+ ⚠️ Warning: if you do not specify `locale: "*"` in `entriesQuery`, you may not index all available entries, potentially leading to missing products in your search results. To ensure all entries in every language are indexed in Meilisearch, include the `locale` field with the value 'all'.
443
433
 
444
434
  ```js
445
435
  module.exports = {
@@ -447,7 +437,7 @@ module.exports = {
447
437
  config: {
448
438
  restaurant: {
449
439
  entriesQuery: {
450
- locale: 'all',
440
+ locale: '*',
451
441
  },
452
442
  },
453
443
  },
@@ -455,6 +445,8 @@ module.exports = {
455
445
  }
456
446
  ```
457
447
 
448
+ If you are using Strapi 4 with the [🌍 Internationalization (i18n)](https://docs.strapi.io/developer-docs/latest/plugins/i18n.html) plugin, the `locale` field should be set to `all`.
449
+
458
450
  If you want to add a collection with a relation to the collection being included, you have to configure the `populate` parameter in `entriesQuery`. See [the docs](https://docs.strapi.io/dev-docs/api/entity-service/populate) on how it works, and [an example](./resources/entries-query/populate.js) in our resources.
459
451
 
460
452
  **Example**
@@ -630,7 +622,7 @@ This command will install the required dependencies and launch the app in develo
630
622
 
631
623
  Complete installation requirements are the same as for Strapi itself and can be found in the documentation under [installation Requirements](https://strapi.io/documentation/v3.x/installation/cli.html#step-1-make-sure-requirements-are-met).
632
624
 
633
- - Strapi `>=v4.x.x`
625
+ - Strapi `>=v5.x.x`
634
626
 
635
627
  If you are using [Strapi v3](https://github.com/strapi/strapi/tree/v3.6.9), please refer to [this README](https://github.com/meilisearch/strapi-plugin-meilisearch/tree/v0.5.1).
636
628
 
@@ -662,5 +654,5 @@ If you want to know more about the development workflow or want to contribute, p
662
654
  Using the [foodadvisor](https://github.com/strapi/foodadvisor) restaurant demo Strapi provided. We added a searchbar to it using [instant-meilisearch](https://github.com/meilisearch/meilisearch-js-plugins/tree/main/packages/instant-meilisearch).
663
655
 
664
656
  <p align="center">
665
- <img src="./assets/restaurant.gif" alt="Fooradvisor demo" width="600"/>
657
+ <img src="./assets/restaurant.gif" alt="Foodadvisor demo" width="600"/>
666
658
  </p>