forked from Archives/searxng
e9fff4fde6
Normalize reST sources with best practice and KISS in mind. to name a few points: - simplify reST tables - make use of ``literal`` markup for monospace rendering - fix code-blocks for better rendering in HTML - normalize section header markup - limit all lines to a maximum of 79 characters - add option -H to the sudo command used in code blocks - drop useless indentation of lists - ... [1] https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
49 lines
1.2 KiB
ReStructuredText
49 lines
1.2 KiB
ReStructuredText
=======
|
|
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``
|