Metadata-Version: 1.1
Name: the-real-django-wordpress
Version: 0.5
Summary: Django models and views for a WordPress database.
Home-page: http://github.com/sunlightlabs/django-wordpress/
Author: Jeremy Carbaugh
Author-email: jcarbaugh@sunlightfoundation.com
License: BSD License
Description: ================
        django-wordpress
        ================
        
        Models and views for reading a WordPress database. Compatible with WordPress version 3.1.
        
        django-wordpress is a project of `Sunlight Foundation <http://sunlightfoundation.com>`_ (c) 2012.
        
        
        --------
        Features
        --------
        
        Read-only models to protect your content
        ========================================
        
        This package is **designed to be read-only**. Writing is enabled by adding ``WP_READ_ONLY = False`` to settings.py. None of the WordPress specific logic is included while writing to the database so there is a good chance you will break your WordPress install if you enable writing.
        
        WordPress table prefix
        ======================
        
        The default table prefix is *wp*. To change the table prefix, add ``WP_TABLE_PREFIX = 'yourprefix'`` to settings.py.
        
        Multiple database support
        =========================
        
        Added the ability to specify which database the WordPress content is coming from. Set it using the *WP_DATABASE* setting. Defaults to "default".
        
        
        Database routers need be set to::
        
            DATABASE_ROUTERS = ['wordpress.router.WordpressRouter']
        
        Default templates
        =================
        
        Default templates are provided only for development purposes so you can see content on your screen! Please override these with customized templates for your application.
        
        Export Management Commands
        ==========================
        
        * *wpexport* Dump published posts in WXR format.
        * *wpexportauthors* Export authors as CSV.
        
        -----------------------------
        Working With WordPress Models
        -----------------------------
        
        Ten most recent published posts::
        
            Posts.objects.published()[:10]
        
        Posts tagged *wordpress*::
        
            Posts.objects.term("wordpress")
        
        Post attachments::
        
            for attachment in post.attachments():
                pass
        
        Post tags::
        
            post.tags()
        
        
        ------------
        Installation
        ------------
        
        ::
        
            pip install the-real-django-wordpress
        
        Add to INSTALLED_APPS in settings.py::
        
            'wordpress'
        
        Include the following in urls.py::
        
            url(r'^path/to/blog/', include('wordpress.urls')),
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Environment :: Web Environment
