silverware / facebook
SilverWare Facebook Module.
Installs: 174
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 1
Open Issues: 0
Type:silverstripe-vendormodule
Requires
- php: >=5.6.0
- silverware/silverware: ^1.0
- silverware/social: ^1.1
README
Provides a Facebook Page Plugin component and sharing button for use with SilverWare.
Contents
Requirements
Installation
Installation is via Composer:
$ composer require silverware/facebook
Configuration
As with all SilverStripe modules, configuration is via YAML. An extension is applied to site configuration which adds a tab for Facebook settings to the SilverWare Services tab.
Facebook App ID
Before the FacebookPagePlugin
component can function, you will first need to create a Facebook App ID using
the Facebook for Developers site. To do this:
- Login to the Facebook for Developers site.
- Click on "My Apps" and then "Add a New App".
- Enter the app display name and contact email.
- Click on the "Create App ID" button.
This will generate a new Facebook App ID. Copy the ID number, and paste it into the "Facebook App ID" field under Settings > SilverWare > Services > Facebook API. Finally, click the "Save" button to store your site settings.
Alternatively, you can enter the Facebook App ID into your YAML configuration files:
SilverWare\Facebook\API\FacebookAPI: app_id: '<paste-id-here>'
Usage
Facebook Page Plugin
This module provides a FacebookPagePlugin
component which can be added to a SilverWare
template or layout using the CMS. For the plugin to work correctly, you will need:
- A valid Facebook App ID (see above).
- The name of your Facebook page.
- The URL of your Facebook page.
Add the component where desired in your template or layout, enter the name of your Facebook page (e.g. "My Company") and the URL of your page on Facebook.
For more information about the Facebook Page Plugin, see the Facebook documentation.
Facebook Sharing Button
Also provided is a FacebookSharingButton
which is used with the SharingComponent
from the SilverWare Social Module. Simply add this button as a child of
SharingComponent
using the site tree, and your pages will now
be able to be shared via Facebook.
For more information, see the Facebook documentation.
Issues
Please use the GitHub issue tracker for bug reports and feature requests.
Contribution
Your contributions are gladly welcomed to help make this project better. Please see contributing for more information.
Maintainers
License
BSD-3-Clause © Praxis Interactive