Updated existing image tests to reflect changes

- Also added some new tests

diff --git a/app/Entities/Repos/EntityRepo.php b/app/Entities/Repos/EntityRepo.php
index 88ca1bca6d2cce234a83b13456a7c403733e9327..1cff46da124a9074a1bd81bfb5f421a3c9a410f6 100644 (file)
--- a/app/Entities/Repos/EntityRepo.php
+++ b/app/Entities/Repos/EntityRepo.php
@@ -762,7 +762,7 @@ class EntityRepo
      */
     public function searchForImage($imageString)
     {
      */
     public function searchForImage($imageString)
     {

-        $pages = $this->entityQuery('page')->where('html', 'like', '%' . $imageString . '%')->get();
+        $pages = $this->entityQuery('page')->where('html', 'like', '%' . $imageString . '%')->get(['id', 'name', 'slug', 'book_id']);

         foreach ($pages as $page) {
             $page->url = $page->getUrl();
             $page->html = '';
         foreach ($pages as $page) {
             $page->url = $page->getUrl();
             $page->html = '';

diff --git a/app/Http/Controllers/Images/ImageController.php b/app/Http/Controllers/Images/ImageController.php
index a76fb5e538d17cac7bd8eacd733fc2b266c42dc0..024003f87d13c4a40611b7942ce83d3cbdcf9a43 100644 (file)
--- a/app/Http/Controllers/Images/ImageController.php
+++ b/app/Http/Controllers/Images/ImageController.php
@@ -103,7 +103,7 @@ class ImageController extends Controller
      */
     protected function checkImagePermission(Image $image)
     {
      */
     protected function checkImagePermission(Image $image)
     {

-        if ($image->type !== 'drawio' || $image->type !== 'gallery') {
+        if ($image->type !== 'drawio' && $image->type !== 'gallery') {

             $this->showPermissionError();
         }
 
             $this->showPermissionError();
         }
 

diff --git a/app/Http/Controllers/UserController.php b/app/Http/Controllers/UserController.php
index c7a7c5646cb5097dafbc04c46cf1ea390a91db82..1367f631bcc0772c35ad470a6f3aac887189ec72 100644 (file)
--- a/app/Http/Controllers/UserController.php
+++ b/app/Http/Controllers/UserController.php
@@ -98,7 +98,6 @@ class UserController extends Controller
             $this->userRepo->setUserRoles($user, $roles);
         }
 
             $this->userRepo->setUserRoles($user, $roles);
         }
 

-        // TODO - Check this uses new profile assignment

         $this->userRepo->downloadAndAssignUserAvatar($user);
 
         return redirect('/settings/users');
         $this->userRepo->downloadAndAssignUserAvatar($user);
 
         return redirect('/settings/users');

diff --git a/app/Uploads/ImageRepo.php b/app/Uploads/ImageRepo.php
index dbf652ddf2f9595a3fe82444d77109e34a04a65f..16d1bb3d1ff5c4d3cdbf14ffe24f9577f446b0ea 100644 (file)
--- a/app/Uploads/ImageRepo.php
+++ b/app/Uploads/ImageRepo.php
@@ -232,8 +232,8 @@ class ImageRepo
     protected function loadThumbs(Image $image)
     {
         $image->thumbs = [
     protected function loadThumbs(Image $image)
     {
         $image->thumbs = [

-            'gallery' => $this->getThumbnail($image, 150, 150),
-            'display' => $this->getThumbnail($image, 840, 0, true)
+            'gallery' => $this->getThumbnail($image, 150, 150, false),
+            'display' => $this->getThumbnail($image, 840, null, true)

         ];
     }
 
         ];
     }
 

diff --git a/app/Uploads/ImageService.php b/app/Uploads/ImageService.php
index 63c3b31722c3cb7746f48486fffe5b9615349a8e..eaf787c9c59786ca1720c8f2436f53e7aac78e92 100644 (file)
--- a/app/Uploads/ImageService.php
+++ b/app/Uploads/ImageService.php
@@ -235,7 +235,7 @@ class ImageService extends UploadService
      * @return string
      * @throws ImageUploadException
      */
      * @return string
      * @throws ImageUploadException
      */

-    protected function resizeImage(string $imageData, $width = 220, $height = null, $keepRatio = true)
+    protected function resizeImage(string $imageData, $width = 220, $height = null, bool $keepRatio = true)

     {
         try {
             $thumb = $this->imageTool->make($imageData);
     {
         try {
             $thumb = $this->imageTool->make($imageData);


@@ -336,6 +336,7 @@ class ImageService extends UploadService
         $image = $this->saveNewFromUrl($userAvatarUrl, 'user', $imageName);
         $image->created_by = $user->id;
         $image->updated_by = $user->id;
         $image = $this->saveNewFromUrl($userAvatarUrl, 'user', $imageName);
         $image->created_by = $user->id;
         $image->updated_by = $user->id;

+        $image->uploaded_to = $user->id;

         $image->save();
 
         return $image;
         $image->save();
 
         return $image;

diff --git a/tests/Uploads/ImageTest.php b/tests/Uploads/ImageTest.php
index c2e21f95c865a8e62df5b24cff77455982b5e640..01bf23d5b2b3ba2ab9a631d9ef151e101ff94ada 100644 (file)
--- a/tests/Uploads/ImageTest.php
+++ b/tests/Uploads/ImageTest.php
@@ -17,14 +17,10 @@ class ImageTest extends TestCase
         $admin = $this->getAdmin();
         $this->actingAs($admin);
 
         $admin = $this->getAdmin();
         $this->actingAs($admin);
 

-        $imageName = 'first-image.png';
-        $relPath = $this->getTestImagePath('gallery', $imageName);
-        $this->deleteImage($relPath);
-
-        $upload = $this->uploadImage($imageName, $page->id);
-        $upload->assertStatus(200);
+        $imgDetails = $this->uploadGalleryImage($page);
+        $relPath = $imgDetails['path'];

 
 

-        $this->assertTrue(file_exists(public_path($relPath)), 'Uploaded image not found at path: '. public_path($relPath));
+        $this->assertTrue(file_exists(public_path($relPath)), 'Uploaded image found at path: '. public_path($relPath));

 
         $this->deleteImage($relPath);
 
 
         $this->deleteImage($relPath);
 


@@ -35,8 +31,91 @@ class ImageTest extends TestCase
             'path' => $relPath,
             'created_by' => $admin->id,
             'updated_by' => $admin->id,
             'path' => $relPath,
             'created_by' => $admin->id,
             'updated_by' => $admin->id,

-            'name' => $imageName
+            'name' => $imgDetails['name'],
+        ]);
+    }
+
+    public function test_image_edit()
+    {
+        $editor = $this->getEditor();
+        $this->actingAs($editor);
+
+        $imgDetails = $this->uploadGalleryImage();
+        $image = Image::query()->first();
+
+        $newName = str_random();
+        $update = $this->put('/images/' . $image->id, ['name' => $newName]);
+        $update->assertSuccessful();
+        $update->assertJson([
+            'id' => $image->id,
+            'name' => $newName,
+            'type' => 'gallery',
+        ]);
+
+        $this->deleteImage($imgDetails['path']);
+
+        $this->assertDatabaseHas('images', [
+            'type' => 'gallery',
+            'name' => $newName
+        ]);
+    }
+
+    public function test_gallery_get_list_format()
+    {
+        $this->asEditor();
+
+        $imgDetails = $this->uploadGalleryImage();
+        $image = Image::query()->first();
+
+        $emptyJson = ['images' => [], 'has_more' => false];
+        $resultJson = [
+            'images' => [
+                [
+                    'id' => $image->id,
+                    'name' => $imgDetails['name'],
+                ]
+            ],
+            'has_more' => false,
+        ];
+
+        $pageId = $imgDetails['page']->id;
+        $firstPageRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}");
+        $firstPageRequest->assertSuccessful()->assertJson($resultJson);
+
+        $secondPageRequest = $this->get("/images/gallery?page=2&uploaded_to={$pageId}");
+        $secondPageRequest->assertSuccessful()->assertExactJson($emptyJson);
+
+        $namePartial = substr($imgDetails['name'], 0, 3);
+        $searchHitRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}&search={$namePartial}");
+        $searchHitRequest->assertSuccessful()->assertJson($resultJson);
+
+        $namePartial = str_random(16);
+        $searchHitRequest = $this->get("/images/gallery?page=1&uploaded_to={$pageId}&search={$namePartial}");
+        $searchHitRequest->assertSuccessful()->assertExactJson($emptyJson);
+    }
+
+    public function test_image_usage()
+    {
+        $page = Page::first();
+        $editor = $this->getEditor();
+        $this->actingAs($editor);
+
+        $imgDetails = $this->uploadGalleryImage($page);
+
+        $image = Image::query()->first();
+        $page->html = '<img src="'.$image->url.'">';
+        $page->save();
+
+        $usage = $this->get('/images/usage/' . $image->id);
+        $usage->assertSuccessful();
+        $usage->assertJson([
+            [
+                'id' => $page->id,
+                'name' => $page->name
+            ]

         ]);
         ]);

+
+        $this->deleteImage($imgDetails['path']);

     }
 
     public function test_php_files_cannot_be_uploaded()
     }
 
     public function test_php_files_cannot_be_uploaded()


