PHP Classes

File: contextvoice.php

Recommend this page to a friend!
  Classes of Dave Kinsella   Context Voice php library   contextvoice.php   Download  
File: contextvoice.php
Role: Class source
Content type: text/plain
Description: Context Voice API 1.1.1 library
Class: Context Voice php library
Track conversation about URLs
Author: By
Last change: added support for "threaded" parameter in getUrlReactions method
Date: 14 years ago
Size: 7,507 bytes
 

Contents

Class file image Download
<?php
/**
* contextvoice API wrapper for php
* @package contextvoice
* @version 1.1.1
* @author Dave Kinsella <kinsella.dave@gmail.com>
* @copyright 2009 Dave Kinsella - http://webdeveloper2.com
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/

/**
* Main class
* @package contextvoice
* @subpackage Main
*/
class contextvoice{
  private
$apikey;

 
/**
   * Default constructor
   *
   * You can use the service anonymously by not specifying an API key but you will be limited to only using the getUrlReactions method, and a call rate limit of 500 calls per day.
   *
   * Instantiate as
   * $myvar = new contextvoice('[my api key]');
   * or
   * $myvar = new contextvoice(); //anonymous access
   *
   * @param string $apikey
   */
 
public function __construct($apikey=false){
   
$this->apikey = $apikey;
  }

 
/**
   * Submit a single url to contextvoice for tracking
   *
   * @param string $url
   * Must be a fully qualified url e.g. http://www.example.com/page.htm
   * @return cv_Response
   */
 
function addUrl($url){
   
$api = "http://api.contextvoice.com/1.1/resources/";
   
$uri = $api."?apikey={$this->apikey}&format=json";
   
$data = array("url" => $url);
   
$response = $this->sendRequest($uri, 'POST', $data);
    return
$response;
  }

 
/**
  * Submit a number of urls to contextvoice for tracking.
  *
  * $urls can be either a comma delimited list or an array.
  * each URL must be a fully qualified url e.g. <i>http://www.example.com/page.htm</i>
  *
  * @param mixed $urls
  * This must be either a comma-separated list(string) or an array of urls
  * @return cv_Response
  */
 
function addUrls($urls){
   
$api = "http://api.contextvoice.com/1.1/resources/batch/";
   
$uri = $api."?apikey={$this->apikey}&format=json";
   
//allow urls to be passed as array or comma delimted string
   
if(is_array($urls)){
     
$urlData = implode(",", $urls);
    }else{
     
$urlData = $urls;
    }
   
$data = array("urls" => $urlData);
   
$response = $this->sendRequest($uri, 'POST', $data);
    return
$response;
  }
 
/**
  * Get info about a single url from contextvoice.
  *
  * The url must have first been registered via the addUrl or addUrls methods.
  *
  * @param string $url
  * Must be a fully qualified url e.g. http://www.example.com/page.htm
  * @return cv_Response
  */
 
function getUrlInfo($url){
   
$api = "http://api.contextvoice.com/1.1/resources/";
   
$uri = $api."?url={$url}&apikey={$this->apikey}&format=json";
   
$response = $this->sendRequest($uri);
    return
$response;
  }
 
/**
  * Get a set of reactions about a single url from contextvoice.
  *
  * The url must have first been registered via the addUrl or addUrls methods.
  *
  * @param string $url
  * Must be a fully qualified url e.g. http://www.example.com/page.htm
  * @param string $since
  * [optional] Any php parseable date string e.g. "15 May 2009"
  * @param string $include
  * [optional] Comma-separated list of sources e.g. "twitter,digg,friendfeed"
  * @param string $exclude
  * [optional] Comma-separated list of sources e.g. "flickr,hackernews,slashdot"
  * @param bool $filter
  * [optional] if true, attempts to remove "retweets" from the results.
  * @param string $order
  * [optional] "asc" or "desc" orders the results by the date that they were added to the contextvoice indexes
  * @param int $page
  * [optional] the page of results to return defaults to 1
  * @param int $perpage
  * [optional] the number of results to return per page, defaults to 25
  * @param bool $threaded
  * [optional] return the threaded conversation (retwitts will be treated as children of the original twitt), defaults to false
  * @return cv_Response
  */
 
function getUrlReactions($url, $since=false, $include=false, $exclude=false, $filter=false, $order=false, $page=false, $perpage=false, $threaded=false ){
    if(
$this->apikey==false){
     
$api = "http://externalapi.contextvoice.com/1.1/reactions/";
     
$uri = $api."?url={$url}&format=json";
    }else{
     
$api = "http://api.contextvoice.com/1.1/reactions/";
     
$uri = $api."?url={$url}&apikey={$this->apikey}&format=json";
    }
    if(
$order!=false){
     
$uri = $uri."&order={$order}";
    }
    if(
$perpage!=false){
     
$uri = $uri."&perpage={$perpage}";
    }
    if(
$page!=false){
     
$uri = $uri."&page={$page}";
    }
    if(
$exclude!=false){
     
$uri = $uri."&exclude[generator]={$exclude}";
    }
    if(
$include!=false){
     
$uri = $uri."&include[generator]={$include}";
    }
    if(
$filter!=false){
     
$uri = $uri."&filter=remove-retwitts";
    }
    if(
$threaded!=false){
     
$uri = $uri."&threaded=true";
    }
    if(
$since!=false){
     
$date = date_parse($since);
      if(
$date['error_count']==0){
       
$uri = $uri."&since=".date("U", strtotime($since));
      }
    }
   
$response = $this->sendRequest($uri);
    return
$response;
  }

 
/**
  * create and excute a CURL request
  * @ignore
  */
 
private function sendRequest($uri, $method ='GET', $data ='')
  {
   
$ch = curl_init();
   
curl_setopt($ch, CURLOPT_URL, $uri);
   
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
   
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Expect:'));

    if(
'POST' == ($method = strtoupper($method)))
    {
       
curl_setopt($ch, CURLOPT_POST, TRUE);
       
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    }
    else if(
'GET' != $method)
    {
       
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
    }
   
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, TRUE);
   
curl_setopt($ch, CURLOPT_TIMEOUT, 21600);

   
$data = curl_exec($ch);
   
$meta = curl_getinfo($ch);

   
curl_close($ch);

    return new
cv_response($data, $meta);
  }
}

/**
 * Response class
 * Returns both the response data and the curl request info to aid debugging
 * @package contextvoice
 * @subpackage Response
 */
class cv_Response{
 
/**
   * an object derived from the output of the API call
   */
 
public $data;

 
/**
   * an object derived from the curl_getinfo method, provides information useful for handling network errors or API unavailability
   */
 
public $info;

 
/**
   * Constructor, only used by Main class
   * @ignore
   */
 
public function __construct($inData,$inInfo){
   
$this->data = json_decode($inData);
   
$this->info = $inInfo;
  }
}
?>