collective.blogging 1.0-rc3

About
============

Yet another blogging tool for Plone. Blogging package provides simple extension for Plone
to make blogging easier with as little as possible modifications or extra content.
But still use as much as possible from Plone's default UI to let user's get familiar
with extra blogging features in a while.

Installing
============

This package requires Plone 3.x or later (tested on 3.3.x and 4.0b2).

Installing without buildout
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Install this package in either your system path packages or in the lib/python
directory of your Zope instance. You can do this using either easy_install or
via the setup.py script.

Installing with buildout
~~~~~~~~~~~~~~~~~~~~~~~~

If you are using `buildout`_ to manage your instance installing
collective.blogging is even simpler. You can install
collective.blogging by adding it to the eggs line for your instance::

[instance]
eggs = collective.blogging

After updating the configuration you need to run the ''bin/buildout'', which
will take care of updating your system.

.. _buildout: http://pypi.python.org/pypi/zc.buildout

Usage
=====

So, let's say that in most cases when you want to start simple personal blog,
default Plone installation without any extra add-ons provides almost all you need.
For example you can create Folder / Large Plone Folder for blog posts, Smart Folder
as site frontpage with criteria to search contents of the blog folder and then you
can start blogging by creating News Items in the blog folder.

Yes that's fine but after while you end up with thinking about better blog view
template because folder summary view doesn't provide some extra info about listed
News Items like number of comments, permalink etc.

And that's why the Blogging package was created and hopefully will save your time
in case you don't need complex blogging tool but still want a blog.

Features
========

- Creating blog(s) from Plone Folders

- Posting Plone's Pages, News Items, Events, Files, Images, Links and External Videos (or other embed
content)

- Smart folders supported

- Fancy image galleries

- Simple archive toolbar (filter by category, year, month)

- Archive portlet (lists entry numbers in years and months)

- Helper blog portlet

- Next / Prev navigation replacement

- Auto-blogging action for content rules

- Google maps integration with events via collective.bloggingmaps extra-extension

- Safe uninstall

Translations
============

- English (default): lzdych (lukas dot zdych at gmail dot com)

- Czech: lzdych (lukas dot zdych at gmail dot com)

- Italian: Enzo Cesanelli (luthy)

- Portuguese: Davi Lima (davilima6)

- Dutch: Rob Gietema (robgietema)

- Japanese: Yusuke NAKAI (nyusuke at nagosui dot org)

New translations or help with correction of an existing ones would be appreciated.

Examples
========

Here are sites where the blogging tool is already in production use.

- lukaszdych.net_

.. _lukaszdych.net: http://lukaszdych.net

- blog.horovi.com_

.. _blog.horovi.com: http://blog.horovi.com

Copyright and Credits
=====================

collective.blogging is licensed under the GPL. See LICENSE.txt for details.

Author: `Lukas Zdych (lzdych)`__.

.. _lzdych: mailto:lukas.zdych@gmail.com

__ lzdych_

Thanks to Enzo Cesanelli (luthy) for testing and ideas.

Homepage: collective.blogging_.

.. _collective.blogging: http://plone.org/products/collective.blogging


Changelog
=========

1.0rc3 (2010-04-26)
~~~~~~~~~~~~~~~~~~~

- Changed batch_size field UI from a selection widget to a more flexible
entry field. Also helps to avoid a problem with the handling of integer
vocabularies for the selection widget. [newbery]
- Fixed error in filtering per month.
Hopefully fixes http://plone.org/products/collective.blogging/issues/3
[maurits]
- blog entry author's link can now optionally target to any referencable object instead of default
author's page [lzdych]
- added Japanese translation by Yusuke Nakai [lzdych]
- cache interval for the filter toolbar dropdowns configurable in the blog (folder) settings [lzdych]

1.0rc2 (2010-02-24)
~~~~~~~~~~~~~~~~~~~

- made entry's document byline block easier to customize in the blog view [lzdych]
- updated i18n and czech translation [lzdych]

1.0rc1 (2010-02-16)
~~~~~~~~~~~~~~~~~~~

- added blogger's name field to blog entry's schemata [lzdych]
- updated czech translation [lzdych]
- cleaned up translation from blogging help page mess, so user's guide is no more translatable and will
be replaced by online documentation in final version [lzdych]
- added new blog option which enables blogger to set max. length of entry's description displayed in
non-full blog view [lzdych]
- auto-blogging content rule now can (optionally) enable blogging, comments, exclude from nav
[lzdych]
- added new richtext field to blogs (hidden if blog content already has "text" field) [lzdych]
- added patch fixing reply counts if discussion moderation is enabled via quintagroup.plonecomments
[lzdych]
- updated portuguese translation [davilima6]
- Plone 3.2 compatibility [naro]

