djangocms-blog

============== djangocms-blog

|Gitter| |PyPiVersion| |PyVersion| |GAStatus| |TestCoverage| |CodeClimate| |License|

django CMS blog application - Support for multilingual posts, placeholders, social network meta tags and configurable apphooks.

Supported Django versions:

• Django 3.2 - 4.2

Supported django CMS versions:

• django CMS 3.9 - 3.11+

---

Installation

---

See installation documentation_

---

Features

---

See features documentation_ for all the features details

• Support for django-app-enabler_ autoconfiguration.
• Placeholder content editing
• Frontend editing using django CMS frontend editor
• Multilingual support using django-parler
• Twitter cards, Open Graph and Google+ snippets meta tags
• Optional simpler TextField-based content editing
• Multisite (posts can be visible in one or more Django sites on the same project)
• Per-Apphook configuration
• Configurable permalinks
• Configurable django CMS menu
• Per-Apphook templates set
• Auto Apphook setup
• Django sitemap framework
• django CMS Wizard integration
• Desktop notifications
• Liveblog

---

Known djangocms-blog websites

---

See DjangoPackages for an updated list https://www.djangopackages.com/packages/p/djangocms-blog/

.. _features documentation: http://djangocms-blog.readthedocs.io/en/latest/features/ .. _installation documentation: http://djangocms-blog.readthedocs.io/en/latest/installation.html .. _permalinks: http://djangocms-blog.readthedocs.io/en/latest/features/permalinks.html .. _cmsplugin-filer migration documentation: http://djangocms-blog.readthedocs.io/en/latest/cmsplugin_filer.html .. _django-app-enabler: https://github.com/nephila/django-app-enabler

.. |Gitter| image:: https://img.shields.io/badge/GITTER-join%20chat-brightgreen.svg?style=flat-square :target: https://gitter.im/nephila/applications :alt: Join the Gitter chat

.. |PyPiVersion| image:: https://img.shields.io/pypi/v/djangocms-blog.svg?style=flat-square :target: https://pypi.python.org/pypi/djangocms-blog :alt: Latest PyPI version

.. |PyVersion| image:: https://img.shields.io/pypi/pyversions/djangocms-blog.svg?style=flat-square :target: https://pypi.python.org/pypi/djangocms-blog :alt: Python versions

.. |GAStatus| image:: https://github.com/nephila/djangocms-blog/workflows/Tox%20tests/badge.svg :target: https://github.com/nephila/djangocms-blog :alt: Latest CI build status

.. |TestCoverage| image:: https://img.shields.io/coveralls/nephila/djangocms-blog/master.svg?style=flat-square :target: https://coveralls.io/r/nephila/djangocms-blog?branch=master :alt: Test coverage

.. |License| image:: https://img.shields.io/github/license/nephila/djangocms-blog.svg?style=flat-square :target: https://pypi.python.org/pypi/djangocms-blog/ :alt: License

.. |CodeClimate| image:: https://codeclimate.com/github/nephila/djangocms-blog/badges/gpa.svg?style=flat-square :target: https://codeclimate.com/github/nephila/djangocms-blog :alt: Code Climate

.. :changelog:

---

History

---

.. towncrier release notes start

2.0.7 (2024-01-16)

Bugfixes

