Dokumentacja Widgetów Osadzanych

Czym są osadzane widżety?

Osadź dowolne z 557+ narzędzi Akousa na swojej stronie jednym tagiem iframe. Widżety są w pełni responsywne, konfigurowalne i obsługują wszystkie 20 języków.

Odwiedź galerię osadzania, aby przeglądać narzędzia, podejrzeć je i skopiować kod. Dostosuj motyw (jasny/ciemny), język i wymiary do swojej strony.

Jak osadzić narzędzie

1. 1Odwiedź galerię osadzania lub stronę dokumentacji dowolnego narzędzia
2. 2Skopiuj kod iframe do osadzenia
3. 3Wklej go do HTML swojej strony

Przykładowy kod osadzenia

'<'iframe src=\''https://akousa.net/embed/json-formatter?theme=dark&lang=en\'' width=\''100%\'' height=\''500\'' frameborder=\''0\''>'<'/iframe>

Funkcje

• ✓Visit /embed-gallery to browse embeddable tools.
• ✓Copy iframe code. Customize with lang and theme parameters.
• ✓Paste the iframe into your HTML.

Opcje konfiguracji

• Motyw (jasny/ciemny/systemowy)
• Język (20 opcji)
• Wymiary (szerokość i wysokość przez atrybuty HTML)

Content Security Policy & Security

All embed widgets use strict Content Security Policy headers with frame-ancestors configured for cross-origin embedding. Data processing happens entirely in the visitor's browser — no user data is transmitted to Akousa servers. The embed is served over HTTPS with the same security standards as the main platform. Your visitors' data stays on their device.

Anonymous Analytics

Osadzone widżety wewnętrznie śledzą anonimowe liczniki wyświetleń, aby pomóc Ci zrozumieć wzorce użytkowania. Od Twoich odwiedzających nie są zbierane żadne dane umożliwiające identyfikację. Analityka jest lekka i nie wpływa na wydajność ani czas ładowania widżetu.

Optymalizacja wydajności

Strony osadzania są wstępnie renderowane dla szybkiego początkowego ładowania i okresowo rewalidowane. Iframe ładuje się asynchronicznie i nie blokuje renderowania Twojej strony. W połączeniu z lazy loading (loading="lazy") osadzone widżety mają niemal zerowy wpływ na wyniki Core Web Vitals Twojej witryny.

Speakable Structured Data

Each embed page includes Speakable schema markup, making widget content eligible for voice assistant read-aloud. This improves accessibility for visually impaired users and positions your embedded tools for voice search discovery.

Często zadawane pytania

Jakie narzędzia można osadzać?

All 557+ tools via /embed/[slug] URL format.

Czy osadzanie jest darmowe?

Yes, completely free with no usage limits.

Czy mogę dostosować wygląd?

Yes, with ?lang=tr and ?theme=dark URL parameters.

Czy osadzona treść jest bezpieczna?

Yes. Embedded widgets use a strict Content Security Policy (CSP) with frame-ancestors configured to allow cross-origin embedding. All data processing happens in the visitor's browser — no user data is transmitted to our servers.

Czy osadzone narzędzia spowolnią moją stronę?

Embedded tools load asynchronously within the iframe and do not block your page rendering or affect your site's performance. The iframe loads independently, so even if the widget takes a moment to initialize, your page content appears instantly. The widget code is optimized and cached for fast loading via static generation with periodic revalidation.

Czy mogę osadzić narzędzia na WordPress?

Tak. Użyj bloku 'Niestandardowy HTML' w edytorze bloków WordPress i wklej kod iframe. Jeśli Twoja strona używa wtyczki bezpieczeństwa usuwającej iframe, dodaj akousa.net do białej listy. Osadzanie działa na WordPress.com (plany Business) i wszystkich samodzielnych instalacjach WordPress.org.

Czy osadzone widżety śledzą analitykę?

Osadzone widżety rejestrują wyłącznie anonimowe liczniki wyświetleń na potrzeby analityki wewnętrznej. Na Twoich odwiedzających nie są zakładane pliki cookie, nie są zbierane dane osobowe, a w iframe nie są ładowane trackery innych firm. Analityka Twojej strony (Google Analytics, Plausible itp.) nie jest zakłócana przez osadzenie.

Czy muszę konfigurować nagłówki CSP do osadzania?

Jeśli Twoja strona używa Content Security Policy, dodaj 'frame-src https://akousa.net' do nagłówka CSP. Większość stron bez jawnej CSP działa od razu. Sam endpoint osadzania ustawia permisywne nagłówki frame-ancestors.

Jak osadzanie wpływa na wydajność strony?

Każdy osadzony widżet ładuje się w izolowanym kontekście iframe, nie blokując głównego wątku, DOM ani krytycznej ścieżki renderowania Twojej strony. Dodaj loading=\'lazy\' do tagu iframe dla odroczonego ładowania, dodatkowo poprawiając Core Web Vitals.

Czy mogę używać osadzonych narzędzi w projektach komercyjnych?

Tak, możesz osadzać dowolne narzędzie na stronach komercyjnych, panelach SaaS, projektach klienckich i narzędziach wewnętrznych. Nie ma opłat licencyjnych, limitów użytkowania ani wymagań dotyczących atrybucji, poza niewielkim linkiem 'Powered by akousa.net' automatycznie dołączonym do każdego widżetu.

Powiązana dokumentacja

• Dokumentacja narzędzi

  Kompletny przewodnik do korzystania z 557+ bezpłatnych narzędzi online. Dowiedz się o narzędziach dla deweloperów, procesorach tekstu, konwerterach i generatorach — wszystko działające w Twojej przeglądarce bez rejestracji.

• Dokumentacja API Deweloperskiego

  Complete documentation for the akousa.net REST API with 104+ endpoints across 13 groups.

• Embed Gallery

  The Embed Gallery at /embed-gallery is a dedicated landing page for webmasters. Browse all 557+ embeddable tools, preview how each looks as a widget, check recommended dimensions, and copy the ready-to-use iframe code with one click.

• Dokumentacja PDF Suite

  Guide to 13 PDF tools: merge, split, compress, convert, and more.