Osadzanie - clarife

Przegląd

Osadzanie pozwala wyświetlić dokument clarife bezpośrednio wewnątrz innej strony internetowej lub aplikacji. Odwiedzający widzą Twoją treść bez opuszczania Twojej witryny. clarife udostępnia gotowe fragmenty kodu do osadzenia, które kopiujesz i wklejasz do swojego HTML.

ℹ️ Informacja: Użytkownicy planu Pro otrzymują osadzanie iframe. Użytkownicy planu Business dodatkowo otrzymują widgety i popupy.

Typy osadzenia

Typ	Opis	Plan
Iframe	Osadzenie inline, które wypełnia kontener na stronie	Pro+
Widget	Pływający przycisk otwierający dokument w panelu bocznym	Business
Popup	Przycisk otwierający dokument w nakładce modalnej	Business

Jak uzyskać kod osadzenia

Otwórz panel Udostępnij — W edytorze kliknij Udostępnij i utwórz link (lub wybierz istniejący).
Kliknij zakładkę Osadź — Przejdź do zakładki Osadź w panelu udostępniania.
Wybierz typ osadzenia — Wybierz Iframe, Widget lub Popup (dwa ostatnie tylko na planie Business).
Skopiuj kod — Kliknij Skopiuj kod, aby skopiować fragment do schowka.
Wklej na swojej stronie — Wklej kod do HTML swojej strony internetowej, centrum pomocy lub aplikacji webowej.

Przykłady kodu osadzenia

Iframe

html

<iframe
  src="https://clarife.app/embed/abc123"
  width="100%"
  height="600"
  frameborder="0"
  allow="clipboard-write"
  style="border: 1px solid #e5e7eb; border-radius: 8px;"
></iframe>

Widget (Business)

html

<script
  src="https://clarife.app/widget.js"
  data-share-id="abc123"
  data-position="bottom-right"
  data-button-text="Zobacz tutorial"
  data-button-color="#6366F1"
  async
></script>

Popup (Business)

html

<!-- Przycisk wyzwalający (styluj dowolnie) -->
<button onclick="ClarifPopup.open('abc123')">
  Otwórz tutorial
</button>

<script src="https://clarife.app/popup.js" async></script>

Dostosowywanie

Iframe — kontroluj szerokość, wysokość i styl obramowania za pomocą standardowych atrybutów HTML/CSS.
Widget — konfiguruj pozycję (bottom-right, bottom-left), tekst przycisku i kolor przycisku za pomocą atrybutów data.
Popup — wywołuj popup z dowolnego elementu za pomocą API JavaScript.

Kontrole dostępu a osadzanie

Wszystkie kontrole dostępu (hasło, bramka email, data wygaśnięcia, lista dozwolonych domen) działają wewnątrz osadzeń. Jeśli hasło jest ustawione, odwiedzający widzi formularz hasła wewnątrz iframe, widgetu lub popupu.

Czy mogę osadzić dokument bez tworzenia linku udostępniania?

Nie. Musisz najpierw utworzyć link udostępniania. Kod osadzenia używa unikalnego ID linku.

Czy osadzenie aktualizuje się po edycji dokumentu?

Tak. Osadzenie zawsze pokazuje najnowszą wersję dokumentu, tak samo jak zwykły link udostępniania.

Czy mogę użyć osadzenia na wielu stronach?

Tak. Ten sam kod osadzenia może być umieszczony na dowolnej liczbie stron. Nie ma limitu liczby witryn używających tego samego osadzenia.

Dlaczego opcja widgetu/popupu jest wyszarzona?

Osadzenia widget i popup są dostępne tylko na planie Business. Przejdź na Business, aby odblokować te typy osadzeń.

Czy osadzenie zadziała w aplikacji SPA?

Tak. Podejście iframe działa w każdym SPA (React, Vue, Angular). Dla widgetu i popupu załaduj skrypt raz i wywołaj API po nawigacji.