Installation

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

Printed from wiki · Installation