Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Write redirects in Python for Plone CMS

Project Description

Introduction

collective.scriptedredirect allows you to write HTTP 302 Moved Temporary and HTTP 301 Moved Permanently redirects for your Plone CMS site in Python code.

Benefits

  • The redirect logic is front-end web server independent: no need to touch variouos configuration files of Apache, Varnish or Nginx)
  • Python allows to write more complex logic for redirects easier - no regular expressions!
  • Python scripts in Plone have access to more complete state information: user logged in status, permissions, etc.

Usage

Installation

Add add-on in buildout.cfg:

eggs =
    ...
    collective.scriptedredirect

Run buildout.

Install Scripted redirects in Python in Site Setup > Add-ons.

Doing redirects through the web

Edit redirect_handler in Zope Management Interface in your site root.

In the case of accident use ?no_redirect HTTP query parameter to override the redirecter and fix your site.

Doing redirects through the web

You can also register a browser view called redirect_handler. In this case, you write the redirect code in addon Python code and not through the web.

redirect_handler view is always preferred over redirect_handler script.

Example Python code in redirector.py:

class TestingRedirectHandler(object):
    """ Redirect handler registered as a ``redirect_handler`` Zope 3 <browser:page>
    """

    def __init__(self, context, request):
        self.context = context
        self.request = request

    def __call__(self, url, host, port, path):
        """
        :return: None if no redirect needed, otherwise a string full HTTP URL to the redirect target

        :raise: zExceptions.Redirect or other custom redirect exception if needed
        """

        # Simple example: always access site over www. domain prefix
        if not url.startswith("http://www."):
            return url.replace("http://", "http://www.")

        # Don't redirect if we are already using www. prefix
        return None

Example ZCML:

<browser:page
    name="redirect_handler"
    for="Products.CMFCore.interfaces.ISiteRoot"
    layer="YOUR_ADDON_LAYER"
    class=".redirector.TestRedirectHandler"
    />

Internals

collective.scriptedredirect hooks itself to Zope’s pre-traversal hook and is triggered before the request traverses into your Plone site in Zope application server.

Author

Mikko Ohtamaa (blog, Facebook, Twitter, Google+)

Changelog

1.1.1 (2013-04-14)

  • Fixed .rst title levels for PyPi [miohtama]

1.1 (2013-04-14)

  • Added redirects via browser view support [miohtama]
  • Testing, Travis CI support [miohtama]

1.0

  • Initial development [miohtama]
Release History

Release History

This version
History Node

1.1.1

History Node

1.1

History Node

1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
collective.scriptedredirect-1.1.1.zip (36.8 kB) Copy SHA256 Checksum SHA256 Source Apr 14, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting