Skip to content

Ebla Real Estate

Overview

Ebla Real Estate enhances the EspoCRM Real Estate extension with tools for managing property images, presenting listings, identifying properties, and finding available properties and requests.

It adds:

  • A visual property gallery with image ordering, a main image, descriptions, and watermarking.
  • A property card view with configurable content.
  • Unique property IDs based on the assigned agent.
  • Configurable Available filters for properties and requests.
  • A mortgage calculator on property records.
  • Controlled public access to selected listing images.
  • Additional property-request criteria and location importing.

Requirements

  • A working installation of the EspoCRM Real Estate extension.
  • An EspoCRM version accepted by the Ebla Real Estate package you are installing.
  • The PHP GD extension for watermarking JPEG, PNG, and WebP property images.
  • A PNG watermark image.
  • Ebla List Pro for the property card view.

Card view dependency

The other Ebla Real Estate features do not require List Pro. List Pro is required only to switch the property list to the specialized card view.

Initial configuration

After installing the extension:

  1. Go to Administration > Ebla Extensions > Ebla Real Estate Settings.
  2. Upload a Watermark Image if your team will watermark property images.
  3. Select the statuses that represent available properties in Property Available Status List.
  4. Select the statuses that represent active customer requests in Request Available Status List.
  5. Save the settings.

The Available filter uses these two status lists. If a list is empty, the corresponding filter will return no records.

Portal-specific watermark

The extension can use a different watermark for each portal:

  1. Go to Administration > Portals.
  2. Open the portal.
  3. Set its Watermark Image.
  4. Save the portal.

When a portal user applies a watermark, the portal watermark is used. If the portal has no watermark, the global watermark from Ebla Real Estate Settings is used.

If Watermark Image is not visible on the portal record, an administrator must add it to the Portal detail layout through the Layout Manager.

Property image management

The property Images field is displayed as a gallery. Open a property in edit mode to manage it.

Upload and order images

  1. Attach images to the Images field.
  2. Drag images into the required order.
  3. Click the star on the image that should represent the property.
  4. Save the property.

The selected image becomes the Main Image used in supported lists and cards. If no main image is selected, the first gallery image is used. Properties without an image display a placeholder in the card view.

Property image management in Ebla Real Estate

Edit image information

Click the edit icon on an image to manage:

  • Description — notes or public-facing information associated with that image.
  • Is Listed — allows the image to be served through the public-image endpoint when its property is also listed.

Save the property after changing image information.

Editing property image information

Administrators can ask a developer to add more image attributes through the extension metadata when a project needs additional information for every property image.

Watermark property images

You can watermark one image or all images attached to a property:

  • Click the stamp icon on an image to watermark only that image.
  • Open the property detail view and click Add Watermark to watermark every attached image.

The source property image can be JPEG, PNG, or WebP. The configured watermark itself must be a PNG image. The watermark is placed in the center of the source image.

Watermarking is not reversible

Watermarking modifies the stored image file. Keep an unmodified copy before applying a watermark. Applying the action again adds another watermark over the current file.

Users need edit access to the property and access to its image attachment to apply a watermark.

Property card view

With Ebla List Pro installed, users can switch the property list between the standard list and the specialized card view.

Each property card can show:

  • The selected main image or the no-image placeholder.
  • Price and status.
  • Configurable property information in the card body.
  • The assigned agent, or the record creator when no agent is assigned.

Property card view

Configure the card body

  1. Go to Administration > Entity Manager.
  2. Open Real Estate Property.
  3. Click Edit.
  4. Enter the required content in Card Body Template.
  5. Save.

Use {{fieldName}} to output a raw value. Use {{{fieldNameField}}} to render the field as it appears in an EspoCRM list.

For example:

<h4>{{title}}</h4>
<div class="field address" data-name="address">{{{addressField}}}</div>
<div class="field square" data-name="square">{{{squareField}}}</div>

The price and status are already displayed over the property image, so they do not need to be repeated in the card body.

Property titles and automatic property IDs

The extension separates the customer-friendly property Title from its unique Property ID.

