Skip to main content

Company blogs as a service. Built for developers.

Project description

Butter CMS for Django

Why Butter?

Butter makes setting up a company blog on Django insanely easy. It’s built for Django developers to save us from hosting, DB setup, themeing, maintaining yet another Wordpress install. It’s designed to be quickly integrated to an existing Django project.

Butter provides a marketing friendly blogging UI, hosted on, and exposes blog content created via an API.

This package provides thin wrapper that interacts with the Butter API and a quick start blog application.


Requires Python 2.7.9 or newer. If you’re on an older version of 2.7 please take a few seconds to upgrade:

$ pip install buttercms-django
# In
# Add buttercms to INSTALLED_APPS

Grab your API token from

# In
BUTTER_CMS_TOKEN = '<your_api_token>'

Define your blog path

# In
# Add your new blog path
urlpatterns = patterns('',
    url(r'^blog/', include('buttercms-django.urls')),

Now generate your blog templates into one of your existing Django apps with our handy butter_templates command

$ python butter_templates <app_name>

Open up <app_name>/templates/blog/blog_base.html and update the {% block content %} to match your existing site’s main body content block. Also, if your root parent file is not called base.html, update blog/blog_base.html to extend whichever template makes sense for your app.

Now check it out: http://localhost:8000/blog

Log into to start blogging!

Sitemap + Feeds

Your new blog comes built-in with a sitemap.xml, RSS + Atom feeds for maximum SEO benefit. You can use these to syndicate your content to social networks, improve search engine indexation, and more.

Sitemap: http://localhost:8000/blog/sitemap.xml

RSS: http://localhost:8000/blog/rss/ (named route blog_rss)

Atom: http://localhost:8000/blog/atom/ (named route blog_atom)

Customizing your blog

Customize the blog template

We’ve provided you with a pre-scaffolded blog. Simply crack open any of the files in the newly created /blog/ directory you created in the step above and modify those Django template as you would any other. Customizing your blog is now the same flow as the rest of your site! No longer do you have to hack Wordpress PHP scripts.

Project details

Download files

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

Source Distribution

buttercms-django-0.3.7.tar.gz (8.7 kB view hashes)

Uploaded Source

Built Distribution

buttercms_django-0.3.7-py2.py3-none-any.whl (15.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page