MokoConsulting/MokoSuiteStorage
1
0
Fork 0
Code Issues 9 Pull Requests Packages Projects Releases 1 Wiki Activity
Page: Installation
Pages Search wiki Recent changes t Print view Export wiki (ZIP)
Architecture Changelog Configuration Database-Schema Home Installation
Clone
1
Installation
Jonathan Miller edited this page 2026-06-29 16:34:15 +00:00
Contents
Table of Contents

Installation

Requirements

  • Joomla 6.x
  • PHP 8.3 or higher
  • MySQL 8.0+ or MariaDB 10.4+
  • MokoSuiteCRM installed (provides contact records for tenants)
  • MokoSuiteERP installed (provides GL integration for payments)

Installing via Joomla Installer

  1. Download pkg_mokosuitestorage.zip from the MokoGitea release page
  2. In Joomla Administrator, navigate to System > Install > Extensions
  3. Upload the package ZIP file
  4. Joomla will install all three extensions in order:
    • plg_system_mokosuitestorage — creates all database tables
    • com_mokosuitestorage — installs the admin component
    • plg_webservices_mokosuitestorage — registers API routes

Package Structure

pkg_mokosuitestorage.zip
├── pkg_mokosuitestorage.xml          # Package manifest
├── script.php                        # Install/update script
├── plg_system_mokosuitestorage.zip   # System plugin (schema owner)
├── com_mokosuitestorage.zip          # Admin component
└── plg_webservices_mokosuitestorage.zip  # API plugin

Post-Install Configuration

  1. Verify Plugin Status: Go to System > Plugins and confirm plg_system_mokosuitestorage is enabled
  2. Set Permissions: Go to Components > MokoSuite Storage > Options to configure access levels
  3. Configure Items Per Page: In component options, set the default pagination (default: 20)

Update Server

MokoSuiteStorage uses the MokoGitea update server. Updates are delivered automatically via:

https://git.mokoconsulting.tech/api/packages/MokoConsulting/generic/MokoSuiteStorage/latest/updates.xml

This is configured in the package manifest and requires no manual setup. Check for updates via System > Update > Extensions.

Uninstallation

Uninstalling the package will:

  1. Drop all #__mokosuitestorage_* tables (data will be lost)
  2. Remove all three extensions
  3. Child uninstall is blocked — you must uninstall the package, not individual extensions

Troubleshooting

  • Tables not created: Ensure the system plugin installed first. Check System > Plugins for plg_system_mokosuitestorage
  • Menu not visible: Verify you have core.manage permission for the component
  • API routes not working: Confirm plg_webservices_mokosuitestorage is enabled in the plugin manager
Pages