Overview

Jive allows customers to develop and deploy their custom themes. To do this, they would use Soy or Freemarker (FTL) templates. By implementing these themes, they can modify the Jive application's underlying page templates.

This article explains how to edit the Jive application's underlying page templates using Soy/ FTL templates.

Process

1. Navigate to Admin Console > System > Settings > Themes and edit the theme that is listed under Global Theme Map.
   
   
   
   
2. For all existing Custom Templates, apply only the difference that can be found in the fixpack's patch file.
   • This way, if fixpack changes the /soy/status_input/status_input_attachments.soy file (which is already customized - see the screenshot below), you need to find the differences and apply only them.
   • For all other files from the fixpack not visible in the Custom Templates list, see Step 3.
     
     
     
     
3. In Create Custom Template, select the file which needs to be modified and click the Create New Template button.
   • For instance, if you need to modify /soy/userregistration/userregistrationform.soy, you would find it in the list of available files for that theme.
     
     
     
     
4. Make the changes and press Save Template. On the Edit Theme page, the file now shows up in the list of Custom Templates.
   
   
   
   
5. For the changes to be reflected in the instance, regenerate JavaScript. 
   1. Go to Admin Console > System > Management > System Properties.
   2. Set jive.resource.salt to the current epoch timestamp.
      • This property was created to force-generated JavaScript to be removed so that when it gets regenerated, the path would include some new unique ID or sequence number without having to restart the application.
6. Clear caches.
   1. Go to Admin Console > System > Settings > Caches.
   2. Select all caches by clicking the checkbox on the top right of the list of caches.
      
      
      
      
   3. Scroll to the bottom of the page and click Clear Selected.
7. Repeat these steps for all soy files included in the commit.