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 +1 -1
- package/README.md +16 -24
- package/dist/_chunks/App-4wYXCpIt.js +1003 -0
- package/dist/_chunks/App-C_AT8Sze.mjs +986 -0
- package/dist/_chunks/en-CByedxRT.js +38 -0
- package/dist/_chunks/en-D4dIehJl.mjs +38 -0
- package/dist/_chunks/es-B-4TrEJr.mjs +38 -0
- package/dist/_chunks/es-DA_jpbS7.js +38 -0
- package/dist/_chunks/index-CnETd4ds.mjs +242 -0
- package/dist/_chunks/index-OgM-GMGo.js +241 -0
- package/dist/admin/index.js +3 -0
- package/dist/admin/index.mjs +4 -0
- package/dist/server/index.js +2005 -0
- package/dist/server/index.mjs +2006 -0
- package/package.json +16 -16
package/LICENSE
CHANGED
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
|
-
- [
|
|
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 [
|
|
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
|
-
|
|
75
|
+
### Run Meilisearch <!-- omit in toc -->
|
|
83
76
|
|
|
84
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
|
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
|
|
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: "
|
|
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: '
|
|
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 `>=
|
|
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="
|
|
657
|
+
<img src="./assets/restaurant.gif" alt="Foodadvisor demo" width="600"/>
|
|
666
658
|
</p>
|