SipX ConfigServer Customize Colors, Layout and Logo

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

Jump to: navigation, search

Contents

Caveats

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

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>
  <!-- Optional definition to override any bean property -->
  <bean id="propsOverrider" class="org.springframework.beans.factory.config.PropertyOverrideConfigurer">
    <property name="properties">
      <props>
        <!-- value=myResources correlates with the bean myResources defined below -->
        <prop key="skin.messageSourceBeanId">myResources</prop>
      </props>
    </property>
  </bean> 

  <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)

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


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

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.

See Also

SipXconfig skin gallery

Personal tools