mirror of
https://github.com/mediacms-io/mediacms.git
synced 2026-03-09 14:37:22 -04:00
foo
This commit is contained in:
102
lms-plugins/mediacms-moodle/INSTALL.txt
Normal file
102
lms-plugins/mediacms-moodle/INSTALL.txt
Normal file
@@ -0,0 +1,102 @@
|
||||
================================================================================
|
||||
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
|
||||
|
||||
================================================================================
|
||||
89
lms-plugins/mediacms-moodle/build.sh
Executable file
89
lms-plugins/mediacms-moodle/build.sh
Executable file
@@ -0,0 +1,89 @@
|
||||
#!/bin/bash
|
||||
|
||||
# MediaCMS Moodle Plugin Suite - Build Script
|
||||
# Creates distributable ZIP package
|
||||
|
||||
set -e # Exit on error
|
||||
|
||||
# Colors for output
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
echo -e "${GREEN}======================================${NC}"
|
||||
echo -e "${GREEN}MediaCMS Moodle Plugin Suite Builder${NC}"
|
||||
echo -e "${GREEN}======================================${NC}"
|
||||
echo
|
||||
|
||||
# Configuration
|
||||
VERSION="1.0.0"
|
||||
BUILD_DATE=$(date +%Y%m%d)
|
||||
PACKAGE_NAME="mediacms-moodle-v${VERSION}"
|
||||
DIST_DIR="dist"
|
||||
BUILD_DIR="${DIST_DIR}/${PACKAGE_NAME}"
|
||||
|
||||
# Create clean dist directory
|
||||
echo -e "${YELLOW}→${NC} Cleaning dist directory..."
|
||||
rm -rf "${DIST_DIR}"
|
||||
mkdir -p "${BUILD_DIR}"
|
||||
|
||||
# Copy filter plugin
|
||||
echo -e "${YELLOW}→${NC} Copying filter plugin..."
|
||||
mkdir -p "${BUILD_DIR}/filter"
|
||||
cp -r filter/mediacms "${BUILD_DIR}/filter/"
|
||||
|
||||
# Copy TinyMCE plugin
|
||||
echo -e "${YELLOW}→${NC} Copying TinyMCE plugin..."
|
||||
mkdir -p "${BUILD_DIR}/lib/editor/tiny/plugins"
|
||||
cp -r tiny/mediacms "${BUILD_DIR}/lib/editor/tiny/plugins/"
|
||||
|
||||
# Copy documentation
|
||||
echo -e "${YELLOW}→${NC} Copying documentation..."
|
||||
cp README.md "${BUILD_DIR}/filter/mediacms/"
|
||||
cp INSTALL.txt "${BUILD_DIR}/filter/mediacms/"
|
||||
|
||||
# Clean up development files
|
||||
echo -e "${YELLOW}→${NC} Removing development files..."
|
||||
find "${BUILD_DIR}" -type d -name "node_modules" -exec rm -rf {} + 2>/dev/null || true
|
||||
find "${BUILD_DIR}" -type f -name ".DS_Store" -delete 2>/dev/null || true
|
||||
find "${BUILD_DIR}" -type f -name "*.log" -delete 2>/dev/null || true
|
||||
find "${BUILD_DIR}" -type d -name ".git" -exec rm -rf {} + 2>/dev/null || true
|
||||
find "${BUILD_DIR}" -type f -name ".gitignore" -delete 2>/dev/null || true
|
||||
|
||||
# Remove AMD source files (keep only built versions)
|
||||
echo -e "${YELLOW}→${NC} Cleaning AMD source files..."
|
||||
find "${BUILD_DIR}/lib/editor/tiny/plugins/mediacms/amd" -type f -name "*.js" ! -name "*-lazy.js" ! -path "*/build/*" -delete 2>/dev/null || true
|
||||
|
||||
# Create ZIP archive
|
||||
echo -e "${YELLOW}→${NC} Creating ZIP archive..."
|
||||
cd "${BUILD_DIR}"
|
||||
zip -r "../${PACKAGE_NAME}.zip" . -q
|
||||
cd ../..
|
||||
|
||||
# Create checksum
|
||||
echo -e "${YELLOW}→${NC} Generating checksum..."
|
||||
cd "${DIST_DIR}"
|
||||
sha256sum "${PACKAGE_NAME}.zip" > "${PACKAGE_NAME}.zip.sha256"
|
||||
cd ..
|
||||
|
||||
# Display results
|
||||
ZIP_SIZE=$(du -h "${DIST_DIR}/${PACKAGE_NAME}.zip" | cut -f1)
|
||||
echo
|
||||
echo -e "${GREEN}✓ Build complete!${NC}"
|
||||
echo
|
||||
echo "Package: ${DIST_DIR}/${PACKAGE_NAME}.zip"
|
||||
echo "Size: ${ZIP_SIZE}"
|
||||
echo "Checksum: ${DIST_DIR}/${PACKAGE_NAME}.zip.sha256"
|
||||
echo
|
||||
echo -e "${YELLOW}Contents:${NC}"
|
||||
echo " - filter/mediacms/ (includes docs)"
|
||||
echo " - lib/editor/tiny/plugins/mediacms/"
|
||||
echo
|
||||
echo -e "${GREEN}Ready for distribution!${NC}"
|
||||
echo
|
||||
|
||||
# Show checksum
|
||||
echo -e "${YELLOW}SHA256 Checksum:${NC}"
|
||||
cat "${DIST_DIR}/${PACKAGE_NAME}.zip.sha256"
|
||||
echo
|
||||
Reference in New Issue
Block a user