DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:autotweet

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:autotweet [2012-12-14 21:08] – [Development] 88.181.0.30plugin:autotweet [2018-05-30 20:49] (current) – [Installation] Klap-in
Line 1: Line 1:
-====== autotweet Plugin ======+====== AutoTweet Plugin ======
  
 ---- plugin ---- ---- plugin ----
Line 7: Line 7:
 type       : Action, Syntax type       : Action, Syntax
 lastupdate : 2011-10-06 lastupdate : 2011-10-06
-compatible : 2011-05-25, 2012-01-25+compatible : 2011-05-25, 2012-01-25, 2013-12-08, 2014-05-05
 depends    :  depends    : 
 conflicts  conflicts 
Line 13: Line 13:
 tags       : twitter, changelog, feed tags       : twitter, changelog, feed
  
-downloadurl: http://www.drost-tenfelde.de/lib/exe/fetch.php?media=dokuwiki:plugin_autotweet_1_0.zip+downloadurl: https://github.com/jdtProjects/dokuwiki/raw/master/published/plugin_autotweet_1_0.zip
 bugtracker :  bugtracker : 
-sourcerepo : +sourcerepo : https://github.com/jdtProjects/dokuwiki/tree/master/autotweet
 donationurl: http://www.drost-tenfelde.de/?id=donate donationurl: http://www.drost-tenfelde.de/?id=donate
 +
 +screenshot_img: 
 ---- ----
  
