Weblog_Pinger: Update Notification PHP Library
Weblog_Pinger is a PHP class library that can send update notification pings over XML-RPC services such as Weblogs.Com, Ping-o-Matic and Technorati and PubSubHubbub services that use REST.
After it is installed, you can use it by creating a Weblog_Pinger object and calling one of its ping methods:
require('weblog_pinger.php');
$pinger = new Weblog_Pinger();
$pinger->ping_ping_o_matic("Ekzemplo", "http://www.ekzemplo.com/");
Links:
- Requirements to run the software
- License
- Source code files
- Installation instructions
- Documentation
- Version History
This software was developed by Rogers Cadenhead, publisher of the Workbench weblog, with help from David Sifry of Technorati. It has been released under the GNU General Public License.
I'm running the software on PHP 5.2.10 and MySQL 5.1. I think it should work with PHP 4 or higher and MySQL 3.2 or higher.
Copyright 2009 Rogers Cadenhead
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
The following methods are available:
Most of these methods take the following four arguments, two of which are optional and may be omitted:
The ping_weblogs_com_extended() method takes four required arguments: weblog_name, weblog_url, changes_url, and rss_url, the URL of the weblog's RSS feed.
The ping_simplaris_blogcast() method takes one additional argument, ping_id, a user-specific ID generated by Simplaris Blogcast when you add the application to your Facebook profile. The ID can be found on your ping info page for the application. The ID is the alphanumeric code that follows "http://blogcast.simplaris.com/ping/" in the ping URL. With the exception of ping_all(), these methods return true on success and false on failure. Errors are reported on the PHP error log.
The ping_all() method returns an array containing two elements: a boolean for the success of the whole method and an array with booleans returned by the method calls to ping_technorati(), ping_weblogs_com(), and ping_ping_o_matic().
There's also a method for other notification services that support the Weblogs.Com XML-RPC interface, but you have to know more about the service:
The ping_rest() method takes two arguments: a string or array of strings with the URLs of RSS feeds that have been updated and the URL of a PubSubHubbub hub. The second argument is optional. If omitted, the hub at http://pubsubhubbub.appspot.com is used. Additional method arguments: Logging:
This class can log all ping requests, responses, and the associated XML data. Here's an example:
Request: weblogUpdates.ping("Ekzemplo", "http://www.ekzemplo.com/") <value><struct> Set the class variable $log_file to the path and name of the log file.
Set the variable $log_level to one of three values: 'none' (no logging), 'short' (everything but XML data), and 'full' (everything).
<?xml version="1.0"?>
<methodCall>
<methodName>weblogUpdates.ping</methodName>
<params>
<param>
<value><string>Ekzemplo</string></value>
</param>
<param>
<value><string>http://www.ekzemplo.com/</string></value>
</param>
</params>
</methodCall>
<member><name>flerror</name>
<value><boolean>0</boolean></value>
</member>
<member><name>message</name>
<value><string>Thanks for the ping.</string></value>
</member>
</struct></value>