Skip to content

Commit

Permalink
Merge pull request #207 from Ubiquiti-App/feature/UNMS-to-UISP-docs
Browse files Browse the repository at this point in the history
UNMS to UISP rename docs
  • Loading branch information
keksa committed Oct 15, 2021
2 parents e70e58f + b5be51d commit 267d2fb
Show file tree
Hide file tree
Showing 3 changed files with 9 additions and 9 deletions.
8 changes: 4 additions & 4 deletions docs/file-structure.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,12 @@ This directory should be placed in the plugin's root, next to the `public.php` f
- https://github.com/Ubiquiti-App/UCRM-plugins/blob/master/plugins/invoice-csv-export/src/templates/form.php#L10

### public/admin-zone.js
*Available since UNMS 1.1.0-beta2.*
*Available since UISP 1.1.0-beta2.*

If this file exists, it will be automatically loaded on every admin zone page in CRM.

### public/client-zone.js
*Available since UNMS 1.1.0-beta2.*
*Available since UISP 1.1.0-beta2.*

If this file exists, it will be automatically loaded on every client zone page in CRM.

Expand Down Expand Up @@ -72,7 +72,7 @@ The configuration is automatically refreshed, when changes are made in UCRM sett
The following options are available:
- `ucrmPublicUrl` - URL under which UCRM is publicly accessible, this will be `null` if the `Server domain name` or `Server IP` options are not configured in UCRM.
- `ucrmLocalUrl` - URL under which UCRM is locally accessible. This should be used to call UCRM API to prevent issues with self-signed certificates. Available since UCRM 2.14.0-beta3.
- `unmsLocalUrl` - URL under which UNMS is locally accessible. This should be used to call UNMS API to prevent issues with self-signed certificates. Available since UNMS 1.0.0-beta.2.
- `unmsLocalUrl` - URL under which UISP (formerly UNMS) is locally accessible. This should be used to call UISP API to prevent issues with self-signed certificates. Available since UISP 1.0.0-beta.2.
- `pluginPublicUrl` - URL under which the `public.php` file is publicly accessible, this will be `null` if the plugin does not have `public.php` file or if the `Server domain name` or `Server IP` options are not configured in UCRM.
- `pluginAppKey` - An App key automatically generated for the plugin (with write permissions), which can be used to access UCRM API.
- `pluginId` - ID of the plugin in UCRM. Available since UCRM 2.15.0-beta6.
Expand All @@ -82,7 +82,7 @@ Example of the `ucrm.json` file:
{
"ucrmPublicUrl": "http://ucrm.example.com/",
"ucrmLocalUrl":"http://localhost/",
"unmsLocalUrl":"http://unms:8081/nms/",
"unmsLocalUrl":"http://uisp:8081/nms/",
"pluginPublicUrl": "http://ucrm.example.com/_plugin/dummy-plugin",
"pluginAppKey": "5YbpCSto7ffl/P/veJ/GK3U7K7zH6ZoHil7j5dorerSN8o+rlJJq6X/uFGZQF2WL",
"pluginId": 1
Expand Down
8 changes: 4 additions & 4 deletions docs/manifest.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,8 +122,8 @@ Contains information describing the plugin.
- `url` - link to the plugin page
- `version` - version of the plugin as displayed on CRM frontend
- `ucrmVersionCompliancy` - defines minimum and maximum version of UCRM this plugin supports, minimum must be always defined, maximum can be `null`
- `unmsVersionCompliancy` - works the same as `ucrmVersionCompliancy` and is required for plugins to work since UNMS 1.0 (integrated version)
- If you want to support both UCRM 2.x and UNMS 1.x, you can include both `ucrmVersionCompliancy` and `unmsVersionCompliancy` in your manifest. If you want to support only UNMS 1.0 (integrated version), do **not** include `ucrmVersionCompliancy` in your manifest.
- `unmsVersionCompliancy` - works the same as `ucrmVersionCompliancy` and is required for plugins to work since UISP 1.0 (formerly UNMS integrated version)
- If you want to support both UCRM 2.x and UISP 1.x, you can include both `ucrmVersionCompliancy` and `unmsVersionCompliancy` in your manifest. If you want to support only UISP 1.0 (integrated version), do **not** include `ucrmVersionCompliancy` in your manifest.
- `author` - author of the plugin as displayed on CRM frontend

### configuration
Expand Down Expand Up @@ -168,7 +168,7 @@ Contains an array of items. Each item is defined as follows:
*Note: The target pages should typically be protected to be available only to authorized clients or admins. Read [this](security.md) for details.*

### widgets
*Note: This feature is available since UNMS 1.0.0-beta7*
*Note: This feature is available since UISP (formerly UNMS) 1.0.0-beta7*

Adds iframe widgets showing the plugin's public page to specified positions.

Expand All @@ -187,7 +187,7 @@ Contains an array of items. Each item is defined as follows:
*Note: The target pages should typically be protected to be available only to authorized clients or admins. Read [this](security.md) for details.*

### paymentButton
*Note: This feature is available since UNMS 1.0.0-beta7*
*Note: This feature is available since UISP (formerly UNMS) 1.0.0-beta7*

Add payment button to one-time online payment page.
- `label` - required, label of the payment button <sup>[1]</sup>
Expand Down
2 changes: 1 addition & 1 deletion docs/security.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ The `public.php` file can be used to provide a customized public page or even mo

However you might want to restrict some or all of these pages to only be available to the admins of the UCRM installation and/or to the clients. Since the plugin is running on the same domain as UCRM itself, it will also receive the UCRM cookies. In this case you can use the `PHPSESSID` cookie to ask UCRM about the current session. This is done by calling the `/current-user` URL and forwarding the `PHPSESSID` cookie.

> *Note that, the URL and the required cookies changed in UNMS 1.0 (integrated version).*
> *Note that, the URL and the required cookies changed in UISP 1.0 (formerly UNMS integrated version).*
> The new URL is `/crm/current-user`.
> The required cookies are `nms-crm-php-session-id` and `nms-session`.
> You can use [UCRM Plugin SDK](https://github.com/Ubiquiti-App/UCRM-Plugin-SDK), which supports the new way since version 0.5.1.
Expand Down

0 comments on commit 267d2fb

Please sign in to comment.