djangocms-blog 0.2

A djangoCMS 3 blog application

A djangoCMS 3 blog application.

Still experimental and untested. You are welcome if you want to try it; if you encounter any issue, please open an issue.

Supported Django versions:

• Django 1.5

• Django 1.6

Supported django CMS versions:

• django CMS 3.0

Documentation

No doc at the moment, sorry

Quickstart

Install djangocms-blog:

pip install djangocms-blog

Add djangocms_blog and its dependencies to INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    'filer',
    'easy_thumbnails',
    'cmsplugin_filer_image',
    'parler',
    'taggit',
    'taggit_autosuggest',
    'django_select2',
    'meta',
    'meta_mixin',
    'admin_enhancer',
    'djangocms_blog',
    ...
]

Then sync and migrate:

$ python manage.py syncdb
$ python manage.py migrate

External applications configuration

Dependency applications may need configuration to work properly.

Please, refer to each application documentation on details.

• django-filer: http://django-filer.readthedocs.org

• django-meta: https://github.com/nephila/django-meta#installation

• django-parler: http://django-parler.readthedocs.org/en/latest/quickstart.html#configuration

• django-taggit-autosuggest: https://bitbucket.org/fabian/django-taggit-autosuggest

Quick hint

The following are minimal defaults to get the blog running; they may not be suited for your deployment.

• Add the following settings to your project:

  SOUTH_MIGRATION_MODULES = {
      'easy_thumbnails': 'easy_thumbnails.south_migrations',
      'taggit': 'taggit.south_migrations',
  }
  THUMBNAIL_PROCESSORS = (
      'easy_thumbnails.processors.colorspace',
      'easy_thumbnails.processors.autocrop',
      'filer.thumbnail_processors.scale_and_crop_with_subject_location',
      'easy_thumbnails.processors.filters',
  )
  META_SITE_PROTOCOL = 'http'
  META_USE_SITES = True

• Configure parler according to your languages:

  PARLER_LANGUAGES = {
      1: (
          {'code': 'en',},
          {'code': 'it',},
          {'code': 'fr',},
      ),
  }

• Add the following to your urls.py:

  url(r'^taggit_autosuggest/', include('taggit_autosuggest.urls')),

• To start your blog create a new page from the CMS and hook it to the blog application:

  • Create a new django CMS page

  • Go to Advanced settings and sele select Blog from the Application selector;

  • Eventually customise the Application instance name;

  • Restart the project instance to properly load blog urls.

Templates

To ease the template customisations a djangocms_blog/base.html template is used by all the blog templates; the templates itself extends a base.html template; content is pulled in the content block. If you need to define a different base template, or if your base template does not defines a content block, copy in your template directory djangocms_blog/base.html and customise it according to your needs; the other application templates will use the newly created template and will ignore the bundled one.

Features

• Placeholder content editing

• Frontend editing using django CMS 3.0 frontend editor

• Multilingual support using django-parler

• Support for Twitter cards, Open Graph and Google+ snippets meta tags

• Optional support for simpler TextField-based content editing

Import from Wordpress

If you want to import content from existing wordpress blog, check https://pypi.python.org/pypi/the-real-django-wordpress and this gist https://gist.github.com/yakky/11336204 as a base.

Settings

• BLOG_ENABLE_COMMENTS: Whether to enable comments by default on posts; while djangocms_blog does not ship any comment system, this flag can be used to control the chosen comments framework; (default: True)

• BLOG_USE_PLACEHOLDER: Post content is managed via placeholder; if False a simple HTMLField is used; (default: True)

• BLOG_IMAGE_THUMBNAIL_SIZE: Size of the main image when shown on the post lists; it’s a dictionary with size, crop and upscale keys; (default: {‘size’: ‘120x120’, ‘crop’: True,’upscale’: False})

• BLOG_IMAGE_FULL_SIZE: Size of the main image when shown on the post detail; it’s a dictionary with size, crop and upscale keys; (default: {‘size’: ‘640x120’, ‘crop’: True,’upscale’: False})

• BLOG_PAGINATION: Number of post per page; (defaul: 10)

• BLOG_LATEST_POSTS: Default number of post in the Latest post plugin; (defaul: 5)

• BLOG_POSTS_LIST_TRUNCWORDS_COUNT: Default number of words shown for abstract in the post list; (default: 100)

Social media tags settings

• BLOG_TYPE: Generic type for the post object; (default: Article)

• BLOG_FB_TYPE: Open Graph type for the post object; (default: Article)

• BLOG_FB_APPID: Facebook Application ID

• BLOG_FB_PROFILE_ID: Facebook profile ID of the post author

• BLOG_FB_PUBLISHER: Facebook URL of the blog publisher

• BLOG_FB_AUTHOR_URL: Facebook profile URL of the post author

• BLOG_FB_AUTHOR: Facebook profile URL of the post author

• BLOG_TWITTER_TYPE: Twitter Card type for the post object; (default: Summary)

• BLOG_TWITTER_SITE: Twitter account of the site

• BLOG_TWITTER_AUTHOR: Twitter account of the post author

• BLOG_GPLUS_TYPE: Google+ Snippet type for the post object; (default: Blog)

• BLOG_GPLUS_AUTHOR: Google+ account of the post author

History

0.2.0 (2014-09-24)

• INCOMPATIBLE CHANGE: view names changed!

• Based on django parler 1.0

• Toolbar items contextual to the current page

• Add support for canonical URLs

• Add transifex support

• Add social tags via django-meta-mixin

• Per-post or site-wide comments enabling

• Simpler TextField-based content editing for simpler blogs

• Add support for custom user models

0.1.0 (2014-03-06)

• First experimental release