/docs/releases/1.4.rst

 1=========================
 2FeinCMS 1.4 release notes
 3=========================
 4
 5* FeinCMS supports more than one site from the same database with
 6  ``django.contrib.sites`` now. Thanks to Bojan Mihelac and Stephen Tyler
 7  for the work and insistence on this issue.
 8
 9* It is possible to customize the administration model inline used for
10  content types. This means that it's possible to customize more aspects
11  of content type editing and to reuse more behaviors from Django itself,
12  such as ``raw_id_fields``.
13
14* FeinCMS has gained support for ``django-reversion``.
15
16* Reusing the media library in your own content types has become much
17  easier than before. When using a
18  ``feincms.module.medialibrary.fields.MediaFileForeignKey`` instead of
19  the standard ``django.db.models.ForeignKey`` and adding the media file
20  foreign key to ``raw_id_fields``, you get the standard Django behavior
21  supplemented with a thumbnail if the media file is an image. This requires
22  the next feature too, which is...
23
24* Custom ``InlineModelAdmin`` classes may be used for the content types now
25  by adding a ``feincms_item_editor_inline`` attribute to the content type
26  specifying the inline class to be used.
27
28* New projects should use ``feincms.content.medialibrary.v2.MediaFileContent``
29  instead of ``feincms.content.medialibrary.models.MediaFileContent``. The
30  argument ``POSITION_CHOICES`` and the corresponding field have been
31  renamed to ``TYPE_CHOICES`` and ``type`` because that's a more fitting
32  description of the intended use. The old and the new media file content
33  should not be mixed; the hand-woven ``raw_id_fields`` support of the
34  old media file content was not specific enough and interferes with
35  Django's own ``raw_id_fields`` support.
36
37* FeinCMS has gained a preview feature for pages which shouldn't be
38  accessible to the general public yet. Just add the following line
39  above the standard FeinCMS handler::
40
41      url(r'', include('feincms.contrib.preview.urls')),
42
43  Another button will be automatically added in the page item editor.
44
45
46Apart from all these new features a few cleanups have been made:
47
48* FeinCMS 1.2 removed the CKEditor-specific rich text content in favor of a
49  generalized rich text content supporting different rich text editors.
50  Unfortunately the documentation and the available settings only reflected
51  this partially. This has been rectified. Support for ``TINYMCE_JS_URL``,
52  ``FEINCMS_TINYMCE_INIT_TEMPLATE`` and ``FEINCMS_TINYMCE_INIT_CONTEXT`` has
53  been completely removed. The two settings ``FEINCMS_RICHTEXT_INIT_CONTEXT``
54  and ``FEINCMS_RICHTEXT_INIT_TEMPLATE`` should be used instead. See the
55  :ref:`contenttypes` documentation for more details.
56
57* The two settings ``FEINCMS_MEDIALIBRARY_ROOT`` and
58  ``FEINCMS_MEDIALIBRARY_URL`` have been removed. Their values always
59  defaulted to ``MEDIA_ROOT`` and ``MEDIA_URL``. The way they were used
60  made it hard to support other storage backends in the media library.
61  If you still need to customize the storage class used in the media
62  library have a look at ``MediaFile.reconfigure``.
63
64* Support for the ``show_on_top`` option for the ``ItemEditor`` has been
65  completely removed. This functionality has been deprecated since 1.2.
66
67* A few one-line Page manager methods which were too similar to each other
68  have been deprecated. They will be removed in the next release of FeinCMS.
69  This concerns ``page_for_path_or_404``, ``for_request_or_404``,
70  ``best_match_for_request`` and ``from_request``. The improved
71  ``for_request`` method should cover all bases.
72
73* A few page methods have been deprecated. This concerns ``active_children``,
74  ``active_children_in_navigation`` and ``get_siblings_and_self``. The useful
75  bits are already available through Django's own related managers.