FEATURE: Add (optional) integration with the queuedjobs module

- Automatically creates a ContentReviewNotificationJob to run the next day if
the queuedjobs module exists

- Does nothing if the queuedjobs module does not exist, to ensure it is optional

- Update composer to suggest queuedjobs module, and updated docs to reflect both
ways of configuring the module

README.md

@@ -50,10 +50,12 @@ by running the dev/build via a CLI.
 
 	composer require silverstripe/contentreview dev-feature_improvements
 
-## Setup
+## Configuration
 
-If you wish to have emails sent when a page comes up for review, you
-new to have the DailyTask cron job set up. See ScheduledTask.php
+In order for the contentreview module to send emails, you need to *either*:
+
+ * Setup the DailyTask script to run daily via cron. See framework/tasks/ScheduledTask.php for more information on setup.
+ * Install the queuedjobs module, and follow the configuration steps to create a cron job for that module. Once installed, you can just run dev/build to have a job created, which will run at 9am every day by default.
 
 ## Usage
 

code/extensions/SiteTreeContentReview.php

@@ -511,4 +511,25 @@ class SiteTreeContentReview extends DataExtension implements PermissionProvider
 			)
 		);
 	}
+
+	/**
+	 * If the queuedjobs module is installed, queue up the first job for 9am tomorrow morning (by default)
+	 */
+	public function requireDefaultRecords() {
+		if(class_exists('ContentReviewNotificationJob')) {
+			// Ensure there is not already a job queued
+			if(QueuedJobDescriptor::get()->filter('Implementation', 'ContentReviewNotificationJob')->first()) return;
+
+			$nextRun = new ContentReviewNotificationJob();
+			$runHour = Config::inst()->get('ContentReviewNotificationJob', 'first_run_hour');
+			$firstRunTime = date('Y-m-d H:i:s', mktime($runHour, 0, 0, date("m"), date("d")+1, date("y")));
+
+			singleton('QueuedJobService')->queueJob(
+				$nextRun,
+				$firstRunTime
+			);
+
+			DB::alteration_message(sprintf('Added ContentReviewNotificationJob to run at %s', $firstRunTime));
+		}
+	}
 }

code/jobs/ContentReviewNotificationJob.php

@@ -0,0 +1,82 @@
+<?php
+
+if(!class_exists('AbstractQueuedJob')) {
+	return;
+}
+
+/**
+ * Class ContentReviewNotificationJob
+ *
+ * Allows the contentreview module to use the optional queuedjobs module to automatically process content review emails.
+ * If the module isn't installed, nothing is done - SilverStripe will never include this class declaration.
+ *
+ * If the module is installed, it will create a new job to be processed once every day by default.
+ *
+ * @see https://github.com/silverstripe-australia/silverstripe-queuedjobs
+ */
+class ContentReviewNotificationJob extends AbstractQueuedJob implements QueuedJob {
+	/**
+	 * @var int The hour that the first job will be created at (for the next day). All other jobs should be triggered
+	 * around this time too, as the next generation is queued when this job is run.
+	 * @config
+	 */
+	private static $first_run_hour = 9;
+
+	/**
+	 * @var int The hour at which to run these jobs
+	 * @config
+	 */
+	private static $next_run_hour = 9;
+
+	/**
+	 * @var int The minutes past the hour (see above) at which to run these jobs
+	 * @config
+	 */
+	private static $next_run_minute = 0;
+
+	/**
+	 * @var int The number of days to skip between job runs (e.g. 1 means run this job every day, 2 means run it every
+	 * second day etc.)
+	 * @config
+	 */
+	private static $next_run_in_days = 1;
+
+	public function getTitle() {
+		return 'Content Review Notification Job';
+	}
+
+	public function getJobType() {
+		$this->totalSteps = 1;
+		return QueuedJob::QUEUED;
+	}
+
+	public function process() {
+		$this->queueNextRun();
+
+		$task = new ContentReviewEmails();
+		$task->run(new SS_HTTPRequest('GET', '/dev/tasks/ContentReviewEmails'));
+
+		$this->currentStep = 1;
+		$this->isComplete = true;
+	}
+
+	/**
+	 * Queue up the next job to run.
+	 */
+	protected function queueNextRun() {
+		$nextRun = new ContentReviewNotificationJob();
+		$nextRunTime = mktime(
+			self::$next_run_hour,
+			self::$next_run_minute,
+			0,
+			date('m'),
+			date('d') + self::$next_run_in_days,
+			date('Y')
+		);
+
+		singleton('QueuedJobService')->queueJob(
+			$nextRun,
+			date('Y-m-d H:i:s', $nextRunTime)
+		);
+	}
+}

composer.json

@@ -19,5 +19,8 @@
 		"composer/installers": "*",
 		"silverstripe/framework": "~3.1",
 		"silverstripe/cms": "~3.1"
-	}
+	},
+    "suggests": {
+        "silverstripe/queuedjobs": "Automatically schedules content review emails to be sent, only requiring one crontask to be created"
+    }
 }