Panel Aukcji Allegro - Miniaturki Aukcji Trwających - w najprostszej formie jest to lista innych aukcji użytkownika, umieszczona na stronie O mnie i/lub na każdej jego aukcji. Od jakiegoś czasu, coraz rzadziej widuje się panele w takiej prostej formie - zazwyczaj są to teraz duże, nasączone grafiką skrypty php.

Ten artykuł nie ma na celu pokazania krok po kroku jak napisać taki panel aukcji, ale tylko wprowadzić osoby zainteresowane w ten temat. Osoby niecierpliwe, lub nie znające się na programowaniu w PHP zapraszam do testowania darmowej wersji panelu aukcji. Zdaję sobie sprawę że istnieją inne sposoby pobierania danych z allegro (jak to ktoś gdzieś napisał - zżerają mnóstwo transferu i wyglądają jak Gołota po walce), ale ten art opisuje tylko jeden sposoób - moim zdaniem najbardziej elegancki.

Zacząć należy od zapoznania z tą stroną

i z tą

oraz pobrania swojego klucza WEBAPI.

Dokumentacja WEBAPI nie zawiera obszernej dokumentacji z licznymi przykładami, ale do prostego panelu nie trzeba wiele :)

1. Pobieranie aukcji Allegro

Komunikacja z serwisem allegro odbywać się będzie poprzez SOAP . PHP należy skompilować z obsługą soap lub użyć klasy nusoap do jej obsługi ... będą jeszcze potrzebne jakieś grafiki i czcionki, ale o tym dalej.

Dla ułatwienia pracy i uporządkowania całego kodu najlepiej zacząć od napisania klasy allegro.inc.php , która będzie odpowiedzialna za komunikację z allegro, oraz pozwoli nam wydzielić całą logikę w innym pliku.

class Allegro {
public function __construct($opcje=array())
{
 foreach($opcje as $n->$v) $this->$n=$v;
}
public function login()
{
  $this->soap = new SoapClient('http://webapi.allegro.pl/uploader.php?wsdl', array('encoding'=>'UTF-8'));
  $this->soap->soap_defencoding = 'UTF-8';
  $this->soap->decode_utf8 = false;

  $params = array(
   'sysvar' => 1, // 1 dla AllegroWebApi
   'country-id' => $this->country_code,
   'webapi-key' => $this->webapi_key
  );
  $result = $this->soap->__soapCall('doQuerySysStatus',$params);
  $this->local_version = $result['ver-key'];

  $msg = array(
   'user-login' => $this->login,
   'user-password' => $this->haslo,
   'country-code' => $this->country_code,
   'webapi-key' => $this->webapi_key,
   'local-version' => $this->local_version
  );

  $response = $this->soap->__call('doLogin', $msg);
  $this->session_handle_part= $response['session-handle-part'];
  $msg= array('country-id'=> $this->country_code, 'user-login'=>$this->login);
  $this->user_id= $this->soap->__call('doGetUserID', $msg);
return true;
}
(...)
}

Jak widzimy podajemy do konstruktora tablicę z parametrami ( takimi jak login, hasło, webapi, country-code ) i zapisujemy ją wewnątrz. Pozwoli to na szybką zmianę. Wartość local-version jest inna , gdy w oprogramowaniu webapi jest jakaś zmiana. Na potrzeby tego skryptu uznałem że można ją zawsze pobierać z serwisu - są to proste działania, które raczej się nie zmienią. W normalnym (większym) programie trzeba po zmianie tej wartości sprawdzić czy wszystkie funkcje działają poprawnie ....

Po pobraniu local-version następuje logowanie do systemu allegro, zapisanie wartości session-handle-part (potrzebne później), oraz pobranie identyfikatora użytkownika allegro - czyli userID.

Następną funkcją jest pobranie wszystkich (t.zn. tyle, ile chcemy wyświetlać w panelu np.6 ) aukcji użytkownika, oraz ich zapisanie. No właśnie zapisanie. Tutaj możliwości jest kilka. Zapisujemy z tego powodu iż jak zauważymy później logowanie oraz pobranie aukcji jest czasochłonne, także bez sensu by było aby za każdym razem gdy ktoś wejdzie na naszą aukcję powtarzać tę czynność. Częstotoliwość pobierania należy ustawić indywidualnie , ja przyjąłem 30 minut. Jak napisałem wcześniej możliwości zapisu aukcji jest kilka np. do pliku, do bazy danych czy też do pamięci. Najbardziej spodobała mi się ta ostatnia metoda, wykorzystałem do tego MemCache . Czemu ? Jest szybki, automatycznie kasuje stare aukcje z pamięci i ... bo lubię :)

