Allimedia Datacruit Jobs - dokumentace

K čemu plugin slouží

Allimedia Datacruit Jobs propojuje WordPress s náborovým systémem Datacruit. Z Datacruit API načítá veřejné pracovní nabídky a umožňuje je zobrazit na webu jako přehled pozic a samostatné stránky s detailem.

Plugin obsahuje vlastní nastavení vzhledu a volitelné e-mailové konektory pro formulářové pluginy. Díky nim lze do zprávy správci i potvrzení uchazeči automaticky vložit název pracovní pozice, ze které byl formulář odeslán.

Hlavní funkce

načítání veřejných pracovních nabídek z Datacruit API;
samostatný přehled pracovních pozic a detail nabídky;
stránkování přehledu pracovních pozic;
bezpečné uložení přístupových údajů v administraci nebo v wp-config.php;
cache odpovědí Datacruit API pro rychlejší web a nižší počet externích požadavků;
dva režimy vzhledu: design aktivní šablony nebo vlastní design pluginu;
nastavení fontů, velikostí, vah a barev;
možnost nahrát vlastní font ve formátu WOFF2 nebo WOFF;
volitelné e-mailové konektory pro Forminator, Contact Form 7 a WPForms;
automatické doplnění názvu otevřené pozice do e-mailové notifikace formuláře;
načítání pouze zapnutých e-mailových konektorů;
přepisovatelné HTML šablony pro child theme;
licenční systém, pravidelná kontrola licence a automatické aktualizace;
zachování kompatibility se shortcode z původní verze pluginu.

Požadavky

WordPress 6.0 nebo novější;
PHP 8.1 nebo novější;
platná licence pluginu;
aktivní účet Datacruit a přístupové údaje k Datacruit API;
odchozí HTTPS připojení serveru k api.datacruit.com a allimedia.cz;
pro e-mailové propojení jeden z podporovaných formulářových pluginů: Forminator, Contact Form 7 nebo WPForms.

Plugin ve verzi 3.3.0 je testovaný do WordPressu 7.0.

Instalace

Přihlaste se do administrace WordPressu.
Otevřete Pluginy → Instalace pluginů.
Klikněte na Nahrát plugin.
Vyberte dodaný ZIP soubor pluginu.
Klikněte na Instalovat a po dokončení na Aktivovat.
Otevřete Nastavení → Datacruit Jobs.

Plugin není distribuovaný prostřednictvím veřejného katalogu WordPress.org. Aktualizace poskytuje vlastní zabezpečený aktualizační systém Allimedia.

Rychlé zprovoznění

Otevřete Nastavení → Datacruit Jobs → Licence a aktivujte licenci.
Na záložce Nastavení vyplňte uživatelské jméno a heslo Datacruit API.
Vytvořte stránku s přehledem pozic a vložte do ní shortcode [allimedia_datacruit_jobs].
Vytvořte stránku s detailem pozice a vložte do ní shortcode [allimedia_datacruit_job_detail].
Obě stránky vyberte v nastavení pluginu a změny uložte.
Na záložce Design zvolte vzhled aktivní šablony nebo nastavte vlastní design.
Pokud používáte formulář pro odpověď na pozici, otevřete E-mailové konektory a zapněte odpovídající integraci.
Otevřete přehled pracovních nabídek a zkontrolujte zobrazení seznamu i detailu.

Aktivace licence

V administraci otevřete Nastavení → Datacruit Jobs.
Přejděte na záložku Licence.
Vložte licenční klíč.
Klikněte na Aktivovat licenci.

Po úspěšné aktivaci se zobrazí stav licence, její typ a případná doba platnosti. Uložený licenční klíč je v administraci maskovaný.

Plugin licenci pravidelně kontroluje jednou denně. Pokud je licenční server dočasně nedostupný, dříve ověřená licence může pokračovat v ochranné lhůtě až 14 dnů. Neplatná, expirovaná nebo chybějící licence vypne načítání pracovních nabídek i e-mailových konektorů.

