Instalare

Sectiunile paginii:

• marketplace - API wrapper
• marketplace_example - Exemple pentru folosirea API wrapper-ului

---

marketplace

CEL.ro Marketplace API wrapper in PHP

Instalarea se poate face in 2 moduri: folosind pachetul de pe packagist si manual. Mai jos sunt detaliate ambele moduri.

Programe necesare

1. PHP >= 5.3
2. composer

Instalare

Metoda 1. Packagist (recomandata)

Metoda 1.1.

1. Creati un fisier denumit composer.json cu urmatorul continut

   {  
       "require": {  
           "celdotro/marketplace": "~1.1"
       },
       "prefer-stable": true
   }

2. Rulati urmatoarea comanda

   composer install

Metoda 1.2.

Rulati urmatoarea comanda

composer require celdotro/marketplace

Metoda 2. Git clone

1. Rulati urmatoarea comanda

   git clone https://github.com/celdotro/marketplace.git

2. In folderul nou creat, rulati urmatoarea comanda

   composer install

Configurare

Pentru a folosi oricare dintre metodele API wrapper-ului, va trebui sa va autentificati in script-ul PHP folosind

use celmarket\Auth;
Auth::setUserDetails('USERNAME', 'PASSWORD');

marketplace_examples

Exemple pentru folosirea API Wrapper-ului pentru CEL.ro Marketplace.
Se recomanda folosirea acestui proiect impreuna cu pagina de WIKI. Proiectul poate fi accesat la urmatoarea adresa: https://github.com/celdotro/marketplace_examples
Mai multe informatii despre proiect si structura fisierelor: https://github.com/celdotro/marketplace_examples#ro

Instalare

1. Cloneaza repository-ul git

   git clone https://github.com/celdotro/marketplace_examples.git

2. In folderul nou creat, ruleaza urmatoarea comanda

   composer install

Folosire

Metoda 1. Ruleaza fiecare fisier manual (recomandata)

1. Gaseste urmatoarea instructiune in fisier si inlocuieste USERNAME (nume de utilizator) si PASSWORD (parola) cu cele pe care le detii

   Auth::setUserDetails('USERNAME', 'PASSWORD');

2. Ruleaza fisierul folosind interpretorul de PHP

   php /PATH_TO_PROJECT/Orders/1.getOrdersSummary.php

3. Decide daca doresti sa folosesti serverul demo sau cel live. Daca vrei sa folosesti server-ul live, comenteaza linia de cod:

   celmarket\Config::setDemo();

Fisierul index.php contine un cuprins generat automat al directoarelor si fisierelor principale din proiect. Pentru accesare, rulati:

php index.php

Metoda 2. Foloseste un server

Fisierul index.php contine un cuprins generat automat al directoarelor si fisierelor principale din proiect.
Raspunsul nu este optimizat pentru browser, deoarece acest proiect contine o colectie de exemple, nu o interfata web.

1. Gaseste urmatoarea instructiune in fisierul "api_include.php" si inlocuieste USERNAME (nume de utilizator) si PASSWORD (parola) cu cele pe care le detii

   Auth::setUserDetails('USERNAME', 'PASSWORD');

2. Decide daca doresti sa folosesti serverul demo sau cel live. Daca vrei sa folosesti server-ul live, comenteaza linia de cod:

   celmarket\Config::setDemo();

3. Deschide urmatorul link in browser si viziteaza pagina fisierului modificat la punctul 1 (inlocuieste asteriscurile cu adresa serverului)

   http://****/marketplace_examples/index.php
   

marketplace.wiki

Pentru a clona acest wiki, folositi:

 git clone https://github.com/celdotro/marketplace.wiki

Update 1.18.0

Incepand cu versiunea 1.18.0 venim in ajutorul dezvoltatorilor ce administreaza mai multe conturi.
A fost adaugat inca un parametru (optional) in metoda setUserDetails.
Acesta trebuie sa extinda clasa AuthProvider, si sa contina metodele obligatorii din aceea clasa.
Daca nu este trimis acest parametru, se va utiliza implicit clasa AuthProviderFile care va salva pentru fiecare cont token-ul in fisier diferit.
Pentru sisteme UNIX, token-urile vor fi salvate implicit in directorul /tmp/, iar pentru Windows in directorul parinte al scriptului.
Pe langa acest parametru a fost adaugata si metoda setProviderID care primeste un singur parametru. Acest parametru poate ajuta developerii ce vor sa distinga conturile de afiliat printr-un ID unic sau alt tip de identificator.
Exemplu utilizare metoda setProviderID pentru clasa AuthProviderFile:

AuthProviderFile::setProviderID(string|array|object);

Exemplu complet cu AuthProviderFile ca si clasa folosita:

AuthProviderFile::setProviderID('abc');
Auth::setUserDetails('test', '1234', AuthProviderFile::class);

Puteti citi fiserele asa cum sunt sau cu ajutorul unui interpretor de Markdown. Cu toate acestea, este recomandat sa nu clonati acest wiki, ci sa-l cititi direct de pe github.