CI_Trackback Class Reference

List of all members.

Public Member Functions
	CI_Trackback ()
	Constructor.
	send ($tb_data)
	Send Trackback.
	receive ()
	Receive Trackback Data.
	send_error ($message= 'Incomplete Information')
	Send Trackback Error Message.
	send_success ()
	Send Trackback Success Message.
	data ($item)
	Fetch a particular item.
	process ($url, $data)
	Process Trackback.
	extract_urls ($urls)
	Extract Trackback URLs.
	validate_url ($url)
	Validate URL.
	get_id ($url)
	Find the Trackback URL's ID.
	convert_xml ($str)
	Convert Reserved XML characters to Entities.
	limit_characters ($str, $n=500, $end_char= '…')
	Character limiter.
	convert_ascii ($str)
	High ASCII to Entities.
	set_error ($msg)
	Set error message.
	display_errors ($open= '< p >', $close= '</p >')
	Show error messages.
Public Attributes
	$time_format = 'local'
	$charset = 'UTF-8'
	$data = array('url' => '', 'title' => '', 'excerpt' => '', 'blog_name' => '', 'charset' => '')
	$convert_ascii = TRUE
	$response = ''
	$error_msg = array()

---

Detailed Description

Definition at line 29 of file Trackback.php.

---

Member Function Documentation

CI_Trackback::CI_Trackback

(

)

Constructor.

public

Definition at line 43 of file Trackback.php.

References log_message().

        {
                log_message('debug', "Trackback Class Initialized");
        }

Here is the call graph for this function:

CI_Trackback::convert_ascii

(

$

str

)

High ASCII to Entities.

Converts Hight ascii text and MS Word special chars to character entities

public

Parameters:

string

Returns:

string

Definition at line 473 of file Trackback.php.

Referenced by send().

        {
           $count       = 1;
           $out = '';
           $temp        = array();
                
           for ($i = 0, $s = strlen($str); $i < $s; $i++)
           {
                   $ordinal = ord($str[$i]);
                
                   if ($ordinal < 128)
                   {
                           $out .= $str[$i];                    
                   }
                   else
                   {
                           if (count($temp) == 0)
                           {
                                   $count = ($ordinal < 224) ? 2 : 3;
                           }
                        
                           $temp[] = $ordinal;
                        
                           if (count($temp) == $count)
                           {
                                   $number = ($count == 3) ? (($temp['0'] % 16) * 4096) + (($temp['1'] % 64) * 64) + ($temp['2'] % 64) : (($temp['0'] % 32) * 64) + ($temp['1'] % 64);
        
                                   $out .= '&#'.$number.';';
                                   $count = 1;
                                   $temp = array();
                           }
                   }
           }
        
           return $out;
        }

Here is the caller graph for this function:

CI_Trackback::convert_xml

(

$

str

)

Convert Reserved XML characters to Entities.

public

Parameters:

string

Returns:

string

Definition at line 406 of file Trackback.php.

Referenced by receive(), and send().

        {
                $temp = '__TEMP_AMPERSANDS__';
                
                $str = preg_replace("/&#(\d+);/", "$temp\\1;", $str);
                $str = preg_replace("/&(\w+);/",  "$temp\\1;", $str);
                
                $str = str_replace(array("&","<",">","\"", "'", "-"),
                                                   array("&amp;", "&lt;", "&gt;", "&quot;", "&#39;", "&#45;"),
                                                   $str);
                        
                $str = preg_replace("/$temp(\d+);/","&#\\1;",$str);
                $str = preg_replace("/$temp(\w+);/","&\\1;", $str);
                        
                return $str;
        }       

Here is the caller graph for this function:

CI_Trackback::data

(

$

item

)

Fetch a particular item.

public

Parameters:

string

Returns:

string

Definition at line 213 of file Trackback.php.

Referenced by receive().

        {
                return ( ! isset($this->data[$item])) ? '' : $this->data[$item];
        }

Here is the caller graph for this function:

CI_Trackback::display_errors	(	$	open = '<p>',
		$	close = '</p>'
	)

Show error messages.

public

Parameters:

	string
	string

Returns:

string

Definition at line 535 of file Trackback.php.

        {       
                $str = '';
                foreach ($this->error_msg as $val)
                {
                        $str .= $open.$val.$close;
                }
        
                return $str;
        }

CI_Trackback::extract_urls

(

$

urls

)

Extract Trackback URLs.

This function lets multiple trackbacks be sent. It takes a string of URLs (separated by comma or space) and puts each URL into an array

public

Parameters:

string

Returns:

string

Definition at line 299 of file Trackback.php.

Referenced by send().

        {               
                // Remove the pesky white space and replace with a comma.
                $urls = preg_replace("/\s*(\S+)\s*/", "\\1,", $urls);
                
                // If they use commas get rid of the doubles.
                $urls = str_replace(",,", ",", $urls);
                
                // Remove any comma that might be at the end
                if (substr($urls, -1) == ",")
                {
                        $urls = substr($urls, 0, -1);
                }
                                
                // Break into an array via commas
                $urls = preg_split('/[,]/', $urls);
                
                // Removes duplicates
                $urls = array_unique($urls);
                
                array_walk($urls, array($this, 'validate_url'));
                
                return $urls;
        }

