Shoper ma w panelu wbudowanego bloga: Wygląd i treści › Blog. To dokładnie ten sam blog, do którego wysyłamy artykuły. Nie instalujesz żadnej wtyczki, nie zmieniasz szablonu i nie prosisz nikogo o pomoc techniczną.
Cała robota po Twojej stronie to wygenerowanie jednego tokenu i wklejenie go u nas. Poniżej masz to rozpisane klik po kliku, dokładnie takimi nazwami, jakie zobaczysz na ekranie.
Zanim zaczniesz
Potrzebujesz dwóch rzeczy.
- Dostępu do panelu administracyjnego sklepu na tyle szerokiego, żeby w menu po lewej rozwinąć Aplikacje i integracje i wejść w Zewnętrzne aplikacje. Jeśli Twoje konto tego nie widzi, poproś właściciela sklepu.
- Adresu swojego sklepu, czyli tego, który wpisują klienci: na przykład
mojsklep.plalbomojsklep.shoparena.pl. Jeśli wkleisz adres skopiowany z paska przeglądarki w panelu, ten z/admini resztą po ukośniku, sami przytniemy go do adresu sklepu i połączenie zadziała tak samo.
Nie musisz nic włączać po stronie bloga. Jeśli w panelu widzisz Wygląd i treści › Blog › Lista wpisów, to wszystko jest na miejscu.
Sklep na okresie próbnym też się nadaje. Jeśli w panelu widzisz pasek Sklep działa w wersji próbnej, nic nie stoi na przeszkodzie: API działa na wersji próbnej tak samo jak na opłaconej i sprawdziliśmy to na prawdziwym sklepie.
1. Wygeneruj token API
Shoper pozwala wygenerować token samodzielnie, bez kontaktu z pomocą techniczną i bez zakładania aplikacji w App Store. To jest droga, którą polecamy.
- Zaloguj się do panelu administracyjnego swojego sklepu.
- W menu po lewej rozwiń Aplikacje i integracje. Pod spodem pojawi się lista: APP Tools, Katalog aplikacji, Zainstalowane aplikacje, Własne integracje, Zewnętrzne aplikacje, Wbudowane integracje, Webhooki, Powiązane. Kliknij Zewnętrzne aplikacje. Otworzy się strona zatytułowana Integracje zewnętrzne.
- Kliknij DODAJ INTEGRACJĘ. Trafisz na stronę Dodaj integrację, z odnośnikiem powrotu przejdź do: Integracje zewnętrzne u góry.
- W sekcji PODSTAWOWE, w polu Narzędzie, wybierz z listy pozycję Inne. Naszej nazwy nie ma na tej liście i to jest normalne.
- W polu Nazwa integracji wpisz coś, po czym ją poznasz, na przykład
Artykuły SEO. Pole Opis możesz zostawić puste. - Zjedź do sekcji UPRAWNIENIA INTEGRACJI, tej podpisanej „Decyduj, do czego ta integracja może mieć dostęp w Twoim sklepie.”. Uprawnienia dodaje się tu po jednym. Pierwszy blok nazywa się Uprawnienia integracji (1): i ma dwie listy: Obszar sklepu i Zakres dostępu. Ustaw w nim pierwszy wiersz z tabeli poniżej, potem kliknij niebieski przycisk Dodaj uprawnienie, żeby dostać blok (2), i tak dalej, aż wpiszesz całą tabelę. Czerwony przycisk Usuń przy bloku kasuje ten jeden blok.
- Pod blokami zobaczysz zdanie „W następnym kroku otrzymasz Client ID i Token API.”. Kliknij Zapisz i utwórz token.
- Otworzy się strona Szczegóły z ramką „Wklej te informacje u dostawcy integracji”, a pod nią Client ID i Token API, każde z ikoną kopiowania. Skopiuj Token API i miej go pod ręką. Czerwona ramka ostrzega przy tym wprost: „Skopiuj Token API przed zamknięciem tej strony”, „Możesz go skopiować tylko teraz”, i to prawda, drugi raz go nie zobaczysz. Potem kliknij Rozumiem. Client ID nie jest nam do niczego potrzebny: wystarczy token i adres sklepu.
Co ustawić w uprawnieniach
| Obszar sklepu | Zakres dostępu | Po co nam to |
|---|---|---|
| aktualności/blog | odczyt + dodawanie + edycja | To jest blog. Pod tą nazwą Shoper trzyma wpisy, które w panelu widzisz jako Wygląd i treści › Blog. Wymagane. Sam odczyt nie wystarczy, a token, który umie tylko czytać, wyłapujemy już przy podłączeniu i mówimy o tym wprost. Zakres odczyt + dodawanie + edycja + usuwanie też zadziała, ale nie jest potrzebny: niczego nie kasujemy. |
| języki i lokalizacja | odczyt | Wymagane. Każdy wpis musi mieć przypisany język sklepu. Odczytujemy go raz i zapamiętujemy, żeby nie pytać przy każdym artykule. |
| produkty | odczyt | Opcjonalne. Dzięki temu artykuły mogą odwoływać się do Twoich prawdziwych produktów zamiast do ogólników. Nic nie zmieniamy, tylko czytamy. |
| kategorie | odczyt | Opcjonalne, razem z produktami. Pozwala nam wiedzieć, jak poukładany jest Twój asortyment. |
| waluty | odczyt | Opcjonalne. Bez tego znamy liczbę, ale nie wiemy, czy to złotówki, czy euro. |
Jeśli chcesz dać nam jak najmniej: wystarczą aktualności/blog i języki i lokalizacja, czyli dwa bloki uprawnień. Artykuły będą się publikować. Reszta służy wyłącznie temu, żeby teksty mówiły o Twoim asortymencie konkretami.
2. Wpisz token i adres sklepu w naszym panelu
Wróć do nas i otwórz formularz połączenia. We wdrożeniu, w kroku Publikacja, klikasz kafelek Shoper, a pola rozwijają się pod siatką kafelków. To samo zrobisz później w Witrynach: otwierasz witrynę i wybierasz Podłącz: Publikowanie. Poprosimy o dwie rzeczy.
- Adres sklepu, czyli
mojsklep.pl. Możesz wkleić razem zhttps://, a nawet cały adres skopiowany z panelu, ten z/adminpo ukośniku: przytniemy go do samego adresu sklepu. - Token API, ten skopiowany przed chwilą. Client ID zostaw sobie, nie jest nam potrzebny.
- Kliknij Sprawdź i połącz. Od razu wykonujemy próbne połączenie, a wynik, razem z ewentualnym komunikatem o błędzie, pokazujemy w tym samym panelu, pod polami.
Token trafia prosto do naszego silnika publikującego, który trzyma go zaszyfrowany i nigdy nie pokazuje go z powrotem, nawet Tobie. Jeśli go zgubisz, wygenerujesz w Shoperze nowy, a stary przestanie działać.
3. Sprawdź, że połączenie działa
Po kliknięciu Sprawdź i połącz zadajemy Twojemu sklepowi kilka krótkich pytań, żeby sprawdzić wszystko naraz: że pod tym adresem naprawdę stoi sklep na Shoperze, że token działa, że ma prawo nie tylko czytać bloga, ale i dodawać wpisy, i że widzimy języki sklepu.
Jeśli zobaczysz Połączono, jesteś gotowy. Pierwszy artykuł pojawi się na blogu zgodnie z Twoim harmonogramem.
Jeśli zobaczysz błąd, zjedź do sekcji Gdy coś nie działa. Każdy komunikat, który od nas dostaniesz, ma tam swój wiersz.
Kiedy połączenie działa, na stronie witryny pojawia się przycisk Wyślij artykuł testowy. Publikujemy wtedy jeden krótki, wyraźnie oznaczony wpis tym samym połączeniem, którym pójdą wszystkie następne, więc w kilka minut widzisz na blogu sklepu, że cała droga działa. Chwilę później sami go usuwamy, więc nie zostaje u Ciebie nic do sprzątania. Jeśli utkniesz, napisz na hello@justrank.it.
Jak wygląda gotowy wpis w panelu
Wysłany artykuł ląduje w Wygląd i treści › Blog › Lista wpisów i wygląda dokładnie tak, jakbyś dodał go ręcznie przyciskiem Dodaj wpis na blogu. Na blogu sklepu jest widoczny od razu, bez przypisywania kategorii. Wypełniamy te pola:
| Pole w panelu | Co tam wstawiamy |
|---|---|
| Tytuł wpisu | Tytuł artykułu. |
| Autor | Nazwa Twojego sklepu, ta z ustawień Shopera. Nie ma u nas osobnego pola na autora, więc nie ma czego ustawiać. |
| Data | Moment publikacji, w strefie czasowej sklepu. Możesz ją potem zmienić w panelu, my jej przy poprawkach nie ruszamy. |
| Skróconą treść wpisu | Zajawka, ta sama, która idzie w opis dla wyszukiwarki. |
| Główną treść wpisu | Cały artykuł, w HTML-u, z nagłówkami i akapitami. |
| Zakładka Pozycjonowanie | Tytuł i opis dla wyszukiwarki, słowa kluczowe oraz własny adres URL wpisu. Jeśli taki adres jest w sklepie już zajęty, dopisujemy do niego -2, zamiast tracić artykuł. |
| Moduł | Zaznaczamy to pole. Dzięki temu wpis trafia do modułu bloga na stronie głównej, jeśli Twój szablon taki ma, na przykład do slidera „Wybrane wpisy bloga” w szablonie Storefront. Odnośnik ze strony głównej sprawia, że Google znajduje nowy artykuł szybciej. Możesz je odznaczyć, a my przy poprawkach już do niego nie wracamy. |
| Zdjęcie | Grafika główna artykułu, jeśli ją ma. Wysyłamy ją osobno, zaraz po wpisie, a Shoper zapisuje u siebie własną kopię. Opis zdjęcia ustawiamy na tytuł wpisu. Format WEBP jest przyjmowany. |
Gotowy wpis mieszka pod adresem twojsklep.pl/adres-wpisu, czyli tym własnym z zakładki Pozycjonowanie, prosto w korzeniu domeny. Jeśli własnego adresu nie ma, Shoper podaje wpis pod /pl/n/numer.
Czego nie ustawiamy za Ciebie
Trzy rzeczy zostawiamy Tobie, i mówimy o nich od razu, żebyś nie szukał ich potem po panelu.
- Kategoria wpisu zostaje pusta. Shoper opisuje to pole w swoim API w sposób, którego nie da się jednoznacznie odczytać, a zgadywanie skończyłoby się odrzuceniem całego artykułu. Nic przez to nie tracisz: wpis bez kategorii jest na blogu widoczny od razu, sprawdziliśmy to na prawdziwym sklepie. Kategorię przypiszesz w panelu w dwie sekundy, otwierając wpis i wybierając ją z listy Kategoria.
- Nie ustawiamy pola „Strona główna”. To Ty decydujesz, czy wpis ma trafić na stronę główną sklepu. Jedyny wyjątek to pole Moduł, które zaznaczamy nowemu wpisowi, żeby dostał odnośnik z modułu bloga i szybciej trafił do Google. Odznacz je, jeśli nie chcesz, a my już do niego nie wrócimy.
- Nie dopisujemy tagów. Tagi bloga to w Shoperze osobny słownik, a tworzenie w nim wpisów za Ciebie oznaczałoby zaśmiecanie go nazwami, których nigdy nie zatwierdziłeś.
Starsza droga: konto webapi
Jeśli Twój sklep ma już założone konto webapi, na przykład dla hurtowni albo systemu magazynowego, możesz podać nam zamiast tokenu jego login i hasło. Wtedy sami wymieniamy je na tymczasowy dostęp przy każdym połączeniu.
- W panelu przejdź do Ustawienia › Ogólne › Administratorzy sklepu.
- Kliknij WIĘCEJ, a potem Dodaj grupę administratorów.
- Jako typ dostępu wybierz dostęp do webapi. Jeśli ta sama osoba ma też wchodzić do panelu, wybierz dostęp do panelu administracyjnego i webapi.
- W zakładce Uprawnienia ustaw te same obszary i zakresy co w tabeli wyżej.
- W zakładce Administratorzy kliknij DODAJ ADMINISTRATORA i utwórz konto. Ten login i hasło podajesz nam.
Token z pierwszej części poradnika jest bezpieczniejszy i wygodniejszy: nie daje dostępu do panelu, ma węższe uprawnienia i odbierasz go jednym kliknięciem. Konto webapi opisujemy tylko dlatego, że wiele sklepów już je ma.
Produkty i kategorie
Jeśli dałeś nam obszar produkty, raz na jakiś czas czytamy Twój asortyment: nazwy, adresy, ceny i przypisanie do kategorii. Służy to jednej rzeczy: żeby artykuł mógł napisać „ten model kosztuje 199 zł i jest w kategorii Rowery miejskie” zamiast pisać ogólnikami.
Nie zmieniamy w produktach niczego. Nie zakładamy ich, nie edytujemy, nie ruszamy cen ani stanów magazynowych. Zakres, o który prosimy, to odczyt i nic więcej.
Cenę bierzemy taką, jaką zwraca API sklepu, razem z jego walutą. To, czy jest ona brutto czy netto, wynika z konfiguracji Twojego sklepu, więc jeśli w tekstach zobaczysz kwotę inną niż na karcie produktu, sprawdź w pierwszej kolejności to ustawienie.
Czego dotykamy, a czego nie
Co robimy
- Dodajemy nowe wpisy na Twoim blogu.
- Poprawiamy wpisy, które sami wcześniej dodaliśmy, i tylko te.
- Wgrywamy grafikę główną do wpisu.
- Czytamy listę wpisów, języki oraz, jeśli pozwolisz, produkty, kategorie i waluty.
Czego nie robimy nigdy
- Nie kasujemy niczego. Ani wpisów, ani produktów, ani kategorii.
- Nie dotykamy wpisów, które napisałeś sam.
- Nie prosimy o dostęp do zamówień ani klientów i nie umiemy ich odczytać.
- Nie zmieniamy ustawień sklepu, szablonu ani konfiguracji bloga.
Gdy coś nie działa
Poniżej są prawdziwe komunikaty, które możesz od nas zobaczyć, i co konkretnie zrobić z każdym.
| Co widzisz | Co to znaczy | Co zrobić |
|---|---|---|
| Twój sklep Shoper odrzucił nasze dane dostępowe. Wygeneruj nowy token API i wklej go u nas jeszcze raz. | Token jest nieprawidłowy, został unieważniony albo skopiowany ze spacją na końcu. | Wejdź w Aplikacje i integracje › Zewnętrzne aplikacje, kliknij ikonę koła zębatego przy integracji i wybierz Utwórz nowy Token API. Stary token od razu przestaje działać. Nowy wklej u nas jeszcze raz. |
| Twój token API Shopera nie ma dostępu do bloga. W panelu Shopera edytuj integrację i dodaj obszar "aktualności/blog" z zakresem dostępu "odczyt + dodawanie + edycja". | Token działa, ale integracja nie ma w ogóle obszaru aktualności/blog, czyli tego, pod którym Shoper trzyma bloga. | Na liście Integracje zewnętrzne kliknij ikonę koła zębatego przy integracji i wybierz Edytuj. W sekcji uprawnień kliknij Dodaj uprawnienie, w nowym bloku ustaw Obszar sklepu na aktualności/blog, a Zakres dostępu na odczyt + dodawanie + edycja, i zapisz. Potem kliknij u nas Połącz jeszcze raz. Jeśli Shoper po zapisaniu pokaże nowy Token API, wklej u nas ten nowy. |
| Twój token API Shopera może czytać bloga, ale nie może dodawać wpisów. W panelu Shopera edytuj integrację i ustaw dla obszaru "aktualności/blog" zakres dostępu "odczyt + dodawanie + edycja". | Obszar aktualności/blog jest w integracji, ale z zakresem odczyt. Umiemy wtedy przeczytać bloga i nic poza tym. | Otwórz integrację ikoną koła zębatego i Edytuj, znajdź blok z obszarem aktualności/blog i zmień w nim Zakres dostępu na odczyt + dodawanie + edycja. Zapisz i podłącz sklep u nas jeszcze raz. |
| Twój sklep Shoper nie podał nam swoich języków. W panelu Shopera edytuj integrację i dodaj obszar "języki i lokalizacja" z zakresem dostępu "odczyt", obok obszaru "aktualności/blog". | Integracji brakuje obszaru języki i lokalizacja, a bez niego nie wiemy, w jakim języku opublikować wpis. | Edytuj integrację, kliknij Dodaj uprawnienie i w nowym bloku ustaw Obszar sklepu na języki i lokalizacja z zakresem odczyt. Ten jeden obszar wystarczy do odczytu, niczego w nim nie zmieniamy. |
| Pod tym adresem nie znaleźliśmy sklepu Shoper. Podaj adres, pod którym klienci otwierają Twój sklep, na przykład mojsklep.pl. | Adres odpowiada, ale nie stoi pod nim sklep na Shoperze: literówka w domenie, inna platforma pod tym adresem albo adres czegoś obok sklepu, na przykład strony wizytówki. | Wpisz adres, pod którym klienci otwierają Twój sklep, na przykład mojsklep.pl albo mojsklep.shoparena.pl. Otwórz go najpierw w przeglądarce i sprawdź, czy widzisz swój sklep. |
| Nie udało się połączyć z Twoim sklepem Shoper. | Sklep w ogóle nie odpowiedział: literówka w domenie, przerwa techniczna albo problem z DNS. | Otwórz adres sklepu w przeglądarce. Jeśli sklep się otwiera, a my go nie widzimy, spróbuj za kilka minut, a jeśli to się utrzyma, napisz do nas. |
| Twój sklep Shoper ogranicza liczbę naszych zapytań. Spróbujemy ponownie za chwilę. | Shoper chwilowo przycina liczbę zapytań, najczęściej gdy równolegle pracuje inna integracja, na przykład hurtownia. | Nic. Sami ponawiamy próbę po chwili i artykuł nie ginie. Jeśli to się powtarza codziennie, daj znać, rozłożymy wysyłkę w czasie. |
| Twój sklep Shoper odrzucił login webapi. Sprawdź login i hasło oraz to, czy grupa administratorów tego konta ma dostęp do webapi. | Dotyczy tylko starszej drogi z kontem webapi: złe hasło albo grupa administratorów bez typu dostępu dostęp do webapi. | Sprawdź w Ustawienia › Ogólne › Administratorzy sklepu, czy grupa tego konta ma dostęp do webapi. Najprościej jednak przejść na token. |
| Wpis jest na liście wpisów, ale nie widzę go na blogu sklepu. | Nie chodzi o kategorię: wpis bez kategorii jest na blogu widoczny od razu. Najczęściej szablon sklepu nie ma odnośnika do bloga w menu, albo wpis został przełączony na nieaktywny. | Otwórz /pl/n/list pod adresem swojego sklepu, to jest właśnie lista wpisów bloga. Jeśli wpis tam jest, brakuje tylko odnośnika do bloga w menu szablonu. Jeśli go tam nie ma, otwórz wpis w panelu i sprawdź, czy jest aktywny. |
Jak nas odłączyć
W każdej chwili, bez pytania nas o zgodę i bez czekania.
- Wejdź w Aplikacje i integracje › Zewnętrzne aplikacje.
- Znajdź na liście Integracje zewnętrzne tę, którą utworzyłeś dla nas.
- Usuń ją albo, przez ikonę koła zębatego, wybierz Utwórz nowy Token API i nie podawaj nam nowego. Jedno i drugie odcina nas natychmiast.
Artykuły, które już opublikowaliśmy, zostają na Twoim blogu i są Twoje. Odłączenie nie kasuje żadnej treści.