fidor_starter_kits 0.5.1 → 0.6.0

data/starter_kits/php_advanced/Fidor/SDK/Config.php

@@ -0,0 +1,272 @@
+<?php
+namespace Fidor\SDK;
+
+/**
+ * @method Fidor\SDK\Config setAccessToken( string $access_token )
+ * @method Fidor\SDK\Config setRefreshToken( string $refresh_token )
+ * @method Fidor\SDK\Config setUserAgent( string $user_agent )
+ * @method string getClientId()
+ * @method string getClientSecret()
+ * @method string getCallbackUrl()
+ * @method string getAccessToken( )
+ * @method integer getExpiresIn( )
+ * @method string getRefreshToken( ) 
+ * @method string getUserAgent( ) 
+ */
+class Config {
+    
+    /**
+     *
+     * @var string 
+     */
+    protected $client_id;
+    
+    /**
+     *
+     * @var string 
+     */
+    protected $client_secret;
+    
+    /**
+     *
+     * @var string 
+     */
+    protected $callback_url;
+    
+    /**
+     *
+     * @var boolean 
+     */
+    protected $sandbox;
+    
+    /**
+     *
+     * @var string 
+     */
+    protected $access_token;
+
+    /**
+     *
+     * @var integer 
+     */
+    protected $expires_in;
+   
+    /**
+     *
+     * @var string 
+     */
+    protected $refresh_token;
+    
+    /**
+     * The base string used to build endpoints. You can override specific
+     * endpoints by providing values for oauth_url and/or api_url keys in the config array
+     * 
+     * @var string 
+     */
+    protected $base_uri = 'fidor.de';
+    
+    /**
+     *
+     * @var string 
+     */
+    protected $user_agent = 'FidorSDK (+https://docs.fidor.de)';
+    
+    /**
+     *
+     * @var string 
+     */
+    protected $api_url;
+    
+    /**
+     *
+     * @var string 
+     */
+    protected $oauth_url;
+
+    /**
+     * Constructor
+     * 
+     * @param string $client_id
+     * @param string $client_secret
+     * @param boolean $sandbox
+     */
+    public function __construct( $client_id, $client_secret, $callback_url, $sandbox = false ) {
+        $this->client_id     = $client_id;
+        $this->client_secret = $client_secret;
+        $this->callback_url  = $callback_url;
+        $this->sandbox       = (bool) $sandbox;
+    }
+    
+    /**
+     * Handle setters/getters
+     * 
+     * @param string $name
+     * @param array $args
+     * @return mixed
+     */
+    public function __call( $name, $args ) {
+        if ( preg_match( '/^get(.*)/', $name, $m ) ) {
+            $property = strtolower( preg_replace( '/([a-z])([A-Z])/', '$1_$2', $m[1] ) );
+            if ( property_exists( $this, $property ) ) {
+                return $this->$property;
+            }
+        } elseif ( preg_match( '/^set(.*)/', $name, $m ) ) {
+            $property = strtolower( preg_replace( '/([a-z])([A-Z])/', '$1_$2', $m[1] ) );
+            if ( property_exists( $this, $property ) ) {
+                $this->$property = current( $args );
+                return $this;
+            }
+        }
+    }
+    
+    /**
+     * 
+     * @param integer $expires_in
+     * @return \Fidor\SDK\Config
+     */
+    public function setExpiresIn( $expires_in ) {
+        if ( preg_match( '/^\d+$/', $expires_in ) ) {
+            $this->expires_in = $expires_in;
+        }
+        return $this;
+    }
+    
+    /**
+     * 
+     * @return boolean
+     */
+    public function hasTokenExpired( ) {
+        if ( $this->expires_in < time() ) {
+            return true;
+        }
+        return false;
+    }
+    
+    /**
+     * 
+     * @return boolean
+     */
+    public function is_sandbox( ) {
+        return $this->sandbox;
+    }
+    
+    /**
+     * 
+     * @param string $url
+     * @return \Fidor\SDK\Config
+     */
+    public function setOAuthUrl( $url ) {
+        $this->oauth_url = $url;
+        return $this;
+    }
+    
+    /**
+     * Get base endpoint to OAuth authorization server
+     * 
+     * @return string
+     */
+    public function getOAuthUrl( ) {
+        // maybe use user provided OAuth url
+        if ( ! empty( $this->oauth_url ) ) {
+            return $this->oauth_url;
+        }
+        
+        return 'https://' . ( $this->sandbox ? 'aps' : 'apm' ) . '.fidor.de/oauth';
+    }
+    
+    /**
+     * 
+     * @param string $url
+     * @return \Fidor\SDK\Config
+     */
+    public function setApiUrl( $url ) {
+        $this->api_url = $url;
+        return $this;
+    }
+    
+    /**
+     * Get base endpoint used for API calls
+     * 
+     * @return string
+     */
+    public function getApiUrl( ) {
+        // maybe use user provided API url
+        if ( ! empty( $this->api_url ) ) {
+            return $this->api_url;
+        }
+        
+        return 'https://' . ( $this->sandbox ? 'aps' : 'api' ) . '.fidor.de';
+    }
+    
+    /**
+     * Create config instance from array
+     * 
+     * @param array $info
+     * @return \Fidor\SDK\Config
+     */
+    public static function fromArray( array $info ) {
+        if ( ! empty( $info['client_id'] ) && ! empty( $info['client_secret'] ) ) {
+            // default to sandbox
+            if ( ! $info['sandbox'] ) {
+                $info['sandbox'] = true;
+            }
+            
+            $sandbox = false;
+            $callback_url = null;
+            
+            if ( 1 == $info['sandbox'] OR 'yes' === $info['sandbox'] OR 'true' === $info['sandbox'] OR true === $info['sandbox'] ) {
+                $sandbox = true;
+            }
+            
+            if ( ! empty( $info['callback_url'] ) ) {
+                $callback_url = $info['callback_url'];
+            }
+            
+            $obj = new self( $info['client_id'],  $info['client_secret'], $callback_url, $sandbox );
+            
+            $props = array( 'user_agent', 'oauth_url', 'api_url' );
+            foreach ( $props as $prop ) {
+                if ( empty( $info[ $prop ] ) OR ! is_string( $info[ $prop ] ) ) {
+                    continue;
+                }
+                
+                $value = $info[ $prop ];
+                if ( 'user_agent' === $prop ) {
+                    $obj->setUserAgent( $value );
+                } elseif ( 'oauth_url' === $prop ) {
+                    $obj->setOAuthUrl( $value );
+                } elseif ( 'api_url' === $prop ) {
+                    $obj->setApiUrl( $value );
+                }
+            }
+            
+            return $obj;
+        }
+    }
+    
+    /**
+     * Create a config instance from JSON string
+     * 
+     * @param string $json
+     * @return \Fidor\SDK\Config
+     */
+    public static function fromJSON( $json ) {
+        $info = json_decode( $json, true );
+        if ( ! empty( $info['client_id'] ) && ! empty( $info['client_secret'] ) && isset( $info['sandbox'] ) ) {
+            return self::fromArray( $info );
+        }
+    }
+    
+    /**
+     * Create a config instance from JSON file
+     * 
+     * @param string $file
+     * @return \Fidor\SDK\Config
+     */
+    public static function fromJSONFile( $file ) {
+        if ( is_readable( $file ) ) {
+            return self::fromJSON( file_get_contents( $file ) );
+        }
+    }
+    
+}