Deaktivace licence

Tlačítko Deaktivovat licenci uvolní aktivaci pro použití na jiném webu. Běžná deaktivace WordPress pluginu licenci na licenčním serveru automaticky neuvolňuje.

Připojení k Datacruit API

Přístupové údaje získáte ve svém účtu Datacruit nebo od správce náborového systému.

Na záložce Nastavení vyplňte:

Uživatelské jméno API;
Heslo API.

Po uložení se heslo již nevypisuje zpět do HTML administrační stránky. Prázdné pole při dalším uložení zachová stávající heslo. Pokud chcete uložené heslo odstranit, použijte příslušnou volbu u pole hesla.

Přístupové údaje ve wp-config.php

Na spravovaných nebo produkčních webech lze přístupové údaje definovat přímo v souboru wp-config.php:

define( 'ALLIMEDIA_DATACRUIT_API_USERNAME', 'uzivatel@example.cz' );
define( 'ALLIMEDIA_DATACRUIT_API_PASSWORD', 'tajne-heslo' );

Konstanty mají přednost před údaji uloženými v databázi. Pokud jsou definované, příslušná pole v administraci jsou uzamčená.

Vytvoření stránek

Plugin používá dvě běžné WordPress stránky.

Přehled pracovních pozic

Vytvořte stránku, například Kariéra, a vložte do ní:

[allimedia_datacruit_jobs]

Stránka zobrazí počet dostupných nabídek, karty pracovních pozic a stránkování. Výchozí počet je 10 pozic na jednu stránku.

Detail pracovní pozice

Vytvořte druhou stránku, například Detail pozice, a vložte do ní:

[allimedia_datacruit_job_detail]

Plugin na této stránce zobrazí detail pozice zvolené v přehledu. Podle dostupných dat může detail obsahovat název, lokalitu, plat, typ úvazku, krátký popis, plný popis, požadavky a nabídku zaměstnavatele.

Výběr stránek v nastavení

Na záložce Nastavení vyberte:

Stránku se seznamem pozic;
Stránku s detailem pozice.

Bez vybrané stránky detailu se v přehledu nemusí zobrazit tlačítko Více informací. Bez vybrané stránky přehledu nebude v detailu dostupný odkaz Zpět na přehled nabídek.

Starší shortcode

Kvůli kompatibilitě zůstávají funkční také původní shortcode:

[datacruit_jobs_customized]
[datacruit_job_detail]

Pro nový obsah používejte aktuální shortcode s prefixem allimedia_datacruit_.

Cache pracovních nabídek

Odpovědi Datacruit API se ukládají do WordPress transients. Opakované načtení stránky proto obvykle neodesílá nový požadavek do Datacruitu.

Výchozí platnost cache je 3600 sekund, tedy jedna hodina. V administraci lze nastavit hodnotu od 300 do 86 400 sekund.

kratší doba zobrazí změny z Datacruitu rychleji, ale zvýší počet API požadavků;
delší doba sníží zatížení API, ale nové nebo upravené pozice se mohou na webu projevit později.

Uložení hlavního nastavení pluginu cache pracovních nabídek automaticky vymaže.

E-mailové konektory

Plugin sám nevytváří formulář ani neposílá vlastní potvrzovací e-maily. Propojí aktuální pracovní pozici s e-mailovými notifikacemi podporovaného formulářového pluginu.

V administraci otevřete Nastavení → Datacruit Jobs → E-mailové konektory. Konektor lze zapnout pouze tehdy, když je odpovídající formulářový plugin aktivní.

Všechny vestavěné konektory používají placeholder:

{allimedia_datacruit_position}

Starší placeholder {datacruit_pozice} zůstává podporovaný kvůli zpětné kompatibilitě.

Jak se pozice přenáší do formuláře

