the affordable java shopping cart   
  HOME     FEATURES     PRICING     DEMO     DOCS     ABOUT US     CONTACT US    

7 Simple Rules for Making Customizations

For any customization you make to SoftSlate Commerce, at all times try to follow these rules. It will save you work and spare you from issues that may occur when upgrading to a future version.

  1. Custom Java Classes. 

    Override existing Java classes by subclassing the appropriate class from the com.softslate.commerce package with your own new class. (Requires application reload.) Then, change the setting under the Settings -> Components screen of the Administrator (npcSetting database table) to tell the application to use your new class instead of the default one. Do not modify any of the existing classes as they may change with an upgrade.

    For more information, refer to SoftSlate Commerce's Java API documentation available at http://www.softslate.com.

  2. Custom SQL Queries. 

    Override existing SQL queries or create ones in the appropriate sql-custom.properties file found under the subdirectories of the /WEB-INF/classes/resources directory. (Requires application reload.) Since the sql-custom.properties files are the last files read into memory, they will override the queries defined in the other sql*.properties files. Do not modify any of the other sql*.properties files as they may change with an upgrade.

  3. Custom Struts Configurations. 

    Override existing Struts action mappings and form bean definitions, or create new ones, in /WEB-INF/conf/core/struts-config-custom.xml. (Requires application reload.) Since this is the last file read into memory, it will override the mappings and form beans defined in the other Struts XML files. Do not modify any of the other Struts XML files as they may change with an upgrade.

  4. Custom Tiles Definitions. 

    Override existing Tiles definitions or create new ones in /WEB-INF/conf/core/tiles-defs-custom.xml. (Requires application reload.) Since this is the last file read into memory, it will override the definitions defined in the other Tiles XML files. Do not modify any of the other Tiles definition XML files as they may change with an upgrade.

    For more information, refer to the section on Working with the Tiles Framework

  5. Custom JSP Templates. 

    Override existing JSP templates by copying them from the /WEB-INF/layouts/default directory over to the /WEB-INF/layouts/custom directory and modifying them there. Create any new JSP templates in the custom directory as well. Do not modify the templates in the default directory as they may change with an upgrade. (In a similar way, to customize templates used in the Administrator, copy templates from /WEB-INF/templates/administrator/default to /WEB-INF/templates/administrator/custom.)

    For more information, refer to the section on Creating a Custom Layout.

  6. Custom Application Messages. 

    Create new application messages in /WEB-INF/classes/resources/core/application-custom.properties. (Access the message using <bean:message key="[your key]" bundle="/custom"/> in a JSP page. Requires application reload.) Do not modify any of the other application*.properties files as they may change with an upgrade. (Note: it is not possible to override an existing application message in the application-custom.properties file, you can only create new messages.)

  7. Custom CSS Styles. 

    Override existing CSS styles or create new ones in /css/styles-custom.css. Do not modify /css/styles.css as it may change with an upgrade.

    For more information, refer to the section on Using CSS Stylesheets.


Home  |   Features  |   Pricing  |   Demo Store  |   Documentation  |   About Us  |   Contact Us

Copyright © 2005 SoftSlate, Inc. All Rights Reserved.