Skip to main content

Butter CMS for Django

https://www.buttercms.com

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 buttercms.com, 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.

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-django',
)

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

# 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-django.urls')),
)

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

$ python manage.py 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 https://buttercms.com/ 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.

Metadata

Release files for buttercms-django 0.3.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for buttercms-django 0.3.7
File Size Uploaded Provenance Actions
buttercms-django-0.3.7.tar.gz 8.7 kB Without provenance Details for buttercms-django-0.3.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for buttercms-django 0.3.7
File Interpreter ABI Platform Actions
buttercms_django-0.3.7-py2.py3-none-any.whl Python 3, Python 2 none any Details for buttercms_django-0.3.7-py2.py3-none-any.whl

Total release size: 24.2 kB

Release files / buttercms-django-0.3.7.tar.gz

Download URL buttercms-django-0.3.7.tar.gz
Size 8.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a81e9816d6be4195c03ef40e97488183e2ecbcd5f07aec8d85cd94a9005e93a3
BLAKE2b-256 checksum
How to use checksums
be33d067728ec52c430e8712721d19e69945f5c8a29a3e34de52db7608992c38
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / buttercms_django-0.3.7-py2.py3-none-any.whl

Download URL buttercms_django-0.3.7-py2.py3-none-any.whl
Size 15.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
d74f46c8e5beb89fa1108daab95805ca91974e3811ba05665792758736ee2ed4
BLAKE2b-256 checksum
How to use checksums
21afa6f85aa3dc1cfade2634bd4502fd490e98f3d68e374b003fc580495c3734
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for buttercms-django 0.3.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page