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 wejść w Aplikacje i integracje. 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. Bez/paneli bez niczego po ukośniku.
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.
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 przejdź do Aplikacje i integracje, a potem do Zewnętrzne aplikacje.
- Kliknij DODAJ INTEGRACJĘ w prawym górnym rogu.
- W polu Narzędzie wybierz z listy pozycję Other. 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. Zaznacz obszary z tabeli poniżej i przy każdym ustaw Zakres dostępu zgodnie z tą tabelą.
- Kliknij ZAPISZ I UTWÓRZ TOKEN.
- Skopiuj token, który się pokaże, i miej go pod ręką. Shoper ostrzega przy tym wprost: „Skopiuj Token API przed zamknięciem tej strony”. Drugi raz go nie zobaczysz.
Co zaznaczyć w uprawnieniach
| Obszar sklepu | Zakres dostępu | Po co nam to |
|---|---|---|
| Aktualności | Odczyt+dodawanie+edycja | To jest blog. Pod tą nazwą Shoper trzyma wpisy, które w panelu widzisz jako Wygląd i treści › Blog. Bez tego uprawnienia nie wyślemy ani jednego artykułu. |
| Języki i lokalizacja | Odczyt | 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 i Języki i lokalizacja. Artykuły będą się publikować. Reszta uprawnień służy wyłącznie temu, żeby teksty mówiły o Twoim asortymencie konkretami.
2. Przekaż nam token i adres sklepu
Wróć do nas i otwórz swój sklep w panelu. Poprosimy o dwie rzeczy.
- Adres sklepu, czyli
mojsklep.pl. Możesz wkleić razem zhttps://, poradzimy sobie. - Token API, ten skopiowany przed chwilą.
- Zapisz. Od razu wykonujemy próbne połączenie i mówimy, czy zadziałało.
Token trzymamy zaszyfrowany i nigdy nie pokazujemy 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 zapisaniu robimy jedno pytanie do Twojego sklepu, żeby sprawdzić trzy rzeczy naraz: że adres jest prawidłowy, że token działa i że ma dostęp do bloga.
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.
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. Wypełniamy te pola:
| Pole w panelu | Co tam wstawiamy |
|---|---|
| Tytuł wpisu | Tytuł artykułu. |
| Autor | Nazwa, którą ustawisz u nas. Domyślnie nazwa Twojego sklepu. |
| Data | Moment publikacji. 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 oraz własny adres URL wpisu. |
| Zdjęcie | Grafika główna artykułu, jeśli ją ma. Wysyłamy ją osobno, zaraz po wpisie. |
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. Wolimy, żeby wpis wszedł bez kategorii, niż żeby nie wszedł wcale. Kategorię przypiszesz w panelu w dwie sekundy, otwierając wpis i wybierając ją z listy Kategoria.
- Nie ustawiamy pól „Strona główna” ani „Moduł”. To Ty decydujesz, czy wpis ma się pokazywać na stronie głównej albo w slajderze wpisów. Na samej liście bloga wpis jest widoczny od razu.
- 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 zaznacz te same obszary 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 uprawnienie 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. Uprawnienie, o które 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 odrzucił nasze dane logowania. | Token jest nieprawidłowy, został unieważniony albo skopiowany ze spacją na końcu. | Wygeneruj nowy token w Aplikacje i integracje › Zewnętrzne aplikacje, przez ikonę koła zębatego przy integracji i Utwórz nowy Token API, a potem wklej go u nas jeszcze raz. |
| Sklep odpowiedział, ale nie blogiem. Sprawdź uprawnienie „Aktualności”. | Token istnieje i działa, ale przy tworzeniu integracji nie zaznaczono obszaru Aktualności. | Edytuj integrację w Zewnętrzne aplikacje, dodaj obszar Aktualności z zakresem Odczyt+dodawanie+edycja i zapisz. Jeśli Shoper każe utworzyć token na nowo, utwórz i wklej go u nas. |
| Nie mogliśmy połączyć się z Twoim sklepem. | Zły adres, literówka w domenie albo sklep w trakcie przerwy technicznej. | Sprawdź, czy adres jest dokładnie taki, jak wpisują go klienci, bez /panel i bez końcówek po ukośniku. Otwórz go w przeglądarce. Jeśli sklep się otwiera, a my go nie widzimy, napisz do nas. |
| Sklep ogranicza tempo naszych zapytań. | 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. |
| Sklep odrzucił login 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, ale nie widzę go na stronie bloga. | Najczęściej brak kategorii albo szablon, który pokazuje wyłącznie wpisy przypisane do kategorii. | Otwórz wpis w Lista wpisów, wybierz coś z listy Kategoria i zapisz. Sprawdź też w Ustawienia bloga, jak zbudowane są adresy URL wpisów. |
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 integrację, którą utworzyłeś dla nas.
- Usuń ją albo wygeneruj dla niej nowy token, którego nam nie podasz. 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.