Metadata-Version: 1.1
Name: collective.elasticindex
Version: 1.2.4
Summary: Index Plone content in Elastic Search
Home-page: https://github.com/infrae/collective.elasticindex
Author: Infrae
Author-email: info@infrae.com
License: BSD
Description: =======================
        collective.elasticindex
        =======================
        
        This extension index `Plone`_ content into `ElasticSearch`_. This doesn't
        replace the Plone catalog with ElasticSearch, nor interact with the
        Plone catalog at all, it merely index content inside ElasticSearch when
        it is modified or published.
        
        In addition to this, it provides a simple search page called
        ``search.html`` that queries ElasticSearch using Javascript (so Plone
        is not involved in searching) and propose the same features than the
        default Plone search page. A search portlet let you redirect people to
        this new search page as well.
        
        This extension have been built for Plone 4, but might work with Plone
        3.
        
        Usage
        -----
        
        After adding this extension to your buildout (including the zcml), you
        can install the extension in Plone. A configuration screen is
        available inside site setup. It will let you configure the URLs of the
        ElasticSearch servers to use in order to index, and search. To proceed:
        
        - Fill in the ElasticSearch settings,
        
        - Click on *Save*,
        
        - Click on *Create Index* in order to create the ElasticSearch index,
        
        - Click on *Import site content* in order to index already existing
          content in ElasticSearch.
        
        You can use the same ElasticSearch server (and probably index) for
        multiple Plone sites, creating a federated search that way.
        
        Security disclaimer
        -------------------
        
        By default is no authentication or access validation while searching
        or indexing content. The original purpose of this search is to be
        public.
        
        If you have private content that you don't want to be searchable or
        viewable by unauthorized people, please be sure to check the checkbox
        *index only published content* in the configuration screen.
        
        In addition to this ElasticSearch is not secured by default, meaning
        there is no authentication to provide in order to index or look-up
        content. Be sure to hide it behind a firewall and use a proxy or
        Apache in order to restrict the requests made to it: you only need to
        allow access via POST to the sub-URL ``_search`` after the index name
        configured in the configuration screen. For instance, if the index
        name is ``plone``, you shall allow only requests to
        ``http://your-public-es-url/plone/_search``. After you configured your
        proxy, be sure to configure its public URL, like
        ``http://your-public-es-url`` in the configuration screen so the
        search page knows how to contact it.
        
        However if you want to allow users to search though restricted and not
        yet published content, you can check *index security* and uncheck
        *index only published content* in the configuration screen. After
        reindexing your content, if you check *proxy search requests though
        Plone and apply security filter*, search will work on restricted and
        not yet published content, but will be slower as the queries will be
        proxied though Plone.
        
        .. _Plone: http://plone.org/
        .. _ElasticSearch: http://www.elasticsearch.org/
        
        Changes
        =======
        
        1.2.4 (2015-04-21)
        ------------------
        
        - More logging while indexing.
        
        
        1.2.3 (2015-02-03)
        ------------------
        
        - Fix indexation after checkin from plone.app.iterate.
        
        
        1.2.2 (2015-01-29)
        ------------------
        
        - Fix savepoint.
        
        1.2.1 (25/03/2014)
        ------------------
        
        - Update javascript so it longer strips double quotes away.
        
        1.2 (28/01/2014)
        ----------------
        
        - Add an option to rewrite the domain name in the URL of indexed
          documents.
        
        1.1.2 (21/01/2014)
        ------------------
        
        - Fix a stupid bug when a document that is unindex get reindex inside
          the same transaction.
        
        1.1.1 (26/11/2013)
        ------------------
        
        - Disable completely the extension when ``portal_factory`` is in the
          path, i.e. we have an add forms. ``portal_factory`` uses lot of
          hacks regarding the ZODB that are not very clean.
        
        1.1 (05/11/2013)
        ----------------
        
        - Index Plone authorization in the index and provide an option to
          redirect the queries through Plone in order to restrict the search
          results to what the current user is allowed to see. Effectively
          Plone will modify the search query to include a restriction on the
          authorization.
        
        - Improve the public search page.
        
        - Improve the public search javascript to ignore special Lucene
          characters in the query and colons except if they are before an
          authorized term.
        
        1.0 (13/09/2013)
        ----------------
        
        - Initial release.
        
        
Keywords: plone index elasticsearch search
Platform: UNKNOWN
Classifier: Programming Language :: Python