• Pin Django CMS version < 4, update Github test matrix (#786)

2.0.6 (2023-12-22)

Features

• Switch to Coveralls Github action (#774)

Bugfixes

• Add sphinx-rtd-theme dependency in setup (#769)
• Add force_str to FeaturedPostsPlugin str method (#780)
• Fix FeaturedPostsPlugin get_posts method rendering all posts instead of selected ones (#781)

2.0.5 (2023-09-26)

Bugfixes

• Pin correct django-meta version (#763)

2.0.4 (2023-09-25)

Bugfixes

• Bump django-meta version in setup.cfg (#761)

2.0.3 (2023-09-22)

Features

• Migrate to bump-my-version (#759)

2.0.2 (2023-08-30)

Features

• Update translations (#751)

2.0.1 (2023-08-07)

Features

• Add BlogFeaturedPostsPlugin to show selected posts (#428)

2.0.0 (2023-08-03)

Features

• Add include in rss field to post, to be able to exclude blog items from rss feed. (#663)
• Add a CMS toolbar item for category and tag list (#676)
• Add optional BLOG_UNICODE_SLUGS setting that disable unicode in blog posts slugs. (#707)
• Improve meta image size handling (#718)
• Port to django 3.2/4.1 - django CMS 3.11 (#720)
• Add default_auto_field to BlogAppConfig (#737)

Bugfixes

• Fix distinct preventing post delete from admin (#683)
• See description here: https://github.com/nephila/djangocms-blog/issues/699 (#699)
• Add classname for categories and tags that uses slug, not empty "count". (#710)
• Fix pre-commit flake8 repo url (#715)
• Fix template urls not respecting namespaces (#723)
• Do not show a post detail published on another site (#724)

1.2.3 (2020-12-21)

Features

• Improve django-app-enabler support (#660)
• Update translations
• Update django-app-enabler information

1.2.2 (2020-12-20)

Features

• Add support for Python 3.9 (#657)

Bugfixes

• Handle unicode chars in reverse of Post and Category models, using Django path() method instead of url() (#653)

Improved Documentation

• Update docs to clarify how to add content (#636)

1.2.1 (2020-11-16)

Bugfixes

• Fix admin urlconf not matching path syntax (#648)

1.2.0 (2020-11-14)

• BREAKING CHANGE: Replace url() function with path() (#645)

Features

• Add support for django CMS 3.8 / Django 3.1 (#643)
• Update to modern tooling and port to github actions (#564)
• Add option to allow fallback language in post/category URLs (#546)
• Move post slug to top of post admin form (#567)
• Add blog post extensions (#569)
• Replace deprecated function calls (#571)
• Improve tag selection UX/UI (#614)
• Improve admin customization (#620)
• Improve documentation (#622)
• Add rtd config file and refactor test / docs dependencies (#624)
• Replace G+ metadata with Schema.org (#637)
• Update pre-commit checks to latest version (#639)

Bugfixes

• Do not let site crash on menu if there is a namespace mismatch (#532)
• Improve setup documentation (#541)
• Fix GA on pull request (#575)
• Fix coveralls failure on pull request in GA (#577)
• Fix link in PR template (#581)
• Skip haystack index creation if aldryn-search is not installed but haystack is (#584)
• Skip towncrier on develop / master branch (#591)
• Fix missing template folders selection in plugins (#595)
• Clarify documentation regarding templates customization (#595)
• Fix extra migration when customizing BLOG_PLUGIN_TEMPLATE_FOLDERS (#597)
• Set default pytest configuration (#598)
• Add missing condition for (date_published)
• on blog_meta template (#603)
• Fix python version declaration in tox (#606)
• Fix creating text plugin in wizard (#607)
• Split linting GA to its own file (#608)
• Doc improvements for usage with djangocms-page-meta (#613)
• Update linting (#618)
• Fix building docs (#632)

Improved Documentation

• Improve documentation to enable social meta tags rendering (#613)

Misc

• #593

1.1.1 (2020-05-15)

• Fix channels support
• Avoid admin exception for related posts when config is None
• Fix error when overriding templates folder

1.1.0 (2020-05-04)

• Add support for django 3.0
• Add BlogAuthorPostsListPlugin to show posts per author
• Add experimental support for django-app-enabler
• Remove cmsplugin_filer from installation docs
• Set minimum django-parler version to 2.0
• Reduce the maximum length of slug fields to 752 characters
• Fix duplicated authors in BlogAuthorPostsPlugin
• Fix to respect current locale for category names
• Improve documentation for meta tags

1.0.0 (2019-11-04)

• Add support for django CMS 3.7
• Add support for Python 3.7
• Add image size meta for Facebook
• Add support for django-parler >= 2
• Move to django-app-helper
• Drop support for Django < 1.11
• Drop support for django CMS < 3.5
• Drop older compatibilities

0.9.11 (2019-08-06)

• Use menu_empty_categories config for BlogCategoryPlugin
• Purge menu cache when deleting a BlogConfig

0.9.10 (2019-07-02)

• Fixed allow_unicode kwarg for AutoSlugField
• Fixed sphinx conf isort
• Set category as requested or not depending on the permalink setting

0.9.9 (2019-04-05)

• Fixed issue with thumbnails not being preserved in admin form
• Pinned django-taggit version

0.9.8 (2019-01-13)

• Fixed test environment in Django 1.8, 1.9
• Added related posts to templates / documentation
• Added a fix for multiple error messages when slug is not unique

0.9.7 (2018-05-05)

• Fixed subtitle field not added to the admin

0.9.6 (2018-05-02)

• Fixed string representation when model has no language
• Added subtitle field

0.9.5 (2018-04-07)

• Fixed jquery path in Django 1.9+"Fix jquery path in Django 1.9+
• Added configurable blog abstract/text CKEditor

0.9.4 (2018-03-24)

• Fixed migration error from 0.8 to 0.9

0.9.3 (2018-03-12)

• Added dependency on lxml used in feeds
• Fixed warning on django CMS 3.5
• Fixed wizard in Django 1.11
• Updated translations

0.9.2 (2018-02-27)

• Fixed missing migration

0.9.1 (2018-02-22)

• Added Django 1.11 support

0.9.0 (2018-02-20)

• Added support for django CMS 3.4, 3.5
• Dropped support for Django<1.8, django CMS<3.2.
• Added liveblog application.
• Refactored plugin filters: by default only data for current site are now shown.
• Added global and per site posts count to BlogCategory.
• Added option to hide empty categories from menu.
• Added standalone documentation at https://djangocms-blog.readthedocs.io.
• Enabled cached version of BlogLatestEntriesPlugin.
• Added plugins templateset.
• Improved category admin to avoid circular relationships.
• Dropped strict dependency on aldryn-search, haystack. Install separately for search support.
• Improved admin filtering.
• Added featured date to post.
• Fixed issue with urls in sitemap if apphook is not published
• Moved template to easy_thumbnails_tags template tag. Require easy_thumbnails >= 2.4.1
• Made HTML description and title fields length configurable
• Added meta representation for CategoryEntriesView
• Generated valid slug in wizard if the given one is taken
• Fixed error in category filtering when loading the for via POST
• Returned 404 in AuthorEntriesView if author does not exists
• Returned 404 in CategoryEntriesView if category does not exists
• Generate valid slug in wizard if the given one is taken
• Limit categories / related in forms only to current lan

0.8.13 (2017-07-25)

• Dropped python 2.6 compatibility
• Fixed exceptions in str
• Fixed issue with duplicated categories in menu

0.8.12 (2017-03-11)

• Fixed migrations on Django 1.10

0.8.11 (2017-03-04)

• Fixed support for aldryn-apphooks-config 0.3.1

0.8.10 (2017-01-02)

• Fix error in get_absolute_url

0.8.9 (2016-10-25)

• Optimized querysets
• Fixed slug generation in wizard

0.8.8 (2016-09-04)

• Fixed issue with one migration
• Improved support for django CMS 3.4

0.8.7 (2016-08-25)

• Added support for django CMS 3.4
• Fixed issue with multisite support

0.8.6 (2016-08-03)

• Set the correct language during indexing

0.8.5 (2016-06-26)

• Fixed issues with ThumbnailOption migration under mysql.

0.8.4 (2016-06-22)

• Fixed issues with cmsplugin-filer 1.1.

0.8.3 (2016-06-21)

• Stricter filer dependency versioning.

0.8.2 (2016-06-12)

• Aldryn-only release. No code changes

0.8.1 (2016-06-11)

• Aldryn-only release. No code changes

0.8.0 (2016-06-05)

• Added django-knocker integration
• Changed the default value of date_published to null
• Cleared menu cache when changing menu layout in apphook config
• Fixed error with wizard multiple registration
• Made django CMS 3.2 the default version
• Fixed error with on_site filter
• Removed meta-mixin compatibility code
• Changed slug size to 255 chars
• Fixed pagination setting in list views
• Added API to set default sites if user has permission only for a subset of sites
• Added Aldryn integration

0.7.0 (2016-03-19)

• Make categories non required
• Fix tests with parler>=1.6
• Use all_languages_column to admin
• Add publish button
• Fix issues in migrations. Thanks @skirsdeda
• Fix selecting current menu item according to menu layout
• Fix some issues with haystack indexes
• Add support for moved ThumbnailOption
• Fix Django 1.9 issues
• Fix copy relations method in plugins
• Mitigate issue when apphook config can't be retrieved
• Mitigate issue when wizard double registration is triggered

0.6.3 (2015-12-22)

• Add BLOG_ADMIN_POST_FIELDSET_FILTER to filter admin fieldsets
• Ensure correct creation of full URL for canonical urls
• Move constants to settings
• Fix error when no config is found

0.6.2 (2015-11-16)

• Add app_config field to BlogLatestEntriesPlugin
• Fix str plugins method
• Fix bug when selecting plugins template

0.6.1 (2015-10-31)

• Improve toolbar: add all languages for each post
• Improve toolbar: add per-apphook configurable changefreq, priority

0.6.0 (2015-10-30)

• Add support for django CMS 3.2 Wizard
• Add support for Apphook Config
• Add Haystack support
• Improved support for meta tags
• Improved admin
• LatestPostsPlugin tags field has been changed to a plain TaggableManager field. A migration is in place to move the data, but backup your data first.

0.5.0 (2015-08-09)

• Add support for Django 1.8
• Drop dependency on Django select2
• Code cleanups
• Enforce flake8 / isort checks
• Add categories menu
• Add option to disable the abstract

0.4.0 (2015-03-22)

• Fix Django 1.7 issues
• Fix dependencies on python 3 when using wheel packages
• Drop Django 1.5 support
• Fix various templates issues
• UX fixes in the admin

0.3.1 (2015-01-07)

• Fix page_name in template
• Set cascade to set null for post image and thumbnail options

0.3.0 (2015-01-04)

• Multisite support
• Configurable default author support
• Refactored settings
• Fix multilanguage issues
• Fix SEO fields length
• Post absolute url is generated from the title in any language if current is not available
• If djangocms-page-meta and djangocms-page-tags are installed, the relevant toolbar items are removed from the toolbar in the post detail view to avoid confusings page meta / tags with post ones
• Plugin API changed to filter out posts according to the request.
• Django 1.7 support
• Python 3.3 and 3.4 support

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