Při otevření detailu z odkazu vytvořeného pluginem se název pozice uloží na dvě hodiny do podepsané cookie. Podpis brání podvržení libovolného názvu pozice. Konektor placeholder nahradí pouze tehdy, když je cookie platná.

Pokud návštěvník odešle formulář mimo detail pracovní pozice nebo po vypršení cookie, placeholder zůstane beze změny. Každý e-mail, ve kterém chcete název pozice zobrazit, musí obsahovat placeholder samostatně.

Forminator

Aktivujte Forminator.
Na záložce E-mailové konektory zapněte dlaždici Forminator.
Otevřete nastavení e-mailové notifikace formuláře.
Do předmětu nebo těla vložte {allimedia_datacruit_position}.
Stejný placeholder vložte také do potvrzení zájemci, pokud ho Forminator odesílá.

Konektor nahradí placeholder při sestavení předmětu a těla notifikace.

Contact Form 7

Aktivujte Contact Form 7.
Na záložce E-mailové konektory zapněte dlaždici Contact Form 7.
Otevřete konkrétní formulář a přejděte na záložku E-mail.
Do pole Předmět nebo Tělo zprávy vložte {allimedia_datacruit_position}.
Pokud používáte potvrzení návštěvníkovi přes E-mail (2), vložte placeholder také do jeho předmětu nebo těla.

Konektor podporuje hlavní e-mail i volitelný E-mail (2).

WPForms

Aktivujte WPForms.
Na záložce E-mailové konektory zapněte dlaždici WPForms.
V editoru formuláře otevřete Nastavení → Oznámení.
Do předmětu nebo zprávy vložte {allimedia_datacruit_position}.

Po zapnutí konektoru je položka dostupná také v nabídce WPForms Smart Tags pod názvem Pracovní pozice Datacruit. Konektor zpracuje každé administrátorské i uživatelské oznámení, které tento Smart Tag obsahuje.

Výkon konektorů

Vypnutý konektor:

nenačítá svůj PHP soubor;
neregistruje hooky formulářového pluginu;
nenačítá JavaScript ani CSS na frontendu;
nemění e-maily ostatních formulářových pluginů.

Zapínejte pouze integrace, které na webu skutečně používáte.

Design pracovních nabídek

Na záložce Design jsou dostupné dva režimy.

Použít design z motivu

Plugin převezme fonty, velikosti a barvy z aktivní WordPress šablony. Zachová pouze rozložení pracovních karet, mezery, responzivní chování a další strukturální styly potřebné pro správné zobrazení.

Tento režim je výchozí pro nové instalace.

Použít vlastní design

Po zvolení vlastního designu lze nastavit:

rodinu základního fontu;
vlastní nahraný font;
základní velikost a váhu písma;
velikost a váhu nadpisů v přehledu a detailu;
velikost a váhu textu tlačítek;
barvu nadpisů, běžného a doplňkového textu;
barvu pozadí karet, detailu a zvýrazněných bloků;
barvu okrajů;
pozadí a text tlačítek;
barvy tlačítek při najetí kurzorem;
barvu focus zvýraznění při ovládání klávesnicí.

Dynamické CSS se načítá pouze na stránkách s pracovním přehledem nebo detailem a pouze ve vlastním režimu.

Vlastní font

V poli Rodina fontu zvolte Vlastní nahraný font.
Klikněte na Nahrát nebo vybrat font.
Vyberte soubor WOFF2 nebo WOFF z knihovny médií.
Nastavení uložte.

Doporučený je formát WOFF2. Plugin jiné formáty fontů nepovolí. Font používá font-display: swap, takže neblokuje první vykreslení textu.

Přepsání HTML šablon

Výchozí šablony jsou uložené v adresáři templates/ pluginu. Pro vlastní úpravu je nekopírujte přímo uvnitř pluginu, protože aktualizace by změny přepsala.

Soubory zkopírujte do child theme:

