Questions answered by this recipe
How can I display a specific tweet in my page?
Enter your recipe's description here. EmbedTweet provides a short form markup that permits users to pull in a specific tweet specified by the twitter status id and format it as it appears in twitter.
Add the following lines to your
To use, simply include the following in your wiki page text:
[tweet id=<status id of tweet>]
Alternately, you can use the URL of the particular status:
[tweet url=https://twitter.com/<user>/status/<status code>]
Both of these can be obtained for a tweet on the twitter web site by clicking on the "Expand" link in the tweet, then on "Embed this Tweet" and selecting Link tab. The status id is the last string of digits in the path. If you choose to url method, use the entire link shown.
Additional parameters are described on the API document at https://dev.twitter.com/docs/api/1/get/statuses/oembed but note that the omit_script parameter is always set to true and the script is linked in the html footer automatically by the recipe.
For future-proofing, there are two customizable variables that deal with the functionality provided by twitter.
- is the url of API call that returns the contents of the tweet desired.
- is the HTML that will include the widget script from twitter in the page footer.
Neither of these should be set or changed unless the twitter API changes.
- Provide a means of saving the tweet instead of fetching it each time. This will also prevent losing the tweet in the case it disappears from twitter, or twitter is inaccessible for some reason.
- Some twitter feeds are inaccessible by outside sources, unless the caller is an authenticated user, and is allowed to view the tweet. Currently, there is nothing in twitter's oembed API that can get around this.
The recipe is maintained at the following Gitorious repository: https://gitorious.org/pmwikistuff/embedtweet
Change log / Release notes
If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".
See discussion at EmbedTweet-Talk