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]);

client/components/open/forms/components/FormEditor.vue

@@ -106,6 +106,7 @@ import { captureException } from "@sentry/core"
 import FormSettings from './form-components/FormSettings.vue'
 import FormEditorErrorHandler from '~/components/open/forms/components/FormEditorErrorHandler.vue'
 import { setFormDefaults } from '~/composables/forms/initForm.js'
+import { breakpointsTailwind, useBreakpoints } from '@vueuse/core'
 
 export default {
   name: "FormEditor",
@@ -145,6 +146,16 @@ export default {
   emits: ['mounted', 'on-save', 'openRegister', 'go-back', 'save-form'],
 
   setup() {
+    // Check if the editor is visible on smaller screens then send an email
+    const breakpoints = useBreakpoints(breakpointsTailwind)
+    const isVisible = ref(breakpoints.smaller("md"))
+    watch(isVisible, (newValue) => {
+      if (newValue) {
+        opnFetch('/open/forms/' + form.value.id + '/mobile-editor-email')
+      }
+    })
+    
+
     const { user } = storeToRefs(useAuthStore())
     const formsStore = useFormsStore()
     const { content: form } = storeToRefs(useWorkingFormStore())