====== Twitter Plugin ======

---- plugin ----
description: Show tweets or searches from Twitter (previous author Christoph Lang)
author     : Mark Prins
email      : REMOVE.mprins@users.sf.net
type       : syntax
lastupdate : 2020-11-22
compatible : Angua, "Adora Belle" Weatherwax "Ponder Stibbons", Hrun, detritus, binky,2016-06-26, 2017-02-19, Greebo
depends    : 
conflicts  : 
similar    : 
tags       : embed, listing, users, search, social, twitter, !up_for_adoption, !discontinued
screenshot_img: 

downloadurl: 
bugtracker : 
sourcerepo : https://github.com/mprins/dokuwiki-twitter
donationurl: https://github.com/sponsors/mprins

----

====== Discontinued ======
:!: Since I stopped using this plugin some years back this plugin is up for adoption. Ping me if you're interested in maintaining so I can transfer ownership.

===== Description =====
This syntax will enable users to put tweets and searches from twitter on a page. It uses the media cache thereby bypassing twitter's tracking cookies and complying with EU privacy guidelines.

===== Installation =====
Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

After installation you need to [[https://dev.twitter.com/apps/new|create a Twitter application]] so you can obtain the necessary OAuth credentials (oauth consumer key, oauth consumer secret, oauth token and oauth token secret) which must be entered in the admin page.

===== Purpose =====

If you want to show some tweets from twitter on a DokuWiki page, use this Plugin. The syntax is easy:
<code>
[TWITTER:TYPE:USERNAME/SEARCHWORD:COUNT]
</code>

Replace the following:
  * **TYPE**: Valid options are **USER** and **SEARCH**: USER will show a timeline of a user and SEARCH will search for a given word on twitter.
  * **USERNAME/SEARCHWORD**: The name of the user (in USER mode) or word (in search mode).
  * **COUNT**: The number of tweets to show, when in user mode.

And here are some valid examples:

<code>
//The 5 latest tweets from user schwarzenegger.
[TWITTER:USER:schwarzenegger:5]
//All tweets from user BritneySpears
[TWITTER:USER:BritneySpears]
//Search for the word mj
[TWITTER:SEARCH:mj]
//Search for the word dokuwiki
[TWITTER:SEARCH:dokuwiki]
</code>