Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: filter multiembed.
- 1 Introduction
- 2 Installation
- 3 How to use the Multi-Embed filter
- 4 Requesting for new services to be added
- 5 Adding new services to the filter
The Multi-Embed filter automatically turns URLs from supported services into embedded content, without any user input. By using the Multi-Embed filter, Moodle users (e.g. teachers) do not need to know how to 'embed' objects from other sites, they only need to know how to copy/paste a URL into their Moodle content, using the standard Moodle editor.
Please make sure that you have enabled the 'Convert URLs into links' filter, and placed it above the Multi-Embed filter, as shown below. This setting can be found at Site administration > Plugins > Filters > Manage filters.
Please ensure that the 'Converts URLs into links and images' filter settings are set to filter all types of content at Site administration > Plugins > Filters > Convert URLs into links and images as shown below
Depending on your Moodle installation, you may also need to do the following
In Site administration > Security > Site policies, set 'Allow EMBED and OBJECT tags' to 'Yes'
How to use the Multi-Embed filter
Enabling/Disabling the filter
The Multi-Embed filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit Administration > Plugins > Filters > Manage Filters Locate the 'Multi-Embed' filter, and click on the dropdown box to enable it (or disable it). Please ensure that the 'Convert URLs into links' filter is also enabled, and is placed above the multi-embed filter.
Enabling/Disabling specific services
Visit Administration > Plugins > Filters > Manage Filters and click on Settings for the Multi-Embed filter. On that page, select/deselect the services you wish to have the filter take care of. Scroll down to the bottom of the page to save your changes.
Enabling/disabling Multi-Embed filter in specific courses/activities/resources
The Multi-Embed filter can be disabled for specific courses/activities/resources. Please note that, currently it is not possible to enable/disable specific services at the activity/resource level. Visit  this page to find out how to manage filters at the course/activity/resource level.
Requesting for new services to be added
New services are regularly added to the Mutli-Embed filter. However, please click here to request for a service to be added to the plugin. When requesting a plugin, please make sure to include the URL of the service, as well as the name. Please note that not all websites allow for their content to be embedded into other websites.
Adding new services to the filter
Please feel free to submit new services to be added to the Multi-Embed filter. Whilst it is not yet possible to add services using the Moodle User Interface, if you feel comfortable modifying PHP code, you should be able to add services fairly easily. Please submit your pull-requests here.