Welcome to the PHPingFM documentation!

The PHPingFM library is a PHP library for accessing http://ping.fm/ (Ping.fm is a service that can post micro-blog posts, blog posts, and status updates, to a number of social networks all at once). It uses Ping.fm's public APIs to accomplish all of it's requests.

To use the PHPingFM libraries, you need two basic things:
  1. An account on Ping.fm. You can get that here. As Ping.fm is still in private beta, you will need a beta code. The current beta code is letmeping.
  2. A developer key on Ping.fm. You can get that here, once you've already gotten an account.

Authentication

In short, the way authentication for Ping.fm APIs is as follows:

here are two things needed to perform the authentication: the Developer's API key and the User's APP key. The Developer's API key is per-application, and the User's APP keys are per-user - they are like passwords, except they give limited access. You will only need one developer key for your application, but each user who wants to use it will need their own application key (they come with every account and do not need to be specifically requested). You can read more about the authentication here.
Once you have read up on that, you should be ready to get started using PHPingFM.

Getting started

The first step is to instantiate a PHPingFM object:
<?php
include_once 'PHPingFM.php';
$PHPingFM = new PHPingFM($your_developer_key, $your_api_key);
// Do operations with $PHPingFM here

?>

Once that is done, you may use methods contained within the $PHPingFM object. A list of them can be found below: