WordPress.org

Template Tag Usage

void wp_pingfm_status ( [ int $limit [, string $prefix [, bool $permalink ]]] )

Displays status updates in an unordered list (<ul>). All parameters are optional.

Parameters

limit

The number of status updates to show. Default value is 10. Depending on your needs and the location on the page, a value between 5 and 15 is usually pretty reasonable.

prefix

Some text to display before every status update. Default value is nothing. This can be useful if all of your status updates begin with a verb. For example, you might post "going to the store" from Ping.fm. If your prefix is "Matt is", the final output will be "Matt is going to the store". Neat, huh?

permalink

Whether to show timestamps as permalinks, a la Twitter. The archive page is editable via the tmpl-single.php template file.

Example

If you're using the Twenty Ten theme that ships with WordPress 3.0, you might put the following into your sidebar.php file:

<li id="pingfm" class="widget-container">
    <h3 class="widget-title">Status Updates</h3>
    <?php wp_pingfm_status(); ?>
</li>

mixed wp_pingfm_latest ( void )

Retrieves the single most recent ping (status update) from the database.

Return Values

A stdClass object representing the latest ping, if it exists. Otherwise, false. The object will contain the properties listed below. For more information, dig through the source of the WordPress get_posts() function.

ID
post_author
post_date
post_date_gmt
post_content
post_title
post_excerpt
post_status
comment_status
ping_status
post_password
post_name
to_ping
pinged
post_modified
post_modified_gmt
post_content_filtered
post_parent
guid
menu_order
post_type
post_mime_type
comment_count
filter