WebApp Developers Manual

Edition 2.1 - The Kopano Team

This document, the WebApp Developers Manual, describes how to develop and extend WebApp. In addition various code snippets are provided for an easier incorporate the WebApp code architecture.

Table of contents

• 1. Introduction
  • 1.1. WebApp
  • 1.2. Requirements
  • 1.3. Document Structure Overview
  • 1.4. Examples
    • 1.4.1. Facebook Events
    • 1.4.2. Facebook widget
• 2. Architecture Overview
• 3. Ext JS and OO-Javascript
  • 3.1. Classes
  • 3.2. Accessing Components
  • 3.3. Enums
  • 3.4. Singletons
• 4. Extending WebApp
  • 4.1. Ways of Extending WebApp
• 5. Insertion Points
  • 5.1. Zdeveloper plugin
  • 5.2. Example: adding a button
• 6. Widgets
  • 6.1. Creating a widget
  • 6.2. Widget configuration
  • 6.3. Events
• 7. Dialogs
  • 7.1. Events
  • 7.2. Example
  • 7.3. Dealing with MAPI records
    • 7.3.1. Displaying a record
• 8. Bidding System
  • 8.1. Bidding and insertion points
  • 8.2. Working
  • 8.3. Bidding on a shared component
  • 8.4. Example
• 9. Data Models
  • 9.1. Model-based architecture
  • 9.2. Separable model architecture
  • 9.3. Hierarchy model
  • 9.4. Settings model
• 10. MAPI
• 11. Communication
  • 11.1. Conceptual Overview
  • 11.2. Protocol
  • 11.3. Javascript Communication
  • 11.4. Response Handlers
  • 11.5. Notifications
• 12. Stores and RecordFactory
  • 12.1. Stores and Substores
    • 12.1.1. MAPI Store
    • 12.1.2. IPM Stores and ShadowStore
  • 12.2. RecordFactory
• 13. Deployment and Build System
  • 13.1. Deployment
  • 13.2. Build System
    • 13.2.1. Getting Started
      • 13.2.1.1. Linux
      • 13.2.1.2. Windows, Mac OSX
    • 13.2.2. Ant Introduction
    • 13.2.3. Tools
      • 13.2.3.1. JsConcat
      • 13.2.3.2. Ext-doc
      • 13.2.3.3. Closure Compiler
• 14. Translations
  • 14.1. Gettext
  • 14.2. Server-Side
    • 14.2.1. Implemented Functions on the Server-Side
  • 14.3. Client-Side
    • 14.3.1. Reading Translations and Passing it to the Client
    • 14.3.2. Implemented Functions on the Client-Side
• 15. Appendix A: Naming Conventions
  • 15.1. Namespace Structure
  • 15.2. Naming Packages and Classes
  • 15.3. Naming Insertion Points
    • 15.3.1. Coding Style Guidelines
    • 15.3.2. Documentation
  • 15.4. Documenting Classes
  • 15.5. Documenting Fields
  • 15.6. Documenting Constructors
  • 15.7. Documenting Methods
  • 15.8. Documenting Insertion Points
  • 15.9. Documenting Enumerations
• 16. Appendix B: References
• 17. Legal Notice