wp-content/themes/nazev-child-theme/allimedia-datacruit-jobs/jobs-list.php
wp-content/themes/nazev-child-theme/allimedia-datacruit-jobs/job-detail.php

Plugin nejprve hledá šablonu v child theme a teprve poté použije vlastní výchozí soubor.

Po aktualizaci pluginu zkontrolujte, zda se struktura výchozích šablon nezměnila. Starší vlastní šablony mohou vyžadovat ruční doplnění nových CSS tříd nebo funkcí.

Aktualizace pluginu

Plugin používá vlastní aktualizační systém napojený na licenci Allimedia. Dostupná aktualizace se zobrazí standardně na stránce Pluginy → Instalované pluginy nebo Nástěnka → Aktualizace.

Pro stažení aktualizačního balíčku je potřeba uložený licenční klíč. Balíčky jsou přijímány pouze přes HTTPS z povolených domén Allimedia.

Před aktualizací produkčního webu doporučujeme vytvořit zálohu souborů a databáze.

Chyba oprávnění při aktualizaci

Pokud WordPress oznámí, že některé soubory nelze zkopírovat, ověřte vlastníka a oprávnění adresáře:

wp-content/plugins/allimedia-datacruit-jobs

PHP proces WordPressu musí mít právo soubory pluginu přepsat a v jeho adresářích vytvářet nové soubory. Běžné bezpečné hodnoty jsou 644 nebo 664 pro soubory a 755 nebo 775 pro adresáře podle konfigurace hostingu. Nepoužívejte plošně oprávnění 777. Pokud si nejste jistí, požádejte správce hostingu o sjednocení vlastníka a skupiny souborů WordPressu.

Deaktivace a odinstalace

Deaktivace

Při běžné deaktivaci pluginu:

se přestanou zobrazovat pracovní nabídky;
přestanou fungovat e-mailové konektory;
zruší se naplánovaná denní kontrola licence;
uložené nastavení, licence, API přístupy a design zůstanou zachované.

Po opětovné aktivaci plugin obnoví pravidelnou licenční kontrolu a použije původní nastavení.

Odinstalace

Při odstranění pluginu přes administrační stránku WordPressu se smažou:

hlavní nastavení a uložené API přístupy;
stav a klíč licence;
nastavení e-mailových konektorů;
nastavení designu;
cache pracovních nabídek a detailů;
cache aktualizačního systému;
naplánovaná licenční kontrola.

Font nahraný do knihovny médií zůstane v knihovně jako běžná mediální příloha. Plugin nemaže WordPress stránky, do kterých byly vložené shortcode.

Ochrana soukromí a externí služby

Plugin neobsahuje reklamní systém ani analytické nebo marketingové sledování návštěvníků.

Datacruit API

Server webu komunikuje s api.datacruit.com pomocí uloženého uživatelského jména a hesla. Z Datacruitu načítá veřejné informace o pracovních pozicích. Odpovědi jsou dočasně uložené v cache databáze WordPressu.

Formulářová data uchazečů plugin do Datacruitu neposílá. Odeslání, uložení a doručení formuláře zajišťuje zvolený formulářový plugin a případný SMTP plugin.

Licenční a aktualizační server

Při aktivaci, kontrole licence a zjišťování aktualizací server webu komunikuje s allimedia.cz. Požadavek může obsahovat:

licenční klíč;
doménu a URL webu;
identifikátor a aktuální verzi pluginu;
technické údaje potřebné k aktivaci licence a doručení správného aktualizačního balíčku.

Pro e-mailové konektory plugin používá dvě technické cookies s platností dvě hodiny:

název otevřené pracovní pozice;
kryptografický podpis chránící název před podvržením.

Cookies jsou nastavené jako HttpOnly, používají SameSite=Lax a na HTTPS webu také příznak Secure. Neobsahují odpovědi uchazeče ani jeho kontaktní údaje.

