WP Cron Job Setup
### 1. Create a Function for the Script
Place the script inside a WordPress function to execute the desired logic.
### 2. Hook the Function to WP-Cron
Schedule the function to run hourly using WP-Cron.
### Implementation
Here's how you can achieve it:
1. **Add the following code to your WordPress theme's `functions.php` file** (or create a custom plugin for better organization).
// Add hourly job to WP-Cron
function register_personio_cron_job() {
if (!wp_next_scheduled('personio_fetch_jobs')) {
wp_schedule_event(time(), 'hourly', 'personio_fetch_jobs');
}
}
add_action('wp', 'register_personio_cron_job');
// Define the cron job function
function personio_fetch_jobs() {
$hostname = 'personio';
$lang = get_locale() === 'de_DE' ? 'de' : 'en'; // Assuming English and German locales
$positions = simplexml_load_file('https://' . $hostname . '.jobs.personio.de/xml?language=' . $lang);
$categories = [];
foreach ($positions->position as $position) {
$category = (string)$position->recruitingCategory;
if ($category && !in_array($category, $categories)) {
$categories[] = $category;
}
}
$translations = [
"full-time" => [
"de" => "Vollzeit",
"en" => "Full-time"
],
"part-time" => [
"de" => "Teilzeit",
"en" => "Part-time"
],
"permanent" => [
"de" => "Festanstellung",
"en" => "Permanent Employment"
],
"intern" => [
"de" => "Praktikum",
"en" => "Internship"
],
"trainee" => [
"de" => "Trainee Stelle",
"en" => "Trainee Stelle"
],
"freelance" => [
"de" => "Freelance Position",
"en" => "Freelance Position"
],
];
// Process job postings
foreach ($positions as $position) {
$detailLink = 'https://' . $hostname . '.jobs.personio.de/job/' . $position->id;
$channel = htmlspecialchars($_GET['channel'] ?? '');
if ($channel) {
$detailLink .= '?_pc=' . $channel;
}
// For demonstration purposes, jobs are logged to a file. Replace this with desired logic.
error_log('<a href="' . $detailLink . '" target="_blank" alt="Job Details">' .
'<h2>' . $position->name . '</h2>' .
'<p>' . $translations[(string)$position->employmentType][$lang] . ', ' . $translations[(string)$position->schedule][$lang] . '</p>' .
'</a>');
}
}
// Cleanup on deactivation
function cleanup_personio_cron_job() {
$timestamp = wp_next_scheduled('personio_fetch_jobs');
if ($timestamp) {
wp_unschedule_event($timestamp, 'personio_fetch_jobs');
}
}
register_deactivation_hook(__FILE__, 'cleanup_personio_cron_job');### Explanation
1. **Register the Cron Event**:
– The `register_personio_cron_job` function checks if the event `personio_fetch_jobs` is already scheduled. If not, it schedules it to run hourly.
2. **Define the Job Logic**:
– The `personio_fetch_jobs` function contains the main logic, similar to your script. It fetches job data from the Personio API and processes it.
3. **Cleanup**:
– The `cleanup_personio_cron_job` function ensures that the cron event is unscheduled when the code/plugin is deactivated.
4. **Logging (Optional)**:
– Currently, job postings are logged to the `error_log` for demonstration. You can replace this with saving the jobs to a database, sending emails, or another desired action.
### 3. Verify WP-Cron
To ensure WP-Cron is functioning correctly:
– Use a plugin like **WP Crontrol** to view and manage scheduled events.
– Confirm that the `personio_fetch_jobs` event is listed.
### 4. Debugging
If the cron job doesn’t seem to execute:
– Make sure WordPress cron is enabled (`DISABLE_WP_CRON` is not set to `true` in `wp-config.php`).
– Use a tool like WP-CLI to trigger cron jobs manually:
wp cron event run personio_fetch_jobs### Updated Code for WPML Integration
// Add hourly job to WP-Cron
function register_personio_cron_job() {
if (!wp_next_scheduled('personio_fetch_jobs')) {
wp_schedule_event(time(), 'hourly', 'personio_fetch_jobs');
}
}
add_action('wp', 'register_personio_cron_job');
// Define the cron job function
function personio_fetch_jobs() {
$hostname = 'personio';
// Get the current language using WPML
$lang = apply_filters('wpml_current_language', null);
if (!$lang) {
$lang = 'en'; // Default to English if no language is detected
}
$positions = simplexml_load_file('https://' . $hostname . '.jobs.personio.de/xml?language=' . $lang);
$categories = [];
foreach ($positions->position as $position) {
$category = (string)$position->recruitingCategory;
if ($category && !in_array($category, $categories)) {
$categories[] = $category;
}
}
$translations = [
"full-time" => [
"de" => "Vollzeit",
"en" => "Full-time"
],
"part-time" => [
"de" => "Teilzeit",
"en" => "Part-time"
],
"permanent" => [
"de" => "Festanstellung",
"en" => "Permanent Employment"
],
"intern" => [
"de" => "Praktikum",
"en" => "Internship"
],
"trainee" => [
"de" => "Trainee Stelle",
"en" => "Trainee Stelle"
],
"freelance" => [
"de" => "Freelance Position",
"en" => "Freelance Position"
],
];
// Process job postings
foreach ($positions as $position) {
$detailLink = 'https://' . $hostname . '.jobs.personio.de/job/' . $position->id;
$channel = htmlspecialchars($_GET['channel'] ?? '');
if ($channel) {
$detailLink .= '?_pc=' . $channel;
}
// For demonstration purposes, jobs are logged to a file. Replace this with desired logic.
error_log('<a href="' . $detailLink . '" target="_blank" alt="Job Details">' .
'<h2>' . $position->name . '</h2>' .
'<p>' . $translations[(string)$position->employmentType][$lang] . ', ' . $translations[(string)$position->schedule][$lang] . '</p>' .
'</a>');
}
}
// Cleanup on deactivation
function cleanup_personio_cron_job() {
$timestamp = wp_next_scheduled('personio_fetch_jobs');
if ($timestamp) {
wp_unschedule_event($timestamp, 'personio_fetch_jobs');
}
}
register_deactivation_hook(__FILE__, 'cleanup_personio_cron_job');### Key Changes for WPML
1. **Use `apply_filters('wpml_current_language', null)`**:
– This retrieves the current language set by WPML. If no language is detected, it defaults to English (`en`).
2. **Handle Translations Based on Language**:
– The `$translations` array remains the same, but the script dynamically selects translations based on the detected language.
### Notes
– Make sure WPML is correctly configured for all your site's languages.
– If you need to fetch job postings for all available languages, you can loop through the array of active languages provided by WPML:
$languages = apply_filters('wpml_active_languages', null, 'orderby=id&order=desc');
foreach ($languages as $lang_code => $language) {
// Fetch job postings for each language
}This approach ensures the cron job adapts to your multilingual setup.
### Step 1: Register the Custom Post Type `job`
Add the following code to your `functions.php` file to register the custom post type:
// Register the 'job' custom post type
function register_job_post_type() {
register_post_type('job', [
'labels' => [
'name' => __('Jobs', 'textdomain'),
'singular_name' => __('Job', 'textdomain'),
],
'public' => true,
'has_archive' => true,
'rewrite' => ['slug' => 'jobs'],
'supports' => ['title', 'editor', 'custom-fields'],
]);
}
add_action('init', 'register_job_post_type');### Step 2: Update the Cron Job to Save as `job`
Modify the `personio_fetch_jobs` function to save each job posting as a custom post of type `job`:
function personio_fetch_jobs() {
$hostname = 'personio';
// Get the current language using WPML
$lang = apply_filters('wpml_current_language', null);
if (!$lang) {
$lang = 'en'; // Default to English if no language is detected
}
$positions = simplexml_load_file('https://' . $hostname . '.jobs.personio.de/xml?language=' . $lang);
$translations = [
"full-time" => [
"de" => "Vollzeit",
"en" => "Full-time"
],
"part-time" => [
"de" => "Teilzeit",
"en" => "Part-time"
],
"permanent" => [
"de" => "Festanstellung",
"en" => "Permanent Employment"
],
"intern" => [
"de" => "Praktikum",
"en" => "Internship"
],
"trainee" => [
"de" => "Trainee Stelle",
"en" => "Trainee Stelle"
],
"freelance" => [
"de" => "Freelance Position",
"en" => "Freelance Position"
],
];
// Process job postings and save as custom post type
foreach ($positions as $position) {
$title = (string) $position->name;
$employmentType = $translations[(string)$position->employmentType][$lang] ?? '';
$schedule = $translations[(string)$position->schedule][$lang] ?? '';
$detailLink = 'https://' . $hostname . '.jobs.personio.de/job/' . $position->id;
// Check if the job already exists
$existing_post = get_posts([
'post_type' => 'job',
'meta_key' => 'personio_id',
'meta_value' => (string)$position->id,
'numberposts' => 1,
]);
if (!$existing_post) {
// Create a new job post
$post_id = wp_insert_post([
'post_title' => $title,
'post_content' => '<a href="' . esc_url($detailLink) . '" target="_blank">' .
esc_html($employmentType) . ', ' . esc_html($schedule) . '</a>',
'post_status' => 'publish',
'post_type' => 'job',
]);
// Save custom metadata
if ($post_id) {
update_post_meta($post_id, 'personio_id', (string) $position->id);
update_post_meta($post_id, 'employment_type', $employmentType);
update_post_meta($post_id, 'schedule', $schedule);
update_post_meta($post_id, 'detail_link', $detailLink);
}
}
}
}### Explanation
1. **Custom Post Type**:
– Registered a `job` post type with basic fields like `title`, `editor`, and `custom-fields`.
2. **Job Insertion Logic**:
– The function checks if the job already exists by searching for a post with the `personio_id` meta key.
– If the job doesn’t exist, it creates a new post with the job title and a link to the job details.
3. **Meta Fields**:
– Additional information like `employment_type`, `schedule`, and `detail_link` is saved as post metadata.
### Step 3: View Jobs in WordPress Admin
Once the script runs, jobs will appear in the WordPress admin under a new "Jobs" section.
### Step 4: Debugging and Testing
1. **Trigger the Cron Job**:
– Use WP-CLI to trigger the cron job manually:
wp cron event run personio_fetch_jobs2. **Check WP-Cron**:
– Use the WP Crontrol plugin to manage and debug scheduled tasks.
This setup ensures that job postings are saved as a custom post type, making them easy to manage and display on the frontend.
—
### **Option 1: Using WP-CLI**
If you have access to WP-CLI (WordPress Command Line Interface), you can trigger the cron job manually:
1. **Run the Cron Event**:
wp cron event run personio_fetch_jobs2. **List All Scheduled Events**:
If you're unsure about the event name, you can list all scheduled events:
wp cron event listLook for the `personio_fetch_jobs` event in the list and confirm it's scheduled.
3. **Force Schedule the Cron Event**:
If the event isn’t scheduled, you can force it to run:
wp cron event schedule personio_fetch_jobs—
### **Option 2: Using WP Crontrol Plugin**
If you don’t have access to WP-CLI, you can use a plugin like **WP Crontrol**:
1. **Install WP Crontrol**:
– Go to your WordPress admin.
– Navigate to **Plugins > Add New**.
– Search for "WP Crontrol" and install it.
2. **Run the Event**:
– Go to **Tools > Cron Events** in your WordPress admin.
– Find the `personio_fetch_jobs` event in the list.
– Click the **Run Now** link next to it.
—
### **Option 3: PHP Script**
If you want to trigger the cron job via a script, you can use the following code:
1. Create a file named `run-cron.php` in the root of your WordPress installation:
<?php
require_once 'wp-load.php';
// Trigger the cron job
do_action('personio_fetch_jobs');
echo 'Cron job executed successfully.';2. Access this script in your browser:
“`
http://yourwebsite.com/run-cron.php