Create method for getting sets of ebooks

lib/Ebook.php

@@ -2280,9 +2280,9 @@ final class Ebook{
 	}
 
 	/**
-	 * Queries for books in a collection.
+	 * Get `Ebook`s in a collection.
 	 *
-	 * Puts ebooks without a `SequenceNumber` at the end of the list, which is more common in a collection with both published and placeholder ebooks.
+	 * Puts `Ebook`s without a `SequenceNumber` at the end of the list, which is more common in a collection with both published and placeholder ebooks.
 	 *
 	 * @return array<Ebook>
 	 */
@@ -2299,9 +2299,10 @@ final class Ebook{
 	}
 
 	/**
-	 * Queries for related to books to be shown, e.g., in a carousel.
+	 * Get related `Ebook`s, e.g., in a carousel.
+	 *
+	 * Does not include `EbookPlaceholder`s, because they're not useful for browsing.
 	 *
-	 * Filters out placeholder books because they are not useful for browsing.
 	 * @return array<Ebook>
 	 */
 	public static function GetAllByRelated(Ebook $ebook, int $count, ?EbookTag $relatedTag): array{
@@ -2331,6 +2332,17 @@ final class Ebook{
 		return $relatedEbooks;
 	}
 
+	/**
+	 * Get all `Ebook`s in a set of `EbookId`s.
+	 *
+	 * @param array<int> $ebookIds
+	 *
+	 * @return array<Ebook>
+	 */
+	public static function GetAllBySet(array $ebookIds): array{
+		return Db::Query('SELECT * from Ebooks where EbookId in ' . Db::CreateSetSql($ebookIds), $ebookIds, Ebook::class);
+	}
+
 	/**
 	* @param array<string> $tags
 	*

www/blog/a-kind-of-bolshevism-in-an-uncanny-bookshop.php

@@ -1,6 +1,5 @@
 <?
-$ebookIds = [2321, 1080, 185, 1090, 431];
-$carousel = Db::Query('SELECT * from Ebooks where EbookId in ' . Db::CreateSetSql($ebookIds), $ebookIds, Ebook::class);
+$carousel = Ebook::GetAllBySet([2321, 1080, 185, 1090, 431]);
 ?>
 <?= Template::Header(title: 'A Kind of Bolshevism in an Uncanny Bookshop', css: ['/css/blog.css']) ?>
 <main>

www/blog/death-and-beauty-in-the-alps.php

@@ -1,6 +1,5 @@
 <?
-$ebookIds = [1085, 1052];
-$carousel = Db::Query('SELECT * from Ebooks where EbookId in ' . Db::CreateSetSql($ebookIds), $ebookIds, Ebook::class);
+$carousel = Ebook::GetAllBySet([1085, 1052]);
 ?>
 <?= Template::Header(title: 'Death and Beauty in the Alps', css: ['/css/blog.css']) ?>
 <main>

www/blog/edith-whartons-vision-of-literary-art.php

@@ -1,6 +1,5 @@
 <?
-$ebookIds = [288, 485, 289, 908, 565, 2114];
-$carousel = Db::Query('SELECT * from Ebooks where EbookId in ' . Db::CreateSetSql($ebookIds), $ebookIds, Ebook::class);
+$carousel = Ebook::GetAllBySet([288, 485, 289, 908, 565, 2114]);
 ?>
 <?= Template::Header(title: 'Edith Wharton’s Vision of Literary Art', css: ['/css/blog.css']) ?>
 <main>

www/blog/joyces-ulysses-the-rubaiyat-and-yes.php

@@ -1,6 +1,5 @@
 <?
-$ebookIds = [565, 778, 561, 1059];
-$carousel = Db::Query('SELECT * from Ebooks where EbookId in ' . Db::CreateSetSql($ebookIds), $ebookIds, Ebook::class);
+$carousel = Ebook::GetAllBySet([565, 778, 561, 1059]);
 ?>
 <?= Template::Header(title: 'Joyce’s Ulysses, the Rubáiyát, and “Yes”', css: ['/css/blog.css']) ?>
 <main>

www/blog/of-human-bondage-spinoza-and-the-meaning-of-life.php

@@ -1,6 +1,5 @@
 <?
-$ebookIds = [981, 561, 833];
-$carousel = Db::Query('SELECT * from Ebooks where EbookId in ' . Db::CreateSetSql($ebookIds), $ebookIds, Ebook::class);
+$carousel = Ebook::GetAllBySet([981, 561, 833]);
 ?>
 <?= Template::Header(title: 'Of Human Bondage, Spinoza, and the Meaning of Life', css: ['/css/blog.css']) ?>
 <main>

www/blog/the-ugly-duckling-and-the-carmelite-in-middlemarch.php

@@ -1,6 +1,5 @@
 <?
-$ebookIds = [415, 607];
-$carousel = Db::Query('SELECT * from Ebooks where EbookId in ' . Db::CreateSetSql($ebookIds), $ebookIds, Ebook::class);
+$carousel = Ebook::GetAllBySet([415, 607]);
 ?>
 <?= Template::Header(title: 'The Ugly Duckling and the Carmelite in Middlemarch', css: ['/css/blog.css']) ?>
 <main>