Logo StartupKit
PL

Osadzanie portalu kariery

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

Oferty pracy na stronie firmy

Tryb osadzania pozwala wyświetlić portal kariery w ramce iframe na stronie firmy. Kandydaci przeglądają oferty i wypełniają formularz w tej ramce.

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>

Skrypt dopasowuje wysokość ramki do treści portalu.

JSON API

Kit udostępnia również JSON API dla portalu kariery, jeśli chcesz zbudować własną stronę z ofertami pracy od podstaw. 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 potrzebujesz pełnej kontroli nad wyglądem i chcesz renderować oferty 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. To 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 witryny

Mapa witryny portalu kariery jest dostępna pod adresem:

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

Kit generuje dane strukturalne i mapy witryn oraz wysyła powiadomienia do Google o zmianach ogłoszeń. Powiadomienia wymagają skonfigurowanej integracji i uprawnień do domeny; o indeksowaniu decyduje Google. 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ę witryny portalu kariery do Google Search Console
  • Rozważ użycie JSON API, jeśli potrzebujesz własnego wyglądu

Wpisz, aby wyszukać...