devianl2/laravel-scorm

PEOPLEAPS scorm package

4.0.1 2022-09-29 03:37 UTC

Requires

• php: ^7.4 || ^8.0
• ext-dom: *
• ext-zip: *
• doctrine/common: ^3.1
• league/flysystem: ^2.0 || ^3.0
• nesbot/carbon: ^2.42

MIT

• Devian Leong

README

Design for Laravel LMS

Laravel Scorm Handler is a laravel package that simplify scorm package contents (zip file) into laravel storage.

Highlight of this package:

• Zipfile handler with auto extract and store sco into database
• Store user CMI data into database
• Get user last learning data

Things you must know before you install:

1. You have a domain/subdomain to serve scorm content
2. Scorm content folder/path must be outside from laravel application (Security issue).
3. Virtual host to point domain/subdomain to scorm content directory (E.g: /scorm/hashed_folder_name/)
4. Uploaded file should have the right permission to extract scorm files into scorm content directory
5. This package will handle folder creation into scorm content directory (E.g: /scorm/{auto_generated_hashname}/imsmanifest.xml)

Step 1:

Install from composer (For flysystem v1)

composer require devianl2/laravel-scorm:"^3.0"

Install from composer (For flysystem v2/v3)

composer require devianl2/laravel-scorm

Step 2:

Run vendor publish for migration and config file

php artisan vendor:publish --provider="Peopleaps\Scorm\ScormServiceProvider"

Step 3:

Run config cache for update cached configuration

php artisan config:cache

Step 4:

Migrate file to database

php artisan migrate

Step 5 (Optional):

Update SCORM config under config/scorm

• update scorm table names.
• update SCORM disk and configure disk @see config/filesystems.php

    'disk'  =>  'scorm-local',
    'disk'  =>  'scorm-s3',

 // @see config/filesystems.php
     'disks' => [
         .....
         'scorm-local' => [
            'driver'     => 'local',
            'root'       =>  env('SCORM_ROOT_DIR'), // set root dir
            'visibility' => 'public',
        ],

        's3-scorm' => [
            'driver' => 's3',
            'root'   => env('SCORM_ROOT_DIR'), // set root dir
            'key'    => env('AWS_ACCESS_KEY_ID'),
            'secret' => env('AWS_SECRET_ACCESS_KEY'),
            'region' => env('AWS_DEFAULT_REGION'),
            'bucket' => env('AWS_SCORM_BUCKET'),
        ],
        .....
     ]

Update SCORM translations under resources/lang/en-US/scorm.php

• SCORM runtime errors exceptions handler, (Check next example)
• Copy and translate error msg with key for other locale as you wish.

After finishing don't forget to run php artisan config:cache

Step 6 (Optional):

Usage

class ScormController extends BaseController
{
    /** @var ScormManager $scormManager */
    private $scormManager;
    /**
     * ScormController constructor.
     * @param ScormManager $scormManager
     */
    public function __construct(ScormManager $scormManager)
    {
        $this->scormManager = $scormManager;
    }

    public function show($id)
    {
        $item = ScormModel::with('scos')->findOrFail($id);
        // response helper function from base controller reponse json.
        return $this->respond($item);
    }

    public function store(ScormRequest $request)
    {
        try {
            $scorm = $this->scormManager->uploadScormArchive($request->file('file'));
            // handle scorm runtime error msg
        } catch (InvalidScormArchiveException | StorageNotFoundException $ex) {
            return $this->respondCouldNotCreateResource(trans('scorm.' .  $ex->getMessage()));
        }

        // response helper function from base controller reponse json.
        return $this->respond(ScormModel::with('scos')->whereUuid($scorm['uuid'])->first());
    }

    public function saveProgress(Request $request)
    {
        // TODO save user progress...
    }
}

Upgrade from version 2 to 3: Update your Scorm table:

• Add entry_url (varchar 191 / nullable)
• Change hash_name to title
• Remove origin_file_mime field

Upgrade from version 3 to 4: Update your Scorm table:

• Add identifier (varchar 191)