16.2. Cronjob entfernen

Im Beispiel konnte ich zeigen, wie ein Cronjob angelegt wird. Natürlich muss dieser auch wieder entfernt werden, wenn er nicht mehr benötigt wird. In der Regel passiert das beim Deaktivieren eines Plugins. Dafür benötigen wir dann folgende Funktion:

<?php
function wp_clear_scheduled_hook( $hook, $args = array() ) {
	...
}
?>

Es gilt:

  • hook (string)
    Der Hook-Name der beim Hinzufügen eines Cron-Hooks gewählt wurde.
  • args (array)
    Die zusätzlichen Argumente, die beim Hinzufügen eines Crons verwendet wurden.

Zurückgegeben wird folgendes:

  • Ein int-Wert, der die Anzahl der entfernten Cronjobs. Wobei der Wert 0 impliziert, dass der Cronjob, der entfernt werden soll, gar nicht erst registriert wurde.
  • false wird zurückgegeben, wenn das Entfernen eines oder mehrerer Cronjobs fehlschlug.

Hinweis: In WordPress Versionen kleiner 5.1 hat die Funktion keinen Rückgabewert.

Beispiel:

You’re not allowed to see this content. Please log in first.