[ANN]: FeinCMS v1.6.0

Hello everyone

FeinCMS v1.6.0 has been released this noon and is available from
usual places.


What is FeinCMS anyway?
=======================

FeinCMS is one of the most advanced Content Management Systems built on top
of Django. FeinCMS not only includes a page module with many bundled content
types (plugins), a media library and up-to-date documentation but also the
tools to build your own CMS if our view of how a page CMS is supposed to
act like does not fit your requirements.

Website: http://www.feincms.org/

PyPI: http://pypi.python.org/pypi/FeinCMS/
Github: https://github.com/feincms/feincms/
Docs: http://feincms-django-cms.readthedocs.org/

Please report any issues you find in the issue tracker of github:
https://github.com/feincms/feincms/issues


This release would not have been possible without the contributions by the
community. Thanks for all the patches, bug reports and ideas which went into
this release.



=========================
FeinCMS 1.6 release notes
=========================

Welcome to FeinCMS 1.6!


Backwards-incompatible changes
==============================


Reversing application content URLs
----------------------------------

The default value of ``FEINCMS_REVERSE_MONKEY_PATCH`` has been changed to
``False``. Support for monkey-patching the ``reverse()`` method to support
the old ``'urlconf/viewname'`` notation will be removed in the 1.7 release.


Improvements to the bundled file and image contents
---------------------------------------------------

* ``ImageContent``, ``FileContent`` and ``VideoContent`` now have pretty
icons out-of-the-box.

* ``ImageContent`` now accepts optional ``FORMAT_CHOICES`` for use with
FeinCMS' bundled thumbnailers, as well as ``caption`` and ``alt_text`` fields.

.. note::

If you are upgrading from an earlier version of FeinCMS, you'll have to
add the new database columns yourself or use a migration tool like South
to do it for you. Instructions for MySQL and the page module follow::

ALTER TABLE page_page_imagecontent ADD COLUMN `alt_text`
varchar(255) NOT NULL;
ALTER TABLE page_page_imagecontent ADD COLUMN `caption`
varchar(255) NOT NULL;

If you want to use ``FORMAT_CHOICES``::

ALTER TABLE page_page_imagecontent ADD COLUMN `format`
varchar(64) NOT NULL;

* ``FileContent`` now displays the size of the file in the default template,
and uses ``span`` elements to allow styling of the title / size.


Removal of deprecated features
------------------------------

* Deprecated page manager methods have been removed. You should use
``Page.objects.for_request`` instead of the following manager methods:

* ``Page.objects.page_for_path_or_404()``
* ``Page.objects.for_request_or_404()``
* ``Page.objects.best_match_for_request()``
* ``Page.objects.from_request()``

* Deprecated page methods have been removed:

* ``Page.active_children()``: Use ``Page.children.active()`` instead.
* ``Page.active_children_in_navigation()``: Use
``Page.children.in_navigation()`` instead.
* ``Page.get_siblings_and_self()``: You probably wanted
``self.parent.children.active()`` or
``self.get_siblings(include_self=True).active()`` anyway.

* The shortcuts ``Page.register_request_processors()`` and
``Page.register_response_processors()`` to register several request
or response
processors at once have been removed in favor of their counterparts which
only allow one processor at a time, but allow for replacing FeinCMS' included
processors, ``require_path_active_request_processor`` and
``redirect_request_processor``.

* It is not possible anymore to access the request and response processors as
methods of the ``Page`` class. The processors are all in
``feincms.module.page.processors`` now.

* The deprecated support for prefilled attributes has been removed. Use
Django's own ``prefetch_related`` or ``feincms.utils.queryset_transform``
instead.

* The deprecated ``feincms.views.base`` module has been removed. The code has
been moved to ``feincms.views.legacy`` during the FeinCMS v1.5 cycle.


New deprecations
----------------

* The view decorator ``feincms.views.decorators.add_page_to_extra_context``
has been deprecated as it was mostly used with function-based generic views,
which have been deprecated in Django as well. Use Django's class-based generic
views and the ``feincms.context_processors.add_page_if_missing`` context
processor if you need similar functionality instead.

* The content type ``feincms.content.medialibrary.models.MediaFileContent`` has
been deprecated since FeinCMS v1.4. The whole module has been deprecated now
and will be replaced with the contents of ``feincms.content.medialibrary.v2``
in FeinCMS v1.7. The ``v2`` module will stay around for another release or
two so that code using ``v2`` will continue working with FeinCMS v1.8 (at
least).