Fragment kodu odpowiedzialnego za pobranie listy aukcji alllegro :

$msg=array(
  'user-id' => $this->user_id,
  'webapi-key' => $this->webapi_key,
  'country-id' => $this->country_code,
  'offset' => $this->offset); // np. 0
$allAuctions= $this->soap->__call('doGetUserItems', $msg);

Teraz poprzez iterację pobieramy po kolei każdą aukcję i ją zapisujemy. Powinniśmy tutaj sprawdzać, czy aukcja nie kończy się przed czasem ('it-time-left') następnego pobierania, u nas 30 minut.
Każda aukcja ma unikalny ID ('it-id'), można wykorzystać go do zapisu obrazków z aukcji - sprawdzamy czy już taki istnieje jeśli nie pobieramy go i zapisujemy w jakimś katalogu :

$obrazek='/allegro/zdjecia/'.$aukcja['it-id'].'.jpg';
  if(!file_exists($obrazek))
   {
   $msg=array(
    'session-handle' => $this->session_handle_part,
    'item-id' => $aukcja['it-id'],
    'get-desc'=>0,
    'get-image-url' => 1
   );
  $res = $this->soap->__call('doShowItemInfo', $msg);
  $res = get_object_vars($res['item-img-list'][0]);
  $img = $this->getImage($res['image-url']);
  $f = fopen($obrazek,"w");
  fwrite($f, $img);
  fclose($f);
  }
}

i funkcja do pobrania obrazka ( PHP musi mieć włączoną obsługę CURL'a ) :

private function getImage($url='')
{
  if(empty($url)) return '';
  $ch = curl_init($url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_BINARYTRANSFER, true);
  $output = curl_exec($ch);
  return $output;
}

na końcu, zapisujemy aukcję :

private function saveAuctions($aukcje=array())
{
$memcache = new Memcache;
$memcache->connect('localhost', 11211) or die ("Nie mogę się połączyć z memcache!");
if(!$memcache->set($this->login, $aukcje, false, $this->saveTime)) die("Nie udało się zapisać danych do memcache'a"); // 30 minut
}

Tak przygotowaną i odpowiednio przez nas dopieszczoną klasę Allegro wykorzystujemy w skrypcje poniżej, nazywając go odpowiednio pobierz_aukcje.php i uruchamiając poprzez CRON co np. 30 minut (ustalone wcześniej) :

$op['login'] = 'NASZ_LOGIN';
$op['haslo'] = 'NASZE_HASLO';
$op['country_code'] = '1'; // dla allegro
$op['webapi_key'] = 'NASZ_WEBAPI_KEY';

require_once('./allegro.inc.php');

$all = new Allegro($op);
$all->getAuctionsFromAllegro(6); // ile ma pobrać, np 6

2. Wyświetlanie panelu

Jak działa wyświetlanie panelu aukcji ? Administratorzy allegro, zabronili (wyłączyli) możliwość uruchamiania skryptów JavaScript na stronach "O mnie" i poszczególnych aukcjach. Jak wiadomo powszechnie Polak Potrafi , więc wynaleziono kilka sposobów. Dwa najbardziej popularne to chyba :

• Tag HTML AREA
• Tag HTML A

Działa to na takiej zasadzie, że tworzy się np. tabelkę (może być lista) obrazków ponumerowanych kolejno , które są linkami z parametrem ID takim samym jak ID IMG. SRC obrazka pobierane jest z naszego servera. Linki są kierowane także na nasz server. Może to troszkę źle wytłumaczyłem, (wybaczcie nie jestem nauczycielem) ale zaraz wszystko się wyjaśni.

Np. pierwsza komórka z aukcją w tabelce mogłaby wyglądać tak :

<a title="Zobacz naszą inną aukcję!" href="http://www.naszserver.pl/allegro/panel_aukcji.php?aukcja=1">
<img src="http://www.naszserver.pl/allegro/panel_aukcji.php?img=1" alt="" />
</a>

Wyświetlane są kolejno obrazki pobrane wcześniej, nakładamy na nie tytuł aukcji, cenę i czas do końca. Po kliknięciu na taki link skrypt pobiera adres aukcji (zapisany w czasie iteracji w skrypcie pobierz_aukcje.php ) i przekierowywuje nas na nią. Proste, nie ?

No i to by było na tyle ... udostępniłem darmową wersje skryptu pod tym adresem

Polecam także za kurs za kilka złotych jak pokonać konkurencję (obronić się przed konkurencją) na allegro