data/starter_kits/php_advanced/Fidor/SDK/Customers.php

@@ -0,0 +1,27 @@
+<?php
+namespace Fidor\SDK;
+
+class Customers extends Client {
+
+    /**
+     * 
+     * @param \Fidor\SDK\Config $config
+     */
+    public function __construct( Config $config ) {
+        parent::__construct( $config );
+    }
+    
+    /**
+     * 
+     * @param integer $id
+     * @return string
+     */
+    public function get( $id = null ) {
+        $data = parent::get( $this->config->getApiUrl() . '/customers' );
+        if ( ! empty( $data['data'] ) ) {
+            $data = $data['data'];
+        }
+        return $data;
+    }
+    
+}

data/starter_kits/php_advanced/Fidor/SDK/Transactions.php

@@ -0,0 +1,47 @@
+<?php
+namespace Fidor\SDK;
+
+class Transactions extends Client {
+    
+    /**
+     * 
+     * @param \Fidor\SDK\Config $config
+     */
+    public function __construct( Config $config ) {
+        parent::__construct( $config );
+    }
+    
+    /**
+     * 
+     * @param integer|null $id
+     * @param integer|null $page
+     * @param integer|null $per_page
+     * @return string
+     */
+    public function get( $id = null, $page = null, $per_page = null ) {
+        $url = $this->config->getApiUrl() . '/transactions';
+        if ( $id ) {
+            $url .= '/' . $id;
+        } elseif ( is_numeric( $page ) OR is_numeric( $per_page ) ) {
+            $url .= '/?page=' . ( $page ? $page : 1 ) . '&per_page=' . ( $per_page ? $per_page : 10 );
+        }
+        $data = parent::get( $url );
+        if ( ! empty( $data['data'] ) ) {
+            $data = $data['data'];
+        }
+        return $data;
+    }
+    
+    
+    /**
+     * 
+     * @return string
+     */
+    public static function make_external_uid(){
+        if ( function_exists('com_create_guid') === true ) {
+            return trim(com_create_guid(), '{}');
+        }
+        return sprintf('%04X%04X-%04X-%04X-%04X-%04X%04X%04X', mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(16384, 20479), mt_rand(32768, 49151), mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(0, 65535));
+    }
+    
+}

