Dokumentation

Dies ist die Dokumentation für jobs2wordpress Version 3.

Hier gehts zur Dokumentation der alten Version 2: Dokumentation v2

Shortcodes

Job-Filter

Die folgenden Shortcodes können für die Jobfilter auf der Seite verwendet werden, auf der auch die Jobliste eingebunden ist:

Filtern nach Kategorie:

[j2wp_CategoryFilter]

Parameter	Typ	Standard	Beschreibung
default_text	string	Alle	Wie die Option für alle Einträge heissen soll.

Filtern nach benutzerdefiniertem Metafield:

[j2wp_CustomMetaFilter]

Filtern nach Art der Anstellung:

[j2wp_EmploymentTypeFilter]

Parameter	Typ	Standard	Beschreibung
default_text	string	Alle	Wie die Option für alle Einträge heissen soll.

Filtern nach Ort:

[j2wp_LocationFilter]

Filtern nach Name:

[j2wp_NameFilter]

Alle Filter zurücksetzen

[j2wp_ResetLink]

Parameter	Typ	Standard	Beschreibung
linktext	string	„reset filters“	Text für den ResetLink im Frontend

Filtern Button
Frei positionierbarer Button, um alle Filter, die auf der aktuellen Seite eingebunden sind, abzusenden.

[j2wp_SubmitButton]

Parameter	Typ	Standard	Beschreibung
buttontext	string	„Search“	Text für den Absenden-Button im Frontend

Order Filter

Sortiere die Liste der Jobs

[j2wp_OrderFilter]

Parameter	Typ	Standard	Beschreibung
orderby	string	title	Das Feld wonach man sortieren möchte. Optionen: – title – date
oder	string	ASC	Die Richtung in welche sortiert werden soll. Optionen: – ASC – DESC

Custom Drop Down Filter

Erstellte ein Custom Drop Down Feld mit dem man die Jobliste sortieren kann.

[j2wp_CustomDropDownFilter]

Parameter	Typ	Standard	Beschreibung
key	string	–	Das Feld wonach man filtern möchte.
default_text	string	Alle	Wie die Option für alle Einträge heissen soll.

Job-Liste

Stellt die Liste der Jobs dar.

[j2wp_joblist]

Parameter	Typ	Standard	Beschreibung
posts_per_page	number	-1	Anzahl der Jobs, die angezeigt werden -1 = alle Jobs
scroll_to_jobs	bool	false	Ob beim Jobs laden automatisch zur Jobsliste gescrollt werden soll
display_mode	string	list	„list“ oder „grid“ Ansicht der Jobs

Vorgefilterete Job-Liste

Stellt eine vor gefilterte und vor gerenderte Liste der Jobs dar.

[j2wp_prefiltered_joblist]

Parameter	Typ	Standard	Beschreibung
posts_per_page	number	-1	Anzahl der Jobs, die angezeigt werden -1 = alle Jobs
meta_key	string	null (type)	Wenn nur „meta_key“ angegeben wird gefiltert ob das Meta Feld existiert. Wenn auch „meta_value“ angegeben ist wird es als key genutzt.
meta_value	string	null (type)	Jobs werden filtered ob diesen ein Meta Feld haben welches den gleichen Wert hat.

Spezifische Felder ausgeben

Gibt den Wert des angegebenen Feldes zurück.

[j2wp_custom_field field="freitextfeld1" container="false"]

Parameter	Typ	Standard	Beschreibung
field	string		Feldname
provider	string		Einer der 3 folgenden Strings ist möglich: CovetoProvider SoftgardenProvider HR4UProvider

Link zum Job

Gibt den Permalink des aktuellen Jobs im Loop zurück.

[j2wp_joblink]

Bewerber Link

Gibt einen Link zum Bewerben aus.

[j2wp_application_link type=button text="Jetzt Bewerben"]

Parameter	Typ	Standard	Beschreibung
type	string	link	Entweder „link“ oder „button“
text	string	Apply Now	Der Text des Links bzw. des Buttons

Job Gehalt

Gibt das Gehalt für den Job aus

[j2wp_job_salary tag=div]

Parameter	Typ	Standard	Beschreibung
tag	string	div	HTML Element in welchem das Gehalt ausgegeben wird

Job Anzahl

Gibt die aktuelle Anzahl an Jobs an. Wenn auf der Job Liste genutzt dann wird die Anzahl angepasst, wenn der Filter sich ändert.

[j2wp_job_count]

Ansprechpartner Bild

Gibt ein Platzhalter Bilde für den Ansprechpartner aus

[j2wp_job_contact_person_image]

Erweiterung:

• Filter: j2wp_job_contact_person_image
  • Parameters:
    • $image: Ein J2WP Bild Object bei welchem man die URL, Height, Width setzen kann.
    • $job: Das J2WP Job Objekt vom aktuell angezeigt Job
  • Return: J2WP Bild Objekt

Beispiel 1: Filter zum laden vom Coveto Ansprechpartner Bild aus der WordPress Mediathek mit dem Namen als Mapping

add_filter("j2wp_job_contact_person_image", function(j2wp_Image $image, Job $job){

	$contactPersonFirstName = strtolower($job->getRawField("aa_ansprechpartner->nachname"));
	$contactPersonLastName = strtolower($job->getRawField("aa_ansprechpartner->vorname"));

		$query = new WP_Query([
		'post_type'      => 'attachment', 
		'post_status'    => 'inherit',
		'posts_per_page' => -1,          
	]);

	if ($query->have_posts()) {
		foreach ($query->posts as $media_post) {
			$title = strtolower($media_post->post_title);

			if (str_contains($title, $contactPersonFirstName) && str_contains($title, $contactPersonLastName)){

				$image->setURL(wp_get_attachment_url( $media_post->ID ));
				return $image;
			}
		}
	}

	wp_reset_postdata();

	return $image;
}, 10, 2);

Beispiel 2: Laden einer externen Ressource, welche im Coveto Freitextfeld_2 definiert ist, mit veränderter Bildgröße.

add_filter("j2wp_job_contact_person_image", function($image,$job) {
	$url = $job->getRawField("freitextfeld_2");
	$image->setURL($url);
	$image->setHeightInPixels(200);
	$image->setWidthInPixels(200);
	return $image;
},10,2);