Metadata-Version: 1.0
Name: ftw.bridge.client
Version: 1.0.7
Summary: Adds ftw.bridge support to plone.
Home-page: https://github.com/4teamwork/ftw.bridge.client
Author: Jonas Baumann
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.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
