BookStack RSS Feed Loglcal Theme System

_readme.md

This is a hack to add a simple latest-page RSS feed to the BookStack using the logical theme system.

Setup

This uses the logical theme system.

1. Within the BookStack install folder, you should have a themes folder.
2. Create a themes/custom/functions.php file with the contents of the functions.php file example below.
3. Add APP_THEME=custom to your .env file.
4. Save the contents of the rss.blade.php file below to a themes/custom/rss.blade.php file.

Note

These customizations are not officially supported any may break upon, or conflict with, future updates. Quickly tested on BookStack v22.11.1.

functions.php

<?php

use BookStack\Entities\Models\Page;
use Illuminate\Support\Facades\Route;

Route::get('/rss/pages/new', function() {
    $pages = Page::query()
        ->visible()
        ->orderBy('created_at', 'desc')
        ->take(25)
        ->get();

    return response()->view('rss', ['pages' => $pages], 200, ['Content-Type' => 'text/xml']);
});

rss.blade.php

<?xml version="1.0"?>
<rss version="2.0">
   <channel>
      <title>Latest BookStack Pages</title>
      <link>{{ url('/') }}</link>
      <description>Latest pages in our BookStack instance</description>
      <lastBuildDate>{{ date(DATE_RSS) }}</lastBuildDate>
      @foreach($pages as $page)
        <item>
            <title>{{ $page->name }}</title>
            <link>{{ $page->getUrl() }}</link>
            <description>{{ $page->getExcerpt() }}</description>
            <pubDate>{{ $page->created_at->format(DATE_RSS) }}</pubDate>
            <guid>page#{{ $page->id }}</guid>
        </item>
      @endforeach
   </channel>
</rss>