Note: You are currently viewing documentation for Moodle 2.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Youtube videos repository.

Youtube videos repository: Difference between revisions

From MoodleDocs
(copied from 2.9 docs)
m (small rewording)
Line 1: Line 1:
{{Repositories}}
{{Repositories}}
The YouTube repository allows users easily to embed videos from YouTube.
==Enabling the Youtube repository==
==Enabling the Youtube repository==


*Go to ''Administration>Site administration>Plugins>Repositories>Manage Repositories'';
*Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories'';
*Select from the drop down next to Youtube "Enabled and visible" if it is not already enabled and visible;
*Select from the drop down next to YouTube "Enabled and visible" if it is not already enabled and visible;
*Click on "Settings"  
*Click on "Settings"  


[[File:youtubereposettings.png|thumb|center|400px]]
[[File:youtubereposettings.png|thumb|center|400px]]


'''NOTE:''' ''If you don't see the API key box as in the screenshot above, perhaps you installed Moodle before this fix. Please see MDL-50176
Note: The API key setting is only available in Moodle 2.8.7 and 2.9.1 onwards (MDL-50176).
''
 
* If desired, give the repository a name. You don't have to; it is OK to leave it blank.
* 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.)''
* 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.)''
Line 24: Line 26:
[[File:createproject3a.png]]
[[File:createproject3a.png]]


*On the next screen, click APIs and Auth ''(1)'' and then APIs ''(2)'' and then in the Youtube APIs section, click Youtube data API ''(3)'' :
*On the next screen, click APIs and Auth ''(1)'' and then APIs ''(2)'' and then in the YouTube APIs section, click YouTube data API ''(3)'' :


[[File:apis02.png]]
[[File:apis02.png|thumb|center|450px]]


*On the next screen, click the blue button to enable the API.
*On the next screen, click the blue button to enable the API.
Line 38: Line 40:
[[File:apis04.png]]
[[File:apis04.png]]


*Copy this key and paste it into the API key box you see on ''Site administration>Plugins>Repositories>Manage Repositories>Youtube videos>Settings''
*Copy this key and paste it into the API key box you see on ''Site administration > Plugins > Repositories > Manage Repositories > YouTube videos > Settings''


==Searching for and embedding a video from Youtube==
==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.
*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).
*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.
*Within a course you must ensure in ''Course administration > Filters'' that multimedia are ON.
*Click the filmstrip, "Moodle media icon" in the editor:
*Click the filmstrip, "Moodle media icon" in the editor:


Line 49: Line 51:


*Click "Browse repositories"
*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.
*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.
*Your search results will appear as video thumbnails.


{|
{|
| [[File:youtubesearch.png|thumb|400px|center|Searching Youtube videos]]
| [[File:youtubesearch.png|thumb|400px|center|Searching YouTube videos]]
| [[File:FIlepickerYoutube.png|thumb|400px|center|The search results]]
| [[File:FIlepickerYoutube.png|thumb|400px|center|The search results]]
|}
|}
Line 72: Line 74:
==Repository capabilities==
==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.  
There is just one capability, [[Capabilities/repository/youtube:view|Use YouTube in file picker]], which is allowed for the default authenticated user role.  


==FAQ==
==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.
===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:Multimedia]]

Revision as of 05:41, 6 July 2015

The YouTube repository allows users easily to embed videos from YouTube.

Enabling the Youtube repository

  • Go to Administration > Site administration > Plugins > Repositories > Manage Repositories;
  • Select from the drop down next to YouTube "Enabled and visible" if it is not already enabled and visible;
  • Click on "Settings"
youtubereposettings.png

Note: The API key setting is only available in Moodle 2.8.7 and 2.9.1 onwards (MDL-50176).

youtubecreateproject.png

  • Click the blue button to create a new project:

createproject2.png

  • Give your project a name. Tick the box to agree to the conditions and then click the blue Create button:

createproject3a.png

  • On the next screen, click APIs and Auth (1) and then APIs (2) and then in the YouTube APIs section, click YouTube data API (3) :
apis02.png
  • On the next screen, click the blue button to enable the API.
  • Now click the link Credentials (1) and click to create a new public API key (2):

apis03.png

  • Choose 'Server' and on the next screen just click the blue Create button.
  • You will then get an API key:

apis04.png

  • Copy this key and paste it into the API key box you see on Site administration > Plugins > Repositories > Manage Repositories > YouTube videos > Settings

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:

Moodlemediaicon.png

  • 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"

Youtubestep2.png

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

Youtubestep3.png

  • 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.

Youtubestep4.png

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.