Installation Guide — MTS ownCloud Integration

Requirements

Before installing, ensure the following are in place:

Step 1 — Download the Package

Download the correct ZIP file for your license plan:

• MTS_ownCloud_Integration_x.x.x.zip — One-Time License
• MTS_ownCloud_Integration_Yearly_x.x.x.zip — Yearly License

Step 2 — Install via Module Loader

SuiteCRM v7

1. Log in as Administrator
2. Navigate to Admin → Module Loader
3. Click Choose File, select the downloaded ZIP
4. Click Upload, then Install
5. Accept the license agreement and proceed through the installer
6. Wait for the installation to complete — a Quick Repair & Rebuild runs automatically

SuiteCRM v8

1. Log in as Administrator
2. Navigate to Admin → Module Loader (under the Legacy Admin section)
3. Upload and install the same ZIP file as above
4. The Angular extension (remoteEntry.js) is automatically deployed to the extensions/ directory during installation

Note: After installing on v8, clear the browser cache and reload the page to ensure the Angular extension is loaded correctly.

Step 3 — Activate Your License

1. Go to Admin → MTS ownCloud Integration → License
2. Enter your license key received at purchase
3. Click Activate
4. A green confirmation message confirms successful activation

If activation fails, ensure the SuiteCRM server has outbound HTTPS access to the license validation endpoint.

Step 4 — Configure the ownCloud Connection

1. Go to Admin → MTS ownCloud Integration → Connector Settings
2. Fill in the following fields:

3. Click Test Connection — the WebDAV indicator should show green
4. Click Save

Step 5 — Enable Modules

1. Go to Admin → MTS ownCloud Integration → Enable Modules
2. Select the modules you want to integrate with ownCloud (e.g. Accounts, Contacts, Opportunities)
3. Click Save

The system will automatically: - Add the ownCloud Files subpanel to each enabled module's detail view - Add the upload widget tab to the detail view on SuiteCRM v8 - Run a Quick Repair & Rebuild

Step 6 — Verify Installation

1. Open any record in an enabled module (e.g. an Account)
2. Scroll to the ownCloud Files subpanel — it should be visible
3. On SuiteCRM v8, open the ownCloud tab in the detail view — the drag-and-drop upload widget should appear
4. Upload a test file and confirm it appears in the subpanel and in your ownCloud folder

Uninstallation

1. Navigate to Admin → Module Loader → Installed Packages
2. Find MTS ownCloud Integration and click Uninstall
3. Choose whether to remove database tables when prompted
4. Run Admin → Repair → Quick Repair & Rebuild after uninstallation

Uninstalling removes the PHP modules and extension files but does not delete files already uploaded to ownCloud.