Skip to content

Commit eea13bb

Browse files
committed
[TASK] update README
1 parent a93b9cb commit eea13bb

1 file changed

Lines changed: 50 additions & 35 deletions

File tree

README.md

Lines changed: 50 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -24,51 +24,28 @@ Relevant Packages:
2424
* `Flowpack.SearchPlugin`: search plugin for Neos
2525

2626

27-
## Version 2 vs Version 1
28-
29-
* Version 1 is the initial, productive version of the Neos ElasticSearch adapter.
30-
* Version 2 has a dependency on TYPO3.TYPO3CR.Search; which contains base functionality
31-
which is also relevant for other search implementations (like the SQLite based SimpleSearch).
32-
33-
The configuration from Version 1 to Version 2 has changed; here's what to change:
34-
35-
36-
**Settings.yaml**
27+
## Installation
3728

38-
1. Change the base namespace for configuration from `Flowpack.ElasticSearch.ContentRepositoryAdaptor`
39-
to `TYPO3.TYPO3CR.Search`. All further adjustments are made underneath this namespace:
40-
41-
2. (If it exists in your configuration:) Move `indexName` to `elasticSearch.indexName`
42-
43-
3. (If it exists in your configuration:) Move `log` to `elasticSearch.log`
44-
45-
4. search for `mapping` (inside `defaultConfigurationPerType.<typeName>`) and replace it by
46-
`elasticSearchMapping`.
47-
48-
5. Inside the `indexing` expressions (at `defaultConfigurationPerType.<typeName>`), replace
49-
`ElasticSearch.` by `Indexing.`.
50-
51-
**NodeTypes.yaml**
52-
53-
1. Replace `elasticSearch` by `search`. This replaces both `<YourNodeType>.elasticSearch`
54-
and `<YourNodeType>.properties.<propertyName>.elasticSearch`.
55-
56-
2. search for `mapping` (inside `<YourNodeType>.properties.<propertyName>.search`) and replace it by
57-
`elasticSearchMapping`.
58-
59-
3. Replace `ElasticSeach.fulltext` by `Indexing`
60-
61-
4. Search for `ElasticSearch.` (inside the `indexing` expressions) and replace them by `Indexing.`
29+
```
30+
// for development (Master; Tested on Neos 2.0)
31+
composer require 'typo3/typo3cr-search:@dev'
32+
composer require 'flowpack/elasticsearch-contentrepositoryadaptor:@dev'
6233
34+
composer require 'flowpack/searchplugin:@dev'
35+
```
6336

37+
Now, add the routes as described in the [README of Flowpack.SearchPlugin](https://github.com/skurfuerst/Flowpack.SearchPlugin)
38+
as the **first route** in Configuration/Routes.yaml.
6439

40+
Then, ensure to update `<your-elasticsearch>/config/elasticsearch.yml` as explained below; then start ElasticSearch.
6541

42+
Finally, run `./flow nodeindex:build`, and add the search plugin to your page. It should "just work".
6643

6744
## ElasticSearch Configuration file elasticsearch.yml
6845

6946
Due to the fact that the default scripting language has changed from marvel to groovy since elasticsearch 1.3.0,
7047
there is a need, depending on your running installation of ElasticSearch, to add following lines of configuration to your
71-
ElasticSearch Configuration File `elasticsearch.yml`.
48+
ElasticSearch Configuration File `<your-elasticsearch>/config/elasticsearch.yml`.
7249

7350
### Needed Configuration in configuration.yml for ElasticSearch 1.4.x
7451

@@ -407,3 +384,41 @@ In order to understand what's going on, the following commands are helpful:
407384
* use `./flow nodeindex:showMapping` to show the currently defined ElasticSearch Mapping
408385
* use the `.log()` statement inside queries to dump them to the ElasticSearch Log
409386
* the logfile `Data/Logs/ElasticSearch.log` contains loads of helpful information.
387+
388+
389+
## Version 2 vs Version 1
390+
391+
* Version 1 is the initial, productive version of the Neos ElasticSearch adapter.
392+
* Version 2 has a dependency on TYPO3.TYPO3CR.Search; which contains base functionality
393+
which is also relevant for other search implementations (like the SQLite based SimpleSearch).
394+
395+
The configuration from Version 1 to Version 2 has changed; here's what to change:
396+
397+
398+
**Settings.yaml**
399+
400+
1. Change the base namespace for configuration from `Flowpack.ElasticSearch.ContentRepositoryAdaptor`
401+
to `TYPO3.TYPO3CR.Search`. All further adjustments are made underneath this namespace:
402+
403+
2. (If it exists in your configuration:) Move `indexName` to `elasticSearch.indexName`
404+
405+
3. (If it exists in your configuration:) Move `log` to `elasticSearch.log`
406+
407+
4. search for `mapping` (inside `defaultConfigurationPerType.<typeName>`) and replace it by
408+
`elasticSearchMapping`.
409+
410+
5. Inside the `indexing` expressions (at `defaultConfigurationPerType.<typeName>`), replace
411+
`ElasticSearch.` by `Indexing.`.
412+
413+
**NodeTypes.yaml**
414+
415+
1. Replace `elasticSearch` by `search`. This replaces both `<YourNodeType>.elasticSearch`
416+
and `<YourNodeType>.properties.<propertyName>.elasticSearch`.
417+
418+
2. search for `mapping` (inside `<YourNodeType>.properties.<propertyName>.search`) and replace it by
419+
`elasticSearchMapping`.
420+
421+
3. Replace `ElasticSeach.fulltext` by `Indexing`
422+
423+
4. Search for `ElasticSearch.` (inside the `indexing` expressions) and replace them by `Indexing.`
424+

0 commit comments

Comments
 (0)