Własne szablony dla deweloperów i agencji

W sekcji „Domeny i szablony” właściciele i admini mogą od planu Creator Pro tworzyć własne szablony. To szkielet HTML dla deweloperów i agencji, którzy chcą używać jednego układu na wielu stronach. Do zaprojektowania strony nie są Ci potrzebne.

#Plan i uprawnienia

Właściciele i admini mogą tworzyć, edytować i usuwać szablony. W planie Creator Free przycisk „+ Szablon” jest zablokowany i pojawia się „Szablony workspace są dostępne od planu Creator Pro.”

#Tworzenie szablonu

1. Otwórz „Domeny i szablony”
2. Kliknij „+ Szablon”
3. Wypełnij pola i kliknij „Utwórz”

„Klucz (a-zA-Z0-9_-)”

2–64 znaki z liter, cyfr, _ i -. Klucz jest unikalny w obrębie workspace i nie można go później zmienić.

„Nazwa”

Wymagana, do 120 znaków, na przykład „Premiera produktu”.

„Zacznij od”

Tylko przy tworzeniu: „Pusty szablon” lub kopia wbudowanego szablonu. Kopia przejmuje strukturę, placeholdery i wygląd oryginału i jest najszybszym startem.

„Status”

Tylko przy edycji: „Aktywny” lub „Wyłączony”.

„Treść HTML”

Szkielet HTML, wymagany. Do 60 000 bajtów; litery z polskimi znakami i inne znaki specjalne zajmują więcej niż jeden bajt. Jeśli HTML jest większy, LinkHarbor odmawia zapisu.

„Schemat (JSON)” i „Wartości domyślne (JSON)”

Opisują wartości szablonu, które można zmieniać, oraz ich wartości domyślne. Oba muszą być poprawnym JSON-em, a wartości domyślne muszą pasować do schematu. Każdy z nich może mieć najwyżej 64 KB, a pojedynczy tekst w środku najwyżej 5 000 znaków.

#Zasady dla HTML

HTML musi zawierać placeholder w miejscu, w którym pojawia się treść strony.

Ze względów bezpieczeństwa LinkHarbor czyści HTML przy zapisie:

• Dozwolone są typowe elementy tekstu i układu, takie jak div, section, header, p, a, img czy table. script, iframe i noscript są usuwane razem z treścią, inne elementy, takie jak form, svg, link czy meta, bez treści
• Atrybuty zdarzeń, takie jak onclick, oraz linki z javascript: są usuwane
• Blok style zostaje zachowany, ale tak jak Własny CSS nie może niczego wczytywać z innych serwerów
• Klasy CSS zostają zachowane, jeśli zaczynają się od lh-, występują we wbudowanych szablonach lub są zdefiniowane w bloku style szablonu, na przykład jako .hero { … }; inne klasy są usuwane. Identyfikatory oraz atrybuty data- i aria- zostają zachowane
• Style inline są dozwolone, ale deklaracje z url() wskazującym na inne serwery, @import lub position: fixed są usuwane
• Placeholdery w bloku style lub w style="" wstawiają tylko poprawne wartości CSS, takie jak kolory w rodzaju #1a2b3c, rozmiary w rodzaju 24px lub liczby w rodzaju 0.5. Wartość z ; { } cudzysłowami lub url() pozostaje pusta. Pola, których wartością domyślną jest kolor, rozmiar lub liczba, przyjmują przy zapisie strony tylko takie wartości
• Obrazy są możliwe tylko z Twoich plików LinkHarbor lub przez placeholdery, takie jak {{avatar_url}}

Zapis blokują dwa błędy: „CSS szablonu nie może niczego wczytywać z innych serwerów …”, jeśli blok style zawiera zewnętrzne adresy, oraz „Sekcja w HTML szablonu … jest niedozwolona lub niepoprawnie zamknięta.”, jeśli {{#if}}, {{#unless}} lub {{#each}} nie kończy się w tym samym tekście, tagu lub atrybucie, w którym się zaczyna, albo występuje w style, href lub src.

Szablony zapisane przed 1 listopada 2026 r. straciły przy tamtym zapisie style i klasy. Jeśli ich potrzebujesz, utwórz je ponownie ze świeżej kopii.

#Używanie szablonu na stronie

Aktywne szablony workspace pojawiają się przy tworzeniu strony oraz w kreatorze w „Motyw” → „Szablon” w grupie „Własne szablony”, a nad nimi 17 wbudowanych szablonów w grupie „Wbudowane szablony”. Opis brzmi „Szablon workspace, utworzony w sekcji «Domeny i szablony».” Wybór i zmiana działają tak jak przy wbudowanych szablonach, zobacz Wybór i zmiana szablonu.

• Jeśli zmienisz szablon, podgląd strony od razu pokazuje zmianę. Na żywo trafia ona dopiero po ponownym opublikowaniu strony. Jeśli szablonu używa kilka stron, opublikuj ponownie każdą z nich
• Przy publikacji LinkHarbor zapisuje kopię szablonu w wersji. Strona na żywo pozostaje więc bez zmian, nawet jeśli szablon zostanie później zmieniony lub wyłączony
• W API i dla asystentów AI szablon workspace nazywa się „ws:” plus jego klucz, na przykład ws:product-launch
• Własne miejsca na obrazy definiujesz przez API (asset_slots), do 32 na szablon

#Edycja, wyłączanie i usuwanie

Lista pokazuje nazwę, klucz, status i datę z przyciskami „Edytuj” i „Usuń”.

Wyłączanie

Przy edycji ustaw „Status” na „Wyłączony”. Strony, które już używają szablonu, zachowują go. Kreator pokazuje wtedy na przykład „Obecny: Premiera produktu (wyłączony)”. Szablonu nie można już wybrać; kto spróbuje, zobaczy „Ten szablon workspace jest wyłączony. Włącz go w sekcji «Domeny i szablony», aby użyć go na stronie.”

Usuwanie

Usunięty szablon na zawsze znika z listy i nie liczy się już do limitu; jego klucz możesz użyć dla nowego szablonu. Dopóki używa go jakaś strona, usuwanie jest zablokowane: „Ten szablon jest nadal używany przez strony ({count}). Najpierw przełącz te strony na inny szablon.” Zamiast {count} pojawia się liczba stron.

Wyłączone szablony nadal liczą się do limitu Twojego planu. Jeśli potrzebujesz miejsca, usuń je.

#Przy zmianie planu na niższy i wyższy

W planie Creator Free wszystkie aktywne szablony workspace zostają wyłączone; lista pokazuje wtedy „Wyłączone przez plan”. Opublikowane strony pozostają bez zmian, także strony z własnym szablonem. W kreatorze obok „Obecny:” pojawia się wtedy „(wyłączony)”. Po zmianie planu na wyższy dokładnie te szablony znów stają się aktywne. Szablony wyłączone lub usunięte przez Ciebie pozostają w tym stanie.