collective.fbshareProvide some additional Open Graph meta tag in your Plone site, so share items on Facebook will be simplerAdd new meta tags to you Plone site, for better controlling how your items are **shared on Facebook**.
.. contents:: **Table of contents**
Introduction
============
Are you commonly sharing contents from your Plone site or a site page to a `Facebook`__ account?
__ http://www.facebook.com/
When you use the nice Facebook sharing interface, you have a simple way to customize additional data for the item
that will be published (mainly: choose a proper image from the remote page).
However when trying to do this automatically (e.g: you are publishing the link in a `Twitter`__ account that also
feed a Facebook page) Facebook is choosing an image for you... and often this is not the image you want.
__ http://twitter.com/
How can you solve this? In general you can provide some additional ``meta`` tag information using
`Open Graph standard`__, customizing many aspect of the way of sharing contents on Facebook.
__ http://developers.facebook.com/docs/opengraph/
Product detail
==============
Installing *collective.fbshare* product and add some additional ``meta`` tags in the *head* section of your site.
Plone site metas
----------------
When sharing the site root, you'll get:
``og:type``
Always ``website``
``og:url``
The URL to the site
``og:image``
See next section
``og:title``
The name of the site
``og:description``
The description of the site
When sharing site content's you'll get:
``og:type``
Always ``article``
``og:url``
The URL to the content
``og:site_name``
The name of the Plone site
``og:image``
See next section
``og:title``
The title of the content
``og:description``
The description of the content
``article:published_time``
The publication date of the content (when present)
``article:expiration_time``
The expiration date of the content (when present)
``article:author``
A link to the creator's page. This will be used only when you choose to display
the *about* info of site user's
``article:tag``
List of content tags
About images
------------
In the site control panel you can access a new configuration panel named "*Open Graph sharing settings*".
From there you can:
* provide a custom image content to be used as ``og:image``
* choose to use the site's logo as ``og:image``
* enable support for content images, this mean that content types with image field will be able to
provide that image instead of a global ones.
Also supported `collective.contentleadimage`__
__ http://plone.org/products/content-lead-image/
Coexistence with sc.social.like
===============================
Another very common plugin that add ``meta`` tag in Plone Pages is `sc.social.like`__.
As adding duplicate meta tag is reported as an error by Facebook verification, *collective.fbshare* will
hide some of the *sc.social.like* HTML elements when both products are installed.
__ http://plone.org/products/sc.social.like
Dependencies
============
Tested on:
* Plone 3.3
* Plone 4.2
* Plone 4.3
On Plone 3.3 you need to configure properly `plone.app.registry`__ dependencies and upgrade
the default version used of `plone.z3cform`__.
__ http://pypi.python.org/pypi/plone.app.registry
__ http://pypi.python.org/pypi/plone.z3cform
Similar product
===============
There's another Plone package: that will give you Open Graph support: `collective.opengraph`__
__ http://plone.org/products/collective.opengraph
Credits
=======
Developed with the support of:
* `S. Anna Hospital, Ferrara`__
.. image:: http://www.ospfe.it/ospfe-logo.jpg
:alt: S. Anna Hospital logo
* `Regione Emilia Romagna`__
All of them supports the `PloneGov initiative`__.
__ http://www.ospfe.it/
__ http://www.regione.emilia-romagna.it/
__ http://www.plonegov.it/
Authors
=======
This product was developed by RedTurtle Technology team.
.. image:: http://www.redturtle.it/redturtle_banner.png
:alt: RedTurtle Technology Site
:target: http://www.redturtle.it/
Changelog
=========
0.3.0 (2014-01-27)
------------------
- Dexterity content type support [keul]
- Display also the modified time if security site say so [keul]
- Coexistence with *sc.social.like* [keul]
- Properly handle ``article:tag`` as array [keul]
0.2.1 (2013-07-05)
------------------
- When visiting a folderish content refers to folder URL, not default
page URL (close `#2`__) [jnachtigall]
__ https://github.com/RedTurtle/collective.fbshare/pull/2
0.2.0 (2012-11-26)
------------------
- Use of site logo feature for ``og:image`` was broken
[keul]
- i18n fixes
[keul]
- added support for content's own image (also with support for *collective.contentleadimage*)
[keul]
0.1.0 (2012-07-25)
------------------
- Initial releaseRedTurtle Technology32bd2ea73dfddb5ce47e04ac9d20f61018785be40.3.0