Przejdź do głównej zawartości

Ręczne bloki URL (szablony produktów)

Ręczne bloki URL pozwalają wyświetlać pliki PDF na szablonach produktów bez wcześniejszego łączenia plików PDF w aplikacji.

Użyj tej opcji, gdy chcesz wyświetlać ten sam adres URL lub adresy URL pliku PDF na całym szablonie produktu (na przykład dla wszystkich produktów korzystających z szablonu product lub product.custom).

Czym są bloki ręczne​

PDF Connect udostępnia dwa ręczne bloki produktów:

  • PDF Embedded Manual — wyświetla pliki PDF osadzone bezpośrednio na stronie
  • PDF Button Manual — wyświetla klikalne przyciski otwierające pliki PDF

W odróżnieniu od bloków połączonych, bloki ręczne:

  • Nie odczytują połączonych zasobów
  • Nie odczytują metapól pliku PDF
  • Nie wymagają łączenia z poszczególnymi produktami
  • Renderują się wyłącznie z ustawień bloku w edytorze motywu Shopify

Jak dodawać bloki ręczne​

Z poziomu aplikacji (zalecane)​

  1. Otwórz stronę szczegółów pliku PDF w PDF Connect
  2. Kliknij listę rozwijaną Połącz/Dodaj
  3. Wybierz Dodaj blok PDF do szablonu produktu (ręczne URL)
  4. Wybierz:
    • Szablon produktu (np. product lub product.custom)
    • Typ bloku (pdf_embedded_manual lub pdf_button_manual)
  5. Kontynuuj, aby otworzyć edytor motywu Shopify
  6. Wklej jeden lub więcej adresów URL pliku PDF w ustawieniach bloku
  7. Zapisz motyw

Bezpośrednio w edytorze motywu Shopify​

  1. Przejdź do Sklep online > Motywy > Dostosuj
  2. Otwórz szablon produktu
  3. Dodaj blok aplikacji z sekcji PDF Connect
  4. Wybierz PDF Embedded Manual lub PDF Button Manual
  5. Wprowadź adresy URL/ustawienia i zapisz

Typy przeglądarek w blokach ręcznych​

Bloki ręczne obsługują te same cztery typy przeglądarek:

  • Natywna przeglądarka
  • Niestandardowa przeglądarka (PDF.js)
  • Flipbook
  • Lekka przeglądarka

W przypadku bloków ręcznych zachowanie przeglądarki jest konfigurowane w ustawieniach bloku (nie z zapisanej konfiguracji przeglądarki dla każdego pliku PDF), a jeden profil przeglądarki na poziomie bloku stosuje się do wszystkich adresów URL w tym bloku.

Wiele adresów URL i etykiet​

  • Wprowadzaj wiele adresów URL pliku PDF jako wartości oddzielone nowymilinii.
  • W bloku ręcznym przycisku etykiety są opcjonalne i również oddzielone nowymi liniami.
  • Jeśli etykiet jest mniej niż adresów URL, pozostałe adresy URL powracają do nazwy pliku lub domyślnego tekstu.

Bloki połączone a bloki ręczne​

TypŹródło danychNajlepsze zastosowanie
Bloki połączone (pdf_embedded, pdf_button)Łączenie w aplikacji + metapolaPliki PDF dla poszczególnych zasobów, konfiguracja przeglądarki dla każdego PDF
Bloki ręczne (pdf_embedded_manual, pdf_button_manual)Wyłącznie ustawienia schematu bloku motywuWspółdzielone pliki PDF dla całego szablonu bez łączenia

Ważne ograniczenia​

  • Bieżące wdrożenie obejmuje tylko szablony produktów we wczesnym przepływie ręcznym aplikacji.
  • Bloki ręczne są ograniczone do zakresu szablonu, a nie zasobu.
  • Bloki ręczne nie synchronizują się automatycznie z rekordami plików PDF w bibliotece aplikacji.

Szybka diagnostyka problemów​

Jeśli blok ręczny nie wyświetla treści:

  1. Upewnij się, że wprowadzono co najmniej jeden prawidłowy adres URL pliku PDF zaczynający się od https://
  2. Upewnij się, że blok jest dodany do aktywnego szablonu produktu
  3. Zapisz zmiany w motywie i odśwież stronę sklepu z wyczyszczoną pamięcią podręczną
  4. Spróbuj zmienić typ przeglądarki na Natywna przeglądarka, aby wykluczyć problemy specyficzne dla przeglądarki

Następne kroki​