Here you add a new product to the system and define encoding preferences. Your project within the Source Guardian GUI should be setup to use a license file within the "Lock" tab. A good understanding of the Source Guardian system is required,
so you are recommended to read their documentation first. Note that this software is currently based
on the Source Guardian version on the software info page.
Your product can optionally
check for constants as defined in Maian Guardian. For a more advanced overview of Source Guardian, click here.
Please read below carefully. The Help & Info links provide additional information. Note that the doc links reference the Windows GUI, but will be
the same options if you only use command line options.
Enter license project key as defined in your Source Guardian project settings via the "Advanced" tab.
Help & InfoLicense > Expire On / Expire In / Time Servers
If applicable, enter specific expiry date or duration after which license expires. For example, entering a specific date would mean the license would expire
on that date. Entering a duration, eg: 60 days, means the license would expire in 60 days from when it was created.
Note that time restrictions are not included in the license file as a timestamp. So, if you set an expiry to 1 hour, the license file will expire one hour from the time it is downloaded. If someone re-downloaded the file
it would again expire in 1 hour from the time of creation.
Help & InfoRestrictions > Server Encoding Preference
A drop down list of options is included for you to choose which restrictions are applicable. You can combine domain names
and ip addresses for better restrictions.
Note that the preset tags determine which boxes appear to visitors when creating licenses. For example, if you select a domain only restriction, this would display a box for a visitor to enter their domain name, but not
IP or MAC address etc
To validate user input for server restrictions, see the 'Input Validation' section.
Restrictions > Editable Fields
Can user edit domain / ip / mac fields? If checked, a user will be able to edit the information when logged into their Maian Guardian account area. Alternatively you can
use the remote API and offer an update option within your own application.
If you wish you can have custom text appear in your license file. Custom text appears exactly as is in the file.
You can have as many custom text strings as you need, but each will be separated with two pipes as Source Guardian doesn't support line breaks. To add custom text strings, enter preferred text and use the button to add more fields and the buttons remove fields. Tags are also available to auto parse certain data. To view
available tags click the button.
For an example of a license file with custom text strings, click here.
To change the two pipe delimiter, edit the $ctdelimiter variable in the 'control/classes/class.licensing.php' file.
Custom defined constants are a powerful feature when using a licensed based setup. This feature might be used to customise product behaviour based on information read from
the license file. For example, you may require a visitor to enter a product key or other constant information that unlocks certain features of your product.
You can specify as many constant key/value pairs as you need. Use the button to add constant lines and the to remove them.
The value of the constant can be a static value OR a value entered by your visitor via the "Field" selection (see below). Note that constant keys should contain alphanumeric characters ONLY
and no spaces.
To validate user input for server restrictions, see the 'Input Validation' section.
Constants > Field
This option lets you specify a constant that requires a user to enter a value. For example, a product key or unique product identifier to unlock a license. In this case, in the "value" field you enter a suitable instruction for your
users. For example, "Please enter product key", etc. Example screenshots showing entered value and how it would look to a user:
Constants > Editable
If field type is set to "yes", can user re-edit field? In some cases you may not want users to be able to edit
certain values they have entered. If this is set to "no", then editing is only available from an admin member. If you are using the remote API, you
should take care of edits within your own application and update remotely. This will enable you to update the license file within you own
application.