Installation Instructions

Upload the plugin (unzipped) into /wp-content/plugins/. You should end up with /wp-content/plugins/lifestream/lifestream.php.

Activate the plugin under the "Plugins" menu.

Visit "Lifestream" -> "Settings" to configure the basic options, and add feeds.

There are severals methods in which you can use Lifestream in a WordPress page.

The easiest way is to use the normal context handler (works in pages and posts):

[lifestream]

Another method requires a custom WordPress page, or the use of a template, and is a simple function call:

<?php lifestream(); ?>

You may also specify several parameters in the lifestream method (useful for sidebar display). These should be in the standard key=>value format for PHP calls.

• (int) offset: defaults to 0
• (int) limit: defaults to '50'
• (string) date_interval: defaults to '1 month'
• (boolean) break_events: defaults to false - forces grouped events to be single
• (array) user_ids: defaults to all users -- specify the ids of users to show
• (array) feed_types: defaults to all feeds -- specify the feed keys (e.g. twitter) to show
• (array) feed_ids: defaults to all feeds -- specify the ids of feeds to show, also overrides feed_types setting

For example:

[lifestream limit="10"]

For more advanced uses, you may directly use get_events() which will return an array of Event instances. This is the same syntax as the lifestream() method.

Example:

<ul>
<?php
$options = array('limit' => 50);
$events = $lifestream->get_events($options);

foreach ($events as $event)
{
    echo '<li>'.$event->render($options).'</li>';
}
?>
</ul>

Another popular example, would to be show your current Twitter, or Facebook status somewhere in your templates:

$events = $lifestream->get_events(array('feed_types'=>array('twitter'), 'number_of_results'=>1, 'break_groups'=>true);
$event = $events[0];

// to render it with links
echo $event->feed->render_item($event, $event->data);

// or render just the text
echo $event->data['title'];

Or, use our handy shortcuts:

<?php lifestream_twitter_status(); ?>

And

<?php lifestream_facebook_status(); ?>

Changelog

0.99.9.8-BETA

• The last release by David Cramer

1.0

• This updated version containing a whole load of fixes and more plugins. This is the version available on GitHub as at 27/07/2011