Logo StartupKit
PL
English Deutsch Français Español Polski
Career Portal

Osadzanie portalu kariery

Jak osadzić portal kariery na stronie internetowej firmy za pomocą iframe, w tym opcje personalizacji i dostęp do API.

Dlaczego to ważne

Większość firm chce wyświetlać oferty pracy na własnej stronie internetowej, zamiast przekierowywać kandydatów pod osobny adres URL. Tryb osadzania w Kit pozwala dodać portal kariery do dowolnej strony jako iframe — kandydaci pozostają na stronie firmy, a Kit obsługuje cały proces aplikacji.

Osadzanie za pomocą iframe

Portal kariery można dodać do dowolnej strony internetowej za pomocą iframe. Podstawowy kod osadzania:

<iframe
  src="https://startupkit.app/careers/your-subdomain?embed=true"
  width="100%"
  height="800"
  frameborder="0"
  style="border: none;"
></iframe>

Parametr ?embed=true aktywuje tryb osadzania, który:

  • Usuwa nagłówek i nawigację portalu
  • Stosuje kompaktowy układ zoptymalizowany pod iframe
  • Wysyła aktualizacje wysokości do okna nadrzędnego za pomocą postMessage (do automatycznego dostosowywania rozmiaru)
  • Usuwa nagłówki X-Frame-Options, aby iframe ładował się poprawnie

Parametry personalizacji

Do adresu URL osadzania można dołączyć parametry zapytania w celu dostosowania wyglądu:

Parametr Wartości Opis
embed true Aktywuje tryb osadzania (wymagany)
theme light, dark Nadpisuje domyślny motyw portalu
bg Kolor hex (np. %23ffffff) Ustawia niestandardowy kolor tła dopasowany do strony

Przykład z ciemnym motywem i niestandardowym tłem:

<iframe
  src="https://startupkit.app/careers/your-subdomain?embed=true&theme=dark&bg=%231a1a2e"
  width="100%"
  height="800"
  frameborder="0"
></iframe>

Uwaga: w adresach URL należy używać %23 zamiast # dla kolorów hex.

Automatyczne dostosowywanie rozmiaru

Kit wysyła wysokość treści portalu do okna nadrzędnego za pomocą postMessage. Aby iframe automatycznie dostosowywał wysokość, należy dodać następujący skrypt do strony:

<script>
  window.addEventListener("message", function(event) {
    if (event.data && event.data.type === "resize") {
      var iframe = document.querySelector("iframe");
      iframe.style.height = event.data.height + "px";
    }
  });
</script>

Zapobiega to pojawianiu się pasków przewijania wewnątrz iframe i zapewnia kandydatom płynne przeglądanie treści.

JSON API

Kit udostępnia również JSON API dla portalu kariery na potrzeby budowy w pełni niestandardowej strony z ofertami pracy. Wystarczy wysłać żądanie do adresu URL portalu kariery z nagłówkiem Accept: application/json lub dołączyć .json:

GET https://startupkit.app/careers/your-subdomain.json

Odpowiedź zawiera wszystkie opublikowane oferty pracy wraz z metadanymi (tytuł, lokalizacja, dział, wynagrodzenie itp.). Odpowiedź JSON jest buforowana przez 5 minut.

Opcja ta jest przydatna, gdy potrzebna jest pełna kontrola nad wyglądem i renderowanie ofert pracy za pomocą własnego kodu frontendowego. Każda oferta w odpowiedzi zawiera pole url prowadzące do publicznej strony szczegółów oferty, na której kandydaci mogą aplikować.

Format czytelny dla LLM (llms.txt)

Kit udostępnia plik llms.txt dla portalu kariery — pojedynczy dokument markdown, który asystenci AI i modele LLM mogą wykorzystać do poznania wszystkich otwartych stanowisk:

https://startupkit.app/careers/your-subdomain/llms.txt

Plik zawiera każdą opublikowaną ofertę pracy z pełnym opisem, lokalizacją, rodzajem zatrudnienia, przedziałem wynagrodzenia, adresem URL do aplikowania oraz etapami procesu rekrutacyjnego. Gdy nie ma otwartych stanowisk, plik kieruje do puli talentów.

Plik jest zgodny ze specyfikacją llms.txt i jest automatycznie linkowany w sekcji <head> HTML portalu kariery w celu ułatwienia odkrycia. Nie wymaga konfiguracji — jest zawsze dostępny i synchronizowany z opublikowanymi ofertami.

SEO i mapa strony

Kit generuje mapę strony dla portalu kariery pod adresem:

https://startupkit.app/careers/your-subdomain/sitemap.xml

Mapa strony zawiera wszystkie opublikowane oferty pracy wraz z datami ostatniej aktualizacji. Należy ją przesłać do wyszukiwarek, aby poprawić widoczność ofert pracy. Kit generuje również dane strukturalne (JSON-LD w schemacie JobPosting) na każdej stronie szczegółów oferty, co umożliwia wyświetlanie rozszerzonych wyników wyszukiwania.

Szybka lista kontrolna

  • Dodać kod iframe do strony internetowej firmy
  • Ustawić embed=true, aby aktywować tryb kompaktowy
  • Dopasować motyw i kolor tła do wyglądu strony
  • Dodać skrypt automatycznego dostosowywania wysokości
  • Przetestować osadzenie na komputerze i urządzeniu mobilnym
  • Przesłać mapę strony portalu kariery do Google Search Console
  • Rozważyć użycie JSON API, jeśli potrzebny jest w pełni niestandardowy projekt

Wpisz, aby wyszukać...