Here is the caller graph for this function:

CI_Trackback::get_id

(

$

url

)

Find the Trackback URL's ID.

public

Parameters:

string

Returns:

string

Definition at line 354 of file Trackback.php.

Referenced by process().

        {       
                $tb_id = "";
                
                if (strstr($url, '?'))
                {
                        $tb_array = explode('/', $url);
                        $tb_end   = $tb_array[count($tb_array)-1];
                        
                        if ( ! is_numeric($tb_end))
                        {
                                $tb_end  = $tb_array[count($tb_array)-2];
                        }
                        
                        $tb_array = explode('=', $tb_end);
                        $tb_id  = $tb_array[count($tb_array)-1];
                }
                else
                {
                        if (ereg("/$", $url))
                        {
                                $url = substr($url, 0, -1);
                        }
                                
                        $tb_array = explode('/', $url);
                        $tb_id  = $tb_array[count($tb_array)-1];
                        
                        if ( ! is_numeric($tb_id))
                        {
                                $tb_id  = $tb_array[count($tb_array)-2];
                        }
                }       
                                
                if ( ! preg_match ("/^([0-9]+)$/", $tb_id))
                {
                        return false;
                }
                else
                {
                        return $tb_id;
                }               
        }

Here is the caller graph for this function:

CI_Trackback::limit_characters	(	$	str,
		$	n = 500,
		$	end_char = '…'
	)

Character limiter.

Limits the string based on the character count. Will preserve complete words.

public

Parameters:

	string
	integer
	string

Returns:

string

Definition at line 436 of file Trackback.php.

Referenced by receive(), and send().

        {
                if (strlen($str) < $n)
                {
                        return $str;
                }

                $str = preg_replace("/\s+/", ' ', str_replace(array("\r\n", "\r", "\n"), ' ', $str));
        
                if (strlen($str) <= $n)
                {
                        return $str;
                }
                                                                                
                $out = "";
                foreach (explode(' ', trim($str)) as $val)
                {
                        $out .= $val.' ';                       
                        if (strlen($out) >= $n)
                        {
                                return trim($out).$end_char;
                        }               
                }
        }

Here is the caller graph for this function:

CI_Trackback::process	(	$	url,
		$	data
	)

Process Trackback.

Opens a socket connection and passes the data to the server. Returns true on success, false on failure

public

Parameters:

	string
	string

Returns:

bool

Definition at line 231 of file Trackback.php.

References $data, get_id(), and set_error().

