InGoedeBanen plugin

Via de IGB Vacature plugin beschik je automatisch over al jouw vacatures op je eigen WordPress site.

Introductie

Welkom bij de handleiding van de In Goede Banen plugin.

Met InGoedeBanen.nl worden vacatures snel en eenvoudig geplaatst op ruim 500 jobboards. Naast haar CRM software, biedt InGoedeBanen.nl ook koppelingen naar diverse websites. Tussendoor en InGoedeBanen.nl hebben in samenwerking een IGB Vacature WordPress plugin ontwikkeld, waarmee het aanbod vacatures vanuit InGoedeBanen.nl realtime verstuurd en gesynchroniseerd kan worden richting WordPress. Via de IGB Vacature plugin beschik je dus automatisch over al jouw vacatures op je eigen WordPress site. Met het bijgeleverde zoek- en filterformulier is het zoeken naar de ideale baan (in een WordPress site) voor jouw bezoekers een fluitje van een cent.


Features

Dit basis thema kan je als child-theme van je hoofdthema installeren.


Installatie

Installeer de plugin door de ontvangen plugin naar /wp-content/plugins/ te uploaden. Activeer de plugin vervolgens vanuit de WordPress admin.

Plugin updates worden beschikbaar gesteld via de WordPress plugin pagina. Ook is op het dashboard van de plugin te zien of de plugin up-to-date is.

Vereisten

Als hier niet aan voldaan wordt zal het activeren van de plugin mislukken of kan het zijn dat de site niet meer wordt geladen. In dat geval moet de plugin map worden hernoemd of verwijderd om het probleem te verhelpen.

Verder zijn de volgende vereisten noodzakelijk voor het soepel laten verlopen van updates:

Licentie

Bij de aanschaf van de plugin heb je een licentiecode gekregen. Het is van belang dat deze wordt ingevoerd om de plugin zonder restricties te laten werken en om plugin updates te kunnen ontvangen.

Schijfbevoegdheden

Na het activeren van de plugin in WordPress is het van belang om te controleren dat de plugin voldoende schijfbevoegdheden heeft. Als hier niet aan wordt voldaan zullen plugin instellingen niet kunnen worden opgeslagen en zal bijwerken foutmeldingen geven.

Instellingen

Alle instellingen van de plugin worden opgeslagen in de thema-map. Dit heeft als voordeel dat een site gemakkelijk gekopieerd kan worden waarbij alle instellingen ook worden overgenomen.

Bij het wisselen van het actieve WordPress thema worden de instellingen niet automatisch meegenomen. Wissel dus eerst naar het gewenste thema en begin pas daarna met het instellen van de plugin, of verplaats na de thema-wisseling de instellingen map handmatig naar het nieuwe thema. Controleer vervolgens de schijfbevoegdheden opnieuw.


Tussendoor B.V.
Sixmastraat 66-B
8932 PA Leeuwarden

e. info@tussendoor.nl
w. http://www.tussendoor.nl

Admin

Deze sectie van de documentatie is bedoeld voor het gebruik van de plugin vanuit de WordPress omgeving.

Dashboard

Het dashboard dient als centrale beginpunt van de plugin. Zo biedt het beknopt inzicht in het bijwerkproces en over de installatie. Na de activatie kan de plugin vanaf het dashboard geactiveerd worden door de meegeleverde licentiecode in te vullen.

Verder kan de schijfbevoegdheden direct vanaf het dashboard worden gecontroleerd. Het is belangrijk dat deze in order zijn voor het juist functioneren van de plugin, wanneer er problemen zijn wordt dit duidelijk gemaakt door rood gearceerde tekst.

dashboard_igb_2.png


Instellingen

Instellingen die van toepassing zijn op de gehele plugin kunnen in het tabblad Instellingen worden aangepast. Deze instellingen hebben betrekking tot het doorsturen van de gegevens vanaf IGB.

Allereerst moet een koppeling met IGB worden gerealiseerd. Via het instellingen tabblad is bij Bijwerklink de URL te vinden welke aan IGB (info@ingoedebanen.nl) moet worden doorgegeven. Zij zullen deze vervolgens koppelen aan de juiste account.

Houd er rekening mee dat je exact de juiste URL doorgeeft aan IGB, zonder juiste URL werkt de plugin niet. Bij het verhuizen van een website van ontwikkelomgeving naar een live site kan deze wijzigen, houd hier rekening mee.

