libra/docs/tasks/17-1.md

id, title, status, date, parent

id	title	status	date	parent
17-1	17-1 Registration mailable and email template	Done	2026-09-27	17

Description

Create a Mailable and Arabic markdown email template that, when sent, delivers a workshop registration submission to info@libra.adv.ps. This is a prerequisite for task 17-2, which will call it from the form's submit handler.

File to create: app/Mail/WorkshopRegistrationMail.php

<?php

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Content;
use Illuminate\Mail\Mailables\Envelope;
use Illuminate\Queue\SerializesModels;

class WorkshopRegistrationMail extends Mailable implements ShouldQueue
{
    use Queueable, SerializesModels;

    /**
     * Create a new message instance.
     */
    public function __construct(
        public string $fullName,
        public string $contactNumber,
        public ?string $email,
    ) {}

    /**
     * Get the message envelope.
     */
    public function envelope(): Envelope
    {
        return new Envelope(
            subject: 'تسجيل جديد - ورشة عمل ريادايات نابلس',
        );
    }

    /**
     * Get the message content definition.
     */
    public function content(): Content
    {
        return new Content(
            markdown: 'emails.workshop-registration.ar',
            with: [
                'fullName' => $this->fullName,
                'contactNumber' => $this->contactNumber,
                'email' => $this->email,
            ],
        );
    }

    /**
     * Get the attachments for the message.
     *
     * @return array<int, \Illuminate\Mail\Mailables\Attachment>
     */
    public function attachments(): array
    {
        return [];
    }
}

This class deliberately does not extend App\Mail\BaseMailable — BaseMailable::getFromName() switches on the app locale/from-name for the law firm's own bilingual mail, which doesn't apply here; this mailable always sends in Arabic with a fixed subject, following the same ShouldQueue + Queueable/SerializesModels pattern as App\Mail\GuestBookingSubmittedMail (app/Mail/GuestBookingSubmittedMail.php) instead.

File to create: resources/views/emails/workshop-registration/ar.blade.php

<x-mail::message>
<div dir="rtl" style="text-align: right;">
# تسجيل جديد في ورشة عمل رياديات نابلس

تم استلام تسجيل جديد بالبيانات التالية:

- **الاسم الكامل:** {{ $fullName }}
- **رقم التواصل:** {{ $contactNumber }}
@if($email)
- **البريد الإلكتروني:** {{ $email }}
@endif

مع أطيب التحيات،<br>
{{ config('app.name') }}
</div>
</x-mail::message>

This follows the same <x-mail::message> + dir="rtl" wrapper pattern as resources/views/emails/booking/guest-submitted/ar.blade.php.

No route or controller wiring belongs to this task — task 17-2 imports App\Mail\WorkshopRegistrationMail, constructs it with the submitted field values, and sends it with Mail::to('info@libra.adv.ps')->send(...).

Acceptance Criteria

• App\Mail\WorkshopRegistrationMail exists, extends Illuminate\Mail\Mailable, implements Illuminate\Contracts\Queue\ShouldQueue, and its constructor accepts fullName (string), contactNumber (string), and email (nullable string)
• resources/views/emails/workshop-registration/ar.blade.php exists, renders $fullName and $contactNumber unconditionally, and renders $email only when it is not null/empty
• Sending new WorkshopRegistrationMail('Test Name', '0599123456', null) via Mail::fake() in a test produces an email with subject تسجيل جديد - ورشة عمل ريادايات نابلس and body containing "Test Name" and "0599123456", with no email line rendered
• Sending the same mailable with a non-null email value produces a body that additionally contains that email address

Sub-tasks

None.