buttercms-django 0.2.2

Setup

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

$ pip install buttercms-django

# In settings.py
# Add buttercms to INSTALLED_APPS
INSTALLED_APPS = (
    ...
    'buttercms',
)

Grab your API token from https://buttercms.com/api_token

# In settings.py
# Add your BUTTER_CMS_TOKEN
BUTTER_CMS_TOKEN = '<your_api_token>'

Define your blog path

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

Nice job. You’ve now got a blog running natively in your Django project. Nothing but Python goodness. (No PHP scripts here ;))

Check it out! localhost:8000/blog

Customize the Template

We’ve provided a default theme but we expect you’ll want skin it with your branding so we’ve made this as simple as extending your base template.

First create a template file called blog.html that both extends your base template and your main content block.

{% extends "base.html" %}

{% block title %}My amazing blog{% endblock %}

{% block content %}
    {% for post in recent_posts %}
    <div>
        <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
        <p>Posted by <a href="{% url 'blog_author' post.author.slug %}">{{ post.author.first_name }} {{ post.author.last_name }}</a> on {{ post.created }}</p>
        <p>{{ post.summary }}</p>
    </div>
    {% endfor %}
{% endblock %}

Then add this template name to your settings.py:

# In settings.py
BUTTER_CMS_BLOG_TEMPLATE = 'blog.html'

Go to localhost:8000/blog and you’ll see your new professional branded blog!

If you don’t make sure you’re both extending the correct base template (the example assumes “base.html”) and implementing the correct block name (the example assumes {% block content %} is the name of your main body block between the header and footer).

Log into https://buttercms.com/ to start blogging!