YouTube videos repository: Difference between revisions

Latest revision as of 22:45, 31 August 2017

The YouTube repository

The YouTube repository allows users easily to embed videos from YouTube. It is disabled by default on new installs because it requires an API key.

Enabling the YouTube repository

Click the Manage repositories link from Site administration.
Select from the drop down next to YouTube "Enabled and visible".
Click on "Settings"

If desired, give the repository a name. You don't have to; it is OK to leave it blank.
Click the Google API link which will take you to https://developers.google.com/youtube/v3/getting-started (Note that you will need a Google account to proceed.)
When you have created an account or signed in with an existing account, click https://console.developers.google.com
Click the plus sign 'Enable API' at the top of the page:

Click 'YouTube data API'

Click the Enable link (if not already enabled):

Click Credentials in the column on the left and then click the arrow by the blue Credentials link and choose API

You will be given an API code which you can copy:

Paste this into the API key box in your Moodle site (Repositories>Youtube) and save.

The same API key may be used to configure the Youtube block.

Searching for and embedding a video from YouTube

YouTube videos can be searched for and embedded anywhere there is the text editor, for example a label or a page.
Before this works, you must enable the multimedia filters under Administration > Site administration/Plugins/Filters/Manage Filters. Set Multimedia Plugins to "On" and make sure YouTube is selected under Settings (it should be by default).
Within a course you must ensure in Course administration > Filters that multimedia are ON.
Click the filmstrip, "Moodle media icon" in the editor:

Click "Browse repositories"
The file picker will appear with YouTube videos as an option. Click it and a search box will appear.
You can search by relevance, date, rating or view count. Click the "Search" button when you are ready.
Your search results will appear as video thumbnails.

Searching YouTube videos

The search results

Click on the one you want to select it.*
Rename if desired; add the author and license if needed and click "Insert media"

DO NOT WORRY IF YOUR VIDEO NO LONGER SHOWS! You will just get a blue text link at first:

Save it and then it will display.If it still displays as a text link after saving, make sure you have enabled the Multimedia filter as instructed at the top of this page.

Repository capabilities

There is just one capability, Use YouTube in file picker, which is allowed for the default authenticated user role.

FAQ

The YouTube repository is enabled but I still can't see the YouTube option in the file picker

Are you sure you are working with the text editor? The YouTube option allows you to search for and embed YouTube videos into the editor in places such as labels or pages. You won't see it simply by clicking the "add" button when uploading a file, for example.

@@ Line 1: / Line 1: @@
 {{Repositories}}
-The Youtube repository allows users to search from within the HTML/TinyMCE editor for a youtube video which they can then embed without the need for any coding.  The option needs to be enabled  by the administrator before it is available for teachers and students.
+==The YouTube repository==
-==Enabling the Youtube repository==
-*Go to ''Settings>Site administration>Plugins>Repositories>Manage Repositories'';
+The YouTube repository allows users easily to embed videos from YouTube. It is disabled by default on new installs because it requires an API key.
-*Select from the drop down next to Youtube "Enabled and visible";
-*If desired,click on "Settings" and give Youtube a customised name (not essential)
-[[File:Youtuberepo.png]]
+==Enabling the YouTube repository==
-==Searching for and embedding a video from Youtube==
+*Click the Manage repositories link from Site administration.
-*Youtube videos can be searched for and embedded anywhere there is the HTML/TinyMCE editor, for example a label or a page.
+*Select from the drop down next to YouTube "Enabled and visible".
-*Before this works, you must enable the multimedia filters under '' |Settings>Site administration/Plugins/Filters/Manage Filters''. Set Multimedia Plugins to "On" and make sure youtube is selected under Settings (it should be by default).
+*Click on "Settings"
-*Within a course you must ensure in ''Course administration>Filters'' that multimedia are ON.
+[[File:youtubereposettings.png|thumb|center|400px]]
+* If desired, give the repository a name. You don't have to; it is OK to leave it blank.
+* Click the Google API link which will take you to https://developers.google.com/youtube/v3/getting-started ''(Note that you will need a Google account to proceed.)''
+*When you have created an account or signed in with an existing account, click https://console.developers.google.com
+*Click the plus sign 'Enable API' at the top of the page:
+[[File:enableapi.png]]
+*Click 'YouTube data API'
+[[File:youtubedataapi1.png]]
+*Click the Enable link (if not already enabled):
+[[File:enableyoutubedataapi.png]]
+*Click Credentials in the column on the left and then click the arrow by the blue Credentials link and choose API
+[[File:apicredentials.png]]
+*You will be given an API code which you can copy:
+[[File:createdapikey.png]]
+*Paste this into the API key box in your Moodle site (Repositories>Youtube) and save.
+The same API key may be used to configure the [[Youtube block]].
+==Searching for and embedding a video from YouTube==
+*YouTube videos can be searched for and embedded anywhere there is the text editor, for example a label or a page.
+*Before this works, you must enable the multimedia filters under '' Administration > Site administration/Plugins/Filters/Manage Filters''. Set Multimedia Plugins to "On" and make sure YouTube is selected under Settings (it should be by default).
+*Within a course you must ensure in ''Course administration > Filters'' that multimedia are ON.
 *Click the filmstrip, "Moodle media icon" in the editor:
 [[File:Moodlemediaicon.png]]
