From bdeebc8291a424b8c0debf9f68c2fbc0fc13ba0c Mon Sep 17 00:00:00 2001
From: Alex Cabal <alex@alexcabal.com>
Date: Wed, 15 Jan 2025 14:32:50 -0600
Subject: [PATCH] Add endpoint to get collections for an ebook or placeholder

---
 config/apache/rewrites/ebooks.conf |  3 +++
 www/ebook-placeholders/get.php     |  1 -
 www/ebooks/collections.php         | 29 +++++++++++++++++++++++++++++
 3 files changed, 32 insertions(+), 1 deletion(-)
 create mode 100644 www/ebooks/collections.php

diff --git a/config/apache/rewrites/ebooks.conf b/config/apache/rewrites/ebooks.conf
index fc620da6..c16720bb 100644
--- a/config/apache/rewrites/ebooks.conf
+++ b/config/apache/rewrites/ebooks.conf
@@ -10,6 +10,9 @@ RewriteRule	^/images/covers/(.+?)\-[a-z0-9]{8}\-(cover|hero)(@2x)?\.(jpg|avif)$
 # Rewrite ebook downloads.
 RewriteRule	^/ebooks/(.+?)/download$		/ebooks/download.php?url-path=$1 [QSA]
 
+# Rewrite ebook collections.
+RewriteRule	^/ebooks/(.+?)/collections$		/ebooks/collections.php?url-path=$1 [QSA]
+
 # Misc ebook rewrites.
 RewriteRule	^/subjects/([^\./]+?)$			/ebooks/index.php?tags[]=$1 [B,QSA]
 RewriteRule	^/ebooks/([^\./]+?)$			/authors/get.php?url-path=$1 [B,QSA]
diff --git a/www/ebook-placeholders/get.php b/www/ebook-placeholders/get.php
index bc75665a..d87d5f7e 100644
--- a/www/ebook-placeholders/get.php
+++ b/www/ebook-placeholders/get.php
@@ -1,5 +1,4 @@
 <?
-use function Safe\preg_replace;
 use function Safe\session_unset;
 
 session_start();
diff --git a/www/ebooks/collections.php b/www/ebooks/collections.php
new file mode 100644
index 00000000..fd1c15e4
--- /dev/null
+++ b/www/ebooks/collections.php
@@ -0,0 +1,29 @@
+<?
+$identifier = EBOOKS_IDENTIFIER_PREFIX .  trim(str_replace('.', '', HttpInput::Str(GET, 'url-path') ?? ''), '/'); // Contains the portion of the URL (without query string) that comes after `https://standardebooks.org/ebooks/`.
+
+$ebook = null;
+
+try{
+	$ebook = Ebook::GetByIdentifier($identifier);
+}
+catch(Exceptions\EbookNotFoundException){
+	Template::ExitWithCode(Enums\HttpCode::NotFound);
+}
+
+header('content-type: application/xml; charset=utf-8');
+print('<?xml version="1.0" encoding="utf-8"?>');
+print("\n");
+?>
+<collections>
+	<? foreach($ebook->CollectionMemberships as $collectionMembership){ ?>
+		<collection>
+			<meta id="collection-<?= $collectionMembership->SortOrder + 1 ?>" property="belongs-to-collection"><?= Formatter::EscapeXml($collectionMembership->Collection->Name) ?></meta>
+			<? if($collectionMembership->Collection->Type !== null){ ?>
+				<meta property="collection-type" refines="#collection-<?= $collectionMembership->SortOrder + 1 ?>"><?= $collectionMembership->Collection->Type->value ?></meta>
+			<? } ?>
+			<? if($collectionMembership->SequenceNumber !== null){ ?>
+				<meta property="group-position" refines="#collection-<?= $collectionMembership->SortOrder + 1 ?>"><?= $collectionMembership->SequenceNumber ?></meta>
+			<? } ?>
+		</collection>
+	<? } ?>
+</collections>