Using the H5P Documentation Tool
This guide is about using a H5P learning object. For instructions on how to find and create H5P Learning Objects in your space, please see Inserting H5P in VU Collaborate.
The Documentation Tool provides students with a clear structure for the development of a project. This tool can be used to help students with project management activities, to provide an example of how to write a document or to provide the steps required for the completion of written work. It creates assessment "wizards" that give students step-by-step writing instructions to help build interactive, goal-driven student activities. You can add multiple steps to the wizard, which the student will work through in sequence. For example, you could add a section where the student lists their goals, which leads to the next step with text fields to answer specific planning questions.
For each step presented in the documentation tool, it is possible to provide help to students on how to fill in the document by using the Read more option. Students can also assess themselves using the documentation tool. The tool provides a small quiz activity for the student to self-assess their achievements, helping them to reflect on their work, so they improve and perform better the next time.
This tool can help students write content in the structure required. Students can then export the document on to their own devices. This allows them to continue with the work in their own time, print it, or submit it for a final assessment.
Below are the steps to use the H5P documentation tool:
- Create a New Documentation Object
- Create Content in the Documentation Tool
- Create Additional Pages
- Preview and Publish the Documentation Tool
An example of the Documentation Tool:
1. In the Learning Space choose the module you want the H5P to be in, click on New then New Document.
2. In the Insert Stuff menu, click to open the H5P Learning Object.
3. In the H5P tool, click Add Content.
4. Type Documentation Tool in Search for Content Types. Then click Documentation Tool.
If you click on Details, a summary of the tool and an option for a demonstration will appear. You can click Content Demo to check more details. If you are satisfied with your tool selection, click Use.
4. Add a Title for the new object that will be easy to remember and find.
5. Add a Heading for the new object.
1. Start creating pages that will appear in the tool by selecting a type of page. There are four types to choose from: a Standard page, Goals page, Goals assessment page, and a Document Export page. You can make up your new documentation tool using any or all of these types, but we are going to start with the standard page.
Click the drop-down menu of Page type and select Standard page.
2. This will make your first page a Standard page. Enter a Title for the page that will help students understand its purpose.
3. Pick an Element type to start the new page. You can add multiple different types to each page.
- Text: Allows you to enter text that will be displayed to the user (like instructions or a subtitle).
- Text input field editor element: Allows you to create text fields for the student to enter their own text (for example, in response to a question).
- Image: Allows you to add an image of your choice into the page.
4. To add any text, image, or input field element to a page, click Add Element.
5. Enter more information under Label for help text for showing additional helpful information to the user.
6. Under Fill in additional help information, fill in additional information for the user, which will be available when clicked.
2.1 Add a Text element
1. From the Element type dropdown menu, select Text.
2. Enter the text you want the student to see at the start of the page. You can add links and headings using the editor.
You can leave the page with only this text, or add more elements by clicking Add Element.
2.2 Add a Text editor field input element
This element allows students to enter their own text into the tool.
1. Select Text editor field input element from the Element type dropdown menu.
2. Write a task Description of input field so that the student understands what to write in the field.
3. Generate some Placeholder text as an example for the student of what to write in the field. This can help you make it even clearer what this particular field is intended for.
4. Under Maximum text length, enter the maximum number of characters for the text.
5. Under the Input field size section, select a number of lines that the student can enter in this field. If it's a simple item like the project title, you might want to leave it at the default 1 line -- but if it's a project summary, you can use up to 10 lines to give the student plenty of space.
6. Use the Required field tickbox to determine whether this field is mandatory. The student won't be able to export their answers unless they have filled out all of the required fields.
2.3 Add an Image element
You can add images to illustrate your page's purpose and tasks or remind students of useful visual information associated with the project.
1. Select Image from the Element type dropdown menu.
2. Click Add to browse for an image to upload from your desktop.
3. Enter some Alternative text for the image. This helps if the image can't be loaded and for visually impaired students to understand the image.
4. Add some Hover text that will appear when the viewer puts their mouse over the image. This is optional but can be used to add some more context.
You can add more images or other content types to the page, or move on to the next type to create new kinds of pages.
The final version of the documentation tool will usually have a few different pages depending on what you want to achieve. There are four page content types: Standard pages are fully customizable and covered above; Goals pages help students track their aims and progress; Goals assessment pages allow students to rate their progress and self-assess their learning; and a Document Export page at the end of the tool allows students to download their entries as a document and work on it further.
1. Click Add Page to create a new page.
2. In the Page type dropdown menu, select your desired page type.
3.1 Goals pages
1. Select Goals Pages from the dropdown menu of Page type.
2. Edit Title and Description to tailor the tool to your students.
2. You can edit under Define Goal Link Text (what the student will click to make a new goal), Label for a user-defined goal that the student creates and Define goal placeholder indicating what kind of phrasing should go into the field to help students understand what to write.
3. A standard set of options will be available to the student as they go through the necessary steps to create their goals. You can customise the text on any of the buttons that will appear to them on their Goals page, but remember to keep it simple.
Now the page is set up and ready for students to interact with.
3.2 Goals assessment pages
Goals assessment pages work in conjunction with Goals pages to let students self-assess.
1. Select Goals assessment Pages from the dropdown menu of Page type.
1. Edit Title and Description to tailor the tool to your students.
2. Students can rate their goals Low, Medium or High. If no goals have been entered yet, No goals text will be displayed. You can customise any of these options, or leave them as they are.
Goals assessment pages will not work if a Goals page has not been added to the documentation tool.
When you're finished adding your additional help information (where applicable), the page is set up and ready.
3.3 Document Export pages
The Document Export page usually sits at the end of the tool and lets students download their work.
1. Edit the Description text to suit your coursework and customise your Create document button label. The H5P object will automatically generate these for you, and customising them is optional.
2. As on the Goals and Goals assessment pages, there are a set of button labels you can edit or leave as preset. When you're happy with these, make sure all your pages are in the right order, and the activity should be complete.
The document export page should be positioned at the end of the tool so that students have access to all of their work.
3. Click Save to finish the editor and finish creating the object. You can come back and Edit it at any time.
At the bottom of the screen you can adjust your H5P's settings (you can leave these settings by default or make alterations):
1 - Display options: (previously 'Display and copyright buttons') What options do you want to be visible for the user, for example, you can allow users to download button to enable students/staff to download the H5P to their own computer. You can also tick the Display embed button, which allows the user to embed the H5P into their HTML editor in VU Collaborate for example.
2 - Folder: (previously 'My Content') All your content will be saved in one spot, within a root folder.
3 - Publish: This option allows you to make the H5P Unpublished (content cannot be inserted into VUC), Protected (content can be inserted into VUC) or Public (visible to the public using a content link and the content can be inserted into LMS and be embedded). Protected is the default setting and it is recommended to leave this setting as it is.
4 - Collaborators: (previously 'Authors') In this setting you can add and search for other collaborators and give them access to edit your H5P's. For example, if you are teaching a unit with another staff member and you would like them to have access to edit your H5P's, then you can use the search field to locate another staff member by typing in their full name.
5 - Sharing: (previously called 'Select value') This is where you share your H5P with others, so they can view and clone your content. There is a folder allocated for each college, for example, 'Arts and Education', select your College.
To know more about Sharing and Collaborators, please see H5P Sharing and Collaboration.
6 - Send Score to LMS: (previously 'Send to Gradebook') In this section you can link your H5P directly to VU Collaborate and also link it to your grade book. It is recommended to leave this setting as it is, and NOT send the results to the grade book.
1. Click Save and Insert. A preview of the H5P object will appear.
2. The H5P object is now ready to add to your space. Click Insert to add the interactive video to the document.
3. Alternatively, you can click Save.
4. Then click Insert.
Contact ITS Service Desk on (03) 9919 2777 or via self-service http://servicedesk.vu.edu.au for further technical support.