plonesocial.microblog

HomePage: http://github.com/cosent/plonesocial.microblog

Author: Guido Stevens

Download: https://pypi.python.org/packages/source/p/plonesocial.microblog/plonesocial.microblog-0.5.3.zip

        .. image:: https://secure.travis-ci.org/cosent/plonesocial.microblog.png
    :target: http://travis-ci.org/cosent/plonesocial.microblog


Introduction
============

Plonesocial.microblog is part of the `plonesocial suite`_.

If you're an integrator or end-user looking for a pre-integrated solution, you should install `plonesocial.suite`_.

This package, plonesocial.microblog, provides a building block for Plone developers who want to create a custom social business solution in Plone.
You normally wouldn't want to modify this unless you know exactly what you're doing.

Credits
-------

|Cosent|_

This package is maintained by Cosent_.

.. _Cosent: http://cosent.nl
.. |Cosent| image:: http://cosent.nl/images/logo-external.png 
                    :alt: Cosent


plonesocial.microblog
=====================

Plonesocial.microblog provides a 'native' Plone microblogging solution that stores status updates in a performance-optimized site utility.

This component provides only the status update form and storage. To display the stored microblog messages, use `plonesocial.activitystream`_ in combination with plonesocial.microblog, or install the full `plonesocial.suite`_.

Plonesocial.microblog provides a microblogging solution for Plone using core content types only, without any external dependencies. It does not require an external service and can be set up and run with a normal Plone buildout configuration.

The intention is to make this native solution as simple and as fast as possible. The current implementation can handle hundreds of new messages per second in a stock Plone installation on outdated hardware. It achieves this by using batched async commits (without using ``plone.app.async``) and by not indexing status updates in ZCatalog. Instead, custom indexes on time, author and tags are provided.


workspaces
----------

This package provides the "Hosts a local microblog" behavior that can be applied to Dexterity content. When applied to an context, it enables microblogging and activitystreams that are local to that context.

You can also use this on Archetypes content by marking an object as providing the IMicroblogContext interface. An example taken from plonesocial.suite::

        # enable local microblog
        directlyProvides(portal.workspace, IMicroblogContext)


upgrades
--------

An upgrade step is provided to add the UUID index introduced in 0.5 to older installations.


bugs
----

Uninstalling either plonesocial.microblog or `plonesocial.network`_ removes both utilities, deleting all data.

Roadmap
-------

An extensive roadmap_ for the plonesocial suite is available on github.

.. _plonesocial suite: https://github.com/cosent/plonesocial.suite
.. _plonesocial.suite: https://github.com/cosent/plonesocial.suite
.. _plonesocial.activitystream: https://github.com/cosent/plonesocial.activitystream
.. _plonesocial.network: https://github.com/cosent/plonesocial.network
.. _roadmap: https://github.com/cosent/plonesocial.suite/wiki



Contributors
============

* Guido Stevens, Author
* Maurits van Rees
* Leonardo J. Caballero G.
* Thomas Desvenain
* Maarten Kling
* Hector Velarde

Changelog
=========

0.5.3 (2014-03-11)
------------------

* Package distribution was fixed by adding classifiers, dependencies and
  fixing license version number as GPLv2; a MANIFEST.in file was also added.
  [hvelarde]

* Brazilian Portuguese translation was added.
  [hvelarde]

0.5.2 (2013-07-31)
------------------

* bump version after having pypi release confusion [gyst]
* use backwardly compatible accessor [gyst]
* trust context=None defaults [gyst]
* French translation [tdesvenain]
* Few fixes on microblog context when we are in subfolders of context [tdesvenain]

0.5.0rc1 (2013-07-04)
---------------------

* update docs [gyst]
* finish IMicroblogContext implementation [gyst]
* provide upgrade step to add uuid mapping on older installed microblog tool [gyst]
* implement IMicroblogContext acquisition and storage for StatusUpdate [gyst, tdesvenain]
* Simplify API to filter on either user or context, but not on both. Cleanup and res