/
1.15.11 Configuration

1.15.11 Configuration

Owned by Former user (Deleted)
Last updated: Jan 18, 2017Version comment

Configuration files are stored in App_Config directory of web application, usually: C:\inetpub\wwwroot\VUP\App_Config. It's important to backup configuration file before any change. Every changes should be followed by restart of IIS service.

 
- AppSettings.config - general application settings.  This file should be edited only by VoipSwitch engineers. 

 

 AppSettings content

This file contains the pairs of keys and values defining general VUP configuration. 

<!-- MAIN SETTINGS -->
<add key="SiteMode" value="GENERIC"/> <!-- Possible values: RCS, GENERIC, PARTNER, WHOLESALE -->
<add key="SiteName" value="Vippie User Panel"/>
<add key="SiteUrl" value="https://www.ivippie.com"/>
<add key="StartupCulture" value=""/>
<add key="TermsAndConditionsUrl" value=""/>
<!-- MAIN SETTINGS -->


SiteMode - in most cases the mode is set to GENERIC, do not change it without prior consultation with voipswitch's support. GENERIC mode differs from the RCS mode in the way how the public/private IDs are handled. The WHOLESALE mode is very limited, the VUP works without any RCS services enabled. 

SiteName - website name, the title will be displayed on the browser's topbar.  

SiteUrl - address of the VUP, e.g. "https://yourdomain.com"
StartupCulture - ISO code of the default language, if the field is left empty the english language will be used
TermsAndConditionsUrl - the URL pointing to external terms and condition page. The link is shown on the sign up page. 

 

<!-- THEMES -->
<add key="DesktopTheme" value="Default"/>
<add key="MobileTheme" value="Default"/>
<!-- THEMES -->

DesktopTheme, MobileTheme - the name of the file with web css template, the files are located in Content/Themes/

 

<!-- DIALER ACTIVATION URLS -->
<add key="ActivationSucceededUrl" value=""/>
<add key="ActivationFailedUrl" value=""/>
<!-- DIALER ACTIVATION URLS -->

ActivationSucessedUrl, ActivationFailedUrl - you can define external URLs which will be opened when the activation via email process is completed. The flow is shown here 3.5.2 Username registration The URLs allow to replace the default pages which present an appropriate message on success or failure.

 

<!-- SIPML -->
<add key="OffNetPrefix" value="int" />
<add key="OnNetPrefix" value="" />

<add key="SipmlSipServerAddress" value=""/> <!-- voipswitch address, ex: sip.calltopbx.com -->
<add key="SipmlSipServerPort" value=""/> <!-- voipswitch port, ex: 5060 -->
<add key="SipmlWebsocketProxyUrl" value=""/> <!-- SIPml websocket URL, points at webrtc2sip server application -->
<add key="SipmlIceServers" value=""/> <!-- ICE configuration in JSON, ex: [{ url: 'stun:stun.l.google.com:19302'}] -->
<add key="SipmlRealm" value="VoipSwitch"/> <!-- SIPml realm -->
<add key="SipmlDebugLevel" value="info"/> <!-- SIPml debug level in browsers log, possible values: fatal (less details), error, warn, info (more details) -->
<add key="SipmlTpWebsocketProxyUrl" value=""/> <!-- SIPml websocket URL, points to a conference server application -->
<add key="SipmlTpHttpServerUrl" value=""/> <!-- SIPml HTTP server URL, for file uploads -->
<add key="SipmlTpIceServers" value="[]"/> <!-- ICE configuration in JSON, recommended: [] -->
<add key="SipmlTpRealm" value=""/> <!-- SIPml conference server realm -->
<add key="SipmlFullLogs" value="true"/> <!-- SIPml full logs -->
<!-- SIPML -->

OffNetPrefix - prefix which is added to every call made to offnet phone numbers. It allows to group the offnet calls in the routing plan on the SIP server side. 

OnNetPrefix - prefix which is added to calls made to onnet numbers, e.g. to other users.

The next properties of the SIPML section describe the SIP server details, web socket interface of the web to SIP gateway and ICE servers configuration. The keys with the SipmlTp prefix are used to connect to a conference server.