@@ -50,7 +129,7 @@ class ImageTest extends TestCase
         $this->deleteImage($relPath);
 
         $file = $this->getTestImage($fileName);
         $this->deleteImage($relPath);
 
         $file = $this->getTestImage($fileName);

-        $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery/upload', ['uploaded_to' => $page->id], [], ['file' => $file], []);
+        $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);

         $upload->assertStatus(302);
 
         $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');
         $upload->assertStatus(302);
 
         $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');


@@ -72,7 +151,7 @@ class ImageTest extends TestCase
         $this->deleteImage($relPath);
 
         $file = $this->getTestImage($fileName);
         $this->deleteImage($relPath);
 
         $file = $this->getTestImage($fileName);

-        $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery/upload', ['uploaded_to' => $page->id], [], ['file' => $file], []);
+        $upload = $this->withHeader('Content-Type', 'image/jpeg')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);

         $upload->assertStatus(302);
 
         $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');
         $upload->assertStatus(302);
 
         $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded php file was uploaded but should have been stopped');


@@ -89,7 +168,7 @@ class ImageTest extends TestCase
         $this->deleteImage($relPath);
 
         $file = $this->getTestImage($fileName);
         $this->deleteImage($relPath);
 
         $file = $this->getTestImage($fileName);

-        $upload = $this->withHeader('Content-Type', 'image/png')->call('POST', '/images/gallery/upload', ['uploaded_to' => $page->id], [], ['file' => $file], []);
+        $upload = $this->withHeader('Content-Type', 'image/png')->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $file], []);

         $upload->assertStatus(302);
 
         $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded double extension file was uploaded but should have been stopped');
         $upload->assertStatus(302);
 
         $this->assertFalse(file_exists(public_path($relPath)), 'Uploaded double extension file was uploaded but should have been stopped');


