Copyright 2007 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.

The following methods are available:

• ping_weblogs_com($weblog_name, $weblog_url, $changes_url = "", $category = "")


• ping_blo_gs($weblog_name, $weblog_url, $changes_url = "", $category = "")


• ping_technorati($weblog_name, $weblog_url, $changes_url = "", $category = "")


• ping_audio_weblogs_com($weblog_name, $weblog_url, $changes_url = "", $category = "")


• ping_ping_o_matic($weblog_name, $weblog_url, $changes_url = "", $category = "")


• ping_all($weblog_name, $weblog_url, $changes_url = "", $category = ""), ping Weblogs.Com, Ping-O-Matic, and Technorati


• ping_feedburner($weblog_name, $weblog_url, $changes_url = "", $category = "")


• ping_weblogs_com_extended($weblog_name, $weblog_url, $changes_url, $rss_url)

Most of these methods take the following four arguments, two of which are optional and may be omitted:

• weblog_name: the name of the weblog that has been updated


• weblog_url: the URL of the weblog


• changes_url: the URL of a page to be checked for changes (default: use the weblog_url)


• category: the category to which the ping should be submitted (default: none)

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.

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:

• ping($xml_rpc_server, $xml_rpc_port, $xml_rpc_path, $xml_rpc_method, $weblog_name, $weblog_url, $changes_url, $category)

Method arguments:

• xml_rpc_server: the host name of the XML-RPC server


• xml_rpc_port: the server's port number (usually 80)


• xml_rpc_path: the path to use for XML-RPC requests (often /RPC2)


• xml_rpc_method: the name of the ping method


• weblog_name: the name of the weblog that has been updated


• weblog_url: the URL of the weblog


• changes_url: the URL of a page to be checked for changes


• category: the category to which the ping should be submitted

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/")
<?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>

<value><struct>
<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>

Set the class variable $log_file to the path and name of the log file.