dmWidgetTwitterPlugin

• In a console, from your project root dir, run:

git clone git://github.com/ornicar/dmWidgetTwitterPlugin.git plugins/dmWidgetTwitterPlugin  

• In config/ProjectConfiguration.class.php, add dmWidgetTwitterPlugin to the list of enabled plugins:

class ProjectConfiguration extends dmProjectConfiguration
{  
  public function setup()  
  {  
    parent::setup();  
 
    $this->enablePlugins(array(  
      // your enabled plugins  
      'dmWidgetTwitterPlugin'  
    ));  

• In a console, from your project root dir, run:

php symfony dm:setup  

Twitter search widget

This widget uses twitter API to search public tweets with keywords, and display them on the page.
To use it, just drag & drop a Twitter/Search widget somewhere on your site.
See it in action on Diem community page.

Options

Configure the widget on the widget edition dialog:
- query Search query to filter tweets with. You can use simple or complex queries. To get help creating complex queries, use the twitter advanced search form.
- nb_tweets Number of tweets to display.
- life_time Duration of the cache in seconds.

Customize the template

Copy
plugins/dmWidgetTwitterPlugin/modules/dmWidget/templates/_dmWidgetTwitterSearch.php
to
apps/front/modules/dmWidget/templates/_dmWidgetTwitterSearch.php
then modify it.

Default template:

use_helper('Text');
 
/*  
 * A $tweet is an array containing:  
 * - from_user:   username of the one who posted the tweet  
 * - text:        text of the tweet  
 * - created_at:  when the tweet was posted, timestamp  
 */  
 
echo _open('ul');  
 
foreach($tweets as $tweet)  
{  
  echo _tag('li',  
 
    // link to the user page on twitter  
    _link('http://twitter.com/'.$tweet['from_user'])  
    ->text($tweet['from_user'])  
    ->set('.tweet_from_user').  
 
    // render tweet text  
    _tag('p.tweet_text', auto_link_text($tweet['text']))  
 
  );  
}  
 
echo _close('ul');  

This template uses Diem template helpers

Filter tweets with an event

You can modify the list of found tweets before they are displayed by listening the dm.widget_twitter_search.tweets event.

apps/front/frontConfiguration.class.php

class frontConfiguration extends dmFrontApplicationConfiguration
{  
 
  public function configure()  
  {  
    // connect to the dm.widget_twitter_search.tweets event  
    $this->dispatcher->connect('dm.widget_twitter_search.tweets', array($this, 'listenToTwitterSearchTweetsEvent'));  
  }  
 
  public function listenToTwitterSearchTweetsEvent(sfEvent $e, array $tweets)  
  {  
    // do something with the tweets  
    ...  
    // return the filtered tweets  
    return $tweets;  
  }  

Twitter timeline widget

This widget uses twitter API to find tweets from a user, and display them on the page.
To use it, just drag & drop a Twitter/Timeline widget somewhere on your site.
See it in action on Diem homepage.

Options

Configure the widget on the widget edition dialog:
- user Twitter username (Ex: diem_project).
- nb_tweets Number of tweets to display.
- life_time Duration of the cache in seconds.

Customize the template

Copy
plugins/dmWidgetTwitterPlugin/modules/dmWidget/templates/_dmWidgetTwitterTimeline.php
to
apps/front/modules/dmWidget/templates/_dmWidgetTwitterTimeline.php
then modify it.

Default template:

use_helper('Text');
use_helper('Date');  
 
/*  
 * A $tweet is an array containing:  
 * - text:        text of the tweet  
 * - created_at:  when the tweet was posted, timestamp  
 */  
 
echo _open('ul');  
 
foreach($tweets as $tweet)  
{  
  echo _tag('li',  
 
    // render tweet text  
    _tag('p.tweet_text', auto_link_text($tweet['text'])).  
 
    // render tweet date  
    _tag('p.tweet_date', format_date($tweet['created_at'], 'D'))  
 
  );  
}  
 
echo _close('ul');  

This template uses Diem template helpers

Filter tweets with an event

You can modify the list of found tweets before they are displayed by listening the dm.widget_twitter_timeline.tweets event.

apps/front/frontConfiguration.class.php

class frontConfiguration extends dmFrontApplicationConfiguration
{  
 
  public function configure()  
  {  
    // connect to the dm.widget_twitter_search.tweets event  
    $this->dispatcher->connect('dm.widget_twitter_timeline.tweets', array($this, 'listenToTwitterTimelineTweetsEvent'));  
  }  
 
  public function listenToTwitterTimelineTweetsEvent(sfEvent $e, array $tweets)  
  {  
    // do something with the tweets  
    ...  
    // return the filtered tweets  
    return $tweets;  
  }