Twitter Pull 7.x-1.0-rc1

Twitter Pull is a small module, the only purpose of which is to allow super-easy embedding of public twitter data like: a user timeline or twitter search results by hashtag or a search term. The emphasis is on making these very specific tasks as easy and straightforward as possible. The purpose of the module is not to be an end-all solution for Twitter.Intended AudienceThe intended audience of the module are developers and designers.UsageThere're no authentication information or API Keys required. Module only interacts with non-auth APIs. In the end, it all boils down to a single function:twitter_pull_render ($twitkey, $title = NULL, $num_items = NULL, $themekey = NULL)ARGUMENTS: * @param $twitkey Twitter key, which can be a username (prepended with @) a hashtag (prepended with #) or a search keyword (no prefix) * @param $title title passed to tpl.php. If you want title to be disabled, pass boolean False. * @param $num_items maximum number of tweets to pull from the Twitter result-set. Can't be more than 20. * @param $themekey Drupal theme key-name to use for theming the output of the Twitter response. Allows providing different tpl.php's for different use-cases. The default is: twitter_pull_listing, which corresponds to a fully-themed twitter-pull-listing.tpl.php in module folder. Please note that underscores become dashes in the TPL name and you may not use dashes in the key name. The tpl.php can be copied to a theme folder for further customization or modified via CSS. ExamplesThe following code will print a nicely themed list of the latest 10 tweets from OpenPublish:ThemingIf you decide to use a custom theme_key, you will have to register it with a hook_theme in a module. Unfortunately, there's not a good way for this module to do it. You should use code like following:function yourmodule_theme() {dlT dlT return array(dlT dlT dlT dlT 'your_custom_theme_key' => array(dlT dlT dlT dlT dlT dlT 'arguments' => array('tweets' => NULL, 'twitkey' => NULL, 'title' => NULL),dlT dlT dlT dlT dlT dlT 'template' => 'your-custom-theme-key'dlT dlT dlT dlT ),dlT dlT );}PerformanceOutput is extensively cached. Default cache period is 20 minutes, but it can be overridden via configuration variables.What About Twitter Module?Twitter module is a much more generic solution to Twitter integration in Drupal. Twitter Pull has a more specific goal, which it achieves in simpler, more focused way, is very lightweight, and provides advanced theming and caching, as well as support to Twitter Search API.At some point the two modules could possibly merge, but at this point they don't really have much in common, except that they both do "something" with Twitter. Things they do are not identical.How do I use this with Panels, Context etc.?If you need more flexibility than just printing-out tweet list in a template file, you should write a quick glue module implementing hook_block() according to your specific application logic and calling the twitter_pull_render() function from the hook.

Requirements:	No special requirements
Platforms:	PHP
Keyword:	Dashes,  Drupal,  Folder,  Module,  Num Items,  Param,  Prepended,  Print,  Purpose,  Search,  Solution,  Specific,  Theme,  Theming,  Title,  Tweets,  Twitter
Users rating:	0/10