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

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, żeby dostosować wygląd:

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 używaj %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ść, dodaj do strony następujący skrypt:

<script>
  window.addEventListener("message", function(event) {
    if (event.data && event.data.type === "startupkit-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, jeśli chcesz zbudować całkowicie niestandardową stronę z ofertami pracy. Wyślij żądanie do adresu URL portalu kariery z nagłówkiem Accept: application/json lub dołącz .json:

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

Odpowiedź zawiera wszystkie opublikowane ogłoszenia o pracę 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żde opublikowane ogłoszenie o pracę 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, żeby ułatwić jego odnalezienie. Nie wymaga konfiguracji — jest zawsze dostępny i synchronizowany z opublikowanymi ogłoszeniami.

SEO i mapa strony

Mapa strony portalu kariery jest dostępna pod adresem:

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

Kit automatycznie zarządza danymi strukturalnymi, mapami strony i indeksowaniem w Google w czasie rzeczywistym dla wszystkich opublikowanych ofert. Szczegółowe informacje o tym, jak oferty pracy pojawiają się w wynikach wyszukiwania Google, znajdziesz w Google Jobs i SEO.

W skrócie

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

Wpisz, aby wyszukać...