-This plugin automatically posts Tweets to your Twitter via the [[http://oauth.net|oAuth authentication protocol]] when specific pages are changed.+This plugin automatically posts Tweets to your Twitter via the [[https://oauth.net/|oAuth authentication protocol]] when specific pages are changed.
  
-You can specify which page updates are sent, by including the %%~~AUTOTWEET:~~%% syntax in these specific pages.+You can specify which page updates are sent, by including the ''%%~~AUTOTWEET:~~%%'' syntax in these specific pages.
  
 The plugin uses the Abraham Williams <abraham@abrah.am> OAuth for Twitter PHP Library. The plugin uses the Abraham Williams <abraham@abrah.am> OAuth for Twitter PHP Library.
Line 29: Line 31:
 ==== cURL Extension ==== ==== cURL Extension ====
  
-:!: Important :!:\\+:!: Important :!: 
 It is **mandatory** that you have installed the [[phpfn>curl|cURL Extension]] for PHP. It is **mandatory** that you have installed the [[phpfn>curl|cURL Extension]] for PHP.
  
 You can check if the extension is installed using the following code: You can check if the extension is installed using the following code:
  
-<code+<code php>
-<PHP>+
 if ( function_exists('curl_init') ) { if ( function_exists('curl_init') ) {
   echo 'cURL is installed';   echo 'cURL is installed';
Line 42: Line 44:
   echo 'cURL is NOT installed';   echo 'cURL is NOT installed';
 } }
-</PHP> 
 </code> </code>
  
 ==== Twitter App ==== ==== Twitter App ====
  
-The plugin communicates with Twitter using the [[http://oauth.net|oAuth authentication protocol]]. This protocol requires authentication keys that you will get by setting up a Twitter App.+The plugin communicates with Twitter using the [[https://oauth.net/|oAuth authentication protocol]]. This protocol requires authentication keys that you will get by setting up a Twitter App.
  
 === Step 1: Setup Twitter App === === Step 1: Setup Twitter App ===
  
-Head to Twitter and [[https://dev.twitter.com/apps/new|set up an application]].+Head to Twitter and [[https://apps.twitter.com/app/new|set up an application]].
  
 :!: Important :!: Make sure you selected "Read & Write" acces. :!: Important :!: Make sure you selected "Read & Write" acces.
Line 57: Line 58:
 === Step 2: Get the security parameters === === Step 2: Get the security parameters ===
  
-Once you've created your Twitter application [[https://dev.twitter.com/apps|get the parameters for authentication]].+Once you've created your Twitter application [[https://apps.twitter.com/|get the parameters for authentication]].
  
 ^ Parameter  ^ Comments  ^ ^ Parameter  ^ Comments  ^
Line 64: Line 65:
 | 'Access token' | This is displayed in the section **Your access token**. | | 'Access token' | This is displayed in the section **Your access token**. |
 | 'Access token secret' | This is displayed in the section **Your access token**. | | 'Access token secret' | This is displayed in the section **Your access token**. |
-\\+
 These parameters must be used in the [[#configuration_and_settings|configuration]] of the plugin, so that the plugin can communicate with Twitter. These parameters must be used in the [[#configuration_and_settings|configuration]] of the plugin, so that the plugin can communicate with Twitter.
 +
 Optionally, you can use [[#syntax|syntax]] parameters to specify alternate Twitter Apps for specific pages. This, however, is optional. Optionally, you can use [[#syntax|syntax]] parameters to specify alternate Twitter Apps for specific pages. This, however, is optional.
  
 ===== Installation ===== ===== Installation =====
  
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
  
 ===== How it works ===== ===== How it works =====
  
-If you wish to track changes for a specific page, add the %%~~AUTOTWEET:~~%% syntax to that page.+If you wish to track changes for a specific page, add the ''%%~~AUTOTWEET:~~%%'' syntax to that page.
  
-If a page containing the %%~~AUTOTWEET:~~%% syntax is edited, the [[devel:metadata#data_structure|change_log]] information is used to assemble a message, which is then forwarded to the configured Twitter App as a Tweet.+If a page containing the ''%%~~AUTOTWEET:~~%%'' syntax is edited, the [[devel:metadata#data_structure|change_log]] information is used to assemble a message, which is then forwarded to the configured Twitter App as a Tweet.
  
 ===== Examples/Usage ===== ===== Examples/Usage =====
Line 94: Line 96:
 You can use the parameters to overwrite the configuration settings for specific pages. This is not normally necessary. You can use the parameters to overwrite the configuration settings for specific pages. This is not normally necessary.
  
-''%%~~AUTOTWEET:key=value&..key=value~~%%''+<code> 
 +~~AUTOTWEET:key=value&..key=value~~ 
 +</code>
  
-''//key//''    | the parameter key to set | optional | +''key''    | the parameter key to set    | optional  
-''//value//''  | the parameter value to set | optional |+''value''  | the parameter value to set  | optional  |
  
 You can set more than one element at once by using an ''&'' delimiter. You can set more than one element at once by using an ''&'' delimiter.
Line 124: Line 128:
 | message_template | string | Message template that will be filled out and used to send a Tweet to the Twitter App. | **required** | | message_template | string | Message template that will be filled out and used to send a Tweet to the Twitter App. | **required** |
 | date_format | string | [[phpfn>strftime|Date format]] of the {date} field used in the message template. | **required** | | date_format | string | [[phpfn>strftime|Date format]] of the {date} field used in the message template. | **required** |
-\\ 
  
 ===== Message Template ===== ===== Message Template =====
Line 160: Line 163:
  
 === Known Bugs and Issues === === Known Bugs and Issues ===
 +
 +  * **2014-05-27**: Change **twitteroauth.php** from //1// to //1.1// and it works with latest dokuwiki-release //2014-05-05 "Ponder Stibbons"//<code>public $host = "https://api.twitter.com/1.1/";</code>
 +  * **2013-12-28**: Change **twitteroauth.php** from //1// to //1.1// and it works with latest dokuwiki-release //2013-12-08 "Binky"//<code>public $host = "https://api.twitter.com/1.1/";</code>
   * <del>I tried step by step, double check but doesnot work, is there a debug mode somehere?</del>   * <del>I tried step by step, double check but doesnot work, is there a debug mode somehere?</del>
     * It works now (just had to wait a couple of days)     * It works now (just had to wait a couple of days)
 +
 === ToDo/Wish List === === ToDo/Wish List ===
  
Line 167: Line 174:
     * + 1      * + 1 
   * Thanks for this plugin!  I am wondering whether it would be possible to set it up so that rather than tweet from a particular page it tweets from a particular NS.  I imagine this would not be too hard to add in...I may try to do it myself but would probably bumble quite a bit.   * Thanks for this plugin!  I am wondering whether it would be possible to set it up so that rather than tweet from a particular page it tweets from a particular NS.  I imagine this would not be too hard to add in...I may try to do it myself but would probably bumble quite a bit.
 +  * It were great, if tweets only sent, when the checkbox "small changes" is unchecked.
  
 ===== FAQ ===== ===== FAQ =====
  
 ===== Discussion ===== ===== Discussion =====
 +
 +Hello... ¿how can I launch a tweet each time a new page is created?  (I'm configuring a blog, and I need to comunicate new entries in the blog) (%%www.laterriblecorduradelidiota.es%%)
plugin/autotweet.1355515718.txt.gz · Last modified: 2012-12-14 21:08 by 88.181.0.30

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki