Custom settings allow you to set how customers see the web interface. You can set the subjects and bodies of emails, the design of invoices, etc. These are set per rate plan, so you can have different settings for different customers. These settings affect your customers, your customers' customers, and so on, unless your customers who are resellers override the custom settings in their own rate plans. If you are the system owner, you can set custom settings for your own rate plan (the plan with id 1), which affects all customers on the system including yourself.

To add a custom setting

  1. Log in to the Enswitch web interface.
  2. Go to Commerce » Rate plans.
  3. Click on the rate plan you wish to edit.
  4. Click on the "Custom settings" link.
  5. Click on the "New" button.
  6. Choose the setting you wish to add.
  7. Choose which customers the setting applies to.
  8. If your system has multiple languages configured, choose which language your new setting is for.
  9. Click the "Next" button.
  10. Enter the value you wish customers to see. Most settings can be either text or HTML. This includes email bodies, but not email subjects which must be text only.
  11. Click the "Save" button.
  12. Enswitch caches custom settings for up to 10 minutes for performance, so the change may not take effect immediately.
  13. Repeat for any other customers or languages as desired.

Uploading logos

Some custom settings, such as logos, are URLs. To configure these:

  1. Create the logos in a graphics program. It is recommended to use the same dimensions as the default logos to preserve the page layout.
  2. Upload them to a web server, which can be the Enswitch web server, or another web server.
  3. Create the custom setting as above. If you have uploaded the logo files to the enswitch machine, you can use a relative URL, for example "/local/my_logo.gif". If you have uploaded to another machine, you should use the full URL, for example "http://my.logo.server/my_logo.gif".

/opt/enswitch/current/www/local will always be a symbolic link to /etc/enswitch/www, so you can put files in /etc/enswitch/www and reference them as /local, and these will not be destroyed by Enswitch upgrades. For example, you can create "/etc/enswitch/www/my_logo.gif", and reference it as "/local/my_logo.gif" in the custom setting.

The default image sizes in pixels are:

Image Width Height
Header background 5 60
Home page 380 285
Title image (right side background) 380 60
Title 188 60

Uploading a CSS file

To change the colours on Enswitch, you will need to produce a custom CSS file. To do this:

  1. Download the "http://<your enswitch server>/css/default/common.css" file.
  2. Make a new file with any elements you want to change. Call it "local.css" or similar. It only needs to include changed elements, not all the elements. Keeping this file as small as possible will reduce the chances of it conflicting with a future Enswitch release.
  3. Upload it to a web server in the same way as the logos above.
  4. Create a custom setting in the same way as the logos above.
  5. The login page will not be affected by this CSS file. Since the user has not yet logged in, we don't know which rate plan to use, and hence which CSS file to use. It is possible to configure the web server to assume a certain rate plan before login. Please ask your vendor to do this, letting them know which rate plan you'd like.