data/starter_kits/php_advanced/Fidor/SDK/Transfers.php

@@ -0,0 +1,65 @@
+<?php
+namespace Fidor\SDK;
+
+/**
+ * @property \Fidor\SDK\Transfers_Internals $internal Internal transfers object
+ */
+class Transfers extends Client {
+    
+    /**
+     *
+     * @var integer 
+     */
+    protected $id;
+    
+    /**
+     *
+     * @var array 
+     */
+    protected $types = array( 'batch', 'global', 'internal', 'sepa' => array( 'SEPA' ) );
+    
+    /**
+     * 
+     * @param \Fidor\SDK\Config $config
+     */
+    public function __construct( Config $config ) {
+        parent::__construct( $config );
+    }
+    
+    /**
+     * 
+     * @param integer $id
+     * @return \Fidor\SDK\Transfers
+     */
+    public function setId( $id ) {
+        $this->id = $id;
+        return $this;
+    }
+    
+    /**
+     * 
+     * @param string $name
+     * @return mixed
+     */
+    public function __get( $name ) {
+        if ( in_array( $name, $this->types ) ) {
+            $name = 'Transfers_' . ucfirst( $name );
+        } elseif ( in_array( $name, array_keys( $this->types ) ) ) {
+            $name = 'Transfers_' . current( $this->types[ $name ] );
+        }
+        
+        return parent::__get( $name );
+    }
+    
+    /**
+     * 
+     * @return string
+     */
+    public static function make_external_uid(){
+        if ( function_exists('com_create_guid') === true ) {
+            return trim(com_create_guid(), '{}');
+        }
+        return sprintf('%04X%04X-%04X-%04X-%04X-%04X%04X%04X', mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(16384, 20479), mt_rand(32768, 49151), mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(0, 65535));
+    }
+    
+}

data/starter_kits/php_advanced/Fidor/SDK/Transfers/Batch.php

@@ -0,0 +1,18 @@
+<?php
+namespace Fidor\SDK;
+
+class Transfers_Batch extends Client {
+    
+    /**
+     * 
+     * @param \Fidor\SDK\Config $config
+     */
+    public function __construct( Config $config ) {
+        parent::__construct( $config );
+    }
+    
+    public function get( ) {
+        return parent::get( $this->config->getApiUrl() . '/batch_transfer' );
+    }
+    
+}

data/starter_kits/php_advanced/Fidor/SDK/Transfers/Global.php

@@ -0,0 +1,18 @@
+<?php
+namespace Fidor\SDK;
+
+class Transfers_Global extends Client {
+    
+    /**
+     * 
+     * @param \Fidor\SDK\Config $config
+     */
+    public function __construct( Config $config ) {
+        parent::__construct( $config );
+    }
+    
+    public function get( ) {
+        return parent::get( $this->config->getApiUrl() . '/global_money_transfers' );
+    }
+    
+}