Voor alle instellingen geldt dat ze expliciet moeten worden opgeslagen, via de blauwe knop rechtsboven.

Voor iedere object afkomstig vanuit de feed wordt een WordPress post aangemaakt. De titel, inhoud en auteur van deze posts kunnen naar wens worden aangepast.

instellingen_igb.png

De titel bepaalt hoe de URL van een vacature eruit ziet, dit is een standaard WordPress functionaliteit. Wanneer je de titel van een vacature anders vorm wil geven zullen daarom de posts opnieuw aangemaakt moeten worden, verwijder daarvoor de vacatures en haal ze opnieuw binnen.

Let er daarbij op dat alleen vacatures die nog in de feed zitten opnieuw worden opgeslagen, het kan voorkomen dat een vacature niet meer in de feed zit en dat deze niet opnieuw opgeslagen kan worden.

De inhoud bepaalt de content van een vacature, hier plaatsen we standaard de aanbiedingstekst van een vacature in.

Als er een typefout in de tekst zit en dit wordt binnen het CRM van IGB aangepast, dan wijzigen we de aanbiedingstekst alleen in de database. Haal daarom altijd de waarde uit de database en niet uit the_content(). De post wordt namelijk niet volledig opnieuw opgeslagen waardoor the_content() de typefout behoudt.

Overig

Vanaf IGB is het mogelijk om bedrijfslogo’s mee te sturen bij de vacature(s). Via de optie “Logo” kan worden aangegeven of deze wel of niet gedownload moeten worden in de WordPress site.

 


Zoekvelden

Vanuit de admin kunnen zoekvelden worden toegevoegd, met hun zoekopties en bijbehorende zoekopdracht. Hieronder zie je een voorbeeld van een zoekveld waarmee op locatie gezocht kan worden.

De naam van een zoekveld is belangrijk, hiermee koppel je het zoekveld aan een zoekveld binnen je thema. Plaats geen hoofdletters, spaties of streepjes in de naam. Dit kan voor onverwachte problemen zorgen.

zoekfilters_1_igb.png


Opties

In het voorbeeld hierboven willen we het zoekveld 'locatie' in een dropdown op de pagina tonen, om de dropdown te vullen met zoekopties kan je binnen de instellingen van het zoekveld opties toevoegen. Op deze opties moet uiteindelijk gezocht kunnen worden, geef daarom een duidelijk label op zodat bezoekers van de website weten wat voor zoekresultaat ze kunnen verwachten.

Het label van de zoekoptie zie je links in de rij en rechts in de grijze bol zie je de waarde. De plugin zoekt binnen de objecten naar deze waarde. In het voorbeeld zijn beide waardes gelijk, maar het kan zijn dat de waarde 'Leeuwarden' is terwijl je wil dat bezoekers op het label 'LWD' kunnen klikken. Wanneer de bezoeker op het vormgegeven label 'LWD' klikt zoekt de plugin dus naar vacatures met de status waarde 'Leeuwarden'.

De plugin weet natuurlijk niet automatisch op welk veld er gezocht moet worden en de naam 'locatie' van het zoekveld is niet genoeg. Je moet daarom nog een zoekopdracht toevoegen waardoor de plugin weet dat het veld 'locatie' gebruikt moet worden. Lees verder op de pagina om er achter te komen hoe je dit doet.

Helemaal links in de rij kan je aan zoekoptie de- of activeren, met het kruisje helemaal rechts kan een optie worden verwijderd en de checkbox er links naast bepaalt of de optie standaard geselecteerd is.

Automatisch bijwerken

In het voorbeeld hierboven willen we zoeken op 'locatie' en je ziet dat onder de naam van het zoekveld 'automatisch bijwerken' op het veld locatie is ingesteld. Voor sommige zoekvelden is het makkelijk om alle mogelijke waardes automatisch beschikbaar te stellen. Door bij ‘Automatisch bijwerken’ het zoekveld te koppelen aan één van de velden, zoekt de plugin door de database naar alle waarden van dit veld binnen de aanwezige vacatures.

Bij het opslaan van de instellingen worden direct alle opties toegevoegd die momenteel beschikbaar zijn, dus handmatig invoeren is dan niet nodig. Labels en waarden worden automatisch toegevoegd.

