Top Banner

Click here to load reader

Moodlemoot spain 2013. taller, creación de un plugin para moodle mobile

Nov 18, 2014





  • 1. Workshop How to develop a new plugin for Moodle Mobile Juan Leyva Moodlemoot Spain 2013 26, 27 y 28 September
  • 2. Speakers Juan Leyva Moodle Developer (since 2003) working @ CV&A Consulting Moodle Mobile official app creator and maintainer Developer of plugins: Configurable Reports jmail LTI Provider UMM (Unofficial Moodle Mobile) Anonymous posting in forums, Collaborative real-time editor, ConfigTabs, Forum discuss subscription,
  • 3. What we are going to do Understand how Moodle Mobile talks with a Moodle installation Understand the basics about Moodle Mobile Architecture Set up your Moodle Mobile development environment Set up your Moodle installation Package a existing Webservice to be used inside a local plugin Configure new Mobile Services in your Moodle installation Set up your MoodleMobile app Develop a MoodleMobile plugin Change the name and appearance of your app Build your MoodleMobile rebranded app
  • 4. The new plugin Display user grades in activities
  • 5. How Moodle Mobile talks with Moodle Moodle Mobile is a REST+JSON based Web Services client HTTPS is recommended User session is emulated using unique tokens File upload and downloads are done using standard HTTP requests
  • 6. Moodle Mobile Architecture basics
  • 7. Set up the development environment Install Google Chrome Create a direct access or script for launching Google Chrome with these flags: --disable-web-security --allow-file-access- from-files With Google Chrome and the F12 or "Developer tools" you can emulate mobile devices changing user-agent, orientation, resolution, geo-location, touch events, etc.. Just open the Developers tools, click on the wheel bottom-right corner to see the Override options. It's interesting also disabling the Cache (in general options)
  • 8. Set up your Moodle Installation Enable debugging Disable all caches Enable WebServices in Advanced options Enable WebServices protocols (REST) Enable Mobile Services (in Plugins -> WebServices -> Services)
  • 9. Package an existing WebService local_custommm
  • 10. Configure the new service A service is a set of functions for an specific purpose. Since Moodle 2.1 there is a pre-built service for Moodle M. This service cannot be edited for adding new functions so we don't have a simple way for make available our new Web Service function to the mobile app. The only way for fix this is creating a new Service in Moodle, and configuring our app for pointing to this new service. There are two ways of creating a Service in Moodle: Using a db/services.php in your plugin as mentioned here: External services description Creating the service in your Moodle installation using the forms in Admin > Plugins > Web Services > External Services
  • 11. Configure the new service In this case we've created the service using the Moodle forms because it gives more flexibility in some aspects. There is a big impediment, due tohttps://tracker.moodle. org/browse/MDL-29807 in order to add a shortname for the new Service, we have to edit manually the Moodle database for adding the shortname in the dbprefix_external_services table
  • 12. Set up your MoodleMobile app Download the last version of the MoodleMobile source code from Edit the config.json file and change the wsservice parameter in order to point to the shortname of the Service you created before. You have to add also the name of the plugin you are developing at the final of the plugins parameter: "plugins" : ["notifications", "upload", "contents", "participants", "addcontact", "addnote", "sendmessage", "grades"], Notice that, for avoid errors, this last change should be done once the file plugins/grades/main.js file exists
  • 13. Develop the MoodleMobile plugin plugin/grades/lang/en.json - Contains the language strings plugin/grades/icon.png - The plugin icon plugin/grades/activities.html - The template for the activities list plugin/grades/activitygrade.html - The template for showing the grade plugin/grades/main.js - The plugin's main code
  • 14. Develop the MoodleMobile plugin (main.js)
  • 15. Develop the MoodleMobile plugin (main.js)
  • 16. Develop the MoodleMobile plugin (main.js)
  • 17. Develop the MoodleMobile plugin (main.js)
  • 18. Change the name an appearance Edit the config.xml to change the app name Replace all the icons found in the app Edit also the config.json file for additional changes Load a custom CSS from your plugin: $('head').append(''); MM.registerPlugin(plugin);
  • 19. Build your MoodleMobile rebranded app Use PhoneGap Build https: // Create a free account pointing to your github repository or upload a zip file with your app Sign the app using your Android and iOs certificates Publish your app in Google Play and Apple app Store
  • 20. Thanks for coming! You have more information here: