- \n \t
- What embedded media and interactive content is supported by Pressbooks<\/li>\n \t
- How to add this content to your book<\/li>\n \t
- How Pressbooks handles this content across formats<\/li>\n<\/ul>\n<\/div>\n
What is Embedded Media & Interactive Content?<\/h1>\nEmbedded content refers to content that is hosted outside of your Pressbooks book, but that you \u2018embed\u2019 so it can been viewed and interacted with within the webbook, saving your reader from needing to visit another site. You will have encountered this kind of content all over the web \u2013 YouTube videos in blog posts, for example, or social media posts in news articles \u2013 and it follows that you may want to add it to your Pressbooks webbook as well.\n
Supported Content<\/h1>\nPressbooks supports several different kinds of media and interactive content. Each of these behave in slightly different ways and have different input methods, and when it comes to embedded content, it is important to understand why some content is allowed and other content is not.\n\nOne kind of embedded content we don't allow is iframes; by default, WordPress (on which Pressbooks is built) heavily restricts the use of iframes for security reasons. Instead, we avoid the need to use iframes altogether by allowing content from approved sites to be embedded without them - all you need is the URL and the system handles the rest!\n
How do I embed content?<\/h1>\nTo embed approved content, all you need to do is drop the URL of the video, audio or other element (not<\/strong> the embed code with iframe tags wrapping it) directly into the visual editor, and Pressbooks will automagically change the URL to an embed.\n\n
![\"\"](\"https:\/\/pb.malartu.org\/pbuserguide\/files\/2018\/09\/2018-03-10_16-55-46-1.gif\")
\n\nThe full list of approved content is too long to include here, but includes major providers such as:\n- \n \t
- YouTube<\/li>\n \t
- Vimeo<\/li>\n \t
- SoundCloud<\/li>\n \t
- Social media (Twitter, Instagram, Facebook etc.)<\/li>\n \t
- Flickr<\/li>\n \t
- TED.com<\/li>\n<\/ul>\nWe also support several EDU-specific platforms, including:\n
- \n \t
- PHET simulations<\/a><\/li>\n \t
- Openassessments.org<\/a><\/li>\n \t
- eduMedia<\/a><\/li>\n<\/ul>\nIf you\u2019re not sure whether the content you want to embed is supported or not, the easiest way to find out is to paste the link to your chapter and see if it turns into to the expected content or not. If it is not supported, you will need to instead add a regular hyperlink<\/a> that takes the reader to the content on another site.\n\nNote: EDU network managers can request a site be added to our list of approved content sources. Please contact your network manager if you require embed support for a specific site and we will evaluate requests for inclusion on the list.<\/em>\n
H5P Interactive Content (PressbooksEDU Hosted Networks Only)<\/h1>\nH5P is not currently available on Pressbooks.com. If you are on a Pressbooks network that does offer H5P, you can find documentation here<\/a>.\n
Display Across Formats<\/h1>\nWhile interactive and embedded content is handled natively in web, it is not supported quite so easily across the other formats Pressbooks produces, including PDF and ebook. As a result, we have implemented a fallback method for content that isn\u2019t supported across the board.\n\nThis fallback consists of an inserted message that is populated with information available in the system (may include a title, thumbnail, the kind of media, etc.) and provides the reader with a link to the webbook version of the chapter so they can view the missing element (print readers will see a short URL that they can type into a browser). See a couple of examples below.\n\n
![\"\"](\"https:\/\/pb.malartu.org\/pbuserguide\/files\/2018\/09\/Screen-Shot-2018-03-10-at-6.06.44-PM.png\")
\n\n![\"\"](\"https:\/\/pb.malartu.org\/pbuserguide\/files\/2018\/09\/Screen-Shot-2018-03-10-at-6.07.00-PM.png\")
\nUploaded Media<\/h1>\nPressbooks also enables users to upload audio and video directly to their books. Typically, we discourage people from uploading video as the file sizes tend to be quite large and can eat up your storage space quickly. However, if ever audio or video is uploaded and inserted into a book, it will be handled in the same way as embedded media: displayed normally in web and swapped for a missing element message in other formats.\n\n \n
NOTE:\u00a0<\/strong>Please avoid<\/span> linking to your Pressbooks media files from outside of the Pressbooks platform.<\/div>\nPrefer to watch and learn? Check out this video tutorial:\u00a0<\/strong>\n\nhttps:\/\/youtu.be\/gQwWesSEjXc\n\nIf you still aren\u2019t sure how to embed media or interactive content, or have other questions, contact us<\/a>!<\/em>","rendered":"\nThis chapter will cover:<\/p>\n
- \n
- What embedded media and interactive content is supported by Pressbooks<\/li>\n
- How to add this content to your book<\/li>\n
- How Pressbooks handles this content across formats<\/li>\n<\/ul>\n<\/div>\n
What is Embedded Media & Interactive Content?<\/h1>\n
Embedded content refers to content that is hosted outside of your Pressbooks book, but that you \u2018embed\u2019 so it can been viewed and interacted with within the webbook, saving your reader from needing to visit another site. You will have encountered this kind of content all over the web \u2013 YouTube videos in blog posts, for example, or social media posts in news articles \u2013 and it follows that you may want to add it to your Pressbooks webbook as well.<\/p>\n
Supported Content<\/h1>\n
Pressbooks supports several different kinds of media and interactive content. Each of these behave in slightly different ways and have different input methods, and when it comes to embedded content, it is important to understand why some content is allowed and other content is not.<\/p>\n
One kind of embedded content we don’t allow is iframes; by default, WordPress (on which Pressbooks is built) heavily restricts the use of iframes for security reasons. Instead, we avoid the need to use iframes altogether by allowing content from approved sites to be embedded without them – all you need is the URL and the system handles the rest!<\/p>\n
How do I embed content?<\/h1>\n
To embed approved content, all you need to do is drop the URL of the video, audio or other element (not<\/strong> the embed code with iframe tags wrapping it) directly into the visual editor, and Pressbooks will automagically change the URL to an embed.<\/p>\n
<\/div>\nThe full list of approved content is too long to include here, but includes major providers such as:<\/p>\n
- \n
- YouTube<\/li>\n
- Vimeo<\/li>\n
- SoundCloud<\/li>\n
- Social media (Twitter, Instagram, Facebook etc.)<\/li>\n
- Flickr<\/li>\n
- TED.com<\/li>\n<\/ul>\n
We also support several EDU-specific platforms, including:<\/p>\n
- \n
- PHET simulations<\/a><\/li>\n
- Openassessments.org<\/a><\/li>\n
- eduMedia<\/a><\/li>\n<\/ul>\n
If you\u2019re not sure whether the content you want to embed is supported or not, the easiest way to find out is to paste the link to your chapter and see if it turns into to the expected content or not. If it is not supported, you will need to instead add a regular hyperlink<\/a> that takes the reader to the content on another site.<\/p>\n
Note: EDU network managers can request a site be added to our list of approved content sources. Please contact your network manager if you require embed support for a specific site and we will evaluate requests for inclusion on the list.<\/em><\/p>\n
H5P Interactive Content (PressbooksEDU Hosted Networks Only)<\/h1>\n
- Openassessments.org<\/a><\/li>\n
- PHET simulations<\/a><\/li>\n
- Openassessments.org<\/a><\/li>\n \t
- PHET simulations<\/a><\/li>\n \t