This product is tightly coupled with the Escola LMS ecosystem and is not compatible with any other Laravel application.
Proof of concept demo is available at https://h5p-laravel-demo.stage.etd24.pl/.
All of the features are available thought REST API, there are no blade templates of using server side rendering H5PIntegration global js variable, this is a different approach then moodle, drupal and wordpress h5p plugins.
This package does provide only REST API access endpoints, this is so far only package that allows to render h5p headlessly.
The features includes:
- play all h5p content - exposed all essential data, yet player is needed
- edit all h5p content - exposed all essential data, yet editor is needed
- CRUD libraries
- CRUD content
- upload library from
.h5pfile - upload content from
.h5pfile - all the other h5p features like export etc
See Swagger documented endpoints.
Some tests can also be a great point of start.
To play the content you can use EscolaLMS H5P Player
Demo React source files, are great starting point for frontend tutorial
composer require escolalms/headless-h5pphp artisan migratephp artisan h5p:storage-linksee belowphp artisan db:seed --class="EscolaLms\HeadlessH5P\Database\Seeders\PermissionTableSeeder"see below
You need to publish many of files to be available as public link.
php artisan h5p:storage-link which creates a symbolic link from storage/app/h5 and vendor/h5p/h5p-core and vendor/h5p/h5p-editor to be accessible to public, as follows
public_path('h5p') => storage_path('app/h5p'),
public_path('h5p-core') => base_path().'vendor/h5p/h5p-core',
public_path('h5p-editor') => base_path().'vendor/h5p/h5p-editor',
All the endpoints need to be accessible from other domains, so CORS must be properly set.
Except of endpoints assets must expose CORS headers as well. You achieve that by setting Apache/Nginx/Caddy/Whatever settings - below is example for Nginx for wildcard global access.
location ~* \.(eot|ttf|woff|woff2|jpg|jpeg|gif|png|wav|mp3|mp4|mov|ogg|webv)$ {
add_header Access-Control-Allow-Origin *;
}
Most of the endpoints require authorization, this is possible with Laravel passport
There is a seeder to must be run in order to authorize
User model is taken from Auth package.
To seed content and library
php artisan db:seed --class="\EscolaLms\HeadlessH5P\Database\Seeders\ContentLibrarySeeder"
You can seed library and content with build-in seeders as command that are accessible with
php artisan h5p:seedto add just librariesphp artisan h5p:seed --addContentto add content with libraries
- rewrite h5p core in a way like luminare in typescript
run ./test.sh