Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/edwinm/twitterfetch
[obsolete] Fetches your latest tweets from your website, no server scripts needed
https://github.com/edwinm/twitterfetch
javascript twitter twitter-widget
Last synced: 29 days ago
JSON representation
[obsolete] Fetches your latest tweets from your website, no server scripts needed
- Host: GitHub
- URL: https://github.com/edwinm/twitterfetch
- Owner: edwinm
- License: mit
- Created: 2016-04-17T14:06:42.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2017-09-10T13:13:33.000Z (over 7 years ago)
- Last Synced: 2024-04-23T19:38:16.572Z (9 months ago)
- Topics: javascript, twitter, twitter-widget
- Language: JavaScript
- Homepage:
- Size: 9.77 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# twitterFetch
Fetches your latest tweets
_twitterFetch shows your latest tweets on your website._
:warning: **Warning: Twitter switched to iframes to embed Twitter widgets and disabled fetching the feed from JavaScript.
This means twitterFetch is no longer working! This repository is only for informational purposes.** :warning:
Twitter already offers two options to show your tweets on your website:
1. [Using a Twitter widget](https://dev.twitter.com/web/overview)
2. [Using the Twitter REST API](https://dev.twitter.com/rest/public)
They are fully supported by Twitter and might be the best solution for you.
Disadvantages are:
1. Limited layout possibilities (widget).
2. Cookies are send to Twitter, which, without warning, might be illegal in your jurisdiction (widget).
3. Page load (widget).
4. Needs server side scripting (api).
TwitterFetch provides a solution without these disadvantages. It fetches the Twitter widget (without sending
cookies) and makes the tweets available in JavaScript, to be placed on a webpage the way you want.
Less than 2kB, twitterFetch is also very lightweight.
TwitterFetch uses unsupported Twitter functionality, so there's no guarantee of continuity.
## Quickstart
Start by downloading [twitterfetch.js](twitterfetch.js) to you server and including it in your web page.
```html
```
In your HTML, make sure you have a place to show the tweets:
```html
<div id="tweets"></div>
```
Now, use twitterFetch to fetch the tweets and show the first one:
```javascript
twitterFetch.fetch('345615146724495360', {}, function (tweets) {
if (!tweets || tweets.length == 0) {
return;
}
document.getElementById('tweets').innerHTML = tweets[0];
});
```
But don't use the widget id 345615146724495360, that belongs to my [@edwinmdev](https://twitter.com/edwinmdev) Twitter account.
## How to make your own widget id?
Create a [Twitter widget](https://twitter.com/settings/widgets/new) and look at the generated code.
You'll find data-widget-id="..." with the number you can use.
## API
The twitterFetch fetch function takes three parameters:
```javascript
twitterFetch.fetch(widgetId, options, callbackFunction);
```
### widgetId
The widget id you get when creating a widget, see above.
### options
An object literal with several options:
**images** (boolean): when false, prevents loading images that are not needed (default: false).
**plaintext** (boolean): when false, encodes some entities to make the text safe for HTML (default: false).
**hyperlinks** (boolean): when true, turns urls and Twitter @usernames into hyperlinks (default: true).
Example:
```javascript
{
images: false,
plaintext: true
}
```
### callbackFunction
The function that is called back with one argument containing an array with tweets.
## License
TwitterFetch is copyright 2016 Edwin Martin and MIT licensed.