Metadata-Version: 2.1
Name: nuclia.plone
Version: 1.0a1
Summary: Integrate Nuclia search in Plone
Home-page: https://github.com/collective/nuclia.plone
Author: Eric BREHAULT
Author-email: ebrehault@gmail.com
License: GPL version 2
Project-URL: PyPI, https://pypi.python.org/pypi/nuclia.plone
Project-URL: Source, https://github.com/collective/nuclia.plone
Project-URL: Tracker, https://github.com/collective/nuclia.plone/issues
Keywords: Python Plone CMS
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 5.2
Classifier: Framework :: Plone :: 6.0
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Requires-Python: >=3.7
Provides-Extra: test
License-File: LICENSE.GPL
License-File: LICENSE.rst

# nuclia.plone

![Nuclia logo](https://nuclia.cloud/assets/logos/logo_text.svg)

This Plone add-on allows to index Plone contents in [Nuclia](https://nuclia.com/).

## Create a Nuclia knowledge box

[Create a Nuclia account](https://docs.nuclia.dev/docs/quick-start/create)

## Install the add-on

Add `nuclia.plone` in your buildout in the `eggs` section and run buildout.

Restart Plone.

Go to Site Setup / Add-ons and install `nuclia.plone`.

Go to Nuclia settings, and enter the following:

- Knowledge box ID: you have a default knowledge box created with your Nuclia account, go to [Nuclia dashboard](https://nuclia.cloud/), the knowledge box ID is indicated on the home page in the **Nuclia APi endpoint**
- API key: see [how to get an API key](https://docs.nuclia.dev/docs/quick-start/push#get-a-service-access-token)
- Region: this the geographical region your knowledge box is attached to (at the moment only `europe-1` is supported)
- Widget ID: see [how to create a widget](https://docs.nuclia.dev/docs/quick-start/search#add-a-search-widget-to-your-website)

## Usage

Everytime a `File` or a `Link` content is created, it is indexed in Nuclia.

The Nuclia search widget is visible on the `/@@nuclia-search` view.


Contributors
============

- Eric BREHAULT, ebrehault@gmail.com


Changelog
=========


1.0a1 (unreleased)
------------------

- Initial release.
  [ebrehault]
