-
Notifications
You must be signed in to change notification settings - Fork 3
/
README.txt
112 lines (95 loc) · 4.62 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
CONTENTS OF THIS FILE
---------------------
* Introduction
* Requirements
* Installation
* Configuration
* Developers
* Maintainers
INTRODUCTION
------------
This module provides a framework for easily creating searches on any entity
known to Drupal, using any kind of search engine. For site administrators,
it is a great alternative to other search solutions, since it already
incorporates faceting support (with [1]) and the ability to use the Views module
for displaying search results, filters, etc. Also, with the Apache Solr
integration [2], a high-performance search engine is available for this module.
[1] https://www.drupal.org/project/facets
[2] https://www.drupal.org/project/search_api_solr
Developers, on the other hand, will be impressed by the large flexibility and
numerous ways of extension the module provides. Hence, the growing number of
additional contrib modules, providing additional functionality or helping users
customize some aspects of the search process.
* For a full description of the module, visit the project page:
https://www.drupal.org/project/search_api
* To submit bug reports and feature suggestions, or to track changes:
https://www.drupal.org/project/issues/search_api
REQUIREMENTS
------------
No other modules are required.
INSTALLATION
------------
Install as you would normally install a contributed Drupal module. For further
information, see:
https://www.drupal.org/docs/8/extending-drupal-8/installing-modules
CONFIGURATION
-------------
After installation, for a quick start, just install the "Database Search
Defaults" module provided with this project. This will automatically set up a
search view for node content, using a database server for indexing.
Otherwise, you need to enable at least a module providing integration with a
search backend (like database, Solr, Elasticsearch, …). Possible options are
listed at [3].
Then, go to
/admin/config/search/search-api
on your site and create a search server and search index. Afterwards, you can
create a view based on your index to enable users to search the content you
configured to be indexed. More details are available online in the handbook [4].
There, you can also find answers to frequently asked questions and common
pitfalls to avoid.
[3] https://www.drupal.org/docs/8/modules/search-api/getting-started/server-backends-and-features
[4] https://www.drupal.org/docs/8/modules/search-api/getting-started
DEVELOPERS
----------
The Search API provides a lot of ways for developers to extend or customize the
framework.
- Hooks
All available hooks are listed in search_api.api.php.
- Events
Currently, only the Search API's task system (for reliably executing necessary
system tasks) makes use of events. Every time a task is executed, an event
will be fired based on the task's type and the sub-system that scheduled the
task is responsible for reacting to it. This system is extensible and can
therefore also easily be used by contrib modules based on the Search API. For
details, see the description of the \Drupal\search_api\Task\TaskManager class,
and the other classes in src/Task for examples.
- Plugins
The Search API defines several plugin types, all listed in its
search_api.plugin_type.yml file. Here is a list of them, along with the
directory in which you can find there definition files (interface, plugin base
and plugin manager):
- Backends: src/Backend
- Datasources: src/Datasource
- Data types: src/DataType
- Displays: src/Display
- ParseModes: src/ParseMode
- Processors: src/Processor
- Trackers: src/Tracker
The display plugins are a bit of a special case there, because they aren't
really "extending" the framework, but are rather a way of telling the Search
API (and all modules integrating with it) about search pages your module
defines. They can then be used to provide, for example, faceting support for
those pages. Therefore, if your module provides any search pages, it's a good
idea to provide display plugins for them. For an example (for Views pages),
see \Drupal\search_api\Plugin\search_api\display\ViewsPage.
The handbook documentation for developers is available at [5].
[5] https://www.drupal.org/docs/8/modules/search-api/developer-documentation
To know which parts of the module can be relied upon as its public API, please
read the "Drupal 8 backwards compatibility and internal API policy" [6] and the
module's issue regarding potential module-specific changes to that policy [7].
[6] https://www.drupal.org/core/d8-bc-policy
[7] https://www.drupal.org/node/2871549
MAINTAINERS
-----------
Current maintainers:
* Thomas Seidl (drunken monkey) - https://www.drupal.org/u/drunken-monkey