djangocms_blog/README.rst

168 lines
5.7 KiB
ReStructuredText
Raw Normal View History

2014-02-25 13:46:50 +00:00
==============
2014-01-05 09:34:10 +00:00
djangocms-blog
2014-02-25 13:46:50 +00:00
==============
2014-01-05 09:34:10 +00:00
.. image:: https://badge.fury.io/py/djangocms-blog.png
2014-06-11 11:05:41 +00:00
:target: http://badge.fury.io/py/djangocms-blog
.. image:: https://travis-ci.org/nephila/djangocms-blog.svg?branch=develop
:target: https://travis-ci.org/nephila/djangocms-blog
.. image:: https://pypip.in/d/djangocms-blog/badge.png
:target: https://pypi.python.org/pypi/djangocms-blog
.. image:: https://coveralls.io/repos/nephila/djangocms-blog/badge.png?branch=develop
:target: https://coveralls.io/r/nephila/djangocms-blog?branch=develop
2014-01-05 09:34:10 +00:00
2014-02-25 13:46:50 +00:00
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.
2014-01-05 09:34:10 +00:00
Supported Django versions:
* Django 1.5
* Django 1.6
Supported django CMS versions:
* django CMS 3.0
2014-01-05 09:34:10 +00:00
Documentation
-------------
2014-02-25 13:46:50 +00:00
No doc at the moment, sorry
2014-01-05 09:34:10 +00:00
Quickstart
----------
Install djangocms-blog::
2014-06-20 10:53:54 +00:00
pip install djangocms-blog==0.2b5
2014-01-05 09:34:10 +00:00
2014-03-06 19:09:37 +00:00
Add ``djangocms_blog`` and its dependencies to INSTALLED_APPS::
2014-01-05 09:34:10 +00:00
2014-03-06 19:09:37 +00:00
INSTALLED_APPS = [
...
'filer',
'parler',
'taggit',
'django_select2',
'taggit_autosuggest',
2014-06-12 16:23:24 +00:00
'meta',
'meta_mixin',
2014-03-06 19:09:37 +00:00
'djangocms_blog',
2014-07-21 10:24:27 +00:00
'cmsplugin_filer_image',
'easy_thumbnails',
'admin_enhancer',
2014-03-06 19:09:37 +00:00
...
]
Then sync and migrate::
$ python manage.py syncdb
$ python manage.py migrate
2014-06-12 16:23:24 +00:00
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-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::
2014-06-12 16:23:24 +00:00
SOUTH_MIGRATION_MODULES = {
2014-06-20 11:14:06 +00:00
'easy_thumbnails': 'easy_thumbnails.south_migrations',
2014-06-12 16:23:24 +00:00
'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
* Add the following to your ``urls.py``::
2014-06-12 16:23:24 +00:00
2014-06-20 10:53:54 +00:00
url(r'^taggit_autosuggest/', include('taggit_autosuggest.urls')),
2014-06-12 16:23:24 +00:00
* To start your blog, you need to create a new page from the CMS and hook it to the blog application.
2014-08-14 06:51:24 +00:00
* Then, go to Advanced setting and select Blog from the Application selector.
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.
2014-01-05 09:34:10 +00:00
Features
--------
2014-03-06 19:09:37 +00:00
* Placeholder content editing
* Frontend editing using django CMS 3.0 frontend editor
* Multilingual support using django-parler
2014-04-26 07:01:23 +00:00
* 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.
2014-04-26 07:01:23 +00:00
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
2014-01-06 09:37:55 +00:00
.. image:: https://d2weczhvl823v0.cloudfront.net/nephila/djangocms-blog/trend.png
:alt: Bitdeli badge
:target: https://bitdeli.com/free