SipX ConfigServer Customize Colors, Layout and Logo

From SIPfoundry sipx, The Open Source SIP PBX for Linux - Calivia

Jump to: navigation, search

Contents

[edit] Caveats

  • Sometimes browsers cache the logo or CSS, so hit Shift+F5 if your logo doesn't appear at first

[edit] Image:Ver3.8.png Look and Feel

Create following files

Code: /etc/sipxpbx/sipxplugin.beans.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" 
	"http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
  <bean id="skinProperties" class="org.sipfoundry.sipxconfig.site.skin.SkinProperties">
    <property name="properties">
      <props>
        <!-- key=X.png correlates to /sipxconfig/skin/X.png (typically referenced in CSS) -->
        <prop key="logo.png">my-logo.png</prop>
        <prop key="home.png">my-home.gif</prop>
        <prop key="colors.css">my-colors.css</prop>
      </props>
    </property>
  </bean>  

  <!-- Optional definition to override any string resource -->
  <bean id="myResources" class="org.springframework.context.support.ResourceBundleMessageSource">
    <property name="basename" value="myres"/>
  </bean>

</beans>

If you define your own resources, simply create a file called myres.properties that contains strings definitions you'd like to alter.

Code: /etc/sipxpbx/myres.properties
product.name=My Product

This file conforms to the Java's internationalization standards, so you can create a series of files to change the resource strings for any language (e.g. myres_fr.properties, etc)

[edit] Image:Ver3.6.png 3.6 Look and Feel

  • This does not affect voicemail page or root page (http://hostname:80/index.html) unless you are using 3.8 or higher

Create following files

Code: /etc/sipxpbx/sipxplugin.beans.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" 
	"http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
  <bean id="skinProperties"
    class="org.sipfoundry.sipxconfig.components.SkinProperties">
    <property name="locationPath" value="skin.properties"/>
  </bean>  
</beans>
Code: /etc/sipxpbx/skin.properties
 logo.png=my-logo.png
 colors.css=my-colors.css
 layout.css=my-layout.css


[edit] Images

Create a logos /etc/sipxpbx/my-logo.png with roughly the same dimensions as the sipxconfig logo

And create corresponding /etc/sipxpbx/my-colors.css and /etc/sipxpbx/my-layout.css based on the default CSS files

[edit] Advanced

  • You can change the names of any files except sipxplugin.beans.xml
  • You can include all files including sipxplugin.beans.xml into a jar file and drop it into /usr/share/sipxpbx/lib
  • This is part of a much larger plugin framework where you can change all sorts of default settings for sipxconfig.

[edit] See Also

SipXconfig skin gallery

Personal tools