purplespider / twitter-feed
Inserts a custom styled Twitter feed on any SilverStripe page, uses Twitter API v1.1
Installs: 120
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 4
Forks: 1
Open Issues: 0
Type:silverstripe-module
Requires
- silverstripe/cms: ~3.1
- silverstripe/framework: ~3.1
This package is auto-updated.
Last update: 2024-10-16 16:58:13 UTC
README
Introduction
Allows you to add a custom styled Twitter feed to any page on your SilverStripe website.
The module uses the new Twitter v1.1 API to grab a specified number of tweets from a specified user, allowing you to output them to custom HTML in a template.
Maintainer Contact
- James Cocker (ssmodulesgithub@pswd.biz)
Requirements
- Silverstripe 3.1+
Installation Instructions
-
Add the twitter-feed directory to the root of your SS install.
-
Go to https://dev.twitter.com/apps and Create a new application. Then click Create my access token, you'll then have a key, a token, and a secret for each.
-
Add the following lines to your _config.php:
// Allows you to have a Twitter feed on any page. Object::add_extension('Page', 'TwitterFeed'); // Fill in the following from your Twitter Application: TwitterFeed::set_consumer_key('XXXXX'); TwitterFeed::set_consumer_secret('XXXXX'); TwitterFeed::set_user_token('XXXXX'); TwitterFeed::set_user_secret('XXXXX'); TwitterFeed::set_username('twitter'); // The Twitter username to get the feed from TwitterFeed::set_tweetcount('4'); // The max number of tweets to display
-
Use the included TwitterFeed.ss as an example for creating your HTML for the template. Important: This basic example is designed to be used as a starting point, and does not meet Twitter's new strict Developer Display Requirements: https://dev.twitter.com/terms/display-requirements Please make sure the way you display the Twitter feed meets these requirments or your Twitter app may be banned.
Acknowledgments
Thanks to Matt Bailey's SilverStripe Widget: https://github.com/matt-bailey/
And Matt Harris's Twitter OAuth Library: https://github.com/themattharris/tmhOAuth