*/ public function supportedTypes(): array { return [ GeneratedLetter::TYPE_RELIEVING, GeneratedLetter::TYPE_EXPERIENCE, GeneratedLetter::TYPE_WARNING, GeneratedLetter::TYPE_OFFER, ]; } /** * @return array */ /** * @param array $overrides Placeholder keys e.g. {{last_working_date}} * @return array */ public function variablesForEmployee(User $employee, ?Company $company = null, array $overrides = []): array { $company = $company ?? $employee->company; $variables = [ '{{employee_name}}' => (string) $employee->name, '{{employee_id}}' => (string) ($employee->employee_number ?: $employee->id), '{{designation}}' => (string) ($employee->designation?->name ?? '—'), '{{department}}' => (string) ($employee->department?->name ?? '—'), '{{joining_date}}' => $employee->joining_date?->format('d M Y') ?? '—', '{{last_working_date}}' => $employee->last_working_date?->format('d M Y') ?? '—', '{{company_name}}' => (string) ($company?->name ?? config('app.name')), '{{today_date}}' => now()->format('d M Y'), ]; foreach ($overrides as $key => $value) { $placeholder = str_starts_with((string) $key, '{{') ? (string) $key : '{{' . $key . '}}'; $variables[$placeholder] = (string) $value; } return $variables; } public function mergePlaceholders(string $html, array $variables): string { return str_replace(array_keys($variables), array_values($variables), $html); } public function defaultSubject(string $type, array $variables): string { $company = $variables['{{company_name}}'] ?? 'Company'; $employee = $variables['{{employee_name}}'] ?? 'Employee'; return match ($type) { GeneratedLetter::TYPE_RELIEVING => 'Relieving letter — ' . $employee, GeneratedLetter::TYPE_EXPERIENCE => 'Experience certificate — ' . $employee, GeneratedLetter::TYPE_WARNING => 'Warning letter — ' . $employee, GeneratedLetter::TYPE_OFFER => 'Offer letter — ' . $employee, default => 'Letter — ' . $employee, }; } public function defaultBody(string $type, array $variables): string { $name = $variables['{{employee_name}}'] ?? 'the employee'; $company = $variables['{{company_name}}'] ?? 'the company'; $designation = $variables['{{designation}}'] ?? 'their role'; $department = $variables['{{department}}'] ?? 'the organization'; $joining = $variables['{{joining_date}}'] ?? '—'; $lwd = $variables['{{last_working_date}}'] ?? '—'; $today = $variables['{{today_date}}'] ?? now()->format('d M Y'); return match ($type) { GeneratedLetter::TYPE_RELIEVING => "

To whom it may concern,

This is to certify that {$name} (Employee ID: {$variables['{{employee_id}}']}) was employed with {$company} as {$designation} in {$department}.

The last working day is recorded as {$lwd}. We wish {$name} success in future endeavours.

Issued on {$today}.

", GeneratedLetter::TYPE_EXPERIENCE => "

To whom it may concern,

This is to certify that {$name} worked with {$company} as {$designation} from {$joining} until {$lwd}.

During this period, {$name} performed duties assigned in {$department} to the best of our knowledge.

Issued on {$today}.

", GeneratedLetter::TYPE_WARNING => "

Dear {$name},

This letter serves as a formal warning regarding conduct/performance matters discussed with you. Please treat this as an opportunity to improve and align with company expectations.

Issued on {$today}.

", GeneratedLetter::TYPE_OFFER => "

Dear {$name},

We are pleased to offer you the position of {$designation} with {$company}, effective from the date mentioned in your appointment letter.

We look forward to your contribution in {$department}.

Issued on {$today}.

", default => "

Dear {$name},

Please find the official letter from {$company}.

Issued on {$today}.

", }; } /** * @return array{header: ?string, body: string, footer: ?string} */ public function renderParts(?LetterHeadTemplate $template, string $bodyHtml, array $variables, ?Company $company = null): array { $header = $template?->header_html; if (! $header && $company?->name) { $header = '

' . e($company->name) . '

'; } return [ 'header' => $header ? $this->mergePlaceholders($header, $variables) : null, 'body' => $this->mergePlaceholders($bodyHtml, $variables), 'footer' => $template?->footer_html ? $this->mergePlaceholders($template->footer_html, $variables) : null, ]; } }