mirror of
https://github.com/mediacms-io/mediacms.git
synced 2026-03-10 23:17:21 -04:00
103 lines
3.0 KiB
Plaintext
103 lines
3.0 KiB
Plaintext
================================================================================
|
|
MediaCMS Moodle Plugin Suite v1.0.0
|
|
Installation Guide
|
|
================================================================================
|
|
|
|
Requirements
|
|
------------
|
|
- Moodle 4.5 or later
|
|
- MediaCMS instance
|
|
- MediaCMS set as External Tool
|
|
|
|
|
|
Installation
|
|
------------------
|
|
|
|
1. Extract zip file to Moodle root public directory:
|
|
|
|
cd /var/www/moodle/public
|
|
unzip mediacms-moodle-v1.0.0.zip
|
|
|
|
This will place files in:
|
|
- filter/mediacms/
|
|
- lib/editor/tiny/plugins/mediacms/
|
|
|
|
2. Set permissions
|
|
chown -R www-data:www-data filter/mediacms
|
|
chown -R www-data:www-data lib/editor/tiny/plugins/mediacms
|
|
|
|
3. Install through Moodle
|
|
- Log in as Administrator
|
|
- Go to: Site Administration → Notifications
|
|
- Click "Upgrade Moodle database now"
|
|
- Both plugins will be installed automatically
|
|
|
|
4. Make sure Filter is enabled
|
|
- As Administrator, visit Plugins, 'Manage Filters', find MediaCMS filter and enable it.
|
|
Then place it at the top of the filter. This is important, otherwise embeds won't load.
|
|
CONFIGURATION
|
|
-------------
|
|
|
|
1. CORE SETTINGS (Required)
|
|
Site Administration → Plugins → Filters → MediaCMS (Settings)
|
|
|
|
- MediaCMS URL: https://lti.mediacms.io (your instance)
|
|
- LTI Tool: Select your MediaCMS tool (see LTI SETUP below)
|
|
|
|
✓ These settings are shared by both plugins!
|
|
|
|
2. ENABLE FILTER
|
|
Site Administration → Plugins → Filters → Manage filters
|
|
|
|
- Set "MediaCMS" to "On"
|
|
|
|
3. LTI SETUP (Required for Video Library)
|
|
Site Administration → Plugins → Activity modules → External tool →
|
|
Manage tools → "Configure a tool manually"
|
|
|
|
- Tool name: MediaCMS
|
|
- Tool URL: https://lti.mediacms.io/lti/login/
|
|
- LTI version: LTI 1.3
|
|
- Public key type: Keyset URL
|
|
- Public keyset: https://lti.mediacms.io/lti/jwks/
|
|
- Initiate login URL: https://lti.mediacms.io/lti/login/
|
|
- Redirection URI(s): https://lti.mediacms.io/lti/launch/
|
|
|
|
Services:
|
|
✓ IMS LTI Deep Linking (required for video library)
|
|
|
|
Save and copy the configuration URLs to provide to MediaCMS admin.
|
|
|
|
4. AUTO-CONVERT DEFAULTS (Optional)
|
|
Site Administration → Plugins → Text editors → TinyMCE → MediaCMS
|
|
|
|
Configure default display options for pasted URLs.
|
|
|
|
TESTING
|
|
-------
|
|
|
|
1. Create a test course
|
|
2. Add a page or label
|
|
3. Click MediaCMS button in TinyMCE editor
|
|
4. Try inserting from video library or pasting a URL
|
|
|
|
TROUBLESHOOTING
|
|
---------------
|
|
|
|
Video library won't load:
|
|
- Check LTI tool is selected in filter settings
|
|
- Verify you're in a course context
|
|
- Check LTI tool configuration
|
|
|
|
URLs not auto-converting:
|
|
- Enable MediaCMS filter in Manage filters
|
|
- Verify MediaCMS URL setting matches your instance
|
|
- Clear caches: Site Administration → Development → Purge caches
|
|
|
|
SUPPORT
|
|
-------
|
|
Issues: https://github.com/mediacms-io/mediacms/issues
|
|
Docs: https://docs.mediacms.io
|
|
|
|
================================================================================
|