ENH: Respect sort and limit arguments (#158)

These parameters are defined in the PHPDocs for `Report` and are technically part of the method signature. They should be respected and in the case of the new default limit in silverstripe/silverstripe-reports#139 this could have performance ramifications for large datasets.

src/Reports/PagesDueForReviewReport.php

@@ -148,16 +148,26 @@ class PagesDueForReviewReport extends Report
 
     /**
      * @param array $params
+     * @param array|string|null $sort
+     * @param int|null $limit
      *
      * @return SS_List
      */
-    public function sourceRecords($params = [])
+    public function sourceRecords($params = [], $sort = null, $limit = null)
     {
         Versioned::set_stage(Versioned::DRAFT);
 
         $records = SiteTree::get();
         $compatibility = ContentReviewCompatability::start();
 
+        // Apply sort and limit if appropriate.
+        if ($sort !== null) {
+            $records = $records->sort($sort);
+        }
+        if ($limit !== null) {
+            $records = $records->limit($limit);
+        }
+
         if (empty($params['ReviewDateBefore']) && empty($params['ReviewDateAfter'])) {
             // If there's no review dates set, default to all pages due for review now
             $records = $records->where(

src/Reports/PagesWithoutReviewScheduleReport.php

@@ -104,10 +104,12 @@ class PagesWithoutReviewScheduleReport extends Report
 
     /**
      * @param array $params
+     * @param array|string|null $sort
+     * @param int|null $limit
      *
      * @return SS_List
      */
-    public function sourceRecords($params = [])
+    public function sourceRecords($params = [], $sort = null, $limit = null)
     {
         Versioned::set_stage(Versioned::DRAFT);
 
@@ -125,16 +127,18 @@ class PagesWithoutReviewScheduleReport extends Report
             ));
         }
 
-        $records->sort("ParentID");
+        // Apply sort and limit if appropriate.
-        $records = $records->toArray();
+        if ($sort !== null) {
+            $records = $records->sort($sort);
+        }
+        if ($limit !== null) {
+            $records = $records->limit($limit);
+        }
 
         // Trim out calculated values
-        $list = ArrayList::create();
+        $list = $records->filterByCallback(function ($record) {
-        foreach ($records as $record) {
+            return !$this->hasReviewSchedule($record);
-            if (!$this->hasReviewSchedule($record)) {
+        });
-                $list->push($record);
-            }
-        }
 
         ContentReviewCompatability::done($compatibility);
 

tests/php/ContentReviewReportTest.php

@@ -87,11 +87,11 @@ class ContentReviewReportTest extends FunctionalTest
 
         $results = $report->sourceRecords();
 
-        $this->assertEquals([
+        $this->assertListEquals([
-            "Home",
+            ['Title' => 'Home'],
-            "About Us",
+            ['Title' => 'About Us'],
-            "Page without review date",
+            ['Title' => 'Page without review date'],
-            "Page owned by group",
+            ['Title' => 'Page owned by group'],
-        ], $results->column("Title"));
+        ], $results);
     }
 }