Skip to main content

OpenGraph for plone5

Project description


This packages provides Open Graph tags similar to those built in in plone 5. Basically this started as a backport the social media viewlet of in plone 5 to plone 4. However, in Plone 5.X still misses some extra features and fixes from collective.ogtags, so v2 of collective.ogtags has been made compatible with Plone 5.

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.


  • 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)


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:<facebook_username>

  • Facebook app id:

    Provide your facebook app id. Go to, 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



  • 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.

  • Fred van Dijk (Zest Software) is another maintainer of collective.ogtags.

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


2.0.4 (unreleased)

  • Nothing changed yet.

2.0.3 (2021-10-27)

  • Catch TypeError excpetion on image scale creation for ogtags for real, used wrong KeyError. [fredvd]

2.0.2 (2021-10-26)

  • Catch TypeError when generating image scales from an empty DX image field that was added to the CT schema later. [fredvd]

  • Fix uninstall profile title. [fredvd]

  • Support for collective.behavior.seo title/description is optional now (conditional Python import). [fredvd]

  • Remove support for quintagroup.seooptimizer, this is plone 5.1+ only. [fredvd]

2.0.1 (2018-11-16)

  • Update README and pypi classifier, collective.ogtags 2.X is for Plone 5.1 [fredvd]

  • Allow Site Administrators to change OGTags in the control panel. Extra permission and upgrade step. [fredvd]

2.0.0 (2018-10-29)

  • Plone 5.1 compatibility. Use 1.x branch for Plone 4. [jladage]

1.2 (2017-04-11)

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)

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]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collective.ogtags-2.0.4.dev0.tar.gz (20.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page