@@ -101,9 +180,9 @@ class ImageTest extends TestCase
         $this->asEditor();
         $galleryFile = $this->getTestImage('my-secure-test-upload.png');
         $page = Page::first();
         $this->asEditor();
         $galleryFile = $this->getTestImage('my-secure-test-upload.png');
         $page = Page::first();

-        $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m-M') . '/my-secure-test-upload.png');
+        $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m') . '/my-secure-test-upload.png');

 
 

-        $upload = $this->call('POST', '/images/gallery/upload', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);
+        $upload = $this->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);

         $upload->assertStatus(200);
 
         $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);
         $upload->assertStatus(200);
 
         $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);


@@ -119,9 +198,9 @@ class ImageTest extends TestCase
         $this->asEditor();
         $galleryFile = $this->getTestImage('my-secure-test-upload.png');
         $page = Page::first();
         $this->asEditor();
         $galleryFile = $this->getTestImage('my-secure-test-upload.png');
         $page = Page::first();

-        $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m-M') . '/my-secure-test-upload.png');
+        $expectedPath = storage_path('uploads/images/gallery/' . Date('Y-m') . '/my-secure-test-upload.png');

 
 

-        $upload = $this->call('POST', '/images/gallery/upload', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);
+        $upload = $this->call('POST', '/images/gallery', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);

         $imageUrl = json_decode($upload->getContent(), true)['url'];
         $page->html .= "<img src=\"{$imageUrl}\">";
         $page->save();
         $imageUrl = json_decode($upload->getContent(), true)['url'];
         $page->html .= "<img src=\"{$imageUrl}\">";
         $page->save();


