From 75b3778dccccddb5cc90b2b4e0a3f958826ad8ba Mon Sep 17 00:00:00 2001
From: winter
Date: Wed, 15 Jan 2025 20:33:38 +0000
Subject: implement home timeline

---
 Digitigrade/Timeline/Timeline.php | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 Digitigrade/Timeline/Timeline.php

(limited to 'Digitigrade/Timeline/Timeline.php')

diff --git a/Digitigrade/Timeline/Timeline.php b/Digitigrade/Timeline/Timeline.php
new file mode 100644
index 0000000..b3def28
--- /dev/null
+++ b/Digitigrade/Timeline/Timeline.php
@@ -0,0 +1,24 @@
+<?php
+namespace Digitigrade\Timeline;
+
+abstract class Timeline {
+    // TODO: currently making this number up. probably should be modifiable somewhere
+    private const RESULTS_PER_PAGE = 50;
+
+    /**
+     * Gets a pageful of items to be included in the timeline
+     * @param int $page page number to return (0-indexed)
+     * @return TimelineItem[]
+     */
+    public function getPage(int $page = 0): array {
+        return $this->getItems(self::RESULTS_PER_PAGE, self::RESULTS_PER_PAGE * $page);
+    }
+
+    /**
+     * Gets a selection of items to be included in the timeline
+     * @param int $limit max number of items to return
+     * @param int $offset number of items to skip at first
+     * @return TimelineItem[]
+     */
+    abstract protected function getItems(int $limit, int $offset): array;
+}
\ No newline at end of file
-- 
cgit v1.3