Katalog części Allegro na stronie WordPress

Klient: Auto Moto Georg – sprzedaż części samochodowych
Zakres: autorska wtyczka WordPress integrująca stronę firmową z kontem sprzedawcy na Allegro
Technologie: WordPress, PHP, Allegro REST API, OAuth 2.0, JavaScript

Auto Moto Georg - katalog części zasilany ofertami z Allegro

Wyzwanie

Firma sprzedaje części przez Allegro i ma tam kilkaset aktywnych ofert. Strona firmowa istniała obok tej sprzedaży, ale o niej nie wiedziała – była wizytówką, a nie katalogiem.

Oczywiste rozwiązanie, czyli przepisanie oferty na stronę, odpadało z jednego powodu: oznaczałoby prowadzenie dwóch magazynów naraz. Ceny na Allegro zmieniają się często, oferty się kończą, dochodzą nowe. Ręcznie utrzymywana kopia rozjechałaby się w tydzień, a klient trafiający ze strony na nieaktualną cenę to gorszy scenariusz niż brak katalogu w ogóle.

Do rozwiązania było więc:

  • Jedno miejsce zarządzania ofertą – sprzedawca pracuje tam, gdzie zawsze, czyli w panelu Allegro.
  • Strona jako pełnoprawny katalog – z wyszukiwaniem i filtrowaniem, a nie prostą listą linków.
  • Spójny wygląd – oferty muszą wyglądać jak część serwisu, a nie jak wklejony widget.
  • Wydajność – odpytywanie API przy każdym wejściu użytkownika jest wolne i szybko uderza w limity.

Rozwiązanie

Napisaliśmy wtyczkę, która pobiera oferty wprost z konta Allegro przez oficjalne REST API i wyświetla je na stronie jako natywny katalog produktów, w pełni zgodny ze stylistyką serwisu.

Sprzedawca nie robi nic poza swoją normalną pracą. Wystawia ofertę na Allegro - pojawia się na stronie. Kończy ją - znika. Zmienia cenę - strona pokazuje nową.

Co dostał klient:

Katalog z wyszukiwarką

po nazwie części - kluczowe przy asortymencie, w którym klient szuka konkretnego numeru lub modelu.

Filtr kategorii

z nazwami pobieranymi bezpośrednio z Allegro, więc struktura katalogu zawsze odpowiada tej, którą sprzedawca faktycznie stosuje.

Sortowanie

według ceny rosnąco i malejąco oraz alfabetycznie.

Stopniowe wczytywanie

przyciskiem „Pokaż więcej" zamiast jednej długiej listy, z pulą do 1000 ofert do przeszukania.

Podstronę szczegółów oferty

pełny opis, specyfikacja z parametrami pobranymi z Allegro, galeria zdjęć i duży przycisk „Kup na Allegro" otwierający transakcję w nowym oknie.

Układ z lewą kolumną kategorii

i numerowaną paginacją, dla osób przyzwyczajonych do nawigacji rodem z dużych marketplace'ów.
				
					// katalog czyta wprost z konta Allegro —
// bez drugiej bazy produktów do utrzymania

private function pobierz_oferty() {

    $bufor = get_transient(self::KLUCZ);
    if (! empty($bufor)) return $bufor;

    $odpowiedz = wp_remote_get(self::API . '/sale/offers', [
        'headers' => [
            'Authorization' => 'Bearer ' . $this->token(),
            'Accept'        => 'application/vnd.allegro.public.v1+json',
        ],
    ]);

    $oferty = $this->rozpakuj($odpowiedz);

    // pusta odpowiedź NIGDY nie trafia do bufora —
    // inaczej chwilowa awaria API zamraża pusty
    // katalog na wiele godzin po jej ustaniu
    if (! empty($oferty)) {
        set_transient(self::KLUCZ, $oferty, HOUR_IN_SECONDS);
    }

    return $oferty;
}

/* OAuth, stronicowanie puli ofert, filtry kategorii
   i widok szczegółów oferty — poza kadrem */
				
			

Rozwiązania, które okazały się potrzebne w praktyce

Podstrony tematyczne bez duplikowania katalogu. Firma chciała mieć osobne strony pod konkretne grupy części, ale bez utrzymywania kilku niezależnych katalogów. Wtyczka przyjmuje parametry frazy i kategorii, więc ta sama oferta może zasilić dowolną liczbę podstron, każdą zawężoną tematycznie. To ma znaczenie dla SEO – pozwala budować treści pod konkretne zapytania zamiast jednej ogólnej strony „części”.

Widok listy i widok szczegółów w jednym miejscu. Cały katalog obsługuje jeden krótki kod. Bez parametrów pokazuje siatkę ofert, a po kliknięciu produktu ten sam element wyświetla jego szczegóły. Klient nie musiał zakładać ani konfigurować dodatkowych podstron.

Ostrożne buforowanie. Odpowiedzi z API są zapamiętywane, żeby strona działała szybko i nie uderzała w limity zapytań. Kluczowy detal: pusta odpowiedź nigdy nie trafia do bufora. Bez tego zabezpieczenia jedna chwilowa awaria API zapisałaby pusty katalog i strona pokazywałaby „brak ofert” długo po tym, jak wszystko wróciło do normy.

Pole własnego CSS w ustawieniach. Drobiazg, który oszczędza obu stronom czasu – właściciel może poprawić szczegół wyglądu bez zgłaszania tego jako zadania programistycznego.

Efekt

Zero podwójnej pracy

jedna oferta, jedno miejsce zarządzania.

Strona przestała być wizytówką

i zaczęła pracować jako katalog z realną treścią.

Ruch z wyszukiwarek na konkretne części

dzięki podstronom tematycznym zamiast jednej ogólnej listy.

Klient trafia na Allegro z decyzją już podjętą

obejrzał zdjęcia i specyfikację po drodze.

Brak ryzyka rozjazdu cen

nie ma czego rozjeżdżać, bo dane pochodzą z jednego źródła.

Podsumowanie

Sprzedajesz na Allegro, ale chcesz mieć własną stronę, która na tym korzysta? Nie trzeba przenosić sprzedaży ani prowadzić drugiego katalogu. Wystarczy połączyć jedno z drugim tak, żeby wszystko żyło własnym życiem.