joppuyo/searchwp-finnish-base-forms

SearchWP plugin to add Finnish base forms in search index

v3.2.0 2019-11-03 20:11 UTC

Requires

• danielstjules/stringy: ^3.1
• guzzlehttp/guzzle: ^6.3
• symfony/process: >=3.3
• yahnis-elsts/plugin-update-checker: ^4.4

GPL-3.0-or-later

README

SearchWP plugin to add Finnish base forms into search index using Voikko.

What does it do?

This plugin allows you to add base forms of Finnish words in SearchWP search index. For example for word koirillekin, tokens koirillekin and koira are saved in the index during indexing. Learn mode by reading this article (in Finnish).

This plugin is compatible with Polylang. If you have Polylang installed, it will only process content written in Finnish.

Options

API type

You can use bundled voikkospell binary (on a linux x64 system) to lemmatize the indexed terms.

There is also an option to use a system-wide voikkospell command line application if you have Voikko installed on your system.

It's also possible to set up an external Node.js API to access Voikko over HTTP. Using the binary or CLI application is much faster because it doesn't have the overhead of performing a HTTP request.

Special thanks to siiptuo for contributing voikkospell support for this plugin!

Add base forms to search query

Enable this option to add base forms to search queries entered by users.

Split compound words

Enable this option to split compound words during indexing (and for user queries if the above option is enabled). For example, the word kerrostaloille is transformed into tokens kerrostaloille, kerrostalo, kerros and talo in the search index.

Search result excerpts

It's possible to generate Google-style search result excerpts where the keywords are highlighted using searchwp_finnish_base_forms_get_excerpt($post, $options) function. It takes the following parameters:

• Post you want to create excerpt for

• Array of options

  • length: length of the excerpt, 300 characters by default
  • query: current search query, by default it's get_search_query()
  • fallback Anonymous method that generates excerpt to display if the search query is not found in the post content, by default this will use 'excerpt' field and fall back to 'content' field. The text will be truncated according to length

  This function will automatically check all fields for the search terms that have been configured in SearchWP settings.

Requirements

• SearchWP 2.5 or later
• PHP 5.5.9
• One of the following:
  • A x64 Linux or Mac server
  • A server with voikkospell command line application installed
  • A server with Node.js and about 1GB of spare RAM

Installation

1. Download latest version from the releases tab
2. Unzip the plugin into your wp-content/plugins directory
3. Activate SearchWP Finnish Base Forms from your Plugins page

Bundled voikkospell binary

1. Go on the Plugins page, find the plugin, click Settings. For API Type select Voikko binary (bundled).

Voikkospell command line

1. Install voikkospell on your server. On Ubuntu/Debian this can be done with apt install libvoikko-dev voikko-fi
2. Go on the Plugins page, find the plugin, click Settings. For API Type select Voikko command line.

Node.js web API

1. Install and start Voikko Node.js web API.
2. Go on the Plugins page, find the plugin, click Settings and enter the Node API URL there

After installation, remember to re-index the site from SearchWP settings page.