-*Click "Find or upload a sound, video or applet"
+*Click "Browse repositories"
-*The file picker will appear with Youtube videos as an option. Click it and a search box will appear:
+*The file picker will appear with YouTube videos as an option. Click it and a search box will appear.
+*You can search by relevance, date, rating or view count. Click the "Search" button when you are ready.
+*Your search results will appear as video thumbnails.
+{|
+| [[File:youtubesearch.png|thumb|400px|center|Searching YouTube videos]]
+| [[File:FIlepickerYoutube.png|thumb|400px|center|The search results]]
+|}
-[[File:Searchyoutube.png]]
+*Click on the one you want to select it.*
+*Rename if desired; add the author and license if needed and click "Insert media"
-*Type in your search terms. Videos on that topic will appear. Click the one you want to use and it will appear enlarged.
+[[File:Youtubestep2.png]]
-*Rename if desired; add the author and license if needed and click "Select"
-*The video will be previewed in the next screen.
-[[File:Pinnacleridge2.png]]
+*''DO NOT WORRY IF YOUR VIDEO NO LONGER SHOWS''! You will just get a blue text link at first:
-*Click "Insert"
+[[File:Youtubestep3.png]]
-*''DO NOT WORRY IF YOUR VIDEO NO LONGER SHOWS''! You will just get a blue text link until you save. Then it will display. If it still displays as a text link after saving, make sure you have enabled the Multimedia filter as instructed at the top of this page.
+*Save it and then it will display.If it still displays as a text link after saving, make sure you have enabled the Multimedia filter as instructed at the top of this page.
+[[File:Youtubestep4.png]]
+==Repository capabilities==
+There is just one capability, [[Capabilities/repository/youtube:view|Use YouTube in file picker]], which is allowed for the default authenticated user role.
 ==FAQ==
-===The youtube repository is enabled but I still can't see the youtube option in the file picker===
-*Are you sure you are working with the text (TinyMCE) editor? The youtube option allows you to search for and embed youtube videos into the editor in places such as labels or pages. You won't see it simply by clicking the "add" button when uploading a file, for example.
+===The YouTube repository is enabled but I still can't see the YouTube option in the file picker===
+Are you sure you are working with the text  editor? The YouTube option allows you to search for and embed YouTube videos into the editor in places such as labels or pages. You won't see it simply by clicking the "add" button when uploading a file, for example.
+[[Category:Multimedia]]
+[[Category:Video]]
 [[de:Youtube Video Repository]]
+[[fr:Vidéos Youtube]]
+[[es:Repositorio de videos de YouTube]]

Documentation