Ping.fm Custom URL

Great for having a personal archive of content sent through Ping.fm, displaying
status updates in your sidebar, or starting a mobile photo blog. While there’s
plenty of room for customizing the plugin, sane defaults ensure that 90% of
people can get up and running quickly. Keep reading for a full list of features
below…

Minimum System Requirements

This plugin has required PHP 5 for quite a while, but the increased
requirements below are in line with the new standard coming in WordPress 3.2.
Other version of PHP/MySQL might work just fine, but I personally use even
later versions of both for development and testing. The minimums listed below
are just that—minimums. My advice is to use the latest stable versions you
can get your hands on.

• WordPress 3.0
• PHP 5.2.0
• MySQL 5.0.15

A Quick Note About Donations

Starting with version 2.0.0 of this plugin, I added a PayPal donation link to
the information box in the upper-right corner of the page. Let me be clear: I’m
not soliciting donations, there is no charge for this plugin, and you are
not obligated to give me any money for any reason. However, people have
asked me if they could donate, and I wanted to facilitate that if you feel so
inclined.

I’ve spent countless hours developing and supporting this plugin, but it’s
mostly a labor of love. I first created the plugin to meet my own needs, and
it’s kind of taken off from there. If you feel that the plugin has been useful
to you in some way, I’d be honored to take your money and spend it on gadgets
and firearm accessories.

Ye Olde Features Liste

• Works with Ping.fm’s Custom URL feature to collect blog entries, micro-blog
  entries, and status updates and post them to your blog.

• Photos posted through Ping.fm can be downloaded to your own blog and
  displayed as part of a normal post. It’s a super-easy way to set up an
  awesome self-hosted mobile photo blog.

• Status updates and micro-blogs can be administered through a native
  WordPress management screen while blogs are, well… normal blog entries!
  Every feature of this plugin is tightly integrated with WordPress to
  provide a native look and feel.

• A beautiful settings page with predefined smart defaults and contextual
  help when you need it.

• Status updates are posted to the sidebar and displayed with a widget. A
  standard template tag is also provided for those of you who are
  anti-widget.

• The sidebar widget is customizable with the number of status updates to
  show and an optional string to prepend all updates with (e.g. you might use
  your first name if all your status updates begin with a verb like mine do:
  Matt is…). Sensible CSS and examples are provided for you to customize
  the look and feel of your widget.

• Provides an RSS feed and permalinks for your pings so that you can share
  them with the rest of the world.

• Blog entries and micro-blog entries can have certain metadata applied to
  them automatically. You can set the author, category, tags, and post status
  (published or draft) for all incoming pings.

• All the cool features of Ping.fm: post to your self-hosted WordPress blog
  using SMS, IM, email, desktop gadgets, mobile apps, etc.

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