Metadata-Version: 1.0
Name: ftw.bridge.client
Version: 1.0.11
Summary: Adds ftw.bridge support to plone.
Home-page: https://github.com/4teamwork/ftw.bridge.client
Author: 4teamwork AG
Author-email: mailto:info@4teamwork.ch
License: GPL2
Description: Introduction
        ============
        
        The ``ftw.bridge`` tools are used for communication between several Plone
        instances.
        It is also possible to communicate with other web services.
        Requests between web services are proxied through the `ftw.bridge.proxy`_.
        This makes it possible to move or reconfigure certain dependent webservices
        (clients) only by reconfiguring the proxy.
        The clients do not know where other target clients are located - they only
        communicate with the proxy directly, which forwards the requests to the
        target client.
        
        
        .. figure:: http://onegov.ch/approved.png/image
           :align: right
           :target: http://onegov.ch/community/zertifizierte-module/ftw.bridge
        
           Certified: 01/2013
        
        
        Features
        --------
        
        ``ftw.bridge.client`` integrates ``ftw.bridge`` support into Plone.
        It provides tools and utilities for communication and authentication.
        
        - **Authentication**: A PAS plugin authenticates requests and logs the user
          in on the target client without transmitting his password. Only requests
          from the configured `ftw.bridge.proxy`_ are authenticated.
        
        - **Requests**: The ``IBridgeRequest`` utility is used for making requesting
          other clients. It is also able to make remote catalog queries and
          transmitting the result brains to the sources by using fake brains.
        
        - **Brain transport**: By using a ``BrainRepresentation`` it is possible to
          get brains from a remote client. A ``BrainSerializer`` utility serializes
          and deserializes all brain metadata so that they can be used on the source
          client.
        
        - **Watcher portlet**: A recently-modified portlet can be used for generic
          listing a list of recently modified objects on the remote client but it
          is also possible to list other links. There is a browser view ``@@watch``
          which creates a recently-modified portlet on the remote client
          ``dashboard``. The watcher portlet loads its data asynchronously using
          javascript for not blocking while loading the dashboard.
        
        - **Favorites**: A browser view ``@@remote-add-favorite`` adds the context
          to the favorites on the remote client ``dashboard``.
        
        
        Installation and configuration
        ------------------------------
        
        - A installation of `ftw.bridge.proxy`_ is required.
        
        - Add ``ftw.bridge.client`` to your eggs in the buildout configuration::
        
            [instance]
            eggs +=
                ftw.bridge.client
        
        - Configure the `ftw.bridge.proxy`_ data as environment variables::
        
            [instance]
            environment-vars +=
                bridge_url http://localhost:1234/proxy
                bridge_ips 127.0.0.1, 192.168.1.10
                bridge_client_id workspace
        
        - Install the generic setup profile. This registers the portlet and installs
          a PAS plugin.
        
        
        Configuration Options
        ---------------------
        
        The configuration options are set using environment variables:
        
        - ``bridge_url``: The url to the "/proxy" view of `ftw.bridge.proxy`_.
        - ``bridge_ips``: A comma seperated list of trusted IPs of the
          `ftw.bridge.proxy`_ installation.
        - ``bridge_client_id``: The id of this client as configured in the ``.ini``
          file on ``ftw.bridge.proxy``.
        
        
        Compatibility
        -------------
        
        Runs with `Plone <http://www.plone.org/>`_ `4.1`, `4.2` or `4.3`.
        
        
        Links
        -----
        
        - Github project repository: https://github.com/4teamwork/ftw.bridge.client
        - Issue tracker: https://github.com/4teamwork/ftw.bridge.client/issues
        - Package on pypi: http://pypi.python.org/pypi/ftw.bridge.client
        - Continuous integration: https://jenkins.4teamwork.ch/search?q=ftw.bridge.client
        
        
        Copyright
        ---------
        
        This package is copyright by `4teamwork <http://www.4teamwork.ch/>`_.
        
        ``ftw.bridge.client`` is licensed under GNU General Public License, version 2.
        
        
        .. _ftw.bridge.proxy: https://github.com/4teamwork/ftw.bridge.proxy
        
        Changelog
        =========
        
        
        1.0.11 (2015-04-13)
        -------------------
        
        - Catalog requests: set response headers.
          [jone]
        
        
        1.0.10 (2015-03-24)
        -------------------
        
        - Brain serializer: fix JSON error when there persistent mutables in the catalog.
          [jone]
        
        
        1.0.9 (2014-08-20)
        ------------------
        
        - Implement uninstall profile.
          [jone]
        
        - Use ftw.profilehook instead of custom import steps (setuphandlers).
          [jone]
        
        - ftw.solr compatibility hacks
        
          - copy queries as workaround for
            https://github.com/4teamwork/ftw.solr/issues/41
        
          - remove path when it is "/" as workaround for
            https://github.com/4teamwork/ftw.solr/issues/42
        
          - do not assume that brains are acquisition wrapped,
            solr flairs are not.
        
          - capture DateTime syntax error when Solr dates are broken.
        
          [jone]
        
        - Watcher portlet: fix encoding problem when having discussion items.
          [jone]
        
        
        1.0.8 (2014-02-28)
        ------------------
        
        - Drop support for older ftw.tabbedview versions.
          Requires ftw.tabbedview>=3.2.3.
          This fixes a ZCML autoinclude load order issue.
          [jone]
        
        - Fix "sort_order" bug in catalog query view.
          The problem is that the catalog does not support unicode strings.
          [jone]
        
        - Fix watcher.js (replace jq with $).
          [mathias.leimgruber]
        
        
        1.0.7 (2013-05-24)
        ------------------
        
        - onegov.ch approved: add badge to readme.
          [jone]
        
        
        1.0.6 (2012-06-26)
        ------------------
        
        - Fix proxy support: validate last proxy IP.
          [jone]
        
        
        1.0.5 (2012-06-14)
        ------------------
        
        - View / favorite actions: handle typesUseViewActionInListings so
          that files and images are not downloaded but displayed.
          [jone]
        
        
        1.0.4 (2012-05-24)
        ------------------
        
        - Fix portlet javascript for IE 8.
          [jone]
        
        
        1.0.3 (2012-05-22)
        ------------------
        
        - Tabbedview integration: disable custom sorting since we have
          a lazy result.
          [jone]
        
        
        1.0.2 (2012-05-09)
        ------------------
        
        - Add MANIFEST.in and include all resources.
          [jone]
        
        
        1.0.1 (2012-05-09)
        ------------------
        
        - Update readme (fix restructured text markup).
          [jone]
        
        
        1.0 (2012-05-09)
        ----------------
        
        - Initial implementation.
          [jone]
        
Keywords: ftw bridge proxy client
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python
