collective.fbshare 0.3.2

Provide some additional Open Graph meta tag in your Plone site, so share items on Facebook will be simpler

Add new meta tags to you Plone site, for better controlling how your items are shared on Facebook.

Table of contents

• Introduction

• Product detail

  • Plone site metas

  • About images

• Coexistence with sc.social.like

• Dependencies

• Similar product

• Credits

• Authors

• Changelog

  • 0.3.2 (2016-04-19)

  • 0.3.1 (2015-02-20)

  • 0.3.0 (2014-01-27)

  • 0.2.1 (2013-07-05)

  • 0.2.0 (2012-11-26)

  • 0.1.0 (2012-07-25)

Introduction

Are you commonly sharing contents from your Plone site or a site page to a Facebook account?

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.

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.

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

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.

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.

Similar product

There’s another Plone package that will give you Open Graph support: collective.opengraph

Credits

Developed with the support of:

• S. Anna Hospital, Ferrara

  

• Regione Emilia Romagna

All of them supports the PloneGov initiative.

Authors

This product was developed by RedTurtle Technology team.

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]

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]

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