Customization
From Pbxnsip Wiki
Please note that these steps apply for version 2.1 and onward.
Contents |
Changing the appearance of the web interface
There are three levels for changing the web interface:
- Changing the logo
- Changing the colors
- Changing the layout
The intensity of the change varies. Changing the logo should be relatively simple, while changing the colors requires the change of several pictures. Changing the layout is a major step and should be coordinated with pbxnsip.
There is an archive of the images necessary for the change of the logo and the change of the colors available for download: http://www.pbxnsip.com/download/customization.zip.
Changing the logo
If you change the logo, you need to replace the image main_logo.gif and put it into the html/img directory. When doing the change, please make sure that the size of the image does not change and that the background looks the same like in the original.
Changing the colors
If you want to change the color of the menus, you need to change the images main_right.gif, main_sel0.gif, main_sel1.gif, main_sel2.gif, main_slice1.gif and main_slice2.gif and main_start.gif. Please make also here sure that the size of the images does not change, as it would affect the overall layout.
You might also want to take a look at the style.css file. If you change this file, it must be put into the html directory. The colors used there affect the color of the fonts and the background color for the input frames. We recommend not changing the color of the input frames, as there are many images that assume the used background color.
Changing the layout
If you like to change the borders and the submenus, you may also do this by changing the images for the border decoration and the submenus. All buttons are images and must not only be rendered with the new look, but they must also be available in all used languages.
Please note that the images are intellectual property of pbxnsip and you need to have permission to use the images in other places than the pbxnsip PBX.
Changing Emails
The files that are used in the emails are largely independent from the file for the web interface. They share only the style.css file, and if you want to change the style sheet, please copy the file to style_email.css and change the references in the html email files.
Changing or adding languages
If you want to change or add a language, you need to edit the email_xx.xml file, where xx is the langauge that you want to change. Such changes require a restart of the PBX. Also, you need to "register" the langauge in the PBX. See Localization on how to do this. Templates for the lang_xx.xml file are available from below. Please use a UTF-8 capable editor to edit these files.
Changing the appearance
When the PBX sends out a file, it typically includes three components:
The subject is always in plain text (UTF-8 encoded).
The PBX also includes a text version of the email for those email clients that are not able to display html content.
It also includes an html version of the email.
All three files may use language-independent tags, so that you can easily change languages or wordings according to your needs. This is done in the email_xx.xml file. Please use a UTF-8 capable editor to edit these files. After changing the files, you must restart the PBX in order to fetch the changes.
The following files are available:
email_conference_txt.txt: This contains the text that is sent when the PBX sends out a conference invitation (using the calendar format).
email_de.xml, email_en.xml: These files are used to keep the texts language independent.
email_extstatus_htm.htm, email_extstatus_subject.txt, email_extstatus_txt.txt: These three emails are sent when the extension status changes (for example, the user turns DND on).
email_missed_htm.htm, email_missed_subject.txt, email_missed_txt.txt: These files are sent when the user misses a call.
email_performance_htm.htm, email_performance_subject.txt: The PBX may send this email once per day to notify the system administrator about the CPU usage during the day. This makes it easy to keep possible performance bottlenecks in the eye.
email_trace_htm.htm, email_trace_subject.txt, email_trace_txt.txt: This email is sent when the user requests a call trace of the last call.
email_voicemail_htm.htm, email_voicemail_subject.txt, email_voicemail_txt.txt: This email is sent when the PBX sends out a voicemail email.
The files can be downloaded here http://www.pbxnsip.com/download/emails.zip.
