Below is the list of variables sent with a Ping.fm custom url post:

• method – The method of the message being sent (blog, microblog, status).
• title – If method is “blog” then this contains the blog’s title.
• message – The posted message content.
• location – Any location updates posted with the message.  This is plaintext, verbatim from the posting interface.
• media – If media is posted, this will contain a URL to the media file.
• raw_message – If media is posted, this will contain the posted message WITHOUT the hosted media link (i.e. http://ping.fm/p/12345).
• trigger – If you post a message with a custom trigger (http://ping.fm/triggers/), it will show here.

All that was needed for my script was to use the $_POST[] array to get the variables from the posted messages and use those variables in my script to insert the data into a MySQL database for later use.  Now I can post news stories, status updates, and blog posts right to my website without having to log in to the administrative backend of my site.  The apps I use to post are Meping on the desktop and Blackping on my Blackberry (requires custom trigger to post to custom url).

I’ve also thought of several other possibilities with the custom URL ping.fm functionality, such as HTML email marketing, which would normally be difficult to accomplish from a mobile phone, for example.  All you would need to do to accomplish this is put the HTML template in your server-side script along with queries to your customer database and then include some key words in your pinged message that the script can parse (i.e. the location variable can contain which HTML template to use and some filter keywords for which customers to email).

All it takes is a little imagination, and the possibilities are almost endless with the ping.fm custom URL functionality.  For now, I’m just happy that I can post messages to my website…  Tomorrow, pinging NASA servers to send rockets into space.

First, as part of a backend CMS, I created a form that submits the status update via PHP to a MySQL database. Then I wrote a PHP class that includes a method to query the database for the most recent status update and another method that calls a MySQL stored procedure to get the time of that status update (i.e. “a few minutes ago”, “32 minutes ago”, “5 days ago”, etc.). The following is the code for the MySQL stored procedure that gets the time of the user’s most recent status update:

DROP FUNCTION IF EXISTS `my_DB`.`getStatusTime`;

DELIMITER $$
/*!50003 SET @TEMP_SQL_MODE=@@SQL_MODE, SQL_MODE=” */ $$
CREATE FUNCTION `my_DB`.`getStatusTime`(User VARCHAR(25)) RETURNS VARCHAR(25)
BEGIN
DECLARE TodaysDate TIMESTAMP;
DECLARE StatusDate TIMESTAMP;
DECLARE TimeDifference TIME;
DECLARE Status_Time VARCHAR(25);

SELECT NOW()
INTO TodaysDate;

SELECT s.Stat_Updated
INTO StatusDate
FROM T_Status s
INNER JOIN T_Profile p ON p.Profile_ID=s.Stat_Who
WHERE p.Pr_Name_First=User
ORDER BY s.Stat_Updated desc
LIMIT 1;

SELECT TIMEDIFF( TodaysDate, StatusDate )
INTO TimeDifference;

SELECT TIMEDIFF( MAKETIME(47,59,59), TimeOfStatus )
INTO YesterdayTimeDifference;

/*////// Find the time of status update formatted as a string /////// */
IF HOUR(TimeOfStatus) < 12 THEN SET TimeOfStatusString = CONCAT( ‘ at ‘, HOUR(TimeOfStatus), ‘:‘, MINUTE(TimeOfStatus), ‘ AM‘ );
ELSEIF HOUR(TimeOfStatus) < 13 THEN SET TimeOfStatusString = CONCAT( ‘ at ‘, HOUR(TimeOfStatus), ‘:‘, MINUTE(TimeOfStatus), ‘ PM‘ );
ELSE SET TimeOfStatusString = CONCAT( ‘ at ‘, HOUR( DATE_SUB( StatusDate, INTERVAL 12 HOUR ) ), ‘:‘, MINUTE(TimeOfStatus), ‘ PM‘ );
END IF;

/*////// Find the amount of time since most recent status update /////// */
/*
Status options:
‘a moment ago’
‘less than 1 minute ago’
‘1 minute ago’
‘{n} minutes ago’
‘1 hour ago’
‘{n} hours ago’
‘yesterday at {time}’
‘on {day} at {time}’
‘last {day} at {time}’
‘on {date} at {time}’
*/
IF HOUR( TimeDifference ) < 1 AND MINUTE( TimeDifference ) < 1 THEN SET Status_Time = CONCAT( SECOND( TimeDifference ), ‘ seconds ago‘ );
ELSEIF HOUR( TimeDifference ) < 1 AND MINUTE( TimeDifference ) < 2 THEN SET Status_Time = ‘1 minute ago‘;
ELSEIF HOUR( TimeDifference ) < 1 AND MINUTE( TimeDifference ) < 60 THEN SET Status_Time = CONCAT( MINUTE( TimeDifference ), ‘ minutes ago‘ );
ELSEIF HOUR( TimeDifference ) < 2 THEN SET Status_Time = ‘1 hour ago‘;
ELSEIF HOUR( TimeDifference ) < 24 THEN SET Status_Time = CONCAT( HOUR( TimeDifference ), ‘ hours ago‘ );
ELSEIF HOUR( TimeDifference ) < ( YesterdayTimeDifference ) AND MINUTE( TimeDifference ) < MINUTE( YesterdayTimeDifference ) AND SECOND( TimeDifference ) < SECOND( YesterdayTimeDifference ) THEN SET Status_Time = CONCAT( ‘yesterday‘, TimeOfStatusString );
ELSEIF HOUR( TimeDifference ) < 144 THEN SET Status_Time = CONCAT( ‘on ‘, DAYNAME( StatusDate ), TimeOfStatusString );
ELSEIF HOUR( TimeDifference ) < 168 THEN SET Status_Time = CONCAT( ‘last ‘, DAYNAME( StatusDate ), TimeOfStatusString );
ELSE SET Status_Time = CONCAT( ‘on ‘, MONTHNAME( StatusDate ), ‘ ‘, DAY( StatusDate ), TimeOfStatusString );
END IF;

RETURN Status_Time;
END $$
/*!50003 SET SESSION SQL_MODE=@TEMP_SQL_MODE */ $$

DELIMITER ;

The script works like a charm! My next project on this site is to create a Flash image slideshow where the images can be managed from the backend…