Customization

This page contains instructions on how to manage and add new custom buttons to the interface.

Overview

VoipNow allows you to customize the functionality of the web management interface with the help of custom buttons that are linked to specific URLs. To reach the Custom Buttons management page, go to Unified Communications in the left menu and click on the Custom Buttons icon under the Integrations area.

Add new custom button

To add a new button:

1. Click the Add Custom Button icon and define the Settings of the new button.

   Click here to expand the settings.

   Field	Description
   Code	Enter a unique reference code which will represent this button's key. Must be at least 3-character long. Objects with a unique reference code can be edited based upon this ID.
   Label	Enter the button tag and click it to access the specified location.
   Location	Choose the location of the new custom button using the radio buttons: Navigation panel - Gets displayed on the left panel, in the navigation panel. User's context - Gets displayed on the right panel, in the user's context.
   Default image for all skins	Displays the new custom button in all available skins using the default button icon. If you wish to load custom icons, deselect this checkbox and follow these instructions.
   Include service provider ID	Appends the ID of the currently selected service provider to the URL linked with the button.
   Include organization ID	Appends the ID of the currently selected organization to the URL linked with the button.
   Include user ID	Appends the ID of the currently selected user to the URL linked with the button.
   Include extension ID	Appends the ID of the currently selected extension to the URL linked with the button.
   Include extension internal number	Appends the internal number of the currently selected extension to the URL linked with the button.
   Include extension public number	Appends the public phone number of the currently selected extension to the URL linked with the button.
   Include charging plan	Appends the ID of the currently selected user to the URL linked with the button.
   Priority	Defines the order in which the custom buttons are displayed in the interface.
   URL	The URL that will open when you click this button.
   Tool tip	A short text describing the purpose of the button.
   Display method	Choose one of the two methods by selecting the appropriate radio button: Inheritance level or Account selection. The main difference between the Inheritance level and the Account selection methods lies in the visibility of the button. If you choose the first option, the button will only be visible to the specified level, without having to be available to all the other upper levels.
   Inheritance level	Specify the button visibility relative to the current account. e.g. A service provider account owner setting up a button inheritance level to 1, makes it available to it's subordinate organization accounts, but not to its user accounts.
   Display on account/extension	Specify the button visibility relative to the a certain account level. The button will be visualized by your selected account level and by its parent accounts. Service Provider - visible only in the service provider accounts context. Organization - visible only in the organization accounts context. User - visible only in the user accounts context.
   Also display on owner account	The button will be visible to its owner account and to the organization and user accounts. The Also display on owner account option is not available unless the Display method is b.
   Action	Specify if the URL will open in the current window or a new window using the radio buttons.

2. Define the Custom button expiration date. Specify when the custom button becomes invalid by deselecting the Unlimited checkbox and providing a date using the text box or the available calendar button.
3. Click OK to confirm settings and create button. Click Cancel to go back to the previous page without adding the button to the system.

Add custom image file

If you deselect the Default Image for All Skins icon, VoipNow will display additional controls:

1. Use the Browse button to locate a graphic file on your computer.

2. Select the checkbox corresponding to the skin where you want the icon to be used. If you want to use the same icon for all the VoipNow skins installed on the server, you need to select the All skins checkbox.

3. Use the +/- buttons to add icons for different skins at the same time. The maximum file size for an icon is 10 KB.

Enable or disable a button

VoipNow displays all custom buttons added to the system in the Custom Buttons table. To enable or disable a specific button, simply click on the S (Status) icon, which shows the status of the sound: for enabled for disabled

Search for a button

You can filter the Custom Buttons table by label:

1. Enter the label of the button in the text box at the top of the table.
2. Click the  Search button. The system will remember the search criteria when a new search is performed and even after the user logs out.

Remove a button

To remove a button:

1. Select the custom button from the table and click the Remove selected link on top of the table.
2. Select the Confirm removal checkbox and click OK. To return to the previous page without removing the button, click Cancel.