When a property is created:

  1. The extension uses the assigned user's three-character Short Code. If the property has no assigned user, it uses the creator.
  2. It adds a five-digit sequence number.
  3. It stores the result as the property ID and internal record name.

For example:

JON00042

If the property is reassigned, the three-character prefix changes to the new agent's short code while the numeric part remains the same.

The short code is generated automatically from the user's name when possible. Administrators can review or change it on the User record. A short code must be unique and contain exactly three uppercase letters or numbers.

Use a descriptive title

Add the Title field to property layouts and enter a customer-friendly title such as Two-bedroom apartment near the marina. The property header shows the title while the property ID remains available for tracking and communication.

Available properties and requests

The extension adds an Available preset filter to:

  • Real Estate Properties.
  • Real Estate Requests.

The property filter includes records whose status is in Property Available Status List. The request filter uses Request Available Status List.

To change the results:

  1. Go to Administration > Ebla Extensions > Ebla Real Estate Settings.
  2. Update the appropriate status list.
  3. Save.
  4. Return to the property or request list and apply Available.

Mortgage calculator

A Mortgage Calculator panel is available on property detail views to users with edit access to Real Estate Properties.

  1. Open a property.
  2. Find the Mortgage Calculator side panel.
  3. Select the loan amount, annual interest rate, and loan term.
  4. Click Calculate.

The calculator displays an estimated monthly payment and uses the currency symbol from the property price, user preference, or system default currency.

Estimate only

The result is an informational estimate based on the values entered in the panel. It does not include fees, insurance, taxes, or lender-specific rules.

Additional request criteria

The extension adds fields that can help describe a customer's requirements:

  • Property category.
  • Living rooms.
  • View.
  • Balcony.
  • Last floor.
  • Furnished.

Administrators can place the required fields on Real Estate Request detail, detail-small, and search layouts through Administration > Entity Manager > Real Estate Request > Layouts.

Import real estate locations

Real Estate Locations can be imported through EspoCRM's standard import tool.

  1. Go to Administration > Import.
  2. Select Real Estate Location as the entity type.
  3. Upload and map the source file.
  4. Preview the data and run the import.

Use this option when loading an existing hierarchy of areas, neighborhoods, or other property locations.

Public property images

The extension can expose selected property images without requiring a CRM login. Both the property and the individual image must be explicitly listed.

Side-panel availability

The extension automatically adds Is Listed to the Real Estate Property side panel during installation.

To show it in other layouts, add the field through Administration > Entity Manager > Real Estate Property > Layouts.

Publish an image

  1. Open the property and enable Is Listed on the property.
  2. Edit an image in the Images field.
  3. Enable Is Listed for that image.
  4. Save the property.
  5. Use the attachment ID in the public URL:
https://crm.example.com/?entryPoint=publicImage&id=ATTACHMENT_ID

An optional thumbnail size can be requested:

https://crm.example.com/?entryPoint=publicImage&id=ATTACHMENT_ID&size=medium

The attachment ID can be obtained from the CRM-generated image URL or through the EspoCRM API.

Public access

A listed image is accessible without authentication to anyone who has its URL. Disable Is Listed on the image or its property when it should no longer be public.

The endpoint rejects attachments that do not belong to a Real Estate Property and images that are not listed on a listed property.

Troubleshooting

The Available filter returns no records

Open Ebla Real Estate Settings and select at least one status in the corresponding available-status list.

Card view is not available

Confirm that Ebla List Pro is installed and enabled. Then clear the EspoCRM cache and reload the property list.

The watermark action fails

Check that:

  • A watermark image is configured.
  • The watermark is a valid PNG file.
  • The source image is JPEG, PNG, or WebP.
  • PHP GD supports the source image format.
  • The user can edit the property and access the attachment.

A public image returns Forbidden

Confirm that the property has the Boolean isListed field enabled and that Is Listed is also enabled in that image's edit dialog.

A property ID has no agent prefix

Open the assigned User record and set a unique three-character Short Code, then save the property again. Existing numeric sequence values are retained when a property is reassigned.

Change Log