# Theme System
# Anzeige der Revisionen in einem PDF Export
getestet mit Version **24.02**
## Anforderung
Um die Revisionen und ggfs. den Changelog in einem PDF Export ganz zum Schluss anzeigen lassen zu können sind einige Anpassungen nötig.
Zuerst habe ich dafür einen zusätzlichen Link in das Export-Menü eingebaut um einmal eine Version ohne Revisionen und eine mit Revisionen exportieren zu können.
## betroffene Dateien
Dateien müssen sich in der entsprechenden Struktur unterhalb des Themes befinden.
Ordner = *kursiv*
Dateien = **fett**
- *entities*
- **export-menu.blade.php**
- *exports*
- *parts*
- **revisions-index-row-compact.blade.php**
- **page.blade.php**
## Inhalte der Dateien
revisions-index-row-compact.blade.php
Ich habe in dem Ordner eine weitere Datei angelegt und mit folgendem Inhalt gefüllt:
```html
| {{ $revision->created_at->isoFormat('D MMMM Y') }} |
{{ $revision->revision_number == 0 ? '' : $revision->revision_number }} |
@if($revision->createdBy) {{ $revision->createdBy->name }} @else {{ trans('common.deleted_user') }} @endif |
{{ $revision->summary }} |
```
page.blade.php
In dieser Datei habe ich an das Ende der Seite folgenden Code eingefügt und die alte Meta Ansicht deaktiviert. Der geänderte Code beginnt in **Zeile 7** (in diesem Codeschnipsel).
```html
[...]
{!! $page->renderedHTML ?? $page->html !!}
@if(request()->query('history'))
Dokumentenhistorie
| Datum |
Version |
Autor |
Anmerkungen |
@if(count($page->revisions) > 0)
@foreach($page->revisions as $index => $revision)
@include('exports.parts.revisions-index-row-compact', ['revision' => $revision, 'current' => $page->revision_count === $revision->revision_number])
@endforeach
@else
{{ trans('entities.pages_revisions_none') }}
@endif
@endif
@endsection
```
Der Codeabschnitt kann auch an jeder anderen Stelle hinterlegt werden, für mich hat es aber am Ende des Dokuments den meisten Sinn gemacht.
getestet mit Version **24.02**
## Anforderung
Wenn man Bookstack als PWA nutzt ist es nur umständlich möglich, die URL zu kopieren wenn man diese jemandem schicken möchte.
## betroffene Dateien
Dateien müssen sich in der entsprechenden Struktur unterhalb des Themes befinden.
Ordner = *kursiv*
Dateien = **fett**
- *entities*
- **share-link.blade.php**
- *shelves*
- **show.blade.php**
- *books*
- **show.blade.php**
- *chapters*
- **show.blade.php**
- *page*
- **show.blade.php**
## Inhalte der Dateien
show.blade.php (gleich für jede Datei)
Hier wurde die Zeile 10 hinzugefügt (Zeilennummer nur für diesen Ausschnitt)
```html
@if($watchOptions->canWatch() && !$watchOptions->isWatching())
@include('entities.watch-action', ['entity' => $page])
@endif
@if(user()->hasAppAccess())
@include('entities.favourite-action', ['entity' => $page])
@endif
@if(userCan('content-export'))
@include('entities.export-menu', ['entity' => $page])
@endif
@include('entities.share-link', ['entity' => $page])
@stop
```
getestet mit Version **24.02**
## Anforderung
Für diverse Zertifizierungsdokument wird ein "Dokumentenheader" benötigt. Da ich die Informationen in Tags versteckt habe lasse ich diese einfach als Tabelle bei einem PDF Export darstellen.
## betroffene Dateien
Dateien müssen sich in der entsprechenden Struktur unterhalb des Themes befinden.
Ordner = *kursiv*
Dateien = **fett**
- *exports*
- *parts*
- **tag-export-table.blade.php**
- **page.blade.php**
## Inhalte der Dateien
page.blade.php
An der gewünschten Stelle muss folgender Code eingefügt werden:
```php
@if($page->tags->count() > 0)
Dokumenteninformationen
@foreach($page->tags as $tag)
@include('exports.parts.tag-export-table', ['tag' => $tag])
@endforeach
@endif
```
getestet mit Version **24.02**
## Anforderung
Ich wollte gerne die Möglichkeit haben, exportierte Daten einfach wieder in der digitalen Welt zu finden. Was ist dazu besser geeignet als ein **QR-Code**.
## betroffene Dateien
Dateien müssen sich in der entsprechenden Struktur unterhalb des Themes befinden.
Ordner = *kursiv*
Dateien = **fett**
- *layouts*
- *parts*
- **export-body-start.blade.php**
- *entities*
- **export-menu.blade.php**
## Inhalte der Dateien
export-body-start.blade.php
Vor dem ersten `div`-Container muss hier folgendes eingetragen werden:
```
@inject('totp', 'BookStack\Access\Mfa\TotpService')
@php
$qrCode = $totp->generateQrCodeSvg($page->getUrl());
$imgStr = 'data:image/svg+xml;base64,' . base64_encode($qrCode);
@endphp
```
Im Anschluss kann an einer beliebigen Stelle das Bild an die PDF übergeben werden.
Dazu muss folgender Abschnitt hinzugefügt werden:
```php
@if(request()->query('qr'))
@endif
```
export-menu.blade.php
Hier muss nun einfach nach der Zeile gesucht werden mit dem Inhalt `/export/pdf`.
Danach die Zeile kopieren und den String ?qr=true anhängen an die selbe Stelle.
Es sollte dann wie folgt aussehen:
```html
```
In diesem Ausschnitt ist in Zeile 4 der neue Export Link hinzugefügt.
getestet mit Version **25.07**
## Anforderung
Die Standard-PDF Seite ist nicht wirklich ansprechend, also werden hier Header und Footer sowie Seitenzahlen eingefügt.
## betroffene Dateien
Dateien müssen sich in der entsprechenden Struktur unterhalb des Themes befinden.
Ordner = *kursiv*
Dateien = **fett**
- *layouts*
- *parts*
- **export-body-start.blade.php**
## Inhalte der Dateien
export-body-start.blade.php
Die Datei muss am Ende wie folgt aussehen:
```html
@if ($format === 'pdf')
@endif
```
getestet mit Version 24.12
## Anforderung
Zum Abbilden der Funktion eines schwarzen Bretts bzw. einer News-Seite um aktuelle Infos anzuzeigen.
## betroffene Dateien
Dateien müssen sich in der entsprechenden Struktur unterhalb des Themes befinden.
Ordner = *kursiv*
Dateien = **fett**
- *home*
- **specific-page.blade.php**
## Inhalte der Dateien
)) }})