Puput

Puput is a powerful and simple Django app to manage a blog. It uses the awesome Wagtail CMS as content management system.

Puput is the catalan name for Hoopoe which is indeed a beautiful bird.

Features

Based on Wagtail CMS and Django
Comes with a default clean & responsive template
SEO friendly urls
Support for Disqus comments
Archives, tags & categories results pages
Search form
Last & popular entries
Configurable sidebar widgets
RSS feeds
Blog post related entries
Inspired on Wordpress and Zinnia

Setup

Add to PUPUT_APPS to your INSTALLED_APPS in settings.py file. It also includes Wagtail apps and other dependencies.
```
from puput import PUPUT_APPS

INSTALLED_APPS += PUPUT_APPS
```

Add Wagtail required middleware classes in settings.py file

MIDDLEWARE_CLASSES = (
    ...
    'wagtail.wagtailcore.middleware.SiteMiddleware',
    'wagtail.wagtailredirects.middleware.RedirectMiddleware',
)

Add request context processor to TEMPLATE_CONTEXT_PROCESSORS structure in settings.py file

TEMPLATE_CONTEXT_PROCESSORS = (
    ...
    'django.core.context_processors.request',
)

Set WAGTAIL_SITE_NAME variable in settings.py file with your site name
Place Puput urls at the bottom of the urlpatterns. It also includes Wagtail urls.
```
urlpatterns = [
    ...
    url(r'', include('puput.urls')),
]
```
Run python manage.py migrate and python manage.py puput_initial_data to load initial data to start a blog site.
Open your broswer at http://127.0.0.1:8000/blog/ to view your blog home page.

Setup (as Wagtail plugin)

Add puputto your INSTALLED_APPS in settings.py file.
If you have previously defined Wagtail urls in urls.py set PUPUT_AS_PLUGIN = True in the settings.py. This will avoid to include Wagtail urls again when you include necessary Puput urls.

Include Puput urls in your urls.py file.

urlpatterns = [
    ...
    url(r'', include('puput.urls')),
    ...
]

Run python manage.py migrate

Manage your content

Puput uses the default Wagtail CMS admin page in order to manage the content of the blog. It provides a powerful, clean and modern interface. Just open your browser at http://127.0.0.1:8000/blog_admin/.

This is how adding entry page looks:

Please visit Wagtail: an Editor’s guide for details of how to use Wagtail editor's dashboard.

Comments

Puput allows customize the comment system for your blog entries. Simply go to settings tab while editing blog properties and add the required parameters depending on which system you want to use. For now, only Disqus comments are supported. Set Disqus api secret and Disqus shortname with your project values and comments will be displayed in each blog entry.

marctc / puput