Overview
To help you manage your distributors, we have provided you a table that will help you with this. You can find this table at Enwikuna License Manager > Distributors > Overview. Within the table there are several functions available, which we would like to explain in the next sections.
The distributors table has several columns, each of which contains the details of the distributors. The following columns are available:
| Column | Description |
|---|---|
| User | This column contains the user that should act as a distributor. The user must first be registered inside WordPress. |
| Label | This column contains the label of a distributor. This can, for example, be the name of a store of the distributor if he owns several stores and you want to create a distributor with the same user for each store. |
| Generator | This column contains the optional generator of a distributor, which is used to generate the licences when the associated distributor codes are redeemed. If no generator is set, the generator of the product is used by default. |
| Codes | This column shows how many distributor codes a distributor has and how many have already been redeemed. Click on the column to display all codes of a distributor. |
| Status | This column shows the current status of a distributor. |
| Created | This column shows when and by whom a distributor was created. |
| Updated | This column shows when and by whom a distributor was last updated. |
| Internal note | This column shows whether an internal note has been stored for a distributor. Move the mouse over the icon to read the note. |
Filter, Search & Sort
In order to make the administration of the distributors as simple as possible for you, we have built in various functions:
Filter
You will find a selection of filters above the table at the right of the bulk actions, which can help you to filter distributors according to corresponding filter criteria.
Filter by status
If you want to display distributors in a particular status, you can click on the status between the table and the header. All distributors with exactly this status will now be displayed.
Search
If you want to find an explicit distributor inside the table, you can also use the search. Simply enter the name, email address or ID of the assigned user and start the search by pressing the button. You will now see exactly the distributors you were looking for (if they exist).
Sort
In addition to the filters, it is possible to sort the entries within the table. To do so, click on the blue highlighted headings of the columns. You can sort either ascending or descending.
Distributor actions
Each distributor within the table has actions that allow you to modify the distributor. To do this, move the mouse over a distributor entry inside the table. You will notice that an additional section becomes visible under the user. Here you will find various information and entries:
ID
Probably the most important information is the ID that the distributor has. Under this ID, the distributor is stored within the database. An ID is always unique and can never exist twice.
View / Edit
The first and most important action is to view or edit a distributor. Click on the action to go to the view or edit page of a distributor. You can read how to edit an existing distributor below.
Lock
You can lock a distributor using the Lock action. This has the effect that any interaction with the distributor is prohibited for the customer. This also applies to the redemption of distributor codes.
Unlock
You can unlock a locked distributor using the Unlock action. The customer can now interact again with the distributor.
Delete
You can delete the distributor using the Delete action.
Add a new distributor
If you want to add a new distributor, you can do it easily. To do this, click the Add button under Enwikuna License Manager > Distributors > Overview.
A page will then open where you can define some settings:
User
Select here the user that should act as a distributor. The user must first be registered inside WordPress.
Label
Define here an optional label for the distributor. This can, for example, be the name of a store of the distributor if he owns several stores and you want to create a distributor with the same user for each store.
Generator
Select an optional generator here which should be assigned to the distributor and used to generate the licences when redeeming associated distributor codes. If no generator is defined, the generator from the product of a distributor code is used by default.
Status
Select the status you want the distributor to have. By default, it has the status Inactive.
Internal note
Write an internal note in here, which should be added to the distributor.
Finally, save the distributor by clicking the corresponding button.
View / edit an existing distributor
If you want to view or edit an existing distributor, you can do this easily. To do this, move the mouse over a distributor entry in the table and then click View / Edit.
A page will then open where you can view and edit the settings of a distributor:
ID
The ID under which the distributor was stored within the database.
User
The user who should act as a distributor. This cannot be changed once it has been created.
Label
Define here an optional label for the distributor. This can, for example, be the name of a store of the distributor if he owns several stores and you want to create a distributor with the same user for each store.
Generator
Select an optional generator here which should be assigned to the distributor and used to generate the licences when redeeming associated distributor codes. If no generator is defined, the generator from the product of a distributor code is used by default.
Status
Select the status you want the distributor to have. By default, it has the status Inactive.
Internal note
Write an internal note in here, which should be added to the distributor.
Save the distributor afterwards via the corresponding button, if you have made changes.
Delete an existing distributor
If you want to delete an existing distributor, you can do this in three ways. Either via the bulk actions (we describe this procedure below), in the distributor itself, or via the Delete distributor action. To do this, move the mouse over a distributor entry in the table and then click Delete.
Bulk actions
In order to manage multiple distributors, we have provided some bulk actions. You can find them at the beginning and at the end of the table. Mark all entries which you want to address via a bulk action.
The following bulk actions are available:
Lock
Select the bulk action Lock if you want to lock all selected entries. This has the effect that any interaction with the distributor is prohibited for the customer. This also applies to the redemption of distributor codes.
Unlock
Select the bulk action Unlock if you want to unlock all selected entries. The customers can now interact again with the distributors.
Delete
Select the bulk action Delete if you want to delete all selected entries.
Finally, confirm the execution of the bulk action by clicking the corresponding button.
Import distributors
Click the Import button under Enwikuna License Manager > Distributors to import distributors. Please note that no distributor codes can be imported, as these are always page-bound!
This opens the Importer, which is responsible for importing distributors. Now select a CSV or TXT file containing distributors. Next, decide whether you want to update existing distributors or not.
You can also perform an advanced import by opening the advanced options. You can alternatively specify a path to a CSV or TXT file on your server instead of selecting the file locally. You can also change the delimiter if you want to use a different delimiter. By default, a , is used as a delimiter.
Finally, start the import process by clicking the corresponding button.
You will find a sample-data folder inside the Enwikuna License Manager Pro plugin folder. Inside this folder we have placed a sample file for you, which you can use as a template. Alternatively, you can of course create a distributor by hand and then export that distributor, which will give you your own template.
Export distributors
Click the Export button under Enwikuna License Manager > Distributors to export distributors. Please note that no distributor codes can be exported in this way. You can find out how to export distributor codes here.
This opens the Exporter, which is responsible for exporting distributors. Now select the data you want to export. By default, all distributor data will be exported.
Now, start the export by clicking on the corresponding button.
Your distributors should now be exported.