Primaire opties

Het kan gewenst zijn om bepaalde opties bovenaan de lijst te tonen, zodat ze bijvoorbeeld bovenaan in een dropdown staan. Door deze opties bovenaan in de lijst te schuiven zullen nieuw toegevoegde opties worden ingevoegd vanaf het punt waar deze primaire opties stoppen, dit is waar de alfabetische volgorde onderbroken wordt. De gekozen opties blijven dus altijd bovenaan staan en nieuwe opties worden alsnog alfabetisch toegevoegd. Slepen doe je door op het grid-icoon helemaal links in een zoekoptie rij te klikken en vervolgens te slepen.

Afhankelijke zoekvelden

Opties kunnen worden gekoppeld aan de waarde van een ander veld. Als voorbeeld hieronder zie je het wederom het zoekveld ‘locatie’, deze is afhankelijk van het zoekveld ‘provincie’. Voor elke locatie kan dan worden opgegeven bij welk provincie deze locatie zichtbaar moet zijn. Dus stel een bezoeker filtert op in het zoekveld voor 'provincie' naar 'Friesland' dan wordt in dit geval in het zoekveld voor 'locatie' alleen nog 'Leeuwarden' getoond.

Wanneer er nog geen provincie is gekozen door de bezoeker zal het zoekveld voor locatie leeg zijn.

afhankelijk_igb.png

 


Zoekopdracht

Zoals eerder aangegeven is het niet voldoende om alleen opties toe te voegen, de plugin weet dan namelijk nog niet op welke waarde er gezocht moet worden. Om dit aan de plugin door te geven moet er een zoekopdracht toegevoegd worden.

In veel gevallen is voor iedere optie dezelfde zoekopdracht van toepassing, dan kan een algemene zoekopdracht worden ingesteld. Ook kan voor een optie specifiek een aangepaste zoekopdracht worden opgegeven.

Algemeen

Een algemene zoekopdracht kan onderaan de pagina worden ingevuld bij 'zoekopdracht'. Een ingestelde zoekoptie kan argumenten aan deze zoekopdracht meegeven zodat elke zoekoptie toch een ander resultaat kan geven. Zoals in het voorbeeld van het zoekveld voor locatie stellen we algemeen in dat de plugin op het veld 'locatie' moet zoeken. Per zoekoptie vullen we een andere waarde in en na het klikken (door een bezoeker) op een zoekoptie zal de plugin zoeken naar vacatures met de locatie van de zoekoptie die is aangeklikt.

Rechts naast het label van een optie zie je, zoals eerder aangegeven, de waarde van de zoekoptie in een grijs bolletje. In een algemene zoekopdracht refereer je naar deze waarde met #{0}.

Als een optie geen argumenten heeft wordt de algemene zoekopdracht niet toegepast!

Het is ook mogelijk om nog een argument toe te voegen, na het aanpassen van je eerste waarde druk je op tab waardoor er nog een grijs bolletje ontstaat. Hier kan je je extra waarde invullen. Vanuit de algemene zoekopdracht wordt aan het eerste argument gerefereerd door #{0}, meer argumenten zijn #{1}, #{2} enz.

Zo kan je bijvoorbeeld de opleiding HBO, MBO en VMBO als volgt onder 'Overig' plaatsen. Een bezoeker ziet dus alleen het label 'Overig' maar de plugin zoekt direct ook naar vacatures waar minimaal de opleidingen HBO, MBO en VMBO nodig zijn.

meerderewaardes_zoekveld_igb_2.png

Bij de zoekopdracht stel je nu 'minstens een' in zodat de plugin zoekt naar vacatures die OF de opleiding 'HBO' OF de opleiding 'MBO' OF de opleiding 'MBO' nodig hebben.

Complexe zoekopdrachten zoals hierboven kunnen worden bereikt door meerdere regels toe te voegen, of zelfs meerdere groepen met regels. Voeg regels toe via het kleine omcirkelde plusje rechts naast een regel, en groepen via de grote plus aan het begin van de groep.  Een groep bevat vaak zelf ook meerdere regels, je kan instellen of een object aan alle regels binnen een groep moet voldoen of minstens een. Boven een groep heb je namelijk opnieuw deze keuze zoals je nu ook in het screenshot naar 'zoekopdracht' ziet staan.

