README

A comprehensive Laravel package for H5P interactive content with xAPI/LRS support.

✨ Features

• 📦 H5P Content Management (Create, Edit, Delete)
• 📚 Library Management
• 📊 Student Results Tracking
• 🔗 xAPI/LRS Integration
• 📈 Reports & Analytics
• 🎨 Tailwind CSS Admin Interface
• 🌍 Multi-language Support (EN, AR, FR)

📋 Requirements

• PHP 8.2+
• Laravel 11/12
• PostgreSQL/MySQL

🚀 Installation

1. Install via Composer

composer require djoudi/laravel-h5p

2. Run Installation Command

php artisan h5p:install

This will:

• Publish configuration files
• Run database migrations
• Create storage directories
• Link storage to public

3. Check Installation Status

php artisan h5p:status

⚙️ Configuration

Environment Variables

Add to your .env:

# H5P Settings
H5P_STORAGE_PATH=h5p

# LRS/xAPI Integration (Optional)
LRS_ENABLED=true
LRS_ENDPOINT=https://your-lrs.com/data/xAPI
LRS_USERNAME=your-key
LRS_PASSWORD=your-secret

📖 Available Commands

🔧 Usage

Admin Routes

Student Routes

Programmatic Usage

use Illuminate\Support\Facades\App;

// Get H5P instance
$h5p = App::make('LaravelH5p');

// Get content
$content = $h5p->get_content($id);

// Get embed code
$embed = $h5p->get_embed($content, $settings);

🔗 xAPI/LRS Integration

When LRS is enabled, student results are automatically sent to your LRS:

1. Set LRS_ENABLED=true in .env
2. Configure LRS credentials
3. Run queue worker: php artisan queue:work

📁 Directory Structure

storage/app/public/h5p/
├── content/      # H5P content files
├── libraries/    # H5P libraries
└── temp/         # Temporary files

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines.

📄 License

MIT License - see LICENSE file.