Referenced by send().

        {
                $target = parse_url($url);
        
                // Open the socket
                if ( ! $fp = @fsockopen($target['host'], 80))
                {
                        $this->set_error('Invalid Connection: '.$url);
                        return FALSE;
                }

                // Build the path
                $ppath = ( ! isset($target['path'])) ? $url : $target['path'];
                
                $path = (isset($target['query']) && $target['query'] != "") ? $ppath.'?'.$target['query'] : $ppath;

                // Add the Trackback ID to the data string
                if ($id = $this->get_id($url))
                {
                        $data = "tb_id=".$id."&".$data;
                }

                // Transfer the data
                fputs ($fp, "POST " . $path . " HTTP/1.0\r\n" );
                fputs ($fp, "Host: " . $target['host'] . "\r\n" );
                fputs ($fp, "Content-type: application/x-www-form-urlencoded\r\n" );
                fputs ($fp, "Content-length: " . strlen($data) . "\r\n" );
                fputs ($fp, "Connection: close\r\n\r\n" );
                fputs ($fp, $data);

                // Was it successful?
                $this->response = "";
                
                while( ! feof($fp))
                {
                        $this->response .= fgets($fp, 128);
                }
                @fclose($fp);
                
                if ( ! eregi("<error>0</error>", $this->response))
                {
                        $message = 'An unknown error was encountered';
                        
                        if (preg_match("/<message>(.*?)<\/message>/is", $this->response, $match))
                        {
                                $message = trim($match['1']);
                        }
                        
                        $this->set_error($message);
                        return FALSE;
                }

                return TRUE;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

CI_Trackback::receive

(

)

Receive Trackback Data.

This function simply validates the incoming TB data. It returns false on failure and true on success. If the data is valid it is set to the $this->data array so that it can be inserted into a database.

public

Returns:

bool

Definition at line 138 of file Trackback.php.

References convert_xml(), data(), limit_characters(), and set_error().

        {                                       
                foreach (array('url', 'title', 'blog_name', 'excerpt') as $val)
                {
                        if ( ! isset($_POST[$val]) OR $_POST[$val] == '')
                        {
                                $this->set_error('The following required POST variable is missing: '.$val);
                                return FALSE;
                        }
                        
                        $this->data['charset'] = ( ! isset($_POST['charset'])) ? 'auto' : strtoupper(trim($_POST['charset']));
        
                        if ($val != 'url' && function_exists('mb_convert_encoding'))
                        {
                                $_POST[$val] = mb_convert_encoding($_POST[$val], $this->charset, $this->data['charset']);
                        }
                        
                        $_POST[$val] = ($val != 'url') ? $this->convert_xml(strip_tags($_POST[$val])) : strip_tags($_POST[$val]);
                        
                        if ($val == 'excerpt')
                        {
                                $_POST['excerpt'] = $this->limit_characters($_POST['excerpt']);
                        }
                        
                        $this->data[$val] = $_POST[$val];
                }

                return TRUE;
        }       

Here is the call graph for this function:

CI_Trackback::send

(

$

tb_data

)

Send Trackback.

public

Parameters:

array

Returns:

bool

Definition at line 57 of file Trackback.php.

References $charset, $data, convert_ascii(), convert_xml(), extract_urls(), limit_characters(), process(), and set_error().

        {               
                if ( ! is_array($tb_data))
                {
                        $this->set_error('The send() method must be passed an array');
                        return FALSE;
                }
                
                // Pre-process the Trackback Data
                foreach (array('url', 'title', 'excerpt', 'blog_name', 'ping_url') as $item)
                {
                        if ( ! isset($tb_data[$item]))
                        {
                                $this->set_error('Required item missing: '.$item);
                                return FALSE;
                        }
                        
                        switch ($item)
                        {
                                case 'ping_url' : $$item = $this->extract_urls($tb_data[$item]);
                                        break;
                                case 'excerpt'  : $$item = $this->limit_characters($this->convert_xml(strip_tags(stripslashes($tb_data[$item]))));
                                        break;
                                case 'url'              : $$item = str_replace('-', '-', $this->convert_xml(strip_tags(stripslashes($tb_data[$item]))));
                                        break;
                                default                 : $$item = $this->convert_xml(strip_tags(stripslashes($tb_data[$item])));
                                        break;
                        }

                        // Convert High ASCII Characters
                        if ($this->convert_ascii == TRUE)
                        {
                                if ($item == 'excerpt')
                                {
                                        $$item = $this->convert_ascii($$item);
                                }
                                elseif ($item == 'title')
                                {
                                        $$item = $this->convert_ascii($$item);
                                }
                                elseif($item == 'blog_name')
                                {
                                        $$item = $this->convert_ascii($$item);
                                }
                        }
                }

                // Build the Trackback data string
                $charset = ( ! isset($tb_data['charset'])) ? $this->charset : $tb_data['charset'];
                
                $data = "url=".rawurlencode($url)."&title=".rawurlencode($title)."&blog_name=".rawurlencode($blog_name)."&excerpt=".rawurlencode($excerpt)."&charset=".rawurlencode($charset);
                                
                // Send Trackback(s)
                $return = TRUE;
                if (count($ping_url) > 0)
                {
                        foreach ($ping_url as $url)
                        {
                                if ($this->process($url, $data) == FALSE)
                                {
                                        $return = FALSE;
                                }
                        }       
                }

                return $return;
        }

Here is the call graph for this function:

CI_Trackback::send_error

(

$

message = 'Incomplete Information'

)

Send Trackback Error Message.

Allows custom errors to be set. By default it sends the "incomplete information" error, as that's the most common one.

public

Parameters:

string

Returns:

void

Definition at line 181 of file Trackback.php.

        {
                echo "<?xml version=\"1.0\" encoding=\"utf-8\"?".">\n<response>\n<error>1</error>\n<message>".$message."</message>\n</response>";
                exit;
        }

CI_Trackback::send_success

(

)

Send Trackback Success Message.

This should be called when a trackback has been successfully received and inserted.

public

Returns:

void

Definition at line 198 of file Trackback.php.

        {
                echo "<?xml version=\"1.0\" encoding=\"utf-8\"?".">\n<response>\n<error>0</error>\n</response>";
                exit;
        }

CI_Trackback::set_error

(

$

msg

)

Set error message.

public

Parameters:

string

Returns:

void

Definition at line 519 of file Trackback.php.

References log_message().

Referenced by process(), receive(), and send().

        {
                log_message('error', $msg);
                $this->error_msg[] = $msg;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

CI_Trackback::validate_url

(

$

url

)

Validate URL.

Simply adds "http://" if missing

public

Parameters:

string

Returns:

string

Definition at line 335 of file Trackback.php.

        {
                $url = trim($url);

                if (substr($url, 0, 4) != "http")
                {
                        $url = "http://".$url;
                }
        }

---

Member Data Documentation

CI_Trackback::$charset = 'UTF-8'

Definition at line 32 of file Trackback.php.

Referenced by send().

CI_Trackback::$convert_ascii = TRUE

Definition at line 34 of file Trackback.php.

CI_Trackback::$data = array('url' => '', 'title' => '', 'excerpt' => '', 'blog_name' => '', 'charset' => '')

Definition at line 33 of file Trackback.php.

Referenced by process(), and send().

CI_Trackback::$error_msg = array()

Definition at line 36 of file Trackback.php.

CI_Trackback::$response = ''

Definition at line 35 of file Trackback.php.

CI_Trackback::$time_format = 'local'

Definition at line 31 of file Trackback.php.

---

The documentation for this class was generated from the following file:

• Trackback.php