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