Skip to main content

Social Like is a Plone package providing simple Google+, Twitter and Facebook integration for Plone Content Types

Project description

Life, the Universe, and Everything

This package provides integration for the following social networks in Plone:

  • Facebook

  • Google+

  • LinkedIn

  • Pinterest

  • Telegram

  • Twitter

  • WhatsApp (mobile only)

Mostly Harmless

http://img.shields.io/pypi/v/sc.social.like.svg https://img.shields.io/travis/collective/sc.social.like/master.svg https://img.shields.io/coveralls/collective/sc.social.like/master.svg

Got an idea? Found a bug? Let us know by opening a support ticket.

Don’t Panic

Installation

To enable this product in a buildout-based installation:

  1. Edit your buildout.cfg and add sc.social.like to the list of eggs to install:

    [buildout]
    ...
    eggs =
        sc.social.like

After updating the configuration you need to run ‘’bin/buildout’’, which will take care of updating your system.

Go to the ‘Site Setup’ page in a Plone site and click on the ‘Add-ons’ link.

Check the box next to Social: Like Actions and click the ‘Activate’ button.

Configuration

Go to the ‘Site Setup’ page in the Plone interface and click on the ‘Social Like’ link – under Add-on Configuration.

https://github.com/collective/sc.social.like/raw/master/docs/control-panel.png

The control panel configlet.

There you can configure how Social: Like Actions will behave, which actions will be displayed and for which content types.

Canonical URL and migration to HTTPS

The first time someone shares a link, the Facebook crawler will scrape the HTML code at that URL to gather, cache and display info about the content on Facebook. Facebook uses the og:url tag included in the HTML code to aggregate likes and shares at the same URL rather than spreading across multiple versions of a page. If you move your content around or if you migrate your site schema from HTTP to HTTPS those counters will be zeroed.

