collective.fbshare

Add 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.2 (2016-04-19)

• Fixes for Plone 5.0 (handle missing portal_properties props and unset lead images) [alecm]

0.3.1 (2015-02-20)

• Updated metadata from sc.social.like with latests changes from version 2.0 (matters only when used). This close #7__ [keul]

__ https://github.com/RedTurtle/collective.fbshare/issues/7

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 release