* The template tag ``feincms_navigation`` has been superseded by ``feincms_nav``
which fixes a few problems with the old code and is generally much more
maintainable. The old version will stay around for one more version and will
be removed for FeinCMS v1.8. The only difference (apart from the bugfixes and
the slightly different syntax) is that ``feincms_nav`` unconditionally uses
navigation extensions. Additionally, ``feincms_navigation`` uses
``feincms_nav``'s implementation behind the scenes, which means that the
``extended`` argument does not have an effect anymore (it's always active).

* The HTML cleaning support in ``feincms.utils.html.cleanse`` which could be
easily used in the ``RichTextContent`` by passing ``cleanse=True`` has been
copied into its own Python package,
`feincms-cleanse <http://pypi.python.org/pypi/feincms-cleanse>`_. You should
start passing a callable to ``cleanse`` right now. The existing support for
cleansing will only be available up to FeinCMS v1.7.

* FeinCMS v1.8 will not support shorthands anymore when registering extensions.
Always provide the full python path to the extension file (or pass callables)
to ``feincms.models.Base.register_extensions``. That is,
``Page.register_extensions('feincms.module.extensions.ct_tracker')`` should
be used instead of ``Page.register_extensions('ct_tracker')``. While it is
a bit more work it will make it much more explicit what's going on.


Compatibility with Django and other apps
----------------------------------------

FeinCMS 1.6 requires Django 1.4. If you want to use django-reversion
with FeinCMS
you have to use django-reversion 1.6 or newer.


Notable features and improvements
=================================

* The bundled content types take additional steps to ensure that the main view
context is available in content types' templates. If you only use
the rendering
tags (``feincms_render_region`` and ``feincms_render_content``) you can take
advantage of all variables from your context processors in content types'
templates too. Furthermore, those templatetags have been simplified by using
Django's ``template.Library.simple_tag`` method now, which means that filters
etc. are supported as template tag arguments now.

* ``MediaFile`` does no longer auto-rotate images on upload. It really is not a
media library's job to magically modify user content; if needed, it should be
done in an image filter (like sorl). Also, reading through the image data
seems to have a side effect on some external storage engines which then would
only save half the image data, see issue #254. Additionally, FeinCMS does not
try anymore to detect whether uploaded files really are images, and only looks
at the file extension by default. We did not peek at the contents of
other file
types either.

* A new model field has been added, ``feincms.contrib.richtext.RichTextField``.
This is a drop-in replacement for Django's ``models.TextField`` with the
difference that it adds the CSS classes required by rich text fields in the
item editor.

* The value of ``FEINCMS_FRONTEND_EDITING`` defaults to ``False`` now.

* Frontend editing can now safely be used with caching. This is accomplished
by saving state in a cookie instead of creating sessions all the time.

* The ``SectionContent`` content type has been updated and does properly
use ``raw_id_fields`` for the media files instead of the hack which was used
before.

* It is now possible to specify a different function for generating thumbnails
in the media library administration. Set the setting
``FEINCMS_MEDIALIBRARY_THUMBNAIL`` to a function taking a media file instance
and returning a URL to a thumbnail image or nothing if the file type cannot
be handled by the thumbnailer.

* Thumbnails generated by the bundled ``|thumbnail`` and ``|cropscale`` template
filters are stored separately from the uploaded files now. This change means
that all thumbnails will be automatically regenerated after a FeinCMS update.
If you need the old behavior for some reason, set the setting
``FEINCMS_THUMBNAIL_DIR`` to an empty string. The default setting is
``'_thumbs/'``.

* All templates and examples have been converted to the new ``{% url %}``
syntax.

* Custom comment models are now supported in the ``CommentsContent``.

* Media files are now removed from the disk too if a media file entry is
removed from the database.


Bugfixes
========

* The core page methods support running with ``APPEND_SLASH = False`` now.
Many content types using forms do not, however.

* The MPTT attributes aren't hardcoded in the tree editor anymore. Custom names
for the ``left``, ``right``, ``level`` and ``tree_id`` attributes are now
supported. Models which do not use ``id`` as their primary key are supported
now as well.

* FeinCMS uses timezone-aware datetimes now.

--
You received this message because you are subscribed to the Google Groups "Django users" group.
To post to this group, send email to django-users@googlegroups.com.
To unsubscribe from this group, send email to django-users+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/django-users?hl=en.