<!-- SERVICES URLS -->
<add key="VSServicesUrl" value="http://IP:PORT/VSServices/" />
<add key="OnlineShopUrl" value="http://IP:PORT/OnlineShop/" />
<add key="CallRecordingServiceUrl" value="http://IP:PORT/CrService/"/>
<!-- SERVICES URLS -->

VSServicesUrl - URL of the auxiliary web API providing SMS API (1.9.4 SMS API) and methods used for ordering/removing DIDs.

OnlineShopUrl - URL of the Onlineshop module 1.13 Onlineshop  used for top ups, mobile money transfer, vouchers, user to user transfer.

CallRecordingServiceURL - URL of the web application responsible for streaming recorded calls 


<!-- EMCI -->
<add key="RcsApiInternalUrl" value="http://10.1.1.1:80/"/>
<add key="RcsIdentifier" value="vippie" />
<add key="RcsName" value="Vippie" />
<!-- EMCI -->

The EMCI API provides set of methods related to the RCS services.


<!-- VOIPBOX -->
<add key="voipbox_storage" value="d:\voipbox\storage\" />
<add key="VoipBox_ListenerIP" value="10.0.1.6" />
<add key="VoipBox_ListenerPort" value="1803" />
<add key="VoipBox_PoolTime" value="30" />
<add key="VoipBox_DestinationFolder" value="d:\voipbox\storage\test" />
<!-- VOIPBOX -->

The Voipbox interface is required for playing voicemails and recording greetings.

 

<!-- MOBILE APPS URLS -->
<add key="IPhoneAppUrl" value="" />
<add key="BlackberryAppUrl" value="" />
<add key="SymbianAppUrl" value="" />
<add key="AndroidAppUrl" value="https://play.google.com/store/apps/details?id=com.voipswitch.vippie2" />
<add key="WindowsPhoneAppUrl" value="" />
<add key="WindowsCEAppUrl" value="" />
<!-- MOBILE APPS URLS -->

The URLs pointing to the RCS mobile clients, a user can download the mobile client by clicking a link in VUP.

 

<!-- OTHERS -->
<add key="DurationFormat" value="HMS" />
<add key="DoNotDisturbForDialersOffNetPrefix" value="" />
<add key="UseMobileTopUpUniversalProcess" value="false" />
<add key="Reseller" value="" /> <!-- Reseller login - into which user MUST be assigned to (in order to login) -->
<add key="GoogleTagManagerId" value="" />
<add key="VoucherCheckingDelay" value="3" /> <!-- in seconds -->
<add key="PinForAccessNumberLength" value="8" />
<!-- OTHERS -->

DurationFormat - time format for the duration of calls and recordings

<!-- WEBAPI -->
<add key="WebAPI" value="true"/>
<!-- WEBAPI -->

Enables the VUP's web API methods


 


- AutorechargeLowAmounts.config- allows to define account balance levels when customers can trigger automatic recharge.
- Database.config - Containing database connection settings.
 -Languages.config - Containing list of available languages

 

 Adding a new language
  • Download and install the Resx Editor software available at http://sourceforge.net/projects/resx/files/latest/download
  • Create a new language directory under the default languages location using 2 character county code according to the ISO 639-1 standard.

     

    C:\inetpub\wwwroot\VUP\App_GlobalResources
    eg.
    C:\inetpub\wwwroot\VUP\App_GlobalResources\es

  • Copy all the *.resx files from the default App_GlobalResources folder into the new language directory.

 

  • Rename every file in the new language directory by adding the county code to its name.

    eg.

     

    Labels.resx -> Labels.es.resx
  • Translate all the new files separately using the the Resx Editor software and save them afterwards. It helps to select the View-Keys option under the View menu.

 

  • Edit the VUP languages configuration file:

    Default path:

     

    C:\inetpub\wwwroot\VUP\VUP\App_Config\Languages.config

     

    Languages.config file example

     

    <?xml version="1.0"?>

    <languages>

      <language name="English" culture="en-US" />

     <language name="Spanish" culture="es-ES"/>

    </languages>

 

-Menu.config - defines the content of the top menu bar.
-Permissions.config - allows to enable and disable available features. You can disable/enable certain components by settings their permission to false or true respectively.
-Subscriptions.config - contains list of subscriptions available to be purchased from VUP. 
-TopUp.config - contains onlineshop URLs for different currencies.

Related content