feat(training): choose roadmap embed as PDF or inline SVG

- Add roadmap_embed_kind (pdf|svg|none) and roadmap_svg (mediumText)
- Support [[embed_roadmap]] alongside [[embed_roadmap_pdf]]
- Nova shows PDF URL or SVG textarea based on format

Made-with: Cursor

Author: bernardhanna

app/Nova/TrainingResource.php

@@ -6,8 +6,10 @@
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\URL;
 use Laravel\Nova\Fields\Boolean;
+use Laravel\Nova\Fields\FormData;
 use Laravel\Nova\Fields\ID;
 use Laravel\Nova\Fields\Number;
+use Laravel\Nova\Fields\Select;
 use Laravel\Nova\Fields\Text;
 use Laravel\Nova\Fields\Textarea;
 use Laravel\Nova\Fields\Trix;
@@ -153,10 +155,38 @@ public function fields(Request $request): array
                 ->nullable()
                 ->help('Optional scroll offset in pixels for in-page anchor links (useful with sticky headers).'),
 
+            Select::make('Roadmap embed format', 'roadmap_embed_kind')
+                ->options([
+                    'pdf' => 'PDF (inline viewer)',
+                    'svg' => 'SVG (paste markup below)',
+                    'none' => 'None (remove placeholder output)',
+                ])
+                ->default('pdf')
+                ->help('Use [[embed_roadmap_pdf]] or [[embed_roadmap]] in Content where the roadmap should appear.'),
+
             Text::make('Roadmap PDF embed URL', 'roadmap_pdf_embed_url')
                 ->nullable()
                 ->rules('nullable', 'url')
-                ->help('Optional HTTPS URL to a PDF shown inline in the Roadmap section. Put the literal text [[embed_roadmap_pdf]] in Content where the embed should appear (avoids Nova stripping iframes).'),
+                ->dependsOn(['roadmap_embed_kind'], function (Text $field, NovaRequest $request, FormData $formData) {
+                    if (($formData->roadmap_embed_kind ?? 'pdf') === 'pdf') {
+                        $field->show();
+                    } else {
+                        $field->hide();
+                    }
+                })
+                ->help('HTTPS URL to the roadmap PDF. Used when format is PDF.'),
+
+            Textarea::make('Roadmap SVG', 'roadmap_svg')
+                ->nullable()
+                ->rows(10)
+                ->dependsOn(['roadmap_embed_kind'], function (Textarea $field, NovaRequest $request, FormData $formData) {
+                    if (($formData->roadmap_embed_kind ?? 'pdf') === 'svg') {
+                        $field->show();
+                    } else {
+                        $field->hide();
+                    }
+                })
+                ->help('Full <svg>...</svg> markup from your design tool. Used when format is SVG.'),
 
             Text::make('Button text', 'button_text')->nullable(),
 

app/TrainingResource.php

@@ -35,6 +35,8 @@ class TrainingResource extends Model
         'about_box_section',
         'anchor_offset',
         'roadmap_pdf_embed_url',
+        'roadmap_embed_kind',
+        'roadmap_svg',
         'button_text',
         'button_url',
         'secondary_button_text',

database/migrations/2026_05_01_140000_add_roadmap_embed_kind_and_svg_to_training_resources_table.php

@@ -0,0 +1,23 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('training_resources', function (Blueprint $table) {
+            $table->string('roadmap_embed_kind', 16)->default('pdf')->after('roadmap_pdf_embed_url');
+            $table->mediumText('roadmap_svg')->nullable()->after('roadmap_embed_kind');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('training_resources', function (Blueprint $table) {
+            $table->dropColumn(['roadmap_embed_kind', 'roadmap_svg']);
+        });
+    }
+};

database/seeders/TrainingResourceDiscoverDigitalProgrammeSeeder.php

@@ -91,6 +91,8 @@ public function run(): void
 HTML,
                 'anchor_offset' => 120,
                 'roadmap_pdf_embed_url' => 'https://codeweek-resources.s3.eu-west-1.amazonaws.com/+discover-digital-toolkit/DDP_toolkit_roadmap.pdf',
+                'roadmap_embed_kind' => 'pdf',
+                'roadmap_svg' => null,
                 'third_button_text' => 'Register an activity',
                 'third_button_url' => 'https://codeweek.eu/add?skip=1',
                 'meta_title' => 'Discover Digital Programme - Toolkit',

resources/views/training/partials/roadmap-svg-embed.blade.php

@@ -0,0 +1,6 @@
+@props([
+    'svg',
+])
+<div class="w-full max-w-full my-6 rounded-xl overflow-hidden border border-slate-200 bg-slate-50 shadow-sm [&_svg]:max-w-full [&_svg]:h-auto [&_svg]:block">
+    {!! $svg !!}
+</div>

resources/views/training/show.blade.php

@@ -26,14 +26,29 @@
 
     $renderedContent = $trainingResource->content ?? '';
     $roadmapEmbedUrl = trim((string) ($trainingResource->roadmap_pdf_embed_url ?? ''));
-    if ($roadmapEmbedUrl !== '' && str_contains($renderedContent, '[[embed_roadmap_pdf]]')) {
-        $renderedContent = str_replace(
-            '[[embed_roadmap_pdf]]',
-            view('training.partials.roadmap-pdf-embed', ['url' => $roadmapEmbedUrl])->render(),
-            $renderedContent
-        );
-    } elseif (str_contains($renderedContent, '[[embed_roadmap_pdf]]')) {
-        $renderedContent = str_replace('[[embed_roadmap_pdf]]', '', $renderedContent);
+    $roadmapEmbedKind = strtolower(trim((string) ($trainingResource->roadmap_embed_kind ?? 'pdf')));
+    if (! in_array($roadmapEmbedKind, ['pdf', 'svg', 'none'], true)) {
+        $roadmapEmbedKind = 'pdf';
+    }
+    $roadmapSvg = trim((string) ($trainingResource->roadmap_svg ?? ''));
+
+    $roadmapPlaceholders = ['[[embed_roadmap_pdf]]', '[[embed_roadmap]]'];
+    $hasRoadmapPlaceholder = str_contains($renderedContent, '[[embed_roadmap_pdf]]')
+        || str_contains($renderedContent, '[[embed_roadmap]]');
+
+    if ($hasRoadmapPlaceholder) {
+        $roadmapEmbedHtml = '';
+        if ($roadmapEmbedKind === 'pdf' && $roadmapEmbedUrl !== '') {
+            $roadmapEmbedHtml = view('training.partials.roadmap-pdf-embed', ['url' => $roadmapEmbedUrl])->render();
+        } elseif ($roadmapEmbedKind === 'svg' && $roadmapSvg !== '') {
+            $roadmapEmbedHtml = view('training.partials.roadmap-svg-embed', ['svg' => $roadmapSvg])->render();
+        }
+
+        foreach ($roadmapPlaceholders as $token) {
+            if (str_contains($renderedContent, $token)) {
+                $renderedContent = str_replace($token, $roadmapEmbedHtml, $renderedContent);
+            }
+        }
     }
 @endphp