Adding a SurveyMonkey survey to your Open edX course

Using third party tools in Open edX is a great way to extend the platform's capabilities. One of the common tools is SurveyMonkey for its ability to securely gather student data that's easy to access later. Here's how to embed one such survey in your Open edX course. In this article we're going to assume that you have a SurveyMonkey account already, with a survey that you want to embed.

  1. From SurveyMonkey, go to the Collect Responses step of the survey you want to add to your course. It looks like this: 
    Collect responses located in the middle top part of the screen
  2. If you don't have a web link, click the Add New Collector dropdown and choose Web Link Collector
     web link collector is the first option under the dropdown
     If you already have a Web Link collector, you can just click on it from your list of Survey Collectors
  3. On the web link page, click Copy next to your web link 
    click the green copy button to copy your web link url
  4. Now go over to Open edX Studio
  5. Navigate to the unit where you want to add your survey
  6. Click the green HTML button and choose IFrame Tool
     
    html button is the center of the five green component buttons
    iframe tool is the third item from the bottom
  7. Click Edit
     the edit icon is in the upper right represented by the pencil icon
  8. Click HTML
     The HTML button is found in the toolbar of the editing window
  9. This is where things can get a little scary if you're not familiar with HTML, but it's really not that bad. Just scroll down to line 25 where you see: "<p>The sample IFrame follows. Modify its attributes as described above.</p>" This last bit is all we're concerned with. You can delete everything that precedes it. Your code should look like this now: 
  10. Add the title of your survey between the quotes where you see "Euler Line Demo"
     iframe title="example post course survey"
  11. Next, highlight the url between quotes after src="..." and paste in the web link collector of your survey.
     src="https://studio.edx.org..."
  12. Replacing the src attribute with the survey monkey URL
  13. Next, you'll want to do a bit of adjusting on the sizing/spacing attributes to make sure your survey looks good! First, change width="402" to width="100%" - this will make the survey occupy the entire width of the page. Then change height="402" to height="768". This will give your survey some room to breath without being too big on small screens.

  14. Click OK at the bottom of the HTML window.
  15. You should now see your survey embedded into the component WYSIWYG editor. You might want to accompany your survey with some instruction text, so that your students know what to do.
     
  16. When you're finished editing click Save 

  17. When you're ready don't forget to click Publish to push your changes live to the LMS. 
  18. That's it! 

NOTE: It's always a good idea to check to make sure your survey looks good in the LMS, and make any changes that you feel are necessary to the width and height. Remember to check it out on mobile!