Contribute code (Pull requests) to existing H5P libraries
Thank you for considering to help improve existing H5P content types. In this guide you'll learn the recommended ways for you to efficiently improve H5P content types, by creating pull requests. By following this procedure, your pull request will be reviewed and merged in much quicker, and the chance of it being refused will be much lower.
A pull request is like a super valuable feature request. It is a feature request that contains a suggested solution. However it comes with the potential of not being accepted for one of two reasons:
- The maintainers of the code doesn't find the new feature useful enough. They might think that most people won't use it and it will complicate the code and the user interface.
- The maintainers don't like the suggested solution. I.e. they don't like the code in the pull request.
The H5P Core Team try to avoid that community members spend time working on code that doesn't gets accepted. To do this the Core Team urge community members to prequalify their pull requests by doing the following:
- First raise an issue on GitHub explaining what feature you want to add. Make sure you explain why the feature is needed and how you want to add it both technically, UX wise and accessibility wise. See the example below.
- A maintainer will reply to your issue. You might get a green light for your pull request. You might get suggestions on how you can make an even better pull request. You might also get a message that the feature won't be accepted, so you don't need to make a pull request.
- When you get a green light for the pull request it also comes with a promise that the maintainers will prioritize reviewing and merging in your pull request quickly.
Example issue
Let's say you want to make Interactive Video become able to show/hide interactions every tenth of a second instead of just every second. Your issue could look like this:
I want to prequalify a pull request related to the following:
User story:
As an author I want to be able to specify the times for when interactions appear and disappear with greater precision so that I can sync them better with events in the video.
With today's functionality I often find that I have to compromise and either show the interaction a bit too late or a bit too early.
UX:
Description and placeholder texts related to start and stop points for interactions will be updated to reflect that they allow tents of seconds precision.
Accessibility:
Not relevant
Technical solution:
I plan to rewrite the toggle interactions logic so that it will have a list of the next hide/show events ordered so that the next event comes first given that the user doesn't skip in the video, only plays and pauses. For every tenth of a second the list will be inspected to see if the time for the next event has passed. It will also detect if the user has skipped in the video by comparing the video time with the previous video time.
If the user somehow skips in the video the current brute force methodology will be used to toggle visibility of items, and the list of the next events for normal play/pause movement will be updated given that the user isn't currently actively seeking in the video.
Comments
ecevid
Sat, 09/23/2017 - 09:36
Permalink
quiz type
Hello super team
I'm glad to know this kind of company you are the best i want to say something improve your contents make more the best i send the message to this before you should make some new content like wordsearch game please keep it in mind the reason of my today's message i'm a tutor i'm giving some quizzes to my students in my website with help of your contect they are amazing ))) I make many quizzes with single choice or multiple choise types a small problem is making the answers as an order a),b),c),d) as you know many quizzes made by this my if you can add this option it will be great and also i want to ask something else can i let my students create their own quizzes contents etc without entering my admin bar in wordpress how can i let them create their contents as a user subscriber if so please let me know how to do that
your contents awesome you are the best team
best regards!
tim
Mon, 09/25/2017 - 09:31
Permalink
Hi, thanks for the very kind
Hi, thanks for the very kind message, ecevid. If I understand correctly, you would like a wordsearch game created?
Unfortunately, your students will have to create the content through the admin interface. You could put very strict settings for them and I'm sure they will learn quite quickly how to do it for themselves!
ecevid
Mon, 09/25/2017 - 11:23
Permalink
wordsearch
hello dear Tim
yes i want wordsearch game making content exactly and also as i explained a little add ons with multiple choice option a,b,c,d
tim
Thu, 09/28/2017 - 09:33
Permalink
Hi Ece,could you make a
Hi Ece,
could you make a feature request in the feature request forum?
https://h5p.org/forum/16
NANCY_COLIN
Mon, 02/12/2018 - 06:37
Permalink
a good program
This program is very important in the transmission text
oktayes
Wed, 12/02/2020 - 08:49
Permalink
Please,
https://oktayes.h5p.com/content/1291148131001314367
I want to activate my page. Can you help me please?
BV52
Wed, 12/02/2020 - 18:06
Permalink
Hi oktayes,Please contact H5P
Hi oktayes,
Please contact H5P.com support directly. You check more details here.
-BV
Shawna Doherty
Wed, 05/11/2022 - 03:26
Permalink
Add Speak the Words Set Interaction to Interactive Video
Hi,
We'd like to provide the code to add the Speak the Words Set activity to the list of interaction possibilites for the Interactive Video activity. We could also add the code for the 360 Video and/or Find the Hotspots. This would be a great addition to develop speaking skills for learners. Could you confirm that this would be of interest for h5p if we provided the code for it? Thanks!
ComWriter
Tue, 09/03/2024 - 23:08
Permalink
Word press Plugin
Why can't I upload exisiting content into word press? The WP plugin only allows creating content from scratch. So if I have content on H5P.org or even H5P.com I cannot 'reuse' it on a WP site.
BV52
Wed, 09/04/2024 - 19:35
Permalink
Hi ComWriter,I'm not sure I
Hi ComWriter,
I'm not sure I completely understand what your mean. Do you mean you do not have the option to upload contents or are you getting an error message?
-BV