A djangoCMS 3 blog application
Project description
A djangoCMS 3 blog application.
Supported Django versions:
Django 1.6
Django 1.7
Django 1.8
Supported django CMS versions:
django CMS 3.x
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
Multisite support (posts can be visible in one or more Django sites on the same project)
Per-Apphook configuration
Per-Apphook templates set
Auto Apphook setup
Support for django CMS 3.2+ Wizard
Haystack index support
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',
'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-meta-mixin: https://github.com/nephila/django-meta-mixin#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 = TrueIf you are using Django 1.7+, be aware than filer < 0.9.10, cmsplugin_filer and django-cms < 3.1 currently requires you to setup MIGRATION_MODULES in settings:
MIGRATION_MODULES = { 'cms': 'cms.migrations_django', # only for django CMS 3.0 'menus': 'menus.migrations_django', # only for django CMS 3.0 'filer': 'filer.migrations_django', # only for django filer up to 0.9.9 'cmsplugin_filer_image': 'cmsplugin_filer_image.migrations_django', }Please check django CMS installation, cmsplugin-filer README for detailed information.
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 you need to use AppHooks from django CMS to add the blog to a django CMS page; this step is not required when using Auto setup (see below):
Create a new django CMS page
Go to Advanced settings and select Blog from the Application selector and create an application configuration;
Eventually customise the Application instance name;
Publish the page
Restart the project instance to properly load blog urls.
Add and edit blog by creating them in the admin or using the toolbar, and the use the django CMS frontend editor to edit the blog content:
Create a new blog entry in django admin backend or from the toolbar
Click on “view on site” button to view the post detail page
Edit the post via djangocms frontend by adding / editing plugins
Publish the blog post by flagging the “Publish” switch in the blog post admin
Configurable permalinks
Blog comes with four different styles of permalinks styles:
Full date: YYYY/MM/DD/SLUG
Year / Month: YYYY/MM/SLUG
Category: CATEGORY/SLUG
Just slug: SLUG
As all the styles are loaded in the urlconf, the latter two does not allow to have CMS pages beneath the page the blog is attached to. If you want to do this, you have to override the default urlconfs by setting something like the following in the project settings:
BLOG_PERMALINK_URLS = {
'full_date': r'^(?P<year>\d{4})/(?P<month>\d{1,2})/(?P<day>\d{1,2})/(?P<slug>\w[-\w]*)/$',
'short_date': r'^(?P<year>\d{4})/(?P<month>\d{1,2})/(?P<slug>\w[-\w]*)/$',
'category': r'^post/(?P<category>\w[-\w]*)/(?P<slug>\w[-\w]*)/$',
'slug': r'^post/(?P<slug>\w[-\w]*)/$',
}
And change post/ with the desired prefix.
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 base template and will ignore the bundled one.
Templates set
By using Apphook configuration you can define a different templates set. To use this feature provide a directory name in Template prefix field in the Apphook configuration admin (in Layout section): it will be the root of your custom templates set.
Auto setup
djangocms_blog can install and configue itself if it does not find any attached instance of itself. This feature is enable by default and will create:
a BlogConfig with default values
a Blog CMS page and will attach djangocms_blog instance to it
a home page if no home is found.
All the items will be created in every language configured for the website and the pages will be published. If not using aldryn-apphook-reload or django CMS 3.2 auto-reload middleware you are required to reload the project instance after this. This will only work for the current website as detected by Site.objects.get_current().
The auto setup is execute once for each server start but it will skip any action if a BlogConfig instance is found.
Global Settings
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; (default: 10)
BLOG_LATEST_POSTS: Default number of post in the Latest post plugin; (default: 5)
BLOG_POSTS_LIST_TRUNCWORDS_COUNT: Default number of words shown for abstract in the post list; (default: 100)
BLOG_TYPE: Generic type for the post object; (default: Article)
BLOG_TYPES: Choices of available blog types; (default: to META_OBJECT_TYPES defined in django-meta-mixin settings)
BLOG_FB_TYPE: Open Graph type for the post object; (default: Article)
BLOG_FB_TYPES: Choices of available blog types; (default: to META_FB_TYPES defined in django-meta-mixin settings)
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_TYPES: Choices of available blog types for twitter; (default: to META_TWITTER_TYPES defined in django-meta-mixin settings)
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_TYPES: Choices of available blog types for twitter; (default: to META_GPLUS_TYPES defined in django-meta-mixin settings)
BLOG_GPLUS_AUTHOR: Google+ account of the post author
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_ABSTRACT: Use an abstract field for the post; if False no abstract field is available for every post; (default: True)
BLOG_USE_PLACEHOLDER: Post content is managed via placeholder; if False a simple HTMLField is used; (default: True)
BLOG_MULTISITE: Add support for multisite setup; (default: True)
BLOG_MENU_TYPE: Structure of the Blog menu; (default: Posts and Categories)
BLOG_AUTHOR_DEFAULT: Use a default if not specified; if set to True the current user is set as the default author, if set to False no default author is set, if set to a string the user with the provided username is used; (default: True)
BLOG_DEFAULT_PUBLISHED: If posts are marked as published by default; (default: False)
BLOG_AVAILABLE_PERMALINK_STYLES: Choices of permalinks styles;
BLOG_PERMALINK_URLS: URLConf corresponding to BLOG_AVAILABLE_PERMALINK_STYLES;
BLOG_DEFAULT_OBJECT_NAME: Default name for Blog item (used in django CMS Wizard);
BLOG_AUTO_SETUP: Enable the blog Auto setup feature; (default: True)
BLOG_AUTO_HOME_TITLE: Title of the home page created by Auto setup; (default: Home)
BLOG_AUTO_BLOG_TITLE: Title of the blog page created by Auto setup; (default: Blog)
BLOG_AUTO_APP_TITLE: Title of the BlogConfig instance created by Auto setup; (default: Blog)
Per-Apphook settings
application title: Free text title that can be used as title in templates;
object name: Free text label for Blog items in django CMS Wizard;
Post published by default: Per-Apphook setting for BLOG_DEFAULT_PUBLISHED;
Permalink structure: Per-Apphook setting for BLOG_AVAILABLE_PERMALINK_STYLES;
Use placeholder and plugins for article body: Per-Apphook setting for BLOG_USE_PLACEHOLDER;
Use abstract field: Per-Apphook setting for BLOG_USE_ABSTRACT;
Set author: Per-Apphook setting for BLOG_AUTHOR_DEFAULT;
Paginate sizePer-Apphook setting for BLOG_PAGINATION;
Template prefix: Alternative directory to load the blog templates from;
Menu structure: Per-Apphook setting for BLOG_MENU_TYPE
Object type: Per-Apphook setting for BLOG_TYPE
Facebook type: Per-Apphook setting for BLOG_FB_TYPE
Facebook application ID: Per-Apphook setting for BLOG_FB_APP_ID
Facebook profile ID: Per-Apphook setting for BLOG_FB_PROFILE_ID
Facebook page URL: Per-Apphook setting for BLOG_FB_PUBLISHER
Facebook author URL: Per-Apphook setting for BLOG_AUTHOR_URL
Facebook author: Per-Apphook setting for BLOG_AUTHOR
Twitter type: Per-Apphook setting for BLOG_TWITTER_TYPE
Twitter site handle: Per-Apphook setting for BLOG_TWITTER_SITE
Twitter author handle: Per-Apphook setting for BLOG_TWITTER_AUTHOR
Google+ type: Per-Apphook setting for BLOG_GPLUS_TYPE
Google+ author name: Per-Apphook setting for BLOG_GPLUS_AUTHOR
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.
Known djangocms-blog websites
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for djangocms_blog-0.6.0-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | cad03758b86d7a25ea4b66be6f7606848db73b7707dd358dd175acbe9442c2d9 |
|
| MD5 | 14a3322b50efae910c0414052cd2e0e1 |
|
| BLAKE2b-256 | bb7d3b4e5c681031d7f57ce17437e65241acf1a023c6ed81d63eb3087f5ad21b |
