Struktura pliku importu witryny

Do czego to służy

Zamiast klikać sekcję po sekcji, można opisać całą witrynę w jednym pliku i zbudować ją jednym wgraniem. Powstają wtedy naraz: dane firmy, wszystkie podstrony z treścią, katalog produktów, nawigacja i wersje językowe. Przy witrynie na kilkadziesiąt podstron to różnica między jednym popołudniem a kilkoma dniami.

Panel: Strony → Strona z pliku JSON. Dostępne w planach Pro i wyższych.

Trzy tryby pracy

Ten sam ekran obsługuje trzy sytuacje:

• Utwórz nową stronę. Plik buduje witrynę od zera.
• Zaktualizuj moją istniejącą stronę. Plik dopisuje i nadpisuje podstrony dopasowane po adresie. Podstrony, których w pliku nie ma, zostają nietknięte.
• Dodaj wersję językową. Ten sam plik w innym języku dokłada kompletną wersję obcojęzyczną do istniejącej strony.

Aktualizować i rozszerzać można wyłącznie strony, które same powstały z pliku.

Zawsze najpierw podgląd

Przycisk Podgląd bez zapisu sprawdza plik i pokazuje, co z niego powstanie: ile podstron, jakie będą miały adresy i tytuły, ile pozycji trafi do katalogu i jakie dane firmy zostaną ustawione. Nic nie jest zapisywane, dopóki nie klikniesz Zaimportuj.

Jeśli plik ma błąd, podgląd wypisze, które pole go zawiera. Import jest wtedy zablokowany: platforma nie zapisze witryny zbudowanej w połowie.

Co jest w pliku

Plik ma cztery główne części, z czego dwie są obowiązkowe.

business to dane firmy: nazwa, hasło, telefon, e-mail, obszar działania, adres, godziny pracy, NIP, REGON, KRS, pełna nazwa prawna, profile społecznościowe i typ działalności do danych strukturalnych. Wymagana jest wyłącznie nazwa, reszta na tyle, na ile masz.

pages to lista podstron. Każda ma typ (strona główna, o nas, usługa, realizacja, kontakt, produkt, kategoria, dokument prawny, wpis bloga), adres, tytuł, pola SEO i listę sekcji. Sekcja to typ bloku i jego treść, dokładnie ta sama, którą normalnie wypełniasz w edytorze.

categories i products to opcjonalny katalog. Każdy produkt staje się osobną podstroną, więc nie trzeba ich wypisywać w pages: wystarczy jedna podstrona katalogu, a pozycje wygenerują się same. Nawigacja i rozwijane menu „Oferta" też budują się automatycznie z katalogu.

seo to opcjonalne ustawienia globalne, na przykład dopisek dodawany do tytułu każdej podstrony.

Wersje językowe

Jeden plik opisuje jeden język. Wersję domyślną platforma serwuje w korzeniu adresu, a każdą kolejną pod prefiksem języka. Obsługiwane kody to pl, de, en, sv, cs i sk. Odpowiedniki podstron w różnych językach są ze sobą parowane, dzięki czemu przełącznik flag prowadzi do właściwej podstrony, a nie na stronę główną.

Ograniczenia

• Import wymaga planu Pro lub wyższego, a nowa strona liczy się do limitu stron w Twoim planie. Wersja z żywym sklepem wymaga dodatkowo planu z modułem sklepu.
• Plik nie omija limitów planu: liczba wersji językowych i produktów sklepu jest sprawdzana przed zapisem. Jeśli dokument je przekracza, podgląd powie o ile, a import zostanie odrzucony w całości.
• Import buduje treść, nie projektuje wyglądu. Paleta, szablon i skórka pozostają ustawieniami witryny.
• Po imporcie stroną zarządzasz normalnie w panelu. Ręczne zmiany zostaną nadpisane, jeśli zaimportujesz ten sam adres podstrony jeszcze raz.
• Zdjęcia podaje się adresami. Plik nie przenosi samych obrazów do biblioteki mediów.

Skąd wziąć plik

Struktura jest opisana kompletem pól i przykładów w dokumentacji technicznej repozytorium (docs/serwis-json-schema.md, a dla witryn z żywym sklepem docs/site-json-schema.md). Najprościej wygenerować plik modelem językowym na podstawie tego opisu, a potem sprawdzić go podglądem przed zapisem.