Installation

Install the plugin, complete the Moodle upgrade, and verify the services it relies on.

Before you start

Confirm that the Moodle site meets the version requirements, has a working cron process, and can reach the configured license API when automatic API mode will be used.

Moodle Marketplace

Download the Lenarys Analytics package published for your Moodle release.

GitHub

Review source code and releases in the Lenarys Analytics repository.

Back up first. Follow your normal Moodle change process and back up the database and application files before installing or upgrading any production plugin.

Install the plugin

Download the plugin from one of the Lenarys Analytics sources above and select the release identified for your Moodle version.

Place the files
Copy the plugin directory to local/la in the Moodle application.
Run the Moodle upgrade
Visit Site administration → Notifications, or run the CLI command below from the Moodle root.

Shell

php admin/cli/upgrade.php

Allow Moodle to create the tables
The install process creates report, app, schedule, audience, AI history, audit, and learning-time storage.
Purge caches if required
Use Site administration → Development → Purge caches when new navigation or JavaScript is not visible.

Initial configuration

Open Site administration → Plugins → Local plugins → Lenarys Analytics and set the following first:

Setting	Recommended first value	Why it matters
Appearance	System	Matches the user’s Moodle/browser preference.
Billing Admin	A named site administrator	Owns catalogue approvals, audiences, licensing, and subscription review.
API mode	Automatic API sync	Uses the configured endpoint for license and report/app catalogue updates.
Debug	Disabled	Avoids exposing or persisting technical detail in production.
Learning-time tracking	Disabled until reviewed	Tracking stores personal activity signals and should follow local policy.

Verify the installation

Open Reports → Lenarys Analytics → Get started.
Confirm the Preferences page shows the intended API mode and license state.
Open the Library and confirm Reports and Apps load.
As the Billing Admin, confirm the Library’s Marketplace tab is available.
Run cron and confirm scheduled tasks complete without Lenarys Analytics errors.

Shell

php admin/cli/cron.php

Upgrade safely

Replace the plugin files with the new release, run Moodle’s upgrade process, purge caches, and smoke-test one report, one app, one schedule, and license refresh. Do not overwrite config.php customizations without reconciling them against the new release.

Was this page helpful?

Your feedback is stored in this browser.