WordPress plugin for eXeLearning content management. Upload, manage and embed eXeLearning .elpx files directly in your WordPress site.

Try eXeLearning instantly in your browser using WordPress Playground! Note that all changes will be lost when you close the browser window, as everything runs locally in your browser.

⚠️ The embedded eXeLearning editor is not included in this preview. You can install it from Settings > eXeLearning using the "Download & Install Editor" button. All other plugin features (ELP upload, shortcode, Gutenberg block, preview) work normally.

• ELPX File Support: Upload and manage eXeLearning .elpx files through the WordPress Media Library
• Automatic Extraction: ELPX files are automatically extracted and ready to display
• Embedded Editor: Edit eXeLearning content directly from WordPress without leaving the browser
• Gutenberg Block: Embed eXeLearning content using the native block editor
• Shortcode Support: Use [exelearning id="123"] to embed content in classic editor
• Media Library Integration: View ELPX metadata directly in the media library

1. Download the latest release from the GitHub Releases page.
2. Upload the downloaded ZIP file via Plugins > Add New > Upload Plugin.
3. Activate the plugin.

If you clone the repository directly, you must build the eXeLearning editor:

git clone https://github.com/exelearning/wp-exelearning.git
cd wp-exelearning
make build-editor

By default, make build-editor fetches https://github.com/exelearning/exelearning from main using a shallow checkout. You can override source/ref at runtime:

EXELEARNING_EDITOR_REF=vX.Y.Z EXELEARNING_EDITOR_REF_TYPE=tag make build-editor
# or
EXELEARNING_EDITOR_REF=my-feature EXELEARNING_EDITOR_REF_TYPE=branch make build-editor

Important: It is recommended to download from Releases for production use, which includes the embedded editor pre-built. If you clone the repository without building the editor, you can install it from the WordPress admin panel at Settings > eXeLearning using the "Download & Install Editor" button, which fetches the latest static editor package from GitHub Releases automatically. No remote loading or proxy is used at runtime.

1. Go to Media > Add New in your WordPress admin
2. Upload your .elpx file
3. The file will be automatically validated and extracted

Using Gutenberg Block:

1. Add a new block in the editor
2. Search for "eXeLearning"
3. Select an ELPX file from your media library

Using Shortcode:

[exelearning id="123"]

Replace 123 with the attachment ID of your ELPX file.

• Go to Media > Library to see all uploaded files
• ELPX files display metadata including license, language, and resource type
• Click on an ELPX file to preview its content

For development, you can bring up a local WordPress environment with the plugin pre-installed:

make up

This will start a Dockerized WordPress instance at http://localhost:8888 with credentials:

• Username: admin
• Password: password

make up          # Start development environment
make down        # Stop containers
make test        # Run PHPUnit tests
make lint        # Check code style
make fix         # Auto-fix code style

• WordPress 6.1 or higher
• PHP 8.0 or higher

This plugin is licensed under the AGPL v3 or later.