This page refers to Classic Poodll. For Cloud Poodll see: Getting Started with Cloud Poodll.
1. Install Poodll
You can install PoodLL in one of three ways.
Use Moodle.org and your Moodle site's installation service
See here for more information
Download the zip files and uploading them into Moodle
See here for more information.
Use Git and GitHub (advanced)
See here for more information.
2. Copy your API User and API Secret (https://poodll.com/member)
Cloud Poodll uses your API username and API secret to allow your site users access to Poodll. Each of the Cloud Poodll plugins works independently i.e. they do not depend on each other or on the Poodll filter. So you should add the API username and secret to the settings page for each of them. You will find those on the "API Creds" tab of the https://poodll.com/member page.
3. Register your site URLs (https://poodll.com/member)
Poodll registers your sites as they appear in your Moodle site configuration file. Your registration is checked against that when Poodll runs. To do this, go to http://poodll.com/member and enter your Moodle site's URL/domain (start from http/https).
Most Poodll plans allow you to use a wildcard '*' in place of the www (or other subdomain) to enable all subdomains, e.g https://*.mycoolsite.com .
NB The URL needs to begin with "https" or "http"
Poodll also generates a registration code for each registered URL beneath the URL field. Old versions of the Poodll filter need that registration code. If your version of the Poodll filter is earlier than v3.1.13 (Build 2018112500) you will need to copy the registration code.
4. Add your API user and secret / site registration code (on your moodle site)
Go to: Site administration -> plugins -> filters -> Manage filters
and enable the PoodLL filter.
Then under: Site administration -> plugins -> filters -> PoodLL
You should see:
- General Settings
- File Extension Settings
- Widget Settings
For Poodll filter v3.1.13 (Build 2018112500) or greater : add your API user and secret
Go to General Settings and enter the registration code you made earlier.
5. Enable the Poodll filter
The Poodll players and widgets rely on the Poodll filter to work. In most cases you will use these, so you need to:
- Enable the Poodll filter
- Move it above multimedia plugins in the list of filters
You can do both of these tasks at:
Site administration -> Plugins -> Filters -> Manage filters
6. Confirm default mp4/mp3 handler
PoodLL3 takes a different approach to other media filters, in how it handles the links it is asked to process. Players can be freely configured, customized or created as templates. Any template which has “Show in players list” checked on its template page, will appear as an option to be selected from on the file extension settings page, beside each file extension.
When PoodLL 3 is installed, by default “Flowplayer First Frame” and “Audio JS Shim” are available and registered to handle .mp4 and .mp3 respectively. Confirm this by visiting the PoodLL settings File extensions settings page at:
Site administration -> Plugins ->Filters ->PoodLL ->File Extension Settings
If mp3 and mp4 handlers are not configured,
i) Check “handle mp4” and select “Flowplayer First Frame”
ii) Check “handle mp3” and select “Audio JS Shim”
(You can can use different audio and video players too, if those templates are available.)
7. Ensure your cron job is running
Moodle relies on "cron" to do processing behind the scenes. Poodll also relies on Moodle's cron job. Poodll converts recorded files into mp3 and mp4 in the cloud. It then copies them back into Moodle. When Poodll cloud notifications are enabled (this is the default) then the copy back happens as soon as conversion is finished. If cloud notifications are not enabled then the copy back is handled when the Moodle cron job is run.
The cron job should run frequently. Ideally this should run once a minute so that the student doesn't have to wait long minutes or hours for their recording to be available. Details on how to set up cron and a 1 minute cron example are available here: http://docs.moodle.org/en/Cron
If cron is not running there will be a message under Site administration -> notifications about that.