Introduction
============
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
plone.app.layout 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.
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 <https://github.com/didrix>`_ (Zest Software) is the
creator of collective.ogtags.
* `Maurits van Rees <https://github.com/mauritsvanrees>`_ (Zest Software) is the
maintainer of collective.ogtags.
* `Jean-Paul Ladage <https://github.com/jladage>`_ (Zest Software) is another
maintainer of collective.ogtags.
* `Fred van Dijk <https://github.com/fredvd>`_ (Zest Software) is another
maintainer of collective.ogtags.
* `Matteo Parrucci <https://github.com/parruc>`_ (Bologna university) is a
simple contributor of collective.ogtags.
Changelog
=========
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)
----------------
- 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]