Plugin Class mit Remote-Service

class my_remote_recommendation_service extends ecs_eApplication{
	[...]
	/**
	 * Kunden Produktempfehlung über Remote-Service
	 *
	 * @param    Array $params optional.
	 * [quantity] - Integer, optional (default: 3).  Ergebnis Produktanzahl
	 *
	 * @return    Array.
	 * %r_status_msg%
	 * [data] - Array.  ecs_product eList
	 *         [<n>][<product-fields>] - Mixed.
	 */
	public function person_getRecommendedProducts($params=null)
	{
	    $P = array();
	    $R = array('status'=>true, 'msg'=>null, 'data'=>null);
 
	    /** ********************************************************
	     *
	     *      SESSION / User-Data available?
	     *
	     * Über den "$this->eCS->_sessData" Pointer, der über die Class "ecs_eApplication"
	     * vererbt wird, haben wir Zugriff auf die Shop-Session.
	     * Unterhalb des "person" Array-Key sind die Kunden-Daten verfügbar, wenn der
	     * User als Shop-Kunde identifiziert wurde.
	     */
	    if (is_array($this->eCS->_sessData['person']['data'])==true){
	        /**
	         * In den Session-Daten sind die Kunden-Daten vorhanden. Aus den
	         * Kunden-Daten werden Geschlecht, Alter und PLZ als Parameter
	         * für den Remote-Produktempfehlung übernommen.
	         */
	        $P[] = 'gender='.urlencode($this->eCS->_sessData['person']['data']['gender']);
	        $P[] = 'age='.urlencode($this->eCS->_sessData['person']['data']['drvd_age']);
	        $P[] = 'zip='.urlencode($this->eCS->_sessData['person']['data']['zip']);
 
	    } else {
	        /**
	         * Der aktuelle User wurde nicht als Shop-Kunde erkannt. Es fehlen die
	         * Parameter für die Produktempfehlung-Abfrage.
	         * Alternative zum leeren Result, könnte hier eine Produktempfehlung
	         * mit Default-Daten erfolgen.
	         */
	        return $R;
	    }
 
 
	    /** ********************************************************
	     *
	     *      ... use extra eCMS-Function-Parameter (if given).
	     *
	     * In dem "$params" Array können Parameter für die Datenabfrage übergeben
	     * werden. In unserem Beispiel kann die Ergebnis Produktanzahl
	     * aus dem Produktempfehlung-Service als Parameter übergeben werden.
	     * Wenn kein "quantity" Parameter gesetzt wurde, wird eine
	     * Default-Anzahl verwendet.
	     */
	    if ($params['quantity'] > 0){
	        $P[] = 'quantity='.intval($params['quantity']);
	    } else {
	        $P[] = 'quantity=3';
	    }
 
 
	    /** ********************************************************
	     *
	     *      execute remote CURL-CALL
	     *
	     * Im folgenden wird die Anfrage an den fiktiven Produktempfehlung-Remote-Service
	     * über die CRUL-Erweiterung gesendet.
	     */
	    $ch = curl_init();
	    curl_setopt($ch, CURLOPT_URL, 'http://www.example.com/api/recommendation/person?'.implode('&', $P));
	    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	    $text = curl_exec($ch);
	    $info = curl_getinfo($ch);
 
	    if ($info['http_code'] == 200 && strlen($text) > 0){
 
	        /** ********************************************************
	         *
	         *      enrich ReCo-Result with local eCMS-Product-Data.
	         *
	         * Die Anfrage war erfolgreich und hat bspw. eine Liste von Produktcodes (durch
	         * Komma getrennt) zurückgeliefert.
	         * Mit den Produktcodes aus Produktempfehlung-Service wird nun aus dem
	         * Shopsystem die vollständige Produktliste abgefragt.
	         */
	        $prds =  $this->eCS->ecs_product_dsf->product_getListManually(
	            array(
	                'pcode_list' => explode(',', $text)
	            )
	        );
 
	        $R['data'] = $prds['data'];
 
	    } else {
	        /**
	         * Die Anfrage an den Remote-Service ist fehlgeschlagen. Über die Methode
	         * "log_error" kann detaillierte Fehlermeldung ins Systemlog geschrieben werden.
	         * Mit der "msg_error_i18n" Methode wird eine Fehlermeldung mit i18n-Textbaustein
	         * erzeugt, die für die Shop-User verwendet wird und übersetzt werden kann.
	         * Mit dem "status = false" im Result, meldet die Methode an den Aufrufer zurück,
	         * dass ein technischer Fehler aufgetreten ist.
	         */
	        $this->log_error('Request failed ...');
	        $R['msg'][] = $this->msg_error_i18n('recommendation_service_request_failed');
	        $R['status'] = false;
	    }
 
	    return $R;
	}
	[...]