collective.ogtags 1.2

OpenGraph for plone4

Introduction

This packages provides Open Graph tags similar to those built in in plone 5. Basically this is an attempt to backport the social media viewlet of plone.app.layout in plone 5 to plone 4.

What is Open Graph

Open Graph is a specification developed by Facebook to provide information about a webpage. This information is used by social media sites to get title, author, description, url, images and more in order to create a marked up link.

Installation

• add collective.ogtags to your eggs and run buildout

• go to the add-ons page in the plone control panel and install collective.ogtags

• If you use custom image fields write an adapter for collective.ogtags.interfaces.IOGTagsImageProvider and your content-type to get this image (optional because collective.ogtags already registers the adapters for generic dexterity and archetype CT searching for “image” and “leadImage” fields)

Settings

Go to the ogtags settings in the plone control panel. Provide as much of the following settings as possible:

• Site name:

  Provide the name of your site here.

• Facebook username:

  Provide your facebook username. You can find this by going to your facebook page. The format is: https://www.facebook.com/<facebook_username>

• Facebook app id:

  Provide your facebook app id. Go to https://developers.facebook.com/apps, choose your app and look for your app id in the description.

• Twitter username:

  Provide your twitter name. The @-sign included, for example: @zestsoftware

• Default image:

  Provide the URL to an image to be used in case no other image can be found. By default this will be /logo.png.

Code, issue tracker

See https://github.com/collective/collective.ogtags

Credits

• Diederik Veeze (Zest Software) is the creator of collective.ogtags.

• Maurits van Rees (Zest Software) is the maintainer of collective.ogtags.

• Jean-Paul Ladage (Zest Software) is another maintainer of collective.ogtags.

• Matteo Parrucci (Bologna university) is a simple contributor of collective.ogtags.

Changelog

1.2 (2017-04-11)

• Added pinterest_id to set a Pinterest verification meta key. You need to apply the upgrade step, otherwise the viewlet shows nothing. You may need to go to the Pinterest website and tell them to verify your site. See https://help.pinterest.com/en/articles/confirm-your-website [maurits]

1.1 (2016-07-14)

• Select image field via adapter. The default adapters work on dexterity and Archetypes content types and return either the image or the leadImage field. [parruc]

1.0.2 (2016-06-24)

• Fixed double escaping of attributes, for example when you have & in a title. Fixes issue #3. [parruc]

1.0.1 (2016-06-01)

• Fixed hidden Unauthorized error when called on a private folder with a published default page. Show the image of the page anyway in this case, instead of showing the fallback image. [maurits]

1.0.0 (2016-06-01)

• Fixed KeyError on traverse. Fixes https://github.com/collective/collective.ogtags/issues/1 [parruc]

• Moved to https://github.com/collective/collective.ogtags. [maurits]

1.0.0rc3 (2016-04-12)

• Add support namedimagefile images. [jladage]

• Update Dutch translations and add missing en translations. [jladage]

1.0.0rc2 (2016-04-08)

• Improved PyPI page. [maurits]

1.0.0rc1 (2016-04-08)

• Support quintagroup.seoptimizer if it is installed and enabled. We use its title, description and canonical url when set. [maurits]

1.0.0b1 (2016-03-21)

• prevent generating duplicate image tags [diederik]

• Documentation [diederik]

• Handle images and leadimages correctly. [jladage]

• Initial release [diederik]