Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

The  product installation can be customized in many ways. For example OEM partners can brand  with their own company images and look.

properties make it easy to implement many of the common customization that all customer and OEM partners will want to consider.

Data API provides a programmatic protocol for viewing and managing resources such as tenants, users, applications, forms, schemas, etc.

Info

frevvo only supports/certifies  running in the tomcat container. Refer to our Supported Platforms for the list of Application Servers supported/certified by frevvo.

 


Customization properties can be changed in the <frevvo-home>/tomcat/conf/frevvo-config.properties file. This keeps all your modified parameters in one place and makes it easy to upgrade to newer releases.

Code Block
# SMTP Settings 
frevvo.mail.from.email=
frevvo.mail.bounce.email=
frevvo.mail.debug=false
frevvo.actions.debug=true
frevvo.rule.debug=true

# frevvo schema name settings - needed for 6.0 upgrade only
frevvo.users.schemaName=users
# SQL Server schema name 
#frevvo.users.schemaName=users.dbo

# HTTP Proxy Configuration for licensing
#frevvo.proxy.host=
#frevvo.proxy.port=
#frevvo.proxy.username=
#frevvo.proxy.password=
#frevvo.proxy.ntlm=false

# Insight settings 
insight.enabled=true
insight.server-url=http://localhost:8983/solr

# File Connector settings
frevvo.filesystem.connector.url=http://localhost:8082/filesystem

# Box Connector settings
#frevvo.box.connector.client.id=
#frevvo.box.connector.client.secret=

# Sharepoint Connector settings
frevvo.sharepoint.connector.url=http://localhost:8082/sharepoint
Column
width350px

On This Page:

Table of Contents
maxLevel2

...

These are the brandable parameters and their defaults:

ParameterDescription Default
frevvo.home.urlHome page for the Company Logo link ${context.path}
frevvo.logo.urlURL to the Company Logo image. Also applies to Spaces${context.path}/images/bright/TransparentLogo-NoBeta.png
frevvo.help.urlURL to the Help page${context.path}${servlet.path}/static/help/designer
frevvo.docs.urlURL to the Documentationhttp://docs.frevvo.com/d/display/
frevvo/frevvo+v5+Documentation+Home
<frevvo docs version>
frevvo.forum.urlURL to the Forumhttp://forum.frevvo.com/forum/
frevvo.blog.urlURL to the bloghttp://blog.frevvo.com
frevvo.product.nameThe Product NameLive Forms
frevvo.copyrightProduct Copyright One-LinerCopyright 2006-2012 frevvo Inc. All rights reserved.
frevvo.license.urlURL to License Agreement${context.path}${servlet.path}/static/termsDL
frevvo.contact.emailContact Us email addressmailto:info@frevvo.com
frevvo.downloads.menuShow Downloads menu itemtrue
frevvo.templates.menuShow Templates menu item true
frevvo.css.urlCustom Stylesheet URL
 

frevvo.poweredby.markupLogo in form footer when the Logo property setPowered by Live Forms™
frevvo.page.titleHTML title prefix for all Live Form pagesfrevvo
frevvo.menu.barShow menu bartrue
frevvo.oem.branding.classNames css class applied to body of UI pagesempty
frevvo.certificate.signature Ignore SSL Security when posting to an https endpointempty

Branding External Urls 

Notice that several of the parameters use Url templates. For example, frevvo.help.url references a help file named designer.xsl that is part of frevvo.war and is located in the directory <frevvo-home>\WEB-INF\xsl\main\help after the war file has been unzipped . You may wish to bundle up a replacement help file and store your replacement file in that same directory. In that case you will keep the templates ${context.path}${servlet.path}/static that are part of the default path and append your own help file name. It can be an html file, myAppHelp.html. Or if your help is an external file you can replace the entire default value ${context.path}${servlet.path}/static/help/designer with a Url such has http://mycompany/myapp/help.html. Refer to Installation Tasks for the steps to repackage frevvo.war after parameters in designer.xsl have been editied.

...

Code Block
frevvo.docs.url=        Note:No URL set will hide the Docs menu and top link

...


The look & feel of the Live Forms application is controlled via css. frevvo.css.url gives you the ability to add your own style sheet if you need to customize the look & feel of the page itself such as the background colors and sizes of the items on the pages. You can use a tool such as firebug to learn how the page is styled with css and thus how to override the default styling. 

...

  1. Stop  if it is running.
  2. Navigate to <frevvo-home>\tomcat\webapps directory.
  3. Copy the frevvo.war file to a temporary location of your choice: e.g. c:\tmp\frevvo-war. Change the file extension from .war to .zip if necessary. Unzip it.
  4. Edit c:\tmp\frevvo-war\WEB-INF\data\locales\default.
  5. To change the text of the "Access denied. Authentication required" message locate the Error messages section in the file. Notice that the strings on the left side of the '=' have spaces escaped with the '\' character. This is needed so do not remove that. The escape character is not needed on the right side of the '='. Enter the text that you want on the right side of the '='

    Code Block
    # Error messages
    Access\ Denied.\ Authentication\ required.= Please Sign into Live Forms
  6. To change the labels in the Forms designer, locate the Form Designer toolbox section of the file. Enter the labels that you want to display to the right of the '='

    Code Block
    # Form Designer Toolbox
    Palette=Palette Controls
    Custom=My Custom Controls
    Properties=Control Properties    
    Data\ Sources=Schemas
    Drag\ and\ drop\ controls\ from\ the\ form\ into\ the\ header\ above.\ You\ can\ then\ re-use\ them\ in\ other\ forms.=
    Drop\ Submit\ buttons\ from\ the\ palette\ to\ add\ to\ the\ form.=
    Drop\ controls\ from\ the\ palette\ to\ add\ to\ the\ form.=
    Drag\ and\ drop\ controls\ from\ the\ palette\ into\ the\ form.=
    Drag\ and\ drop\ controls\ from\ the\ palette\ or\ from\ the\ form.=
  7. Save the changes to the default file. 
  8. Rezip all the files in the c:\tmp\frevvo-war directory, even the ones you did not edit — if you change directories or zip them differently, Live Forms may not load correctly:

    This is the correct structure for the frevvo.war zipfile.



  9. Make sure you create the zipfile with the directory structure as shown in the image above. It is an easy mistake to include the containing directory in the zipfile. If you do this, Live Forms may not load correctly. Zip will often give your zipfile a .zip extension. Make sure you change this to a .war extension. 

  10. Copy the updated frevvo.war file to <frevvo-home>tomcat\webapps.
  11. Restart your  server.

    Section
    Column


    Customized "Access denied. Authentication required" message
     
    Column


    Customized Labels in the Forms Designer

...

builds upon several 3rd party products. The frevvo.war file contains a WEB-IN\licenses with all the 3rd party licenses.