Testy, import i aktualizacje

Import ZIP w panelu administratora

W panelu administratora, w sekcji szablonów, wybierz import ZIP. Wymagane jest uprawnienie templates.import. Poprawna paczka trafia do testów ze statusem testing; sam upload nie publikuje szablonu i nie zmienia istniejących stron klientów.

Struktura paczki ZIP

Paczka do importu w panelu zawiera archive.json, źródła GS Loom w theme/ oraz dodatkowe zasoby w assets/, jeśli szablon ich używa. Możesz spakować te elementy bezpośrednio w głównym katalogu ZIP-a albo umieścić je w jednym wspólnym folderze:

noir-explorer/
├── archive.json
├── theme/
│   ├── loom.json
│   ├── layout/
│   ├── templates/
│   ├── sections/
│   ├── blocks/
│   ├── config/
│   └── locales/
└── assets/
    └── blog.css

Folder theme/ musi zawierać kompletny, poprawny szablon, w tym loom.json. Powyższe drzewo ilustruje układ paczki, a nie pełną listę plików szablonu. Nie dodawaj drugiego poziomu folderów otaczających paczkę ani plików spoza jej struktury, takich jak .DS_Store czy __MACOSX.

Co zawiera archive.json

archive.json opisuje format archiwum i konfigurację produktu w GrowSite. Jest osobnym plikiem obok theme/; nie zastępuje manifestu theme/loom.json ani plików schema sekcji i bloków.

Przykład dla szablonu Noir Explorer:

{
  "format": "gs-loom-archive",
  "version": 1,
  "configuration": {
    "key": "noir-explorer",
    "name": "Noir Explorer",
    "version": "1.0.0",
    "tier": "basic",
    "supports_blog": true,
    "price_cents": 0,
    "default_settings": {},
    "schema": {}
  }
}

Przygotowanie i błędy importu

Najłatwiej zacząć od GrowSite Skeleton ZIP, który zawiera archive.json. Launch Theme ZIP zawiera źródła do pracy lokalnej: przed importem przez panel trzeba przenieść zawartość katalogu szablonu do theme/ i dodać obok prawidłowy archive.json.

Limit przesyłanego ZIP-a wynosi 24 MiB. Archiwum może zawierać do 5000 wpisów, łącznie do 48 000 000 bajtów po rozpakowaniu i do 25 000 000 bajtów na plik. Dowiązania symboliczne oraz segmenty ścieżek . i .. są odrzucane.

Instalacja, sprawdzanie i aktualizacja

Uruchamiaj z głównego katalogu repozytorium:

npm run loom:import -- /absolute/path/my-theme
npm run themes:build
npm run themes:check
npm run loom:test
npm run themes:test

Następnie w katalogu api:

php artisan themes:sync --activate

Na końcu przebuduj panel i renderer:

npm run build:customer
npm run build:renderer

--activate aktywuje nowe produkty. Synchronizacja zachowuje ceny i status już istniejących produktów. Nie aktualizuje treści stron klientów.

Do kolejnego wydania zwiększ wersję manifestu i użyj:

npm run loom:update -- /absolute/path/my-theme
npm run themes:build

Aktualizacja nie może usuwać używanych definicji sekcji, bloków, szablonów stron ani identyfikatorów ustawień; typy dotychczasowych ustawień muszą pozostać zgodne. Nie jest to pełna analiza wszystkich zmian wyglądu: usunięcie warunku lub zmiana HTML nadal może zmienić prezentację zapisanej strony. Sprawdź istniejące dokumenty przed wdrożeniem.

themes:build przebudowuje rejestry po bezpośredniej edycji źródeł w repozytorium. Nie zastępuje kontroli kompatybilności loom:update.

Kontrola przed wydaniem

Sprawdź nowe i wcześniej zapisane strony. Zweryfikuj pusty tekst, zero, wyłączony checkbox, bogaty tekst, linki, dodanie i kolejność bloków, blok statyczny, mobile i SSR. Zmiana ustawienia ma być widoczna w podglądzie i po ponownym odczycie z API.

Testy projektu:

npm run loom:test
npm run themes:test
npm run build:renderer
node --test scripts/paylio-renderer.test.mjs scripts/theme-renderer.test.mjs

W api:

php artisan test --compact --filter=loom_theme_settings
php artisan test --compact tests/Feature/LoomDocumentTest.php

Najczęstsze problemy

Import źródeł z terminala wymaga dostępu do repozytorium. Import ZIP w panelu jest dostępny dla uprawnionych administratorów; nie jest publicznym procesem zgłoszenia do marketplace. Zachowuj wersję źródeł i artefakty wdrożenia, żeby móc przywrócić poprzednie wydanie wraz z rejestrami.