Skip to content

Commit 19d56b1

Browse files
🎉 Release v1.0.0
1 parent 9790eb7 commit 19d56b1

File tree

3 files changed

+21
-8
lines changed

3 files changed

+21
-8
lines changed

CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Changelog
2+
3+
# v1.0.0
4+
5+
* Initial release

README.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
# Laravel Scout Settings
22

3-
Import/Export Algolia settings into your Laravel Scout project.
3+
**Import/Export Algolia settings, synonyms and query rules into your Laravel Scout project.**
44

55
The easiest way to manage your settings is usually to go to your Algolia dashboard because it has a nice UI and you can test the relevancy directly there.
66

77
Once you fine tuned your configuration, you may want to add it to your project.
88

99
This package adds two Laravel commands to your project:
1010

11-
- one to save your settings into a JSON file
12-
- one to push them back to Algolia
11+
- one to save your settings, synonyms and query rules into JSON files
12+
- one to push everything back to Algolia
1313

1414
This has 3 majors advantages:
1515

1616
1. You can version your configuration with your VCS
17-
2. You can set up a new environement or restore backups easily
17+
2. You can set up a new environment or restore backups easily
1818
3. It lets you customize your settings in JSON format before pushing them
1919

2020
## Install
@@ -44,19 +44,23 @@ You will now get two new commands available in `artisan`. They both take a model
4444

4545
The following example assume you have an `App\Contact` class, which uses the `Searchable` trait.
4646

47-
Note: Scout allows you to customize the index name with the [`searchableAs()`](https://laravel.com/docs/5.4/scout#configuring-model-indexes) method. This package will follow this naming convention.
47+
Note: Scout allows you to customize the index name with the [`searchableAs()`](https://laravel.com/docs/scout#configuring-model-indexes) method. This package will follow this naming convention.
4848

4949
### Backing up settings (Project ⬅️ Algolia)
5050

51-
The following command will export all the settings and synonyms from the `App\Contact`'s index into the `resources/algolia-settings/prefix_index_name.json` and `resources/algolia-settings/prefix_index_name-synonyms.json` files.
51+
The following command will export all the settings and synonyms from the `App\Contact`'s index into the following files:
52+
53+
* **Settings**: `resources/algolia-settings/prefix_index_name.json`
54+
* **Synonyms**: `resources/algolia-settings/prefix_index_name-synonyms.json`
55+
* **Query Rules**: `resources/algolia-settings/prefix_index_name-rules`
5256

5357
```
5458
php artisan algolia:settings:backup "App\Contact"
5559
```
5660

5761
### Pushing settings (Project ➡️ Algolia)
5862

59-
The following command will read all the settings and synonyms from the `resources/algolia-settings/prefix_index_name.json` and `resources/algolia-settings/prefix_index_name-synonyms.json` files. and import them into Algolia's index.
63+
The following command will read all the settings, synonyms and query rules from the files in `resources/algolia-settings/` and import them into Algolia's index.
6064

6165
```
6266
php artisan algolia:settings:push "App\Contact"
@@ -66,3 +70,7 @@ php artisan algolia:settings:push "App\Contact"
6670
## Need help?
6771

6872
Feel free to open a thread on our [Community forum](https://discourse.algolia.com/)
73+
74+
### Contribute
75+
76+
Contributions are welcome!

src/Console/AlgoliaCommand.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ public function __construct()
2626

2727
protected function getIndex($indexName)
2828
{
29-
AlgoliaUserAgent::addSuffixUserAgentSegment('; Laravel Scout settings package', '0.x');
29+
AlgoliaUserAgent::addSuffixUserAgentSegment('; Laravel Scout settings package', '1.0.0');
3030

3131
return (new Client(
3232
config('scout.algolia.id'),

0 commit comments

Comments
 (0)