(Paid) Nextcloud Module

[Aleksa ᵘ̶ⁿ̶ˢ̶ᵉ̶ᵉ̶ⁿ]

Nextcloud

Simple Nextcloud Provisioning Module

---------------------------------------

Links:
More Info, Gallery & Readme: https://code-cats.com/blesta/nextcloud/
Purchase: https://my.code-cats.com/order/config/index/blesta_plugins/?group_id=16&pricing_id=165
Download (After purchase, requires login): https://my.code-cats.com/plugin/download_manager/client_main/index/4/

---------------------------------------

Install the Module

1. Upload the source code to a /components/modules/nextcloud/ directory within
your Blesta installation path.

    For example:

/var/www/html/blesta/components/modules/nextcloud/

2. Log in to your admin Blesta account and navigate to
> Settings > Modules

3. Find the Nextcloud module and click the "Install" button to install it

4. You're done! Only thing left is to configure it properly.

---------------------------------------

Setting up

Simple Nextcloud provisioning in Blesta, easy to use.

Important note:
This module is intended for provisioning to one Nextcloud server, thus, "Server Groups" might be buggy.
Inside of the "Package", make sure you select "Any" "Server Group" and then select one server you want to deploy to.

If you have multiple servers, for example in different locations, recommended approach is to make a package for each location and let users pick which one they need.

Creating a Server:
- Go to /admin/settings/company/modules/installed/ and click "Manage" on the "Nextcloud" module
- Click "Add Server" in the top right
- Fill out required information
  - Label - This is what you'll see the server named as in the admin panel, name it however you want
  - Hostname - Full URL to your instance, including http(s)://, for example, https://cloud.mycompany.com
  - API Username - Username to your API, read "Quick Support" bellow to learn how to find it
  - API Password - Password to your API, read "Quick Support" bellow to learn how to find it, its in the format xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
  - Capacity - Feature of this module, if you'd like to limit or prevent overallocation, you can set this value to the amount, in GB, that you want deployed to this server. If this amount is exceeded, new orders will be rejected until there's more space on the server. Set to 0 to disable this feature
 
Configurable Options:
If you'd like to make "Storage Amount" configurable by users instead of per-package, you can use "Configurable Options" to achieve this.

Quick guide (Assumes you know how to create a Configurable Option, Group and assign it to a package)
- Create a Configurable Option
- "Name" MUST be storage_quota
- Under "Options", "Value" should be a number of GB that should be provisioned

---------------------------------------

Quick Support
Where are my API Username and Password?

- Login to your Nextcloud with an admin account
- Go to /settings/user/security
- Under "Devices & sessions", enter your desired "App name" and click "Create new app password"
- Two fields, "Username" and "Password", will pop up, those are your "API Username" and "API Password" required for the module.
  - IMPORTANT: Once you click "Done", you won't be able to see this password again, so make sure you save it somewhere!

---------------------------------------

Images: