markguinn / silverstripe-fb-like-button
Super simple Silverstripe extension to add Facebook like buttons to pages.
Installs: 211
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 3
Open Issues: 1
Type:silverstripe-module
Requires
This package is not auto-updated.
Last update: 2024-11-06 12:40:59 UTC
README
There are several other Facebook integration modules out there but I didn't find any that were just a really simple like button. This should be super easy to use and it integrates with the OpenGraph module: https://github.com/tractorcow/silverstripe-opengraph.
Requirements
Silverstripe 3.0+
Maintainer
Mark Guinn - markguinn@gmail.com Pull requests welcome.
Installation
Download this module into a folder in the root of your project. Does not require /dev/build.
Usage
The simplest case is to add this to _config/config.yml:
Page:
extensions:
- FBLikeButtonExtension
Then add $FacebookJSSDK
to your main template right after the body tag. Then just add
$LikeButton
anywhere you want one. If you're using the OpenGraph module the app ID will
be pulled from that, otherwise you'll need to set:
FBLikeButtonExtension: application_id: YOURAPPIDHERE
Application ID's can be attained here: https://developers.facebook.com/apps Any changes to the default configuration can be made as follows:
FBLikeButtonExtension: application_id: YOURAPPIDHERE default_button_config: layout: button_count
Using the same attributes found here: http://developers.facebook.com/docs/reference/plugins/like/
Any Page class or subclass can also implement a getFBLikeButtonConfig method to override the default configuration.
Bonus Twitter Support
Twitter support is so easy it doesn't really need it's own module. But you get if for free with
this one. Just add $TwitterShareButton
anywhere in a Page context. It will also work fine
in a list of pages (like a blog or search list).
LICENSE (MIT):
Copyright (c) 2013 Mark Guinn
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.