To solve this issue this package includes a mechanism to store the URL of the content at publication time to use it as the canonical URL even after renaming or migrating the schema. To enable this feature you must apply the Social Media behavior to your content type and provide the canonical domain (e.g. http://www.example.org) to be used on the site in the control panel configlet.

If you later migrate your site to HTTPS just change the value of the canonical domain (e.g. https://www.example.org). All content created before the change will still reflect the old schema in their canonical url as expected.

The package also includes a helper view to populate content created before release 2.10. You can access this view by pointing your browser at /@@canonical-url-updater.

Privacy and cookies

Social media widgets commonly track user actions and add third party cookies.

If privacy is something you must care about (for instance, if you need to comply with the European Cookie Law), sc.social.like provides a “Do not track users” option. When enabled, social media widgets will be rendered as simple HTML links at the expense of features and user experience.

This product is also respects the Do Not Track user’s browser preference. If the user configured the browser for not being tracked, social media will be rendered as if the “Severe privacy” setting was enabled.

Social media and Plone 5

Plone 5 includes some configuration fields already available in this package on a new Social Media configlet. A synchronization of the values of those redundant fields takes place behind the scenes every time you change the Twitter username, the Facebook App ID or the Facebook username, using either the new Social Media configlet or the Social Like configlet.

https://github.com/collective/sc.social.like/raw/master/docs/social-media-configlet.png

The Social Media configlet in Plone 5.

Screenshots

https://github.com/collective/sc.social.like/raw/master/docs/screenshot1.png https://github.com/collective/sc.social.like/raw/master/docs/screenshot2.png

Tiles

If collective.cover is installed, two new tiles will be available: Facebook and Twitter.

The Facebook tile embeds a Facebook Page. You can set the width and height, and you can control some other aspects of the widget. A Facebook application ID must be defined in the Social Like configlet in order to use this tile.

The Twitter tile embeds a Twitter timeline. Timelines are an easy way to embed multiple tweets on your website in a compact, single-column view. You can set the width, height and tweet limit, and you can use a widget ID. A Twitter username must be defined in the Social Like configlet in order to use this tile.

https://github.com/collective/sc.social.like/raw/master/docs/tiles.png

The Twitter and Facebook tiles.

TODO:

  • [ ] Facebook: return a comma-separated string of tabs to render

  • [ ] Twitter: allow to remove a display component of a timeline (chrome)

  • [ ] Twitter: refresh the tile after editing it

  • [ ] RobotFramework tests for both tiles

Share and Enjoy

sc.social.like would not have been possible without the contribution of the following people:

  • Cleber J. Santos (idea and implementation)

  • André Nogueira

  • Héctor Velarde

  • Erico Andrei

  • Mikel Larreategi

  • Rodrigo Ferreira de Souza

  • Luciano Camargo Cruz

  • Thomas Desvenain

  • Font Awesome (icons)

Development sponsored by:

Changelog

There’s a frood who really knows where his towel is.

2.10 (2017-07-17)

  • Fix support for canonical URL in Facebook’s Open Graph for Dexterity-based content types; previously the current URL was incorrectly used as the canonical URL of an item leading to zeroed counters when moving content around or when changing the schema to access the site (HTTP to HTTPS). Check package documentation for more information on how to use this new feature (fixes #104). [hvelarde]

  • Drop support for Plone 4.2. [rodfersou]

  • In Plone 5, keep in sync some redundant fields found in the new Social Media configlet. Changes on facebook_app_id, facebook_username, or twitter_username fields will be reflected in both configlets (fixes #100). [hvelarde]

2.9 (2017-03-09)

  • Add Facebook control panel setting for showing/hiding the number of likes. By default the Facebook plugin still shows the likes. [fredvd]

2.8b1 (2017-02-03)

  • Update Brazilian Portuguese and Spanish translations. [hvelarde]

  • Add support to share content by email (closes #91). [rodfersou, hvelarde]

2.7b1 (2017-01-09)

  • Add missing upgrade step to cook CSS resources. [hvelarde]

  • Don’t fail in the Twitter plugin if the title has non-ASCII characters. [csenger, hvelarde]

  • Add metadata for Twitter Cards (closes #65). [rodfersou]

2.6b1 (2016-12-21)

  • Code clean up; tests related with loading BMP images were removed as make no sense. [hvelarde]

  • Do not show social like viewlet for unpublished content (closes #83). [rodfersou]

  • Fix package dependencies. [maurits, hvelarde]

2.6a1 (2016-09-23)

  • Add Facebook and Twitter tiles for collective.cover. The Facebook tile embeds a Facebook Page. The Twitter tile embeds a Twitter timeline. [hvelarde]

  • Add title attributes to Telegram and WhatsApp share links. [hvelarde]

  • Enforce constraints on enabled_portal_types field to avoid WrongType error while running upgrade step to v3040. [hvelarde]

  • Do not fail on adding Facebook’s ‘Like’ button while running upgrade step to v3010. [fredvd, hvelarde]

2.5 (2016-07-26)

  • Added Telegram plugin (closes #52). [rodfersou]

  • Use Plone’s registry instead of the portal_properties tool to store package configuration (closes #1). [hvelarde]

2.4.1 (2015-12-10)

  • Update package classifiers; Plone 5 was included by mistake in the list of supported versions. [hvelarde]

  • Use “application/javascript” media type instead of the obsolete “text/javascript”. [hvelarde]

2.4 (2015-09-17)

  • Drop explicit support for Plone 4.1 and Python 2.6; package should work, but we are not testing anymore with those versions so compatibility is not guaranteed. [hvelarde]

  • Fix caching issues with WhatsApp button by moving mobile detection client-side (closes #56). [rodfersou]

  • Add Dutch translations. [fredvd]

  • Fix uninstall error. [bsuttor]

2.3 (2015-07-14)

  • Added the “Do not track users” configuration option, to prevent social networks from sending cookies to site’s visitors. This will replace social badges with simple links. [keul]

  • Added German translations. [tohafi]

2.2 (2015-05-04)

  • Added WhatsApp plugin (closes #39). [rodfersou]

2.1 (2015-03-02)

  • Translations to Brazilian Portuguese and Spanish were updated. [hvelarde]

  • Removed deprecated portal_actionicons registration [keul]

  • Translation fixes: some label were not translated [keul]

  • Facebook “Share” button now provided. See #15. [keul]

  • Added missing migration step for refreshing CSS registry [keul]

2.0.2 (2015-02-23)

  • Removed old Facebook specific CSS rule that truncate the new Facebook widget. This close #38. [keul]

2.0.1 (2015-02-23)

  • Nothing changed (brown bag release).

2.0 (2015-02-10)

  • Do not load social media stuff on non-canonical views (like edit form or similar). This close #36. [keul]

  • Added italian translation. [keul]

  • Load behavior of all social plugins changed to be async. [keul]

  • Fixed a problem with images loaded in news. If the image isn’t a JPG, the get_content_image method can’t get image size and returns nothing. This avoid some strange things, like MemoryError with Pillow. [cekk]

  • If a field named “image” isn’t an ImageField, do not break the viewlet. [cekk]

  • Add exception handling also for TypeError in get_content_image method. [cekk]

  • Fixed metadata og:type, used value ‘article’ for internal page. [fdelia]

2.0rc1 (2014-10-14)

  • Use safe_unicode to deal with accented chars in content Title. [ericof]

2.0b4 (2014-08-08)

  • Fixed styling for action buttons. Now they are displayed side by side [agnogueira]

  • Fix an UnicodeDecodeError in the Twitter plugin (Reported by Programa Interlegis) [ericof]

2.0b3 (2014-06-06)

  • Fix a division by zero issue happening with AT Images during creation (while on portal_factory) [ericof]

2.0b2 (2014-06-02)

  • Facebook now recommends 1200 x 630 images [ericof]

2.0b1 (2014-02-07)

  • Use View permission on viewlets to avoid security failures into viewlet if anonymous try to display non public parts of site. [thomasdesvenain]

  • Fix package dependencies. [hvelarde]

2.0a2 (2013-11-04)

2.0a1 (2013-07-23)

Previous entries can be found in the HISTORY.rst file.

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

sc.social.like-2.10.tar.gz (464.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