{eac}SoftwareRegistry Software Taxonomy is an extension plugin to {eac}SoftwareRegistry Software Registration Server.

{eac}SoftwareRegistry Software Taxonomy is a simple plugin extension that allows you to set and override {eac}SoftwareRegistry options for specific software products. It both defines the software product as well as the server parameters used when that product is registered via the software registration application program interface.

When an API request is received by the registry server, the registry_product is matched to the software taxonomy slug. When a match is found, the parameters entered in the software taxonomy meta data are used to override the registry server default parameters.

Options set on a per-product basis by this extension

• Software Product

  • Registry Title - The Software Product display name
  • Registry Description - The Software Product Description

• Registrar Contact

  • Registrar Name - Sending client email from this name
  • Registrar Telephone - Include telephone in client notifications
  • Registrar Support Email - Include support email address in client notifications
  • Registrar Web Address - Include web address in client notifications

• Registration Defaults

  • Default Status - The default status to assign to newly created registrations
  • Default Initial Term - The initial term when creating a new registration (pending or trial)
  • Default Full Term - The full term when activating a registration
  • Default License - The default license level (L1-L5, LD) to assign to newly created registrations

• Client Notification

  • Client Email Message - Message sent to client on creation, activation or update of registration.
  • Client API Message - Short message included with all API responses.
  • Client Success Notice - Success notification sent via API response.
  • Client Error Notice - Error notification sent via API response.

• License Limitations

The Registrar Contact and Registration Defaults options override existing global options in {eac}SoftwareRegistry.

Client Notification

Customize the email message and API response notifications sent to the client.

License Limitations

Based on the license level assigned to a registration, we can limit the optional values in the registration API (count, variations, options, domains & sites). This allows APIs (possibly from multiple sources) to register any/all values for these options while filtering on the registration server, providing an effective (albeit rudimentary) licensing validation.

For each license level ( L1=Lite, L2=Basic, L3=Standard, L4=Professional, L5=Enterprise, LD=Developer ) you may set a limit for count, variations, options, domains, and sites.

• count - Number of licenses (users/seats/devices)
• variations - List of custom name/value pairs
• options - List of custom registry options
• domains - List of valid/registered domains
• sites - List of valid/registered sites/uris

For count, the value passed through the API is limited to a maximum value. For variations, options, domains, and sites, the arrays passed through the API are sliced to a maximum number of elements.

{eac}SoftwareRegistry Software Taxonomy is an extension plugin to and requires installation and registration of {eac}SoftwareRegistry.

Automatic Plugin Installation

This plugin is available from the WordPress Plugin Repository and can be installed from the WordPress Dashboard » Plugins » Add New page. Search for 'EarthAsylum', click the plugin's [Install] button and, once installed, click [Activate].

See Managing Plugins -> Automatic Plugin Installation

Upload via WordPress Dashboard

Installation of this plugin can be managed from the WordPress Dashboard » Plugins » Add New page. Click the [Upload Plugin] button, then select the eacsoftwareregistry-software-taxonomy.zip file from your computer.

See Managing Plugins -> Upload via WordPress Admin

Manual Plugin Installation

You can install the plugin manually by extracting the eacsoftwareregistry-software-taxonomy.zip file and uploading the 'eacsoftwareregistry-software-taxonomy' folder to the 'wp-content/plugins' folder on your WordPress server.

See Managing Plugins -> Manual Plugin Installation

Settings

Taxonomy settings available from this extension will be seen in the Software Registry → Software Products menu.

1. Software Registry → Software Products

2. Software Registry → Software Products → {product} → Registrar Contact

3. Software Registry → Software Products → {product} → Registration Defaults

4. Software Registry → Software Products → {product} → Client Notification

5. Software Registry → Software Products → {product} → License Limitations

See Also

• {eac}SoftwareRegistry – Software Registration Server

• Implementing the Software Registry SDK

Copyright © 2019-2023, EarthAsylum Consulting, distributed under the terms of the GNU GPL.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should receive a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Version 1.1.1 – October 31, 2023

• Prevent direct load of include files.

Version 1.1.0 – May 9, 2023

• Added client notification messages.
• Reformatted license limitations tab.
• Added contextual help.

Version 1.0.0 – April 11, 2023

• Initial release.

Requires {eac}SoftwareRegistry version 1.3+