Send mobile editor email (#634)

Co-authored-by: Julien Nahum <julien@nahum.net>

api/app/Http/Controllers/Forms/FormController.php

@@ -9,6 +9,7 @@ use App\Http\Requests\UploadAssetRequest;
 use App\Http\Resources\FormResource;
 use App\Models\Forms\Form;
 use App\Models\Workspace;
+use App\Notifications\Forms\MobileEditorEmail;
 use App\Service\Forms\FormCleaner;
 use App\Service\Storage\StorageFileNameParser;
 use Illuminate\Support\Facades\Auth;
@@ -271,4 +272,16 @@ class FormController extends Controller
             'message' => 'Form workspace updated successfully.',
         ]);
     }
+
+    public function mobileEditorEmail($id)
+    {
+        $form = Form::findOrFail($id);
+        $this->authorize('update', $form);
+
+        $form->creator->notify(new MobileEditorEmail($form->slug));
+
+        return $this->success([
+            'message' => 'Email sent.',
+        ]);
+    }
 }

api/app/Notifications/Forms/MobileEditorEmail.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Notifications\Forms;
+
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Notifications\Messages\MailMessage;
+use Illuminate\Notifications\Notification;
+
+class MobileEditorEmail extends Notification implements ShouldQueue
+{
+    use Queueable;
+
+    protected $slug;
+
+    /**
+     * Create a new notification instance.
+     *
+     * @param string $slug
+     * @return void
+     */
+    public function __construct($slug)
+    {
+        $this->slug = $slug;
+    }
+
+    /**
+     * Get the notification's delivery channels.
+     *
+     * @param mixed $notifiable
+     * @return array
+     */
+    public function via($notifiable)
+    {
+        return ['mail'];
+    }
+
+    /**
+     * Get the mail representation of the notification.
+     *
+     * @param  mixed  $notifiable
+     * @return \Illuminate\Notifications\Messages\MailMessage
+     */
+    public function toMail($notifiable)
+    {
+        return (new MailMessage())
+            ->subject('Continue editing your form on desktop')
+            ->line('We noticed you\'re editing a form on smaller screen.')
+            ->line('For the best form building experience, we recommend using a desktop computer.')
+            ->line('Ready to create something amazing? Click below to continue editing. 💻')
+            ->action(__('Continue Editing'), front_url('forms/' . $this->slug . '/edit'));
+    }
+}

api/routes/api.php

@@ -157,6 +157,7 @@ Route::group(['middleware' => 'auth:api'], function () {
             Route::post('/{id}/workspace/{workspace_id}', [FormController::class, 'updateWorkspace'])->name('workspace.update');
             Route::put('/{id}', [FormController::class, 'update'])->name('update');
             Route::delete('/{id}', [FormController::class, 'destroy'])->name('destroy');
+            Route::get('/{id}/mobile-editor-email', [FormController::class, 'mobileEditorEmail'])->name('mobile-editor-email');
 
             Route::get('/{id}/submissions', [FormSubmissionController::class, 'submissions'])->name('submissions');
             Route::put('/{id}/submissions/{submission_id}', [FormSubmissionController::class, 'update'])->name('submissions.update')->middleware([ResolveFormMiddleware::class]);