@@ -139,13 +218,12 @@ class ImageTest extends TestCase
     public function test_system_images_remain_public()
     {
         config()->set('filesystems.default', 'local_secure');
     public function test_system_images_remain_public()
     {
         config()->set('filesystems.default', 'local_secure');

-        $this->asEditor();
+        $this->asAdmin();

         $galleryFile = $this->getTestImage('my-system-test-upload.png');
         $galleryFile = $this->getTestImage('my-system-test-upload.png');

-        $page = Page::first();
-        $expectedPath = public_path('uploads/images/system/' . Date('Y-m-M') . '/my-system-test-upload.png');
+        $expectedPath = public_path('uploads/images/system/' . Date('Y-m') . '/my-system-test-upload.png');

 
 

-        $upload = $this->call('POST', '/images/system/upload', ['uploaded_to' => $page->id], [], ['file' => $galleryFile], []);
-        $upload->assertStatus(200);
+        $upload = $this->call('POST', '/settings', [], [], ['app_logo' => $galleryFile], []);
+        $upload->assertRedirect('/settings');

 
         $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);
 
 
         $this->assertTrue(file_exists($expectedPath), 'Uploaded image not found at path: '. $expectedPath);
 


@@ -183,8 +261,10 @@ class ImageTest extends TestCase
 
         $this->uploadImage($imageName, $page->id);
         $image = Image::first();
 
         $this->uploadImage($imageName, $page->id);
         $image = Image::first();

+        $image->type = 'drawio';
+        $image->save();

 
 

-        $imageGet = $this->getJson("/images/base64/{$image->id}");
+        $imageGet = $this->getJson("/images/drawio/base64/{$image->id}");

         $imageGet->assertJson([
             'content' => 'iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
         ]);
         $imageGet->assertJson([
             'content' => 'iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
         ]);


@@ -196,7 +276,7 @@ class ImageTest extends TestCase
         $editor = $this->getEditor();
         $this->actingAs($editor);
 
         $editor = $this->getEditor();
         $this->actingAs($editor);
 

-        $upload = $this->postJson('images/drawing/upload', [
+        $upload = $this->postJson('images/drawio', [

             'uploaded_to' => $page->id,
             'image' => 'image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
         ]);
             'uploaded_to' => $page->id,
             'image' => 'image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4gEcDCo5iYNs+gAAAB1pVFh0Q29tbWVudAAAAAAAQ3JlYXRlZCB3aXRoIEdJTVBkLmUHAAAAFElEQVQI12O0jN/KgASYGFABqXwAZtoBV6Sl3hIAAAAASUVORK5CYII='
         ]);


@@ -233,7 +313,7 @@ class ImageTest extends TestCase
         $this->actingAs($admin);
 
         $file = $this->getTestProfileImage();
         $this->actingAs($admin);
 
         $file = $this->getTestProfileImage();

-        $this->call('POST', '/images/user/upload', ['uploaded_to' => $editor->id], [], ['file' => $file], []);
+        $this->call('PUT', '/settings/users/' . $editor->id, [], [], ['profile_image' => $file], []);

 
         $this->assertDatabaseHas('images', [
             'type' => 'user',
 
         $this->assertDatabaseHas('images', [
             'type' => 'user',


@@ -242,78 +322,23 @@ class ImageTest extends TestCase
         ]);
     }
 
         ]);
     }
 

-    public function test_standard_user_with_manage_users_permission_can_view_other_profile_images()
-    {
-        $editor = $this->getEditor();
-        $this->giveUserPermissions($editor, ['users-manage']);
-
-        $admin = $this->getAdmin();
-
-        $this->actingAs($admin);
-        $file = $this->getTestProfileImage();
-        $this->call('POST', '/images/user/upload', ['uploaded_to' => $admin->id], [], ['file' => $file], []);
-
-        $expectedJson = [
-            'name' => 'profile.png',
-            'uploaded_to' => $admin->id,
-            'type' => 'user'
-        ];
-
-        $this->actingAs($editor);
-        $adminImagesGet = $this->get("/images/user/all/0?uploaded_to=" . $admin->id);
-        $adminImagesGet->assertStatus(200)->assertJsonFragment($expectedJson);
-
-        $allImagesGet = $this->get("/images/user/all/0");
-        $allImagesGet->assertStatus(200)->assertJsonFragment($expectedJson);
-    }
-
-    public function test_standard_user_cant_view_other_profile_images()
-    {
-        $editor = $this->getEditor();
-        $admin = $this->getAdmin();
-
-        $this->actingAs($admin);
-        $file = $this->getTestProfileImage();
-        $this->call('POST', '/images/user/upload', ['uploaded_to' => $admin->id], [], ['file' => $file], []);
-
-        $this->actingAs($editor);
-        $adminImagesGet = $this->get("/images/user/all/0?uploaded_to=" . $admin->id);
-        $adminImagesGet->assertStatus(302);
-
-        $allImagesGet = $this->get("/images/user/all/0");
-        $allImagesGet->assertStatus(302);
-    }
-
-    public function test_standard_user_cant_upload_other_profile_images()
-    {
-        $editor = $this->getEditor();
-        $admin = $this->getAdmin();
-
-        $this->actingAs($editor);
-        $file = $this->getTestProfileImage();
-        $upload = $this->call('POST', '/images/user/upload', ['uploaded_to' => $admin->id], [], ['file' => $file], []);
-        $upload->assertStatus(302);
-
-        $this->assertDatabaseMissing('images', [
-            'type' => 'user',
-            'uploaded_to' => $admin->id,
-        ]);
-    }
-

     public function test_user_images_deleted_on_user_deletion()
     {
         $editor = $this->getEditor();
         $this->actingAs($editor);
 
         $file = $this->getTestProfileImage();
     public function test_user_images_deleted_on_user_deletion()
     {
         $editor = $this->getEditor();
         $this->actingAs($editor);
 
         $file = $this->getTestProfileImage();

-        $this->call('POST', '/images/user/upload', ['uploaded_to' => $editor->id], [], ['file' => $file], []);
-        $this->call('POST', '/images/user/upload', ['uploaded_to' => $editor->id], [], ['file' => $file], []);
+        $this->call('PUT', '/settings/users/' . $editor->id, [], [], ['profile_image' => $file], []);

 
         $profileImages = Image::where('type', '=', 'user')->where('created_by', '=', $editor->id)->get();
 
         $profileImages = Image::where('type', '=', 'user')->where('created_by', '=', $editor->id)->get();

-        $this->assertTrue($profileImages->count() === 2, "Found profile images does not match upload count");
+        $this->assertTrue($profileImages->count() === 1, "Found profile images does not match upload count");
+
+        $imagePath = public_path($profileImages->first()->path);
+        $this->assertTrue(file_exists($imagePath));

 
         $userDelete = $this->asAdmin()->delete("/settings/users/{$editor->id}");
         $userDelete->assertStatus(302);
 
         $userDelete = $this->asAdmin()->delete("/settings/users/{$editor->id}");
         $userDelete->assertStatus(302);

+

         $this->assertDatabaseMissing('images', [
             'type' => 'user',
             'created_by' => $editor->id
         $this->assertDatabaseMissing('images', [
             'type' => 'user',
             'created_by' => $editor->id


@@ -322,6 +347,8 @@ class ImageTest extends TestCase
             'type' => 'user',
             'uploaded_to' => $editor->id
         ]);
             'type' => 'user',
             'uploaded_to' => $editor->id
         ]);

+
+        $this->assertFalse(file_exists($imagePath));

     }
 
     public function test_deleted_unused_images()
     }
 
     public function test_deleted_unused_images()

diff --git a/tests/Uploads/UsesImages.php b/tests/Uploads/UsesImages.php
index 93bf278e21a91e9f7db0f676afe05a541686439d..aa5ffe4c78250fb41f3a96c1319970a06eae3344 100644 (file)
--- a/tests/Uploads/UsesImages.php
+++ b/tests/Uploads/UsesImages.php
@@ -1,6 +1,7 @@
 <?php namespace Tests\Uploads;
 
 
 <?php namespace Tests\Uploads;
 
 

+use BookStack\Entities\Page;

 use Illuminate\Http\UploadedFile;
 
 trait UsesImages
 use Illuminate\Http\UploadedFile;
 
 trait UsesImages


@@ -41,7 +42,7 @@ trait UsesImages
      */
     protected function getTestImagePath($type, $fileName)
     {
      */
     protected function getTestImagePath($type, $fileName)
     {

-        return '/uploads/images/' . $type . '/' . Date('Y-m-M') . '/' . $fileName;
+        return '/uploads/images/' . $type . '/' . Date('Y-m') . '/' . $fileName;

     }
 
     /**
     }
 
     /**


@@ -55,7 +56,33 @@ trait UsesImages
     {
         $file = $this->getTestImage($name);
         return $this->withHeader('Content-Type', $contentType)
     {
         $file = $this->getTestImage($name);
         return $this->withHeader('Content-Type', $contentType)

-            ->call('POST', '/images/gallery/upload', ['uploaded_to' => $uploadedTo], [], ['file' => $file], []);
+            ->call('POST', '/images/gallery', ['uploaded_to' => $uploadedTo], [], ['file' => $file], []);
+    }
+
+    /**
+     * Upload a new gallery image.
+     * Returns the image name.
+     * Can provide a page to relate the image to.
+     * @param Page|null $page
+     * @return array
+     */
+    protected function uploadGalleryImage(Page $page = null)
+    {
+        if ($page === null) {
+            $page = Page::query()->first();
+        }
+
+        $imageName = 'first-image.png';
+        $relPath = $this->getTestImagePath('gallery', $imageName);
+        $this->deleteImage($relPath);
+
+        $upload = $this->uploadImage($imageName, $page->id);
+        $upload->assertStatus(200);
+        return [
+            'name' => $imageName,
+            'path' => $relPath,
+            'page' => $page
+        ];

     }
 
     /**
     }
 
     /**