Chapter 2: Managing Odoo Server Instances 29 Introduction 29 Configuring the addons path 30 Updating the addon modules list 31 Standardizing your instance directory layout 33 Installing and upgrading local addon modules 36 Installing addon modules from GitHub 40 Applying changes to addons 42 Applying and trying proposed pull requests 43

Chapter 3: Creating Odoo Modules 47 Introduction 47 Creating and installing a new addon module 48 Completing the addon module manifest 49 Organizing the addon module file structure 52 Adding models 55 Adding Menu Items and Views 57 Using scaffold to create a module 61 www.allitebooks.com ii Table of Contents

Chapter 4: Application Models 63 Introduction 63 Defining the Model representation and order 64 Adding data fields to a model 66 Using a float field with configurable precision 71 Adding a monetary field to a Model 73 Adding relational fields to a Model 74 Adding a hierarchy to a Model 78 Adding constraint validations to a Model 80 Adding computed fields to a Model 82 Exposing Related fields stored in other models 85 Adding dynamic relations using Reference fields 86 Adding features to a Model using inheritance 87 Using Abstract Models for reusable Model features 89 Using Delegation inheritance to copy features to another Model 91

Chapter 5: Basic Server Side Development 95 Introduction 95 Defining model methods and use the API decorators 96 Reporting errors to the user 99 Obtaining an empty recordset for a different model 101 Creating new records 102 Updating values of recordset records 104 Searching for records 107 Combining recordsets 109 Filtering recordsets 110 Traversing recordset relations 112 Extending the business logic defined in a Model 114 Extending write() and create() 117 Customizing how records are searched 120

Chapter 6: Advanced Server Side Development Techniques 125 Introduction 125 Change the user performing an action 126 Call a method with a modified context 128 Execute raw SQL queries 130 Write a wizard to guide the user 133 Define onchange methods 138 Call onchange methods on the server side 141 Port old API code to the new API 143 iii Table of Contents

Chapter 7: Debugging and Automated Testing 153 Introduction 153 Producing server logs to help debug methods 153 Using the Odoo shell to interactively call methods 157 Using the Python debugger to trace method execution 159 Writing tests for your module using YAML 164 Writing tests for your module using Python unit tests 168 Running server tests 172 Using the Odoo Community Association maintainer quality tools 173

Chapter 8: Backend Views 179 Introduction 180 Adding a menu item and window action 180 Having an action open a specific view 184 Adding content and widgets to a form view 186 Adding buttons to forms 189 Passing parameters to forms and actions: Context 190 Defining filters on record lists: Domain 193 List views 196 Search views 198 Changing existing views: View inheritance 201 Document-style forms 205 Dynamic form elements using attrs 207 Embedded views 207 Kanban views 209 Show kanban cards in columns according to their state 211 Calendar views 212 Graph and pivot views 213 QWeb reports 215

Chapter 9: Module Data 219 Introduction 219 Using external IDs and namespaces 219 Loading data using XML files 221 Using the noupdate and forcecreate flags 224 Loading data using CSV files 226 Loading data using YAML files 228 Addon updates and data migration 229

Chapter 10: Access Security 233 Create security groups and assign them to users 233 Add security access to models 238 iv Table of Contents Limit access to fields in models 241 Limit record access using record rules 243 Using security group to activate features 246

Chapter 11: Internationalization 253 Installing a language and configure user preferences 253 Configure language-related settings 257 Translate texts through the web client user interface 258 Exporting translation strings to a file 261 Use gettext tools to ease translations 264 Import translation files 266

Chapter 12: Automation and Workflows 269 Introduction 269 Using Kanban stages and features 270 Creating server actions 273 Adding messaging and tracking features 276 Using Python code server actions 281 Using automated actions on time conditions 283 Using automated actions on event conditions 288 Inspecting built-in workflows 291

Chapter 13: Web Server Development 295 Introduction 295 Make a path accessible from the network 295 Restrict access to web accessible paths 300 Consume parameters passed to your handlers 302 Modify an existing handler 304 Using the RPC API 307

Chapter 14: CMS Website Development 311 Introduction 311 Extending CSS and JavaScript for the website 311 Creating or modifying templates - QWeb 314 Offering snippets to the user 318

Chapter 15: Web Client Development 325 Introduction 325 Creating custom widgets 325 Using client-side QWeb templates 331 Making RPC calls to the server 333 Writing tests for client side code 336 Debugging your client side code 340 v Table of Contents

Chapter 16: Server Deployment 345 Introduction 345 Installing Odoo for production 345 Adapting the configuration file for production 351 Set up Odoo as a system service 355 Configure a reverse proxy and SSL 357 Use buildout for repeatable builds