Specifiek

Het komt ook voor dat je een zoekveld wil aanmaken waarvoor geen algemene zoekopdracht mogelijk is, bijvoorbeeld wanneer elke optie op een ander veld moet zoeken. In zo'n geval kan je per optie een zoekopdracht meegeven, belangrijk hiervoor is dat je de waarde (in het grijze bolletje) verwijdert. Daarna klik je op de asterisk om een specifieke zoekopdracht in te stellen, dit gaat op gelijke wijze als de algemene zoekopdracht, maar hier stel je vaste waardes in en maak je dus geen gebruik van #{0} of #{1}

In het voorbeeld met de opleiding waar het label 'Overig' op 'HBO' 'MBO' en 'VMBO' moet zoeken ziet dat er als volgt uit:

specifieke_zoekopdracht_igb.png

Als je goed kijkt zie je in het bovenstaande voorbeeld dat de andere opleidingen nog wel van de algemene zoekopdracht gebruik maken. Dit is dus ook mogelijk.


 

Geavanceerde instellingen

De admin interface biedt toegang tot een klein aantal instellingen, meer geavanceerde instellingen kunnen worden toegepast via het admin tabblad ‘Geavanceerd’. Dit geeft de mogelijkheid om het ruwe bestand met instellingen direct te wijzigen, waaronder ook instellingen die niet gewijzigd zouden moeten worden. Hieronder geven we enkele instellingen die wél zonder risico’s kunnen worden aangepast.

geavanceerde_instellingen_igb.png

Bij verkeerde aanpassingen van de instellingen kunnen fouten in de plugin worden veroorzaakt die niet op te lossen zijn vanuit het dashboard. Wees daarom altijd voorzichtig.

Sorteren

Om resultaten te sorteren moeten de sorteerrichtingen via de geavanceerde instellingen handmatig worden toegevoegd. In search.orderings kan een array van objecten worden opgegeven waarbij de key orderby verplicht is en aangeeft op welke velden er gesorteerd moet worden. Door voor een object "default": true op te geven wordt deze sorteervolgorde als standaard toegepast. Eventueel andere keys zijn beschikbaar vanuit de template.

Meerdere velden worden gescheiden door een komma, de volgorde zelf volgt op de naam van het veld met een dubbele punt en vervolgens asc voor oplopend, desc voor aflopend.

"search": {
    "orderings": [
        {
            "orderby": "datum:asc",
            "label": "Datum",
            "meta": "oplopend",
          	"default": true
        },
        {
            "orderby": "datum:desc",
            "label": "Datum",
            "meta": "aflopend"
        }
    ]
},

Om de bezoeker van de website vervolgens de mogelijkheid te geven om te switchen tussen sorteeropties kan je bijvoorbeeld een dropdown vullen met door jou ingestelde opties. Hoe je dat doet lees je binnen Ontwikkeling.

Vacatures overzicht pagina

De titel van de pagina met vacatures kan worden aangepast via post.archive.title. Het aantal weer te geven resultaten per pagina is eenvoudig aan te passen door post.archive.query.posts_per_page aan te passen. Overige parameters voor de WP_Query kunnen overigens ook via post.archive worden opgegeven.

Andere WordPress plugins kunnen op hun eigen manier de titel aanpassen, waardoor het wijzigen van post.archive.title niet altijd invloed heeft.

Er zijn WordPress thema's en WordPress plugins die de werking van het aantal berichten per pagina overschrijven waardoor het wijzigen van post.archive.query.posts_per_page niet altijd invloed heeft.

URL's aanpassen

Standaard is de pagina met een overzicht van vacatures bereikbaar op /vacatures/ en een enkele vacature op /vacature/{title}. Dit wordt bepaald door de registratie van WordPress’ custom post type, en kan dus worden aangepast door post.register.has_archive en post.register.rewrite.slug aan te passen.

URL opdelen in componenten

Normaal zal een vacature met titel Leeuwarden - Backend developer gezocht beschikbaar zijn onder de URL /vacature/leeuwarden-backend-developer-gezocht. Om de titel op te delen in verschillende URL componenten, voor de URL /vacature/leeuwarden/backend-developer-gezocht, kan bij instellingen in de titel #{/} worden ingevoegd om op die positie de dash (-) te vervangen door een slash (/):