summaryrefslogtreecommitdiff
path: root/docs/dev/plugins.rst
blob: 1d77f8611f5ca250b83a84695cc9435bd1621763 (plain)
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
Plugins
-------

Plugins can extend or replace functionality of various components of
searx.

Example plugin
~~~~~~~~~~~~~~

.. code:: python

    name = 'Example plugin'
    description = 'This plugin extends the suggestions with the word "example"'
    default_on = False  # disabled by default

    js_dependencies = tuple()  # optional, list of static js files
    css_dependencies = tuple()  # optional, list of static css files


    # attach callback to the post search hook
    #  request: flask request object
    #  ctx: the whole local context of the post search hook
    def post_search(request, ctx):
        ctx['search'].suggestions.add('example')
        return True

Plugin entry points
~~~~~~~~~~~~~~~~~~~

Entry points (hooks) define when a plugin runs. Right now only three hooks are implemented. So feel free to implement a hook if it fits the behaviour of your plugin.

Pre search hook
```````````````

Runs BEFORE the search request. Function to implement: ``pre_search``

Post search hook
````````````````

Runs AFTER the search request. Function to implement: ``post_search``

Result hook
```````````

Runs when a new result is added to the result list. Function to implement: ``on_result``