Metadata-Version: 1.0
Name: django-p3p
Version: 0.1.1b
Summary: Django P3P makes it easier to set P3P HTTP headers to prevent session loss.
Home-page: http://github.com/jjanssen/django-p3p
Author: Janneke Janssen
Author-email: j.janssen@lukkien.com
License: GPL
Description: Django P3P
        ==========
        
        About Django P3P
        ----------------
        If your webpage uses sessions you willl lose your session in Internet Explorer when your page gets embedded into in iFrame. This problem can be solved by setting application specific `P3P headers <http://en.wikipedia.org/wiki/P3P>`_.
        
        Django P3P is an application which makes it easier to set those specific headers for your Django application. You can use an editor like IBM's P3P Policy Editor to configure your website policy to its needs.
        
        Installation
        ------------
        
        Install django-p3p with pip::
        
            $ pip install -e http://github.com/jjanssen/django-p3p#egg=django-p3p
        
        or::
        
            $ pip install django-p3p
        
        
        Configuration
        -------------
        
        Configuring django-p3p
        ^^^^^^^^^^^^^^^^^^^^^^
        
        Add the following to your settings file:
        
            * Add ``p3p`` to ``INSTALLED_APPS``
            * Add ``p3p.middleware.P3PMiddleware`` to ``MIDDLEWARE_CLASSES``
        
        
        URL Configuration
        ^^^^^^^^^^^^^^^^^
        
        You need to include the `p3p.urls` urlpatterns in your root url configuration, for e.g.::
        
            (r'^w3c/', include('p3p.urls', namespace='p3p')),
            ...
            (r'^admin/', include(admin.site.urls)),
        
        
        .. warning::
        
            Please keep in mind you should follow the W3C prefix in pattern. So the browser can resolve the ``/w3c/p3p.xml``. In the future I'll probably set a HTTP header for this, but right now I'm too lazy to do this.
        
        
        Overriding templates
        ^^^^^^^^^^^^^^^^^^^^
        
        You need to override at least 2 templates to configure your project specific HTTP headers and policy:
        
            * `templates/p3p/headers.txt`
        
        Contains the actual HTTP headers which are sent to the browser. For e.g.: ``CP="NOI CURa ADMa DEVa TAIa CONa OUR DELa BUS IND PHY ONL UNI PUR COM NAV DEM STA"``
        
            * `templates/p3p/policy.p3p`
        
        Contains the policy as required for the application. You can generate one by using the IBM P3P Policy Editor.
        
        
        .. note::
        
            I left the initial templates mostly blank to prevent default usage. Mainly because every application has its own specific policies and it requires you to **THINK** about what policy fits your website.
        
Keywords: session patch middleware django
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Internet :: WWW/HTTP :: Session
