2022-08-17 12:37:27 -04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Tests\References;
|
|
|
|
|
2023-05-17 12:56:55 -04:00
|
|
|
use BookStack\App\Model;
|
2022-08-17 12:37:27 -04:00
|
|
|
use BookStack\Entities\Repos\PageRepo;
|
|
|
|
use BookStack\Entities\Tools\TrashCan;
|
|
|
|
use BookStack\References\Reference;
|
|
|
|
use Tests\TestCase;
|
|
|
|
|
|
|
|
class ReferencesTest extends TestCase
|
|
|
|
{
|
|
|
|
public function test_references_created_on_page_update()
|
|
|
|
{
|
2022-09-29 17:11:16 -04:00
|
|
|
$pageA = $this->entities->page();
|
|
|
|
$pageB = $this->entities->page();
|
2022-08-17 12:37:27 -04:00
|
|
|
|
|
|
|
$this->assertDatabaseMissing('references', ['from_id' => $pageA->id, 'from_type' => $pageA->getMorphClass()]);
|
|
|
|
|
|
|
|
$this->asEditor()->put($pageA->getUrl(), [
|
|
|
|
'name' => 'Reference test',
|
2022-08-29 12:46:41 -04:00
|
|
|
'html' => '<a href="' . $pageB->getUrl() . '">Testing</a>',
|
2022-08-17 12:37:27 -04:00
|
|
|
]);
|
|
|
|
|
|
|
|
$this->assertDatabaseHas('references', [
|
2022-08-29 12:46:41 -04:00
|
|
|
'from_id' => $pageA->id,
|
2022-08-17 12:37:27 -04:00
|
|
|
'from_type' => $pageA->getMorphClass(),
|
2022-08-29 12:46:41 -04:00
|
|
|
'to_id' => $pageB->id,
|
|
|
|
'to_type' => $pageB->getMorphClass(),
|
2022-08-17 12:37:27 -04:00
|
|
|
]);
|
|
|
|
}
|
|
|
|
|
2023-12-19 07:55:51 -05:00
|
|
|
public function test_references_created_on_book_chapter_bookshelf_update()
|
|
|
|
{
|
|
|
|
$entities = [$this->entities->book(), $this->entities->chapter(), $this->entities->shelf()];
|
|
|
|
$shelf = $this->entities->shelf();
|
|
|
|
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$entity->refresh();
|
|
|
|
$this->assertDatabaseMissing('references', ['from_id' => $entity->id, 'from_type' => $entity->getMorphClass()]);
|
|
|
|
|
|
|
|
$this->asEditor()->put($entity->getUrl(), [
|
|
|
|
'name' => 'Reference test',
|
|
|
|
'description_html' => '<a href="' . $shelf->getUrl() . '">Testing</a>',
|
|
|
|
]);
|
|
|
|
|
|
|
|
$this->assertDatabaseHas('references', [
|
|
|
|
'from_id' => $entity->id,
|
|
|
|
'from_type' => $entity->getMorphClass(),
|
|
|
|
'to_id' => $shelf->id,
|
|
|
|
'to_type' => $shelf->getMorphClass(),
|
|
|
|
]);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public function test_references_deleted_on_page_delete()
|
2022-08-17 12:37:27 -04:00
|
|
|
{
|
2022-09-29 17:11:16 -04:00
|
|
|
$pageA = $this->entities->page();
|
|
|
|
$pageB = $this->entities->page();
|
2022-08-17 12:37:27 -04:00
|
|
|
|
|
|
|
$this->createReference($pageA, $pageB);
|
|
|
|
$this->createReference($pageB, $pageA);
|
|
|
|
|
|
|
|
$this->assertDatabaseHas('references', ['from_id' => $pageA->id, 'from_type' => $pageA->getMorphClass()]);
|
|
|
|
$this->assertDatabaseHas('references', ['to_id' => $pageA->id, 'to_type' => $pageA->getMorphClass()]);
|
|
|
|
|
|
|
|
app(PageRepo::class)->destroy($pageA);
|
|
|
|
app(TrashCan::class)->empty();
|
|
|
|
|
|
|
|
$this->assertDatabaseMissing('references', ['from_id' => $pageA->id, 'from_type' => $pageA->getMorphClass()]);
|
|
|
|
$this->assertDatabaseMissing('references', ['to_id' => $pageA->id, 'to_type' => $pageA->getMorphClass()]);
|
|
|
|
}
|
|
|
|
|
2023-12-19 07:55:51 -05:00
|
|
|
public function test_references_from_deleted_on_book_chapter_shelf_delete()
|
|
|
|
{
|
|
|
|
$entities = [$this->entities->chapter(), $this->entities->book(), $this->entities->shelf()];
|
|
|
|
$shelf = $this->entities->shelf();
|
|
|
|
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$this->createReference($entity, $shelf);
|
|
|
|
$this->assertDatabaseHas('references', ['from_id' => $entity->id, 'from_type' => $entity->getMorphClass()]);
|
|
|
|
|
|
|
|
$this->asEditor()->delete($entity->getUrl());
|
|
|
|
app(TrashCan::class)->empty();
|
|
|
|
|
|
|
|
$this->assertDatabaseMissing('references', [
|
|
|
|
'from_id' => $entity->id,
|
|
|
|
'from_type' => $entity->getMorphClass()
|
|
|
|
]);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-08-20 07:07:38 -04:00
|
|
|
public function test_references_to_count_visible_on_entity_show_view()
|
|
|
|
{
|
2022-09-29 11:49:25 -04:00
|
|
|
$entities = $this->entities->all();
|
2022-09-29 17:11:16 -04:00
|
|
|
$otherPage = $this->entities->page();
|
2022-08-20 07:07:38 -04:00
|
|
|
|
|
|
|
$this->asEditor();
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$this->createReference($entities['page'], $entity);
|
|
|
|
}
|
|
|
|
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$resp = $this->get($entity->getUrl());
|
2023-12-20 12:21:09 -05:00
|
|
|
$resp->assertSee('Referenced by 1 item');
|
|
|
|
$resp->assertDontSee('Referenced by 1 items');
|
2022-08-20 07:07:38 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
$this->createReference($otherPage, $entities['page']);
|
|
|
|
$resp = $this->get($entities['page']->getUrl());
|
2023-12-20 12:21:09 -05:00
|
|
|
$resp->assertSee('Referenced by 2 items');
|
2022-08-20 07:07:38 -04:00
|
|
|
}
|
|
|
|
|
2022-08-19 17:40:44 -04:00
|
|
|
public function test_references_to_visible_on_references_page()
|
|
|
|
{
|
2022-09-29 11:49:25 -04:00
|
|
|
$entities = $this->entities->all();
|
2022-08-19 17:40:44 -04:00
|
|
|
$this->asEditor();
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$this->createReference($entities['page'], $entity);
|
|
|
|
}
|
|
|
|
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$resp = $this->get($entity->getUrl('/references'));
|
|
|
|
$resp->assertSee('References');
|
|
|
|
$resp->assertSee($entities['page']->name);
|
|
|
|
$resp->assertDontSee('There are no tracked references');
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public function test_reference_not_visible_if_view_permission_does_not_permit()
|
|
|
|
{
|
2022-09-29 12:31:38 -04:00
|
|
|
$page = $this->entities->page();
|
2022-09-29 17:11:16 -04:00
|
|
|
$pageB = $this->entities->page();
|
2022-08-19 17:40:44 -04:00
|
|
|
$this->createReference($pageB, $page);
|
|
|
|
|
2023-01-21 06:08:34 -05:00
|
|
|
$this->permissions->setEntityPermissions($pageB);
|
2022-08-19 17:40:44 -04:00
|
|
|
|
|
|
|
$this->asEditor()->get($page->getUrl('/references'))->assertDontSee($pageB->name);
|
|
|
|
$this->asAdmin()->get($page->getUrl('/references'))->assertSee($pageB->name);
|
|
|
|
}
|
|
|
|
|
|
|
|
public function test_reference_page_shows_empty_state_with_no_references()
|
|
|
|
{
|
2022-09-29 12:31:38 -04:00
|
|
|
$page = $this->entities->page();
|
2022-08-19 17:40:44 -04:00
|
|
|
|
|
|
|
$this->asEditor()
|
|
|
|
->get($page->getUrl('/references'))
|
|
|
|
->assertSee('There are no tracked references');
|
|
|
|
}
|
|
|
|
|
2022-08-21 13:05:19 -04:00
|
|
|
public function test_pages_leading_to_entity_updated_on_url_change()
|
|
|
|
{
|
2022-09-29 17:11:16 -04:00
|
|
|
$pageA = $this->entities->page();
|
|
|
|
$pageB = $this->entities->page();
|
2022-09-29 12:31:38 -04:00
|
|
|
$book = $this->entities->book();
|
2022-08-21 13:05:19 -04:00
|
|
|
|
|
|
|
foreach ([$pageA, $pageB] as $page) {
|
|
|
|
$page->html = '<a href="' . $book->getUrl() . '">Link</a>';
|
|
|
|
$page->save();
|
|
|
|
$this->createReference($page, $book);
|
|
|
|
}
|
|
|
|
|
|
|
|
$this->asEditor()->put($book->getUrl(), [
|
|
|
|
'name' => 'my updated book slugaroo',
|
|
|
|
]);
|
|
|
|
|
|
|
|
foreach ([$pageA, $pageB] as $page) {
|
|
|
|
$page->refresh();
|
|
|
|
$this->assertStringContainsString('href="http://localhost/books/my-updated-book-slugaroo"', $page->html);
|
|
|
|
$this->assertDatabaseHas('page_revisions', [
|
|
|
|
'page_id' => $page->id,
|
2022-08-29 12:46:41 -04:00
|
|
|
'summary' => 'System auto-update of internal links',
|
2022-08-21 13:05:19 -04:00
|
|
|
]);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-08-30 17:00:32 -04:00
|
|
|
public function test_pages_linking_to_other_page_updated_on_parent_book_url_change()
|
|
|
|
{
|
2022-09-29 17:11:16 -04:00
|
|
|
$bookPage = $this->entities->page();
|
|
|
|
$otherPage = $this->entities->page();
|
2022-08-30 17:00:32 -04:00
|
|
|
$book = $bookPage->book;
|
|
|
|
|
|
|
|
$otherPage->html = '<a href="' . $bookPage->getUrl() . '">Link</a>';
|
|
|
|
$otherPage->save();
|
|
|
|
$this->createReference($otherPage, $bookPage);
|
|
|
|
|
|
|
|
$this->asEditor()->put($book->getUrl(), [
|
|
|
|
'name' => 'my updated book slugaroo',
|
|
|
|
]);
|
|
|
|
|
|
|
|
$otherPage->refresh();
|
|
|
|
$this->assertStringContainsString('href="http://localhost/books/my-updated-book-slugaroo/page/' . $bookPage->slug . '"', $otherPage->html);
|
|
|
|
$this->assertDatabaseHas('page_revisions', [
|
|
|
|
'page_id' => $otherPage->id,
|
|
|
|
'summary' => 'System auto-update of internal links',
|
|
|
|
]);
|
|
|
|
}
|
|
|
|
|
|
|
|
public function test_pages_linking_to_chapter_updated_on_parent_book_url_change()
|
|
|
|
{
|
2022-09-29 17:11:16 -04:00
|
|
|
$bookChapter = $this->entities->chapter();
|
|
|
|
$otherPage = $this->entities->page();
|
2022-08-30 17:00:32 -04:00
|
|
|
$book = $bookChapter->book;
|
|
|
|
|
|
|
|
$otherPage->html = '<a href="' . $bookChapter->getUrl() . '">Link</a>';
|
|
|
|
$otherPage->save();
|
|
|
|
$this->createReference($otherPage, $bookChapter);
|
|
|
|
|
|
|
|
$this->asEditor()->put($book->getUrl(), [
|
|
|
|
'name' => 'my updated book slugaroo',
|
|
|
|
]);
|
|
|
|
|
|
|
|
$otherPage->refresh();
|
|
|
|
$this->assertStringContainsString('href="http://localhost/books/my-updated-book-slugaroo/chapter/' . $bookChapter->slug . '"', $otherPage->html);
|
|
|
|
$this->assertDatabaseHas('page_revisions', [
|
|
|
|
'page_id' => $otherPage->id,
|
|
|
|
'summary' => 'System auto-update of internal links',
|
|
|
|
]);
|
|
|
|
}
|
|
|
|
|
2022-08-21 13:05:19 -04:00
|
|
|
public function test_markdown_links_leading_to_entity_updated_on_url_change()
|
|
|
|
{
|
2022-09-29 12:31:38 -04:00
|
|
|
$page = $this->entities->page();
|
|
|
|
$book = $this->entities->book();
|
2022-08-21 13:05:19 -04:00
|
|
|
|
|
|
|
$bookUrl = $book->getUrl();
|
|
|
|
$markdown = '
|
|
|
|
[An awesome link](' . $bookUrl . ')
|
|
|
|
[An awesome link with query & hash](' . $bookUrl . '?test=yes#cats)
|
|
|
|
[An awesome link with path](' . $bookUrl . '/an/extra/trail)
|
|
|
|
[An awesome link with title](' . $bookUrl . ' "title")
|
|
|
|
[ref]: ' . $bookUrl . '?test=yes#dogs
|
|
|
|
[ref_without_space]:' . $bookUrl . '
|
|
|
|
[ref_with_title]: ' . $bookUrl . ' "title"';
|
|
|
|
$page->markdown = $markdown;
|
|
|
|
$page->save();
|
|
|
|
$this->createReference($page, $book);
|
|
|
|
|
|
|
|
$this->asEditor()->put($book->getUrl(), [
|
|
|
|
'name' => 'my updated book slugadoo',
|
|
|
|
]);
|
|
|
|
|
|
|
|
$page->refresh();
|
|
|
|
$expected = str_replace($bookUrl, 'http://localhost/books/my-updated-book-slugadoo', $markdown);
|
|
|
|
$this->assertEquals($expected, $page->markdown);
|
|
|
|
}
|
|
|
|
|
2023-12-19 07:55:51 -05:00
|
|
|
public function test_description_links_from_book_chapter_shelf_updated_on_url_change()
|
|
|
|
{
|
|
|
|
$entities = [$this->entities->chapter(), $this->entities->book(), $this->entities->shelf()];
|
|
|
|
$shelf = $this->entities->shelf();
|
|
|
|
$this->asEditor();
|
|
|
|
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$this->put($entity->getUrl(), [
|
|
|
|
'name' => 'Reference test',
|
|
|
|
'description_html' => '<a href="' . $shelf->getUrl() . '">Testing</a>',
|
|
|
|
]);
|
|
|
|
}
|
|
|
|
|
|
|
|
$oldUrl = $shelf->getUrl();
|
|
|
|
$this->put($shelf->getUrl(), ['name' => 'My updated shelf link']);
|
|
|
|
$shelf->refresh();
|
|
|
|
$this->assertNotEquals($oldUrl, $shelf->getUrl());
|
|
|
|
|
|
|
|
foreach ($entities as $entity) {
|
|
|
|
$oldHtml = $entity->description_html;
|
|
|
|
$entity->refresh();
|
|
|
|
$this->assertNotEquals($oldHtml, $entity->description_html);
|
|
|
|
$this->assertStringContainsString($shelf->getUrl(), $entity->description_html);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-08-17 12:37:27 -04:00
|
|
|
protected function createReference(Model $from, Model $to)
|
|
|
|
{
|
|
|
|
(new Reference())->forceFill([
|
|
|
|
'from_type' => $from->getMorphClass(),
|
2022-08-29 12:46:41 -04:00
|
|
|
'from_id' => $from->id,
|
|
|
|
'to_type' => $to->getMorphClass(),
|
|
|
|
'to_id' => $to->id,
|
2022-08-17 12:37:27 -04:00
|
|
|
])->save();
|
|
|
|
}
|
2022-08-29 12:46:41 -04:00
|
|
|
}
|