3 namespace Tests\Entity;
5 use BookStack\Auth\Role;
6 use BookStack\Entities\Models\Book;
7 use BookStack\Entities\Models\Chapter;
8 use BookStack\Entities\Models\Page;
9 use BookStack\Entities\Tools\PdfGenerator;
10 use Illuminate\Support\Facades\Storage;
11 use Illuminate\Support\Str;
14 class ExportTest extends TestCase
16 public function test_page_text_export()
18 $page = Page::query()->first();
21 $resp = $this->get($page->getUrl('/export/plaintext'));
22 $resp->assertStatus(200);
23 $resp->assertSee($page->name);
24 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $page->slug . '.txt"');
27 public function test_page_pdf_export()
29 $page = Page::query()->first();
32 $resp = $this->get($page->getUrl('/export/pdf'));
33 $resp->assertStatus(200);
34 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $page->slug . '.pdf"');
37 public function test_page_html_export()
39 $page = Page::query()->first();
42 $resp = $this->get($page->getUrl('/export/html'));
43 $resp->assertStatus(200);
44 $resp->assertSee($page->name);
45 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $page->slug . '.html"');
48 public function test_book_text_export()
50 $page = Page::query()->first();
54 $resp = $this->get($book->getUrl('/export/plaintext'));
55 $resp->assertStatus(200);
56 $resp->assertSee($book->name);
57 $resp->assertSee($page->name);
58 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $book->slug . '.txt"');
61 public function test_book_pdf_export()
63 $page = Page::query()->first();
67 $resp = $this->get($book->getUrl('/export/pdf'));
68 $resp->assertStatus(200);
69 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $book->slug . '.pdf"');
72 public function test_book_html_export()
74 $page = Page::query()->first();
78 $resp = $this->get($book->getUrl('/export/html'));
79 $resp->assertStatus(200);
80 $resp->assertSee($book->name);
81 $resp->assertSee($page->name);
82 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $book->slug . '.html"');
85 public function test_book_html_export_shows_chapter_descriptions()
87 $chapterDesc = 'My custom test chapter description ' . Str::random(12);
88 $chapter = Chapter::query()->first();
89 $chapter->description = $chapterDesc;
92 $book = $chapter->book;
95 $resp = $this->get($book->getUrl('/export/html'));
96 $resp->assertSee($chapterDesc);
99 public function test_chapter_text_export()
101 $chapter = Chapter::query()->first();
102 $page = $chapter->pages[0];
105 $resp = $this->get($chapter->getUrl('/export/plaintext'));
106 $resp->assertStatus(200);
107 $resp->assertSee($chapter->name);
108 $resp->assertSee($page->name);
109 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $chapter->slug . '.txt"');
112 public function test_chapter_pdf_export()
114 $chapter = Chapter::query()->first();
117 $resp = $this->get($chapter->getUrl('/export/pdf'));
118 $resp->assertStatus(200);
119 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $chapter->slug . '.pdf"');
122 public function test_chapter_html_export()
124 $chapter = Chapter::query()->first();
125 $page = $chapter->pages[0];
128 $resp = $this->get($chapter->getUrl('/export/html'));
129 $resp->assertStatus(200);
130 $resp->assertSee($chapter->name);
131 $resp->assertSee($page->name);
132 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $chapter->slug . '.html"');
135 public function test_page_html_export_contains_custom_head_if_set()
137 $page = Page::query()->first();
139 $customHeadContent = '<style>p{color: red;}</style>';
140 $this->setSettings(['app-custom-head' => $customHeadContent]);
142 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
143 $resp->assertSee($customHeadContent, false);
146 public function test_page_html_export_does_not_break_with_only_comments_in_custom_head()
148 $page = Page::query()->first();
150 $customHeadContent = '<!-- A comment -->';
151 $this->setSettings(['app-custom-head' => $customHeadContent]);
153 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
154 $resp->assertStatus(200);
155 $resp->assertSee($customHeadContent, false);
158 public function test_page_html_export_use_absolute_dates()
160 $page = Page::query()->first();
162 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
163 $resp->assertSee($page->created_at->formatLocalized('%e %B %Y %H:%M:%S'));
164 $resp->assertDontSee($page->created_at->diffForHumans());
165 $resp->assertSee($page->updated_at->formatLocalized('%e %B %Y %H:%M:%S'));
166 $resp->assertDontSee($page->updated_at->diffForHumans());
169 public function test_page_export_does_not_include_user_or_revision_links()
171 $page = Page::query()->first();
173 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
174 $resp->assertDontSee($page->getUrl('/revisions'));
175 $resp->assertDontSee($page->createdBy->getProfileUrl());
176 $resp->assertSee($page->createdBy->name);
179 public function test_page_export_sets_right_data_type_for_svg_embeds()
181 $page = Page::query()->first();
182 Storage::disk('local')->makeDirectory('uploads/images/gallery');
183 Storage::disk('local')->put('uploads/images/gallery/svg_test.svg', '<svg></svg>');
184 $page->html = '<img src="http://localhost/uploads/images/gallery/svg_test.svg">';
188 $resp = $this->get($page->getUrl('/export/html'));
189 Storage::disk('local')->delete('uploads/images/gallery/svg_test.svg');
191 $resp->assertStatus(200);
192 $resp->assertSee('<img src="data:image/svg+xml;base64', false);
195 public function test_page_image_containment_works_on_multiple_images_within_a_single_line()
197 $page = Page::query()->first();
198 Storage::disk('local')->makeDirectory('uploads/images/gallery');
199 Storage::disk('local')->put('uploads/images/gallery/svg_test.svg', '<svg></svg>');
200 Storage::disk('local')->put('uploads/images/gallery/svg_test2.svg', '<svg></svg>');
201 $page->html = '<img src="http://localhost/uploads/images/gallery/svg_test.svg" class="a"><img src="http://localhost/uploads/images/gallery/svg_test2.svg" class="b">';
204 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
205 Storage::disk('local')->delete('uploads/images/gallery/svg_test.svg');
206 Storage::disk('local')->delete('uploads/images/gallery/svg_test2.svg');
208 $resp->assertDontSee('http://localhost/uploads/images/gallery/svg_test');
211 public function test_page_export_contained_html_image_fetches_only_run_when_url_points_to_image_upload_folder()
213 $page = Page::query()->first();
214 $page->html = '<img src="http://localhost/uploads/images/gallery/svg_test.svg"/>'
215 . '<img src="http://localhost/uploads/svg_test.svg"/>'
216 . '<img src="/uploads/svg_test.svg"/>';
217 $storageDisk = Storage::disk('local');
218 $storageDisk->makeDirectory('uploads/images/gallery');
219 $storageDisk->put('uploads/images/gallery/svg_test.svg', '<svg>good</svg>');
220 $storageDisk->put('uploads/svg_test.svg', '<svg>bad</svg>');
223 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
225 $storageDisk->delete('uploads/images/gallery/svg_test.svg');
226 $storageDisk->delete('uploads/svg_test.svg');
228 $resp->assertDontSee('http://localhost/uploads/images/gallery/svg_test.svg', false);
229 $resp->assertSee('http://localhost/uploads/svg_test.svg');
230 $resp->assertSee('src="/uploads/svg_test.svg"', false);
233 public function test_page_export_contained_html_does_not_allow_upward_traversal_with_local()
235 $contents = file_get_contents(public_path('.htaccess'));
236 config()->set('filesystems.images', 'local');
238 $page = Page::query()->first();
239 $page->html = '<img src="http://localhost/uploads/images/../../.htaccess"/>';
242 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
243 $resp->assertDontSee(base64_encode($contents));
246 public function test_page_export_contained_html_does_not_allow_upward_traversal_with_local_secure()
248 $testFilePath = storage_path('logs/test.txt');
249 config()->set('filesystems.images', 'local_secure');
250 file_put_contents($testFilePath, 'I am a cat');
252 $page = Page::query()->first();
253 $page->html = '<img src="http://localhost/uploads/images/../../logs/test.txt"/>';
256 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
257 $resp->assertDontSee(base64_encode('I am a cat'));
258 unlink($testFilePath);
261 public function test_exports_removes_scripts_from_custom_head()
264 Page::query()->first(), Chapter::query()->first(), Book::query()->first(),
266 setting()->put('app-custom-head', '<script>window.donkey = "cat";</script><style>.my-test-class { color: red; }</style>');
268 foreach ($entities as $entity) {
269 $resp = $this->asEditor()->get($entity->getUrl('/export/html'));
270 $resp->assertDontSee('window.donkey');
271 $resp->assertDontSee('<script', false);
272 $resp->assertSee('.my-test-class { color: red; }');
276 public function test_page_export_with_deleted_creator_and_updater()
278 $user = $this->getViewer(['name' => 'ExportWizardTheFifth']);
279 $page = Page::query()->first();
280 $page->created_by = $user->id;
281 $page->updated_by = $user->id;
284 $resp = $this->asEditor()->get($page->getUrl('/export/html'));
285 $resp->assertSee('ExportWizardTheFifth');
288 $resp = $this->get($page->getUrl('/export/html'));
289 $resp->assertStatus(200);
290 $resp->assertDontSee('ExportWizardTheFifth');
293 public function test_page_pdf_export_converts_iframes_to_links()
295 $page = Page::query()->first()->forceFill([
296 'html' => '<iframe width="560" height="315" src="//www.youtube.com/embed/ShqUjt33uOs"></iframe>',
301 $mockPdfGenerator = $this->mock(PdfGenerator::class);
302 $mockPdfGenerator->shouldReceive('fromHtml')
303 ->with(\Mockery::capture($pdfHtml))
305 $mockPdfGenerator->shouldReceive('getActiveEngine')->andReturn(PdfGenerator::ENGINE_DOMPDF);
307 $this->asEditor()->get($page->getUrl('/export/pdf'));
308 $this->assertStringNotContainsString('iframe>', $pdfHtml);
309 $this->assertStringContainsString('<p><a href="https://www.youtube.com/embed/ShqUjt33uOs">https://www.youtube.com/embed/ShqUjt33uOs</a></p>', $pdfHtml);
312 public function test_page_pdf_export_opens_details_blocks()
314 $page = Page::query()->first()->forceFill([
315 'html' => '<details><summary>Hello</summary><p>Content!</p></details>',
320 $mockPdfGenerator = $this->mock(PdfGenerator::class);
321 $mockPdfGenerator->shouldReceive('fromHtml')
322 ->with(\Mockery::capture($pdfHtml))
324 $mockPdfGenerator->shouldReceive('getActiveEngine')->andReturn(PdfGenerator::ENGINE_DOMPDF);
326 $this->asEditor()->get($page->getUrl('/export/pdf'));
327 $this->assertStringContainsString('<details open="open"', $pdfHtml);
330 public function test_page_markdown_export()
332 $page = Page::query()->first();
334 $resp = $this->asEditor()->get($page->getUrl('/export/markdown'));
335 $resp->assertStatus(200);
336 $resp->assertSee($page->name);
337 $resp->assertHeader('Content-Disposition', 'attachment; filename="' . $page->slug . '.md"');
340 public function test_page_markdown_export_uses_existing_markdown_if_apparent()
342 $page = Page::query()->first()->forceFill([
343 'markdown' => '# A header',
344 'html' => '<h1>Dogcat</h1>',
348 $resp = $this->asEditor()->get($page->getUrl('/export/markdown'));
349 $resp->assertSee('A header');
350 $resp->assertDontSee('Dogcat');
353 public function test_page_markdown_export_converts_html_where_no_markdown()
355 $page = Page::query()->first()->forceFill([
357 'html' => '<h1>Dogcat</h1><p>Some <strong>bold</strong> text</p>',
361 $resp = $this->asEditor()->get($page->getUrl('/export/markdown'));
362 $resp->assertSee("# Dogcat\n\nSome **bold** text");
365 public function test_chapter_markdown_export()
367 $chapter = Chapter::query()->first();
368 $page = $chapter->pages()->first();
369 $resp = $this->asEditor()->get($chapter->getUrl('/export/markdown'));
371 $resp->assertSee('# ' . $chapter->name);
372 $resp->assertSee('# ' . $page->name);
375 public function test_book_markdown_export()
377 $book = Book::query()->whereHas('pages')->whereHas('chapters')->first();
378 $chapter = $book->chapters()->first();
379 $page = $chapter->pages()->first();
380 $resp = $this->asEditor()->get($book->getUrl('/export/markdown'));
382 $resp->assertSee('# ' . $book->name);
383 $resp->assertSee('# ' . $chapter->name);
384 $resp->assertSee('# ' . $page->name);
387 public function test_book_markdown_export_concats_immediate_pages_with_newlines()
389 /** @var Book $book */
390 $book = Book::query()->whereHas('pages')->first();
392 $this->asEditor()->get($book->getUrl('/create-page'));
393 $this->get($book->getUrl('/create-page'));
395 [$pageA, $pageB] = $book->pages()->where('chapter_id', '=', 0)->get();
396 $pageA->html = '<p>hello tester</p>';
398 $pageB->name = 'The second page in this test';
401 $resp = $this->get($book->getUrl('/export/markdown'));
402 $resp->assertDontSee('hello tester# The second page in this test');
403 $resp->assertSee("hello tester\n\n# The second page in this test");
406 public function test_export_option_only_visible_and_accessible_with_permission()
408 $book = Book::query()->whereHas('pages')->whereHas('chapters')->first();
409 $chapter = $book->chapters()->first();
410 $page = $chapter->pages()->first();
411 $entities = [$book, $chapter, $page];
412 $user = $this->getViewer();
413 $this->actingAs($user);
415 foreach ($entities as $entity) {
416 $resp = $this->get($entity->getUrl());
417 $resp->assertSee('/export/pdf');
420 /** @var Role $role */
421 $this->removePermissionFromUser($user, 'content-export');
423 foreach ($entities as $entity) {
424 $resp = $this->get($entity->getUrl());
425 $resp->assertDontSee('/export/pdf');
426 $resp = $this->get($entity->getUrl('/export/pdf'));
427 $this->assertPermissionError($resp);
431 public function test_wkhtmltopdf_only_used_when_allow_untrusted_is_true()
433 /** @var Page $page */
434 $page = Page::query()->first();
436 config()->set('snappy.pdf.binary', '/abc123');
437 config()->set('app.allow_untrusted_server_fetching', false);
439 $resp = $this->asEditor()->get($page->getUrl('/export/pdf'));
440 $resp->assertStatus(200); // Sucessful response with invalid snappy binary indicates dompdf usage.
442 config()->set('app.allow_untrusted_server_fetching', true);
443 $resp = $this->get($page->getUrl('/export/pdf'));
444 $resp->assertStatus(500); // Bad response indicates wkhtml usage
447 public function test_html_exports_contain_csp_meta_tag()
450 Page::query()->first(),
451 Book::query()->first(),
452 Chapter::query()->first(),
455 foreach ($entities as $entity) {
456 $resp = $this->asEditor()->get($entity->getUrl('/export/html'));
457 $resp->assertElementExists('head meta[http-equiv="Content-Security-Policy"][content*="script-src "]');