[ADD] estate: add real estate advertisement module by times-odoo · Pull Request #1220 · odoo/tutorials

times-odoo · 2026-04-01T12:03:39Z

Add a new real estate advertisement module that allows
users to manage property listings with a complete UI.

The implementation covers:

Module scaffold with manifest and empty init file
EstateProperty model with all required fields including
text, numeric, boolean, date and selection fields
Security access rights for internal users
Window action and menu to navigate to properties
Custom list, form and search views with filters
and group by options for better user experience

Chapter-2 to Chapter-6

Add the base structure for the Estate module including the manifest file and empty __init__.py. The Estate module aims to provide a real estate advertisement platform. This commit sets up the installable module foundation with proper metadata before adding models and views. Chapter-2

robodoo · 2026-04-01T12:03:42Z

Add the EstateProperty model with essential fields for the real estate advertisement module including text fields, numeric fields, boolean fields and a selection field for garden orientation. Chapter-3

Add ir.model.access.csv in the security folder to define access rights for the estate.property model. Grant read, write, create and unlink permissions to base.group_user. Update the manifest to include the security data file. Chapter-4

Add the views folder with action and menu definitions to make the estate.property model accessible from the UI. Link the menu item to the window action to allow users to navigate to the properties list and form views. Update the manifest to include the views data files. Chapter-5

Updated the date_availability field to use the static add() method from fields.Date. This improves code cleanliness by removing the need for a manual relativedelta import while maintaining the 3-month offset logic.

Replaced the default list view with a structured <list> definition to display key property details including title, postcode, expected price, and availability date. This ensures the user can see a high-level overview of properties without opening individual records. Chapter-6

Replaced the default form view with a structured XML definition. The new layout uses <sheet> and <group> tags to organize property information into logical sections, improving data entry and readability. Chapter-6

mash-odoo

Hello!
Thank you for your work.
Here are some few questions and suggestions.

mash-odoo · 2026-04-09T07:03:09Z

estate/models/estate_property.py

+class EstateProperty(models.Model):
+    _name = 'estate.property'
+    _description = "estate property used to buy and sell houses"
+    _log_access = False


What is _log_access used for?

_log_access(bool) is used to decide whether create the automatic(access log fields: create_uid, create_date, write_uid, write_date) fields or not.

mash-odoo · 2026-04-09T07:03:23Z

estate/models/estate_property.py

+
+class EstateProperty(models.Model):
+    _name = 'estate.property'
+    _description = "estate property used to buy and sell houses"


Where is this description displayed?

Its the model’s informal name. You can see that displayed in Setting > Technical > Database Structure > Models > Description(column)

mash-odoo · 2026-04-09T07:03:54Z

estate/models/estate_property.py

+        copy=False
+    )
+    expected_price = fields.Float(required=True)
+    selling_price = fields.Float(readonly=True, copy=False)


What does copy=False do?

it prevents the field value to be copied over to the new record while duplicated

mash-odoo · 2026-04-09T07:04:26Z

estate/security/ir.model.access.csv

@@ -0,0 +1,2 @@
+id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
+access_estate_property,access_estate_property,model_estate_property,base.group_user,1,1,1,1


Can you explain me what happens when you write this line?

it creates a row in the ir_model_access table . what it does : it gives internal users( base.group_user ) access to estate property model with read, write, create and delete permissions

mash-odoo · 2026-04-09T07:05:05Z

estate/views/estate_menus.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<odoo>
+    <menuitem id="estate_root_menu" name="Real Estate" web_icon="estate,static/description/icon.png">


Does this web icon show in the UI?

yes, it replaces the default icon of the app and shows this icon.

mash-odoo · 2026-04-09T07:05:47Z

estate/__manifest__.py

+    'category': 'Tutorials',
+    'summary': 'The Real Estate Advertisement module',
+    'description': 'Try installing the App',
+    'depends': ['base'],


What is depends used for?

if the app is dependent on functions/features of other odoo modules, they must be defined in the depends field. it will load that modules before installing our app