1.0b4 (2010-01-09)
~~~~~~~~~~~~~~~~~~

- fixed unindexed blogging content by package reinstallation [lzdych]
- blog link from manage portlet excluded in the blog context [lzdych]
- blogging permission is now acquired by default [lzdych]
- unified entry rendering in blog and entry view [lzdych]
- moved blog and entry view snippets into separated macros [lzdych]
- added pictures folder reference to manage blog portlet [lzdych]
- enabled text contents of smart folders in blog view (if nonempty) [lzdych]
- fixed i18n markup for read more link [lzdych]
- added share entry portlet [lzdych]
- blog filter toolbar options now reflects blog contents [lzdych]
- blog now can show number of posts in it [lzdych]
- added dutch translation [robgietema]
- updated italian translation [luthy]
- added portuguese translation [davilima6]

1.0b3 (2009-12-06)
~~~~~~~~~~~~~~~~~~

- removed thumbnail layout replacement for blog galleries - fixes: package reinstall removes blog
gallery layouts [lzdych]
- updated user's guide, i18n and czech translateion [lzdych]
- news item image box moved above entry description so it floats next to it [lzdych]
- permalink moved to document by line area [lzdych]
- added read more link to entry footer in the blog view (not for editors) [lzdych]
- new blog option available to enable / disable entry's text body rendering in the blog view [lzdych]

1.0b2 (2009-12-06)
~~~~~~~~~~~~~~~~~~

- blog view and next / prev navigation now uses EffectiveDate rather then Date sort criterion [lzdych]
- added uninstall profile (wired up with QI) [lzdych]
- next / prev navigation always enabled for blogs based on Large Folders [lzdych]
- unified entry documentbyline and keywords info and added entry footer panel to its detail [lzdych]
- fixed broken news item based entry's layout by non-closed div element of fancy box [lzdych]
- enabled blogging for ATBlog based content - makes image and file posting available in plone 4
[lzdych]
- fixed broken browser views in plone 4 by obsolete global variables usage [lzdych]
- content rule action registered for all events - fixes: zope won't start with plone4 [lzdych]
- updated i18n and czech translation [lzdych]
- removed enforce vocabulary check for blog's batch_size field - fixes: can't translate bloggable content
[lzdych]

1.0b1 (2009-12-03)
~~~~~~~~~~~~~~~~~~

- updated user's guide [lzdych]
- disallow javascript resource merging - fixes: Gallery view doesn't work for anonymous sometimes
[lzdych]
- updated i18n and czech translation [lzdych]
- refactored blog content markup by removing individual content type markup interfaces and added
upgrade step, also fixes: missing NewsItem's title image in blog and entry view [lzdych]
- schema extenders made browser layer specific using new blogging layer [lzdych]
- browser views and static resources now hangs on new blogging specific browser layer [lzdych]
- added edit link to the entry snippet footer in the blog view [lzdych]
- extended manage blog portlet's settings by optional reference to user defined drafts link [lzdych]
- added blog archive portlet (requires publish_year and publilsh_month catalog reindex) [lzdych]
- improved browser views to enable maps to be hidden if not used [lzdych]
- removed empty entry description element if no description available [lzdych]
- added initial italian translation [luthy]

1.0a2 (2009-11-22)
~~~~~~~~~~~~~~~~~~

- updated user's guide [lzdych]
- added TTW configuration for blog view (batch size, enable toolbar) [lzdych]
- blog related fields moved to new schemata fieldset "blog" [lzdych]
- added content rules action for to enable content auto-blogging [lzdych]
- added support for bloggingmaps extension [lzdych]
- named schema extenders to avoid adaptation conflicts [lzdych]
- added support for event based blog entries [lzdych]
- unified position of entry description in blog and entry views [lzdych]
- fixed duplicated appearance of manage portlet and missing default english labels in multilingual sites
[lzdych]
- remote_url made hidden in the entry and blog view if content has default value http:// [lzdych]
- portlet's link are now generated from selected addable types in its settings [lzdych]
- the blog view now renders related items of listed entries (if available) [lzdych]
- updated czech translation (most of the user's guide still not translated) [lzdych]


1.0a1 (2009-11-17)
~~~~~~~~~~~~~~~~~~

- Initial release