Laravel Scorm Handler (DISCONTINUE)

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)