Integrating CTI tel: support for business and profit

Version 6

    This document describes how to enable tel: URI (RFC3966) support in Jive 6.0 for work phone numbers. With a locally installed CTI client (Computer Telephony Integration) you can dial with a single click. Both the vCard on-mouse-over popup and the profile page are supported.

     

    Admin URL to modify the theme: https://example.com/admin/settings-themes.jsp

    More details can be found in Integrating Skype presence & click to call for fun and profit while this document is quite short.

    Edit your theme and modify these two files.

     

    Depending on the entered user data the generated URLs may be invalid. Spaces are replaced with dots, this should be sufficient in most cases.

    The CTI server should be configured to block calls to special, expensive and maybe also international numbers.

    This is no official Jive documentation and this modification may be neither supported by Jive nor by your CTI vendor.

    The home and mobile number are not modified / clickable.

    This does not apply to mobile content, which is generated by the mobile gateway.

     

    A note for Jive:

    If you ever want to add this to the core product please create a global system property jive.tel.work.support=tel (or =skype) to allow the administrator to enable it and to set the proper default URI.

    The user should be able to disable CTI and to modify the default URI (for example for home offices which use Skype).

    The user should be able to enable/disable tel:support for mobile devices.

     

    The on-mouse-over popup of the user profile is configured here:

    /template/global/view-profile-short.ftl
    <#if targetUserProfile.primaryPhoneNumber?? && targetUserProfile.primaryPhoneNumber.phoneNumber?has_content>
        <tr>
            <td><@s.text name='profile.tooltip.user.phone' /></td>
            <td>${targetUserProfile.primaryPhoneNumber.phoneNumber?html}</td>
        </tr>
    </#if>
    
    NEW:
    <#if targetUserProfile.primaryPhoneNumber?? && targetUserProfile.primaryPhoneNumber.phoneNumber?has_content>
        <tr>
            <td><@s.text name='profile.tooltip.user.phone' /></td>
            <td><a href="tel:${targetUserProfile.primaryPhoneNumber.phoneNumber?html?replace(" ", ".")}">${targetUserProfile.primaryPhoneNumber.phoneNumber?html}</a></td>
        </tr>
    </#if>
    
    
    
    
    
    
    

     

    The /people/username page is configured here:

    /template/global/include/profile-macros.ftl
    <#macro displayWorkPhoneNumber fields viewingSelf=false>
        <#list fields as field>
            <#if field.name == "Phone Number">
            <tr class="j-profile-extended-data">
                <@displayProfileField field=field viewingSelf=viewingSelf/>
            </tr>
            </#if>
        </#list>
    </#macro>
    
    NEW:
    <#macro displayWorkPhoneNumber fields viewingSelf=false>
        <#list fields as field>
            <#if field.name == "Phone Number">
                <#if profileObject.primaryPhoneNumber?? && profileObject.primaryPhoneNumber.phoneNumber?has_content>
                <tr>
                    <td><@s.text name='profile.phone.number' /></td>
                    <td><a href="tel:${profileObject.primaryPhoneNumber.phoneNumber?html?replace(" ", ".")}">${profileObject.primaryPhoneNumber.phoneNumber?html}</a></td>
                </tr>
                <#else>
                <tr class="j-profile-extended-data">
                    <@displayProfileField field=field viewingSelf=viewingSelf/>
                </tr>
                </#if>
            </#if>
        </#list>
    </#macro>