Provozovatel webu by měl použití Datacruit API, formulářového pluginu, licenčního serveru a technických cookies zohlednit ve vlastních zásadách ochrany osobních údajů a cookies podle konkrétní konfigurace webu.

Řešení problémů

Pracovní nabídky se nezobrazují

Ověřte, že je plugin aktivní.
Zkontrolujte platnost licence na záložce Licence.
Ověřte vyplněné uživatelské jméno a heslo Datacruit API.
Zkontrolujte, zda server může komunikovat přes HTTPS s api.datacruit.com.
Ověřte, že jsou v Datacruitu dostupné veřejné pracovní nabídky.
Zkuste znovu uložit nastavení pluginu, čímž se vymaže jeho API cache.

Datacruit odmítá přístupové údaje

Zkontrolujte uživatelské jméno a heslo bez nadbytečných mezer.
Pokud používáte konstanty v wp-config.php, ověřte jejich aktuální hodnoty.
Ověřte u správce Datacruitu, že má účet oprávnění načítat veřejné pracovní nabídky.

Tlačítko Více informací se nezobrazuje

Na záložce Nastavení vyberte publikovanou stránku obsahující shortcode [allimedia_datacruit_job_detail].

V detailu chybí odkaz zpět

Na záložce Nastavení vyberte publikovanou stránku obsahující shortcode [allimedia_datacruit_jobs].

Přepínač e-mailového konektoru nelze zapnout

Ověřte, že je odpovídající formulářový plugin aktivní.
Zkontrolujte platnost licence Allimedia Datacruit Jobs.
Obnovte administrační stránku po aktivaci formulářového pluginu.

Název pozice se v e-mailu nenahradil

Ověřte, že je správný e-mailový konektor zapnutý.
Použijte přesný placeholder {allimedia_datacruit_position}.
Vložte placeholder samostatně do každé požadované notifikace.
Formulář odešlete z detailu pozice otevřeného přes tlačítko v přehledu.
Ověřte, že od otevření detailu neuplynuly více než dvě hodiny.
Zkontrolujte, zda bezpečnostní nebo cache plugin neodstraňuje technické cookies.

Změny v Datacruitu se na webu neprojevily

Vyčkejte do vypršení nastavené cache nebo znovu uložte hlavní nastavení pluginu. Zkontrolujte také cache stránky, objektovou cache, CDN a cache prohlížeče.

Vlastní design se nepoužívá

Ověřte, že je zvolen režim Použít vlastní design.
Nastavení uložte tlačítkem Uložit design.
Vymažte cache stránky, minifikovaných stylů a CDN.
Zkontrolujte, zda vlastní CSS aktivní šablony nepřepisuje styly pluginu.

Vlastní font se nenačte

Použijte soubor WOFF2 nebo WOFF.
Zvolte rodinu Vlastní nahraný font.
Ověřte, že příloha stále existuje v knihovně médií.
Zkontrolujte, zda URL fontu neblokuje bezpečnostní pravidlo, CDN nebo rozdílná doména.

Aktualizaci nelze nainstalovat

Ověřte platnost licence a dostupnost allimedia.cz.
Zkontrolujte, že adresář pluginu je zapisovatelný pro PHP proces WordPressu.
Sjednoťte vlastníka a skupinu souborů s ostatními funkčními pluginy.
Ověřte dostatek volného místa na hostingu.
Pokud automatická aktualizace selhává, vytvořte zálohu a nainstalujte aktuální ZIP ručně.

Časté dotazy

Vytváří plugin vlastní formulář pro uchazeče?

Ne. Plugin zobrazuje pracovní pozice a poskytuje e-mailové konektory. Samotný formulář, jeho pole, potvrzení po odeslání, ukládání odpovědí a odesílání e-mailů nastavujete ve Forminatoru, Contact Form 7 nebo WPForms.

Posílá plugin vlastní e-maily?

Ne. E-maily odesílá formulářový plugin prostřednictvím standardního WordPress wp_mail(). Allimedia Datacruit Jobs pouze nahradí placeholder ověřeným názvem aktuální pozice. Díky tomu respektuje také běžné SMTP pluginy napojené na WordPress.

Mohu použít jiný formulářový plugin?

Ano, pracovní nabídky budou fungovat nezávisle na formuláři. Automatické vložení názvu pozice do e-mailu je ve verzi 3.3.0 připravené pro Forminator, Contact Form 7 a WPForms. Další konektor lze doplnit pomocí rozšiřovacího filtru nebo individuální úpravy.

Musí být zapnuté všechny e-mailové konektory?

Ne. Zapněte pouze konektor používaného formulářového pluginu. Vypnuté integrace se nenačítají a nezvyšují režii frontendu.

Co se stane po vypršení licence?

Přestane se načítat přehled a detail pracovních nabídek a nespustí se e-mailové konektory. Uložená nastavení zůstanou zachovaná. Po obnovení a ověření licence začne plugin znovu fungovat bez nutnosti nové konfigurace.

Mohu vzhled upravit vlastním CSS?

Ano. Nejprve lze využít vestavěnou záložku Design. Pro větší úpravy použijte vlastní CSS v child theme. Pro změnu HTML struktury zkopírujte šablony pluginu do adresáře allimedia-datacruit-jobs v child theme.

Funguje plugin s cache pluginem nebo CDN?

Ano. Po změně designu, šablon nebo pracovních nabídek ale může být potřeba vymazat stránkovou cache, objektovou cache a cache CDN. Technické cookies pro e-mailové konektory nesmí být odstraněné před odesláním formuláře.

Jsou API přístupové údaje viditelné ve zdrojovém kódu stránky?

Ne. Požadavky do Datacruit API provádí server WordPressu. Uložené heslo se po uložení nevypisuje zpět do administračního HTML. Pro vyšší provozní bezpečnost lze přístupy definovat v wp-config.php.

Informace pro vývojáře

Shortcode

[allimedia_datacruit_jobs] – přehled pracovních pozic;
[allimedia_datacruit_job_detail] – detail vybrané pracovní pozice;
[datacruit_jobs_customized] – starší kompatibilní alias přehledu;
[datacruit_job_detail] – starší kompatibilní alias detailu.

Přepsání šablon

allimedia-datacruit-jobs/jobs-list.php
allimedia-datacruit-jobs/job-detail.php

Uvedené cesty jsou relativní ke kořenovému adresáři aktivního child theme.

Filtry

allimedia_datacruit_api_base – základní URL Datacruit API;
allimedia_datacruit_api_max_pages – maximální počet načítaných stránek API;
allimedia_datacruit_cache_ttl – platnost cache pracovních pozic;
allimedia_datacruit_jobs_per_page – počet pozic na jednu stránku přehledu;
allimedia_datacruit_license_api_base – základní URL licenčního API;
allimedia_datacruit_license_grace_days – délka ochranné lhůty licence;
allimedia_datacruit_update_cache_ttl – platnost cache kontroly aktualizací;
allimedia_datacruit_update_package_hosts – povolené domény aktualizačních balíčků;
allimedia_datacruit_email_connectors – definice dostupných e-mailových konektorů.

Akce

allimedia_datacruit_email_connector_loaded – spuštěna po načtení konkrétního konektoru;
allimedia_datacruit_email_connectors_updated – spuštěna po uložení nastavení konektorů;
allimedia_datacruit_design_updated – spuštěna po uložení nastavení designu.

Při přidávání vlastního konektoru zachovejte podmíněné načítání a nejprve ověřte dostupnost cílového formulářového pluginu.

Podpora

Pokud potřebujete pomoc s instalací, nastavením, licencí nebo kompatibilitou pluginu, kontaktujte nás:

Allimedia.cz
E-mail: info@allimedia.cz
Web: https://allimedia.cz

Allimedia Datacruit Jobs – dokumentace