-/**
- * PrimeraApi
- * -------------------------------------------
- * Mit dieser Klasse ist ein einfacher Primeratransfer von Ihrem Account
- * zu dem Account eines bei Primusportal.de registrierten Mitglieds m�glich.
- *
- *------------------ Aenderungen durch Roland Haeder 09.08.2008 ----------------
- * Klasse umbenannt nach PrimeraApi, damit sie in das Framework besser passt.
- * Zudem sind alle oeffentlichen Attribute nun privat, der Konstruktor hat den
- * neuen "magischen" Namen __construct() und "normale" Konstanten sind nach
- * Klassenkonstanten umbenannt. Unsinnige else-Bloecke sind noch umgewandelt.
- * Methodennamen fangen nun immer mit einem kleinen Buchstaben an. Zudem sind
- * die Methoden Pay,Query und Parse umbenannt.
- *------------------ Aenderungen durch Roland Haeder 09.08.2008 ----------------
- *
- * Die Einbindung des Interfaces geschieht folgenderma�en:
- * 1. Einbindung der Klasse in Ihr PHP-Auszahlungsskript:
- * CODE:
- * require_once( "PFAD/ZU/DER/KLASSE/PrimeraApi.class.php" );
- * $PPUsername = "username"; // Ihr Username bei Primusportal
- * $PPPassword = "passwort"; // Ihr Passwort bei Primusportal
- *
- * $Interface = new PrimeraApi($PPUsername, $PPPassword);
- * 2. Durchf�hren einer Auszahlung:
- * CODE:
- * $Status = $Interface->payPrimera($PayReceiver, $PayAmount, $PayDescription);
- *
- * Wobei $PayReicer der Username des Empf�ngers bei
- * Primusportal.de ist. $PayAmount ist der gerundete( !! ) Betrag an Primera,
- * die der Empf�nger erhalten soll. $PayDescription ist eine von Ihnen
- * festgelegte kurze Beschreibung. Die L�nge dieses Textes darf 100 Zeichen
- * nicht �berschreiten. Beispiel:
- * $status = $Interface->payPrimera("garbage", 10000, "Auszahlung IhreSeite.de - id: 12345");
- * 3. �berpr�fung des Status (R�ckgabecode):
- * CODE:
- * if (!$status) {
- * // Ein Fehler ist aufgetreten
- * // Fehlerbehandlung hier einf�gen...
- * }else {
- * // Auszahlung erfolgreich durchgef�hrt
- * // F�hren Sie hier Ihre Datenbankabfragen durch, um die Auszahlung zu
- * // best�tigen...
- * }
- *
- * Die komplette R�ckgabe des Interfaces wird als assoziatives Array in der Klassen-
- * variable __data gespeichert:
- * __data => array('status' => R�ckgabecode (PI_DONE, PI_SENDER_ERROR, ...),
- * "statustext" => Status in Worten (z.B.: "Transaktion erfolgreich durchgef�hrt"),
- * ")
- *
- *
- * @author Andreas Schmidt <xxgarbagexx@web.de>
- * @author Roland Haeder <webmaster@ship-simu.org>
- * @version 1.0 - beta
- * @copyright (c) 2007 by Primusportal.de
- * @copyright (c) 2008 by Roland Haeder
- * @copyright 2009, 2010 by Mailer Developer Team
- */
-class PrimeraApi {
- /**
- * Fehler - Interfacebenutzer
- */
- const PI_ERROR = -1;
-
- /**
- * Statuscode f�r erfolgreich ausgef�hrte Transaktion
- */
- const PI_DONE = 200;
-
- /**
- * Fehler - User existiert nicht oder ist gesperrt
- */
- const PI_RECEIVER_ERROR = 301;
-
- /**
- * Sender-Account Fehler (User nicht existent, gesperrt, ...)
- */
- const PI_SENDER_ERROR = 401;
-
- /**
- * Betrag fehler
- */
- const PI_AMOUNT_ERROR = 501;
-
- /**
- * Zu wenig Primera
- */
- const PI_TOO_LESS_PRIMERA = 502;
-
- /**
- * User nicht aktiv oder existiert nicht
- */
- const PI_USER_CHECK_ERROR = 601;
-
- /**
- * User aktiv
- */
- const PI_USER_CHECK_OK = 602;
-
- /**
- * Primerastand erfolgreich geholt
- */
- const PI_GET_PRIMERA_DONE = 701;
-
- /**
- * URL f�r das Interface auf dem Primusserver:
- */
- var $host = 'http://www.primusportal.de';
- var $path = '/transfer.interface.2.0.php';
-
- var $errno = '0';
- var $err = '';
-
- var $separator = ':';
-
- var $username = '';
- var $password = '';
-
- var $data = array();
-
- var $headers = '';
-
- /**
- * Konstruktor
- */
- function PrimeraApi ($PPUsername, $PPPassword) {
- // Set data
- $this->username = $PPUsername;
- $this->password = $PPPassword;
- }
-
- /**
- * Anfrage senden und R�ckgabecode in Variable speichern
- */
- function queryApi ( $data = array() ) {
- // Base64-encode username and password hash
- $data['PrimusInterface_Username'] = base64_encode($this->username);
- $data['PrimusInterface_Password'] = base64_encode($this->password);
-
- // Send POST request
- $return = sendHttpPostRequest($this->host.$this->path, $data);
-
- // Convert the array into a full string
- $returnStr = implode(chr(10), $return);
-
- // Extract the real content, strip header away
- $content = explode('<!-- return-start -->', $returnStr);
-
- // Store headers away for debugging
- $this->headers = $content[0];
-
- // Return the content
- return $content[1];
- }
-
- /**
- * Funktion parst die R�ckgabe vom Transferskript:
- */
- function parseContent ( $content ) {
- $x = explode(chr(10), $content);
- $return = array();
- foreach ($x as $currentLine) {
- $line_exploded = explode(':', $currentLine,2);
- if (count($line_exploded) > 1) {
- $return[$line_exploded[0]] = $line_exploded[1];
- }
- }
- return $return;
- }
-
- /**
- * @param int/string $Receiver UserID / Username des Empf�ngers
- * @param int $Amount Betrag in ganzzahligen Primera
- * @param string $Description Beschreibung (Sichtbar in Einzelauflistung)
- */
- function payPrimera ($Receiver, $Amount, $Description = '') {
- $valid = FALSE;
- $postData = array('PrimusInterface_Action' => 'Pay',
- 'PrimusInterface_Receiver' => base64_encode($Receiver),
- 'PrimusInterface_Amount' => base64_encode($Amount),
- 'PrimusInterface_Description' => base64_encode($Description) );
-
- $postReturn = $this->parseContent( $this->queryApi($postData) );
-
- $this->data = $postReturn;
- if ($postReturn['status'] == '200') {
- $valid = TRUE;
- }
- return $valid;
- }
-
- /**
- * �berpr�ft den Status eines Primus-Users
- * - existiert der User
- * - ist er aktiv
- * @param string/int $User Userid / Username
- */
- function CheckPrimusUser($User) {
- $valid = FALSE;
- $postData = array('PrimusInterface_Action'=> 'CheckPrimusUser',
- 'PrimusInterface_CheckPrimusUser' => $User);
-
- $postReturn = $this->parseContent( $this->queryApi($postData) );
-
- $this->data = $postReturn;
-
- if ($postReturn['status'] == self::PI_USER_CHECK_OK) {
- $valid = TRUE;
- }
- return $valid;
- }
-
- /**
- * Die Funktion liefer den aktuellen Primerastand
- */
- function getPrimera() {
- $primera = FALSE;
- $postData = array( 'PrimusInterface_Action' => 'GetPrimera' );
- $postReturn = $this->parseContent( $this->queryApi($postData) );
-
- $this->data = $postReturn;
- if ($postReturn['status'] == self::PI_GET_PRIMERA_DONE) {
- $primera = $postReturn['primera'];
- }
- return $primera;
- }
-
- /**
- * Getter fuer data
- */
- function getData () {
- return $this->data;
- }
-}
-
-// [EOF]
-?>
projects / mailer.git / commitdiff