mash-odoo · 2026-04-09T07:06:31Z

estate/views/estate_property_views.xml

+                    <group col='2'>
+                        <group>
+                            <field name='postcode'/>
+                            <field name='date_availability' string='Available From'/>


When do we use view level string and field level string?

We use the field-level string in model python file(estate_property.py) to set the global default label for the field. We use the view-level string in xml views (as seen on line 34 for date_availability) when we need to override that default for a specific view to provide better context to the user without changing the model's core definition.

mash-odoo · 2026-04-09T07:06:50Z

estate/views/estate_property_views.xml

+        </field>
+    </record>
+
+    <record id="estate_property_action" model="ir.actions.act_window">


What is a window action?

A window action is used to create a link between our model and its views by specifying the res_model and view_mode

Implemented a custom search view for estate.property to enhance record filtering. Added shortcuts for searching title and postcode, along with a predefined filter for 'Available' properties and a 'Group By' option for postcodes. Chapter-6

Reorganized the estate.property model fields into alphabetical order to improve maintainability and developer accessibility. Cleaned up the security CSV by adding a trailing newline to meet linting standards. Improved the user experience by setting 'Available' as the default filter and 'Postcode' as the default grouping in the list view. Additionally, updated the 'Living Area' search field to use the '>=' operator for more intuitive property filtering. Chapter-6

Created the estate.property.type model to allow categorization of listings. Linked the main estate.property model to property types, buyers, and sellers using Many2one fields. This update includes the necessary menus, actions, and view integrations, as well as updated security access rights for the newly created model. Chapter-7

Integrated res.partner and res.users to manage property transactions. Added a buyer field (not copied) and a salesperson field that defaults to the current user. Organized these new relational fields into a dedicated "Other Info" tab within the property form view for better data segmentation. Chapter-7

Created the estate.property.tag model to allow for flexible property categorization (e.g., 'Cozy', 'Renovated'). Established a many-to-many relationship in the estate.property model. Integrated the tag_ids field into the list and form views, utilizing the 'many2many_tags' widget for a modern, badge-like UI experience. Added the necessary security, actions, and menus for tag management. Chapter-7

Created the estate.property.offer model to track price bids from potential buyers. Established a one-to-many relationship in the estate.property model to display all offers directly on the property form. Included dedicated list and form views for offers, integrated within a new tab on the property model. This allows for seamless management of multiple offers per property listing. Chapter-7

times-odoo added 2 commits April 2, 2026 11:19

[ADD] estate: add EstateProperty model with basic fields

428b78f

Add the EstateProperty model with essential fields for the real estate advertisement module including text fields, numeric fields, boolean fields and a selection field for garden orientation. Chapter-3

times-odoo requested a review from mash-odoo April 2, 2026 10:34

times-odoo changed the title ~~[ADD] estate: add module scaffold for real estate module~~ [ADD] estate: add real estate advertisement module base Apr 3, 2026

times-odoo changed the title ~~[ADD] estate: add real estate advertisement module base~~ [ADD] estate: add real estate advertisement module Apr 6, 2026

times-odoo added 3 commits April 8, 2026 14:38

[IMP] estate: use fields.Date.add for availability default

16ae220

Updated the date_availability field to use the static add() method from fields.Date. This improves code cleanliness by removing the need for a manual relativedelta import while maintaining the 3-month offset logic.

[IMP] estate: add custom form view for property model

fcf5279

Replaced the default form view with a structured XML definition. The new layout uses <sheet> and <group> tags to organize property information into logical sections, improving data entry and readability. Chapter-6

mash-odoo requested changes Apr 9, 2026

View reviewed changes

times-odoo added 6 commits April 9, 2026 13:41

		@@ -0,0 +1,2 @@
		id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
		access_estate_property,access_estate_property,model_estate_property,base.group_user,1,1,1,1 No newline at end of file

Conversation

times-odoo commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

robodoo commented Apr 1, 2026

Uh oh!

mash-odoo left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

times-odoo commented Apr 1, 2026 •

edited

Loading