ftw.bridge.client 1.1.1

Adds ftw.bridge support to plone.

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.

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 4.1, 4.2, 4.3 or 5.1.

Links

• Github: https://github.com/4teamwork/ftw.bridge.client

• Issues: https://github.com/4teamwork/ftw.bridge.client/issues

• 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.

ftw.bridge.client is licensed under GNU General Public License, version 2.

Changelog

1.1.1 (2019-12-14)

• Use configured name from ftw.dashboard.portlets.favourites.foldername if available. [mathias.leimgruber, tinagerber]

• Provide precompiled bundle [tinagerber]

1.1.0 (2019-10-29)

• Add Plone 5.1 support. [tinagerber]

1.0.14 (2016-11-01)

• Watcher portlet feed: fix error when object was deleted. [jone]

1.0.13 (2016-01-20)

• Drop Plone < 4.3 support. [elioschmutz]

• Add types_to_ignore registry entry for the watcher feed. All defined portaltypes will not be listed in the watcher portlet. [elioschmutz]

1.0.12 (2015-04-13)

• Catalog requests: serialize python datetime objects. [jone]

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]