this

LTI_SETUP.md

@@ -90,6 +90,9 @@ You'll need these URLs when configuring your LMS:
 - ✓ IMS LTI Names and Role Provisioning (for roster sync)
 - ✓ IMS LTI Deep Linking (for media selection)
 
+**Tool Settings (Important for Deep Linking):**
+- ✓ **Supports Deep Linking (Content-Item Message)** - Enable this to allow instructors to browse and select media from MediaCMS when adding activities
+
 3. Save the tool configuration
 
 ### B. Copy Platform Details to MediaCMS
@@ -134,10 +137,17 @@ Copy these values back to the LTIPlatform configuration in MediaCMS admin (step
   - Any other MediaCMS page path
 
 **Option 4: Embed Specific Media via Deep Linking (Interactive)**
-- Add activity → External tool → MediaCMS
+
-- Click "Select content" (if Deep Linking is enabled)
+⚠️ **Prerequisite:** Ensure "Supports Deep Linking (Content-Item Message)" is enabled in the External Tool configuration (see section 3.A above)
-- Browse and select media from MediaCMS
+
-- Selected media will be automatically configured and embedded
+When adding the activity to your course:
+1. Add activity → External tool → MediaCMS
+2. In the activity settings, enable **"Supports Deep Linking"** checkbox (may be under "Tool settings" or "Privacy" section)
+3. Click **"Select content"** button → This launches the MediaCMS media browser
+4. Browse and select media from MediaCMS (you can select multiple)
+5. Click **"Add to course"** → Returns to Moodle with selected media configured
+6. The activity will be automatically configured with the selected media's title and embed URL
+7. Students clicking this activity will go directly to the selected media
 
 ### D. Custom Parameters - Complete Examples
 

lti/deep_linking.py

@@ -157,10 +157,10 @@ class SelectMediaView(View):
                     thumb = item['thumbnail']
                     resource.set_icon_url(thumb['url'])
 
-                # Add iframe settings
+                # Set window target to iframe (instead of set_iframe which doesn't exist)
                 if item.get('iframe'):
                     iframe = item['iframe']
-                    resource.set_iframe(iframe.get('width', 960), iframe.get('height', 540))
+                    resource.set_window_target('iframe').set_width(iframe.get('width', 960)).set_height(iframe.get('height', 540))
 
                 resources.append(resource)