mirror of
https://git.friendi.ca/friendica/friendica-addons.git
synced 2024-08-19 22:00:23 +00:00
248 lines
6.9 KiB
PHP
Executable file
248 lines
6.9 KiB
PHP
Executable file
<?php /*
|
|
Name: Posterous API Library
|
|
Description: Object-oriented PHP class for accessing the Posterous API
|
|
Author: Calvin Freitas
|
|
Version: 0.1.0
|
|
Author URI: http://calvinf.com/
|
|
License: MIT License (see LICENSE) http://creativecommons.org/licenses/MIT/
|
|
Warranties: None
|
|
Last Modified: December 07, 2009
|
|
Requirements: PHP 5 or higher.
|
|
*/
|
|
|
|
/*
|
|
Copyright (c) 2009 Calvin Freitas
|
|
|
|
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.
|
|
*/
|
|
|
|
/* Define Static Variables */
|
|
define('POSTEROUS_API_LIBRARY_VERSION','1.0');
|
|
define('POSTEROUS_API_LIBRARY_RELEASE_DATE','December 07, 2009');
|
|
define('POSTEROUS_API_LIBRARY_URL','http://calvinf.com/projects/posterous-api-library-php/');
|
|
define('POSTEROUS_API_LIBRARY_AUTHOR_NAME','Calvin Freitas');
|
|
define('POSTEROUS_API_LIBRARY_AUTHOR_URL','http://calvinf.com/');
|
|
define('POSTEROUS_API_LIBRARY_AUTHOR_EMAIL','cal@calvinfreitas.com');
|
|
|
|
define('POSTEROUS_API_URL', 'http://posterous.com/api/');
|
|
|
|
// ensure Curl extension installed
|
|
if(!extension_loaded("curl")) {
|
|
throw(new Exception("The Curl extension for PHP is required for PosterousAPI to work."));
|
|
}
|
|
|
|
/* Useful to catch this exception separately from standard PHP Exceptions */
|
|
class PosterousException extends Exception {}
|
|
|
|
/* This class contains functions for calling the Posterous API */
|
|
class PosterousAPI {
|
|
private $user;
|
|
private $pass;
|
|
|
|
function __construct($user = NULL, $pass = NULL) {
|
|
$this->user = $user;
|
|
$this->pass = $pass;
|
|
}
|
|
|
|
/* Reading Methods - http://posterous.com/api/reading */
|
|
function getsites() {
|
|
$api_method = 'getsites';
|
|
$xml = $this->_call( $api_method );
|
|
return $xml;
|
|
}
|
|
|
|
function readposts($args) {
|
|
$api_method = 'readposts';
|
|
|
|
$valid_args = array('hostname','site_id','num_posts','page','tag');
|
|
$method_args = $this->_validate($args, $valid_args);
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
function gettags($args) {
|
|
$api_method = 'gettags';
|
|
|
|
$valid_args = array('hostname','site_id');
|
|
$method_args = $this->_validate($args, $valid_args);
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
/* Posting Methods - http://posterous.com/api/posting */
|
|
function newpost($args) {
|
|
$api_method = 'newpost';
|
|
|
|
if (!$this->_auth()) {
|
|
throw new PosterousException('Posterous API call "' . $api_method . '" requires authentication.');
|
|
}
|
|
|
|
$valid_args = array('site_id','media','title','body','autopost','private','date','tags','source','sourceLink');
|
|
$method_args = $this->_validate($args, $valid_args);
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
function updatepost($args) {
|
|
$api_method = 'updatepost';
|
|
|
|
if (!$this->_auth()) {
|
|
throw new PosterousException('Posterous API call "' . $api_method . '" requires authentication.');
|
|
}
|
|
|
|
$valid_args = array('post_id','media','title','body');
|
|
$method_args = $this->_validate($args, $valid_args);
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
function newcomment($args) {
|
|
$api_method = 'newcomment';
|
|
|
|
$valid_args = array('post_id','comment','name','email','date');
|
|
$method_args = $this->_validate($args, $valid_args);
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
/* Post.ly Methods - http://posterous.com/api/postly */
|
|
|
|
function getpost($args) {
|
|
$api_method = 'getpost';
|
|
|
|
$valid_args = array('id');
|
|
$method_args = $this->_validate($args, $valid_args);
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
/* Twitter Methods - http://posterous.com/api/twitter */
|
|
function upload() {
|
|
$api_method = 'upload';
|
|
|
|
$valid_args = array('username','password','media','message','body','source','sourceLink');
|
|
$method_args = $this->_validate( $args, $method_args );
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
function uploadAndPost() {
|
|
$api_method = 'uploadAndPost';
|
|
|
|
$valid_args = array('username','password','media','message','body','source','sourceLink');
|
|
$method_args = $this->_validate( $args, $method_args );
|
|
|
|
$xml = $this->_call( $api_method, $method_args );
|
|
return $xml;
|
|
}
|
|
|
|
|
|
/* Helper Functions */
|
|
private function _call($api_method, $method_args = NULL) {
|
|
$method_url = POSTEROUS_API_URL . $api_method;
|
|
|
|
$user = $this->user();
|
|
$pass = $this->pass();
|
|
|
|
$ch = curl_init();
|
|
curl_setopt($ch, CURLOPT_URL, $method_url);
|
|
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
|
|
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
|
|
curl_setopt($ch, CURLOPT_HEADER, false);
|
|
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
|
|
|
|
if (isset($user) && isset($pass) && $user != '' && $pass != '') {
|
|
curl_setopt($ch, CURLOPT_USERPWD, $user . ':' . $pass);
|
|
}
|
|
|
|
curl_setopt($ch, CURLOPT_POST, 1);
|
|
|
|
if ( is_array($method_args) && !empty($method_args) ) {
|
|
curl_setopt($ch, CURLOPT_POSTFIELDS, $method_args);
|
|
}
|
|
|
|
$data = curl_exec($ch);
|
|
//$response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
|
|
curl_close($ch);
|
|
|
|
$xml = '';
|
|
try {
|
|
$xml = new SimpleXMLElement($data);
|
|
|
|
$response_status = $xml['stat'];
|
|
if ($response_status == 'ok') {
|
|
return $xml;
|
|
}
|
|
elseif ($response_status == 'fail') {
|
|
throw new PosterousException('Error Code ' . $xml->err['code'] . ': ' . $xml->err['msg']);
|
|
}
|
|
else {
|
|
throw new PosterousException('Error: Invalid Posterous response status.');
|
|
}
|
|
}
|
|
catch (Exception $e) {
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
private function _validate($args, $valid_args) {
|
|
$method_args = array();
|
|
foreach($args as $key => $value) {
|
|
if( in_array($key, $valid_args) ) {
|
|
$method_args[$key] = $value;
|
|
}
|
|
}
|
|
|
|
return $method_args;
|
|
}
|
|
|
|
private function _auth() {
|
|
//checks if object has user & password, does not verify w/ Posterous
|
|
if (isset($this->user) && isset($this->pass) && $this->user != '' && $this->pass != '') {
|
|
return TRUE;
|
|
}
|
|
else {
|
|
return FALSE;
|
|
}
|
|
}
|
|
|
|
/* Getters & Setters */
|
|
function user($user = NULL) {
|
|
if ($user) {
|
|
$this->user = $user;
|
|
}
|
|
return $this->user;
|
|
}
|
|
|
|
function pass($pass = NULL) {
|
|
if ($pass) {
|
|
$this->pass = $pass;
|
|
}
|
|
return $this->pass;
|
|
}
|
|
}
|
|
|
|
?>
|