Configuration
[TOC]
1. Overview of the Configuration Feature
The Configuration feature is the control center of the entire OS Property system. This is where administrators set up and control system behavior at the operational level — from business information, listing workflows, and payments, to display settings and third-party service integrations.
All changes are saved to the system and take effect immediately across the entire website, with no restart or additional technical intervention required.
Access: Log in to the administration panel → Go to Components → OS Property → Configuration
The Configuration screen is organized into multiple tabs, each managing a specific group of settings. Administrators can navigate between tabs, make changes, and click Save (save and close) or Apply (save and stay on the page) to apply them. Cancel closes the screen without saving, and Dashboard returns to the OS Property dashboard.
Role of Configuration in OS Property Operations
| Purpose |
Description |
| Process control |
Defines how the system handles listings, account registration, and payments |
| Display management |
Controls what users see on the website interface |
| Integration configuration |
Connects to external services and extensions such as maps, Walk Score, OS Calendar, and OS Membership |
| Business rules setup |
Defines rules such as listing expiration, approval workflows, and listing fees |
| Brand management |
Displays business name, address, and email throughout the system |
2. Configuration Groups
The Configuration screen shows the following tabs, in this order. The Custom CSS, Membership integration, and OS Calendar tabs are only displayed when their conditions are met (see sections 2.10 – 2.12).
| # |
Tab |
Section |
| 1 |
General |
2.1 |
| 2 |
Properties |
2.2 |
| 3 |
Payment & Expiration |
2.3 |
| 4 |
Layouts |
2.4 |
| 5 |
Company |
2.5 |
| 6 |
User Type |
2.6 |
| 7 |
Images |
2.7 |
| 8 |
Search |
2.8 |
| 9 |
Currencies |
2.9 |
| 10 |
Custom CSS (conditional) |
2.10 |
| 11 |
Membership integration (conditional) |
2.11 |
| 12 |
OS Calendar (conditional) |
2.12 |
2.1 General
Purpose: Store business information, currency and price format, privacy settings, the Download ID, general interface libraries, and the map configuration.
Settings, in the order they appear on the tab:
Business Setting
- System bussiness name – the name of the real estate business shown in the component header and elsewhere (for example the print page and email pages)
- Business Address – shown in the header of the print page
- Business Phone number
- Business Email – email address used with the property inspection and mailing list request forms
- Notify Email – the email address that receives system notifications
- Show Copyright – show or hide the copyright line
Currency Setting
- Default currency – selectable only from the currencies that are published in the Currencies tab (section 2.9) (displayed as name - code - symbol)
- Show convert currencies – Yes/No. When enabled, a currency conversion drop-down list is offered on the website (the drop-down may not be visible in some templates for design reasons)
- Money format – choose how numbers are formatted:
1.000.000,00, 1 000 000,00, 1,000,000.00, 1.000.000, 1 000 000, or 1,000,000
- Currency position – Before price or After price
Report
- Report – Yes/No. Shows a Report button (for invalid data or spam) on the Property details, Agent details, and Company details pages
Privacy Policy (GDPR) Settings
- Active Privacy Policy – Yes/No. Shows a privacy policy consent requirement on the front-end forms
- Privacy Policy Article – the Joomla article containing the privacy policy (shown only when Active Privacy Policy is Yes)
- Turn on Profile opt-in – lets users manage their own personal data opt-in (shown only when Active Privacy Policy is Yes)
Download ID
- A single text box for your Download ID, which enables automatic updates of OS Property through Joomla Update. The tab also explains how to obtain it: log in at www.joomdonation.com and open the Download ID menu.
General Setting
- Twitter Bootstrap version – 4 or 5
- Load Bootstrap CSS – Yes/No
- Load Chosen library – Yes/No
- Load Lazy library – Yes/No (lazy loading of images)
- Date format –
d-m-Y H:i:s, m-d-Y H:i:s, Y-m-d H:i:s, or d-m-Y h:i A
- Default countries – multiple selection of the countries used by default in country lists
- Default Itemid – a published OS Property menu item of your website (or -- None --) to be used as the default Itemid
Map
- Select Map type – Google Map or OpenStreetMap
- Google API Key – shown only when Google Map is selected
- Map Overlay – Normal, Satellite, or Hybrid (shown only when Google Map is selected)
- Show street view in Details – Yes/No (shown only when Google Map is selected)
- Default coordinates – an interactive map used to choose the default latitude and longitude
- Map in Details page – Yes/No
- Default Map Zoom
- Limit Zoom level – the limit zoom level of the map in the property details page, from 0 to 18
Impact of changes: Business information appears on print pages, outgoing emails, and system headers. Currency settings change how prices are displayed in all property listings and detail pages. Map settings change the map displayed throughout the website.
Notes:
- The business contact email used in property inquiry forms is different from the Notify Email.
- The notification email should be a mailbox that is actively monitored so that new requests are not missed.
- If the website's Joomla template already includes Bootstrap, it is recommended to disable Load Bootstrap CSS to avoid interface conflicts.
- When using Google Maps, a valid Google API key is required.
- OpenStreetMap does not require an API key.
2.2 Properties
Purpose: Control the listing submission settings, which property fields are used, social sharing, comments and ratings, Walk Score, print and PDF export, related properties, alert emails, and more.
Settings, in the order they appear on the tab:
Featured fields Setting
- Auto approval – Yes/No. Select Yes if new properties should not require administrator approval before publishing
- Select Default Access level – the default access level for properties uploaded by a Company Admin, Agent, or Owner
- Unavailable property redirection – the link users are redirected to when a property is not available
- Address format – the order in which address parts (Address, City, State, Region, Postcode) are displayed; several combinations are offered, including Address, Postcode City, Region, State
- Max photos can uploaded – the maximum number of photos per property
- Max pdf files can be uploaded – the maximum number of PDF files per property
- Ref field – Manual enter or Auto Generate
- Ref Prefix – the prefix used when the reference is auto-generated
- Show Ref – show the reference value on the front-end
- Show meta tag
- Show just added icon
- Show just updated icon
- Use energy and climate – shows the DPE chart in the property details depending on the Energy and Climate measurements of each property
- Energy Measurement steps – Class (the class names of the Energy graph, separated by commas) and Value (the values of the Energy graph, separated by commas)
- CO2 emission steps – Class and Value of the CO₂ graph, entered in the same way
Use base Property Details – enable or disable the property fields used in the system:
- Use number rooms field
- Use number bedrooms field
- Use number bathrooms field
- Fractional Baths – shows quarter, half, or full baths instead of whole numbers
- More Bathroom info
- Building Information – enables or disables all fields associated with building information
- Use parking field
- Basement & Foundation – enables or disables all fields associated with basement and foundation
- Land Information – enables or disables all fields associated with land information
- Land Area Unit of Measurement – Feet or Meter
- Acreage Unit of Measurement – Acres or Hectares
- Show Property History & Tax – shows the property sold history and tax
- Business Information – enables or disables all fields associated with business information
- Rural Information – enables or disables all fields associated with rural information
- Show Open House
Fields required – the required status of fields in the Add property form:
- Address
- Short description
Social Sharing
- Allow Social Sharing
- Sharing type – Addthis sharing or Native sharing (Native sharing does not need a Published ID)
- Published ID – used when Addthis sharing is selected
Sef
- Sef link contain – the link to the property details page contains: Alias Only, Ref and Alias, or Ref, Alias and ID
Breadcrumbs
- Include Categories
- Include Property Type
Convenience
- Amenity Category Icons – the icon class used for each amenity category: General, Accessibility, Appliance, Community, Energy Savings, Exterior, Interior, Landscape, and Security amenities
Alert Email Setting
- Activate Alert Email feature
- Send Alert email when new property created
- Send Alert email when property is updated
- Properties per Cron job – the maximum number of new properties checked per cron run
- Number lists per Cron job – the number of saved lists checked per cron run
- Emails per Cron job – the maximum number of alert emails sent per cron run
This section also shows the status of the OSP Cron Task system plugin (a warning is displayed when it is not enabled; notification emails are only sent when it is enabled) and the instructions on how to configure the plugin, the trigger URL (with a Test Now button), and the server cron task.
Comment Settings
- Active Comment & Rating
- When Active Comment & Rating is Yes, the following options are shown: Auto approved Comment, Show rating icon, Only logged user can submit review, One user can write one review, Allow user to edit comment
CSV setting
- CSV fields Seperator – Comma or Semicolon
Market Status
- Active Market Status
- Select Market status (shown when Active Market Status is Yes) – choose one or more of: Sold, Current, Rented, Off Market, For Sale, For Rent, Sale Pending
Walking score setting
- Show walked score tab
- When enabled: Walked score ID (a Walk Score API key, which can be requested from walkscore.com), Width size of Walked score (px), Height size of Walked score (px), and Unit (Miles or Kilometers)
Property print
- Activate Property Print
- When enabled: Show amenities in printing page, Show custom fields in printing page
PDF Export
- Activate PDF Export feature
- When enabled: Select font in PDF export layout, Show Map image in PDF, Show custom fields in PDF page
Related Properties
- Show Related properties
- When enabled:
- Max relate properties
- Number columns – 2, 3, or 4
- Show related properties by distances and Distance (5, 10, 20, 50, or 100 miles)
- Show related properties in same type
- Filter related properties by price and categories – a price range (From – To) for each published category; leave the price empty if you do not want to filter by category and price
Tweet Auto Posting
- Enable Tweet Auto Posting
- When enabled: Posting Properties (Both new and updated properties, Only new properties, or Only updated properties), Consumer Key, Consumer Secret, Access Token, Access Token Secret
Impact of changes: Directly affects the user listing submission process, the property detail page layout, the fields available when adding a property, and the ability to interact with properties.
Notes:
- When Auto approval is enabled, listings submitted from the front-end appear immediately without review.
- Changing the SEF link format after the website is already live may affect SEO and previously saved links.
- When Active Comment & Rating is turned off, the system automatically sets Show rating icon, Only logged user can submit review, and Allow user to edit comment to No when the configuration is saved.
- If Activate PDF Export feature is enabled and the mPDF library is not installed, the Configuration page displays a warning with instructions to download and install the library.
- The Layouts tab (section 2.4) also contains a Show Print option that uses the same setting as Activate Property Print. Because all tabs are saved together, keep both switches consistent.
2.3 Payment & Expiration
Purpose: Control the listing fee and automatically manage the listing lifecycle.
Settings, in the order they appear on the tab:
Offering Paid Listing
- Activate Payment – when turned on, users need to pay for posting properties at the front-end
- Cost per Standard property – shown when Activate Payment is Yes; the cost of each standard property, in the default currency
Expiration Management setting
- Use expiration Management – Yes/No
- Live time of Standard property (days)
- Live time of Featured property (days)
- Remove Property After (days) – the grace period between when a listing is discontinued and when it can be cleaned from the database; during this period listings can be renewed
Nearly Expiration Checking
- Number of properties to check per Checking Time time – the maximum number of properties checked each time the cron task runs
- Do you want to allow to send the approximates? – sends an alert email to the OS Property user when a property's expiration is approaching
- Send expire notification before (days)
Impact of changes: When payment is enabled, users pay for posting properties at the front-end. When disabled, listings are free.
Important notes:
- Front-end payment is planned to be discontinued in a future version. Featured status can no longer be bought or changed at the front-end; it is managed at the back-end. The Configuration screen has no separate fee for featured properties.
- When enabling expiration on a system that already has existing listings, the countdown will also be applied to those older listings. Consider this carefully before enabling the feature on a live system.
- The expiration notifications require a cron job configured on the server to run automatically on a schedule.
2.4 Layouts
Purpose: Control the default layout, listing pages, category pages, property details pages, and front-end property modification.
Settings, in the order they appear on the tab:
Default layout
- Show one random feature property
- Show quick search – shows the quick search module block in the homepage of OS Property
- Show homepage box
- Intro text Homepage – the content shown in the homepage of the system (an editor is provided for each language of the website)
List Properties Setting
- Show filter form – shows the search form at the top of the listing page
- Show price
- Show User
- Show address
- Show number view
- Show rating of the property
- Show number rooms of the property
- Show number bedrooms of the property
- Show number bathrooms of the property
- Show number comments of the property
Category Settings
- Category layout – One to Five Columns
- Show description
- Show sub categories
- Active RSS – activates the RSS feed on the category listing page
- Order Properties By – Title, Ref, Created, Modified, Price, Featured, or Ordering
- Order Property Type – Descending or Ascending
Property details setting
- Select theme for property details page – Inherit from global configuration or one of the installed OSP themes
- Show request more details form
- Allowed subjects – the subjects shown in the Request More Details form: Tell Me More about This Property, Request A Showing, Request Recent Sales, Request School Information, Request Neighborhood Information, Request Similar Listings Via Email, Request Property availability information
- Show Term and Condition – requires users to agree to the Terms and Conditions before submitting the form
- Select Article – the Terms and Conditions article
- Copy Admin – sends a copy of the "Request more details" email to the administrator
- Log requests – requests can be reviewed at Tools → Request logs
- Show captcha in Request More Details form
- Use Google reCaptcha in Request More Details
- Turn on Tell a friend form
- Show captcha in Tell a friend form
- Allow logged user to pass captcha form
- Show Print
- Save to favorites
- Show get direction icon – uses the Google Map API; the icon is shown in the property listing and property details
- Show compare properties icon – shown in the property listing and property details
- Show gallery tab
- Show User information tab
- Show amenity group
- Show unselected amenities
- Show amenities – Two Columns or Three Columns
- Show feature fields group
- Show neighborhood fields group
Front-end Property modification
- Photo upload at front-end – Ajax Upload or Standard Upload
Impact of changes: Affects how the homepage, listing pages, category pages, and property detail pages are displayed on the front-end.
2.5 Company
Purpose: Control the registration and management of real estate company accounts.
Settings, in the order they appear on the tab (section "Company setting"):
- Company register – allow registered users to create a company profile
- Show Login box on Registration form
- Show captcha on company registration form
- Show Term and Condition
- Select Article – the Terms and Conditions article
- Auto approval company registration request
- Company admin can add new agent – at the front-end
- Alow company admin to change Featured status – of an agent
- Allow to assign free agent – allows a company admin to assign a free agent to his or her company
- Company admin add/edit properties
- Company Joomla user group – assign Joomla permissions to company admins
- Use email as username – the Username field can be removed from the registration form
- Registration completed link – leave it empty to redirect users to the Home page
Impact of changes: Company permission settings directly affect the operational capabilities of companies currently active on the system.
Notes:
- Changing the Joomla user group removes all existing companies from the old group and adds them to the new group when the configuration is saved.
2.6 User Type
Purpose: Control OS Property users (agents, owners, and so on): the permitted user types, the fields shown on the user profile, registration, and front-end display.
Settings, in the order they appear on the tab:
Select User types
- Select User types – multiple selection among Agent, Owner, Realtor, Broker, Builder, Landlord, and Seller. Agent and Owner are the default user types
- Default user type – the user type assigned automatically when a Joomla registered user adds a new property at the front-end; it is chosen among the selected user types
OS Property User Fields
Yes/No switches that control displaying each field: Show User Picture, Show User address, Show User email, Show User fax, Show User mobile, Show User phone, Show User Line Messages, Show User Skype, Show agent Linkin, Show agent Google Plus, Show User Facebook, Show agent Twitter, Show User License
OS Property User Registration
- Allow registered
- Joomla User group – assign Joomla permissions to agents/owners
- Auto approval User register request
- Show Login box on Registration form
- Show captcha in User registration form (uses Joomla Captcha)
- Show Term and Condition
- Select Article – the Terms and Conditions article
- Use email as username
- Agent/owner is also Joomla user – Yes or Optional
- Registration completed link – leave it empty to redirect users to the Home page
OS Property User Front-end Settings
- Show Search tab in User listing page
- Only show agents already added properties
- Show Alphabet filtering in Users listing page
- Allow User to upload their properties
- Show most rated properties in User page
- Show most viewed properties in User page
- Show User contact
- Display properties of the user
Impact of changes:
- Changing the Joomla user group removes all existing agents from the old group and adds them to the new group when the configuration is saved.
- Turning off Allow registered prevents users from registering as OS Property users from the front-end.
2.7 Images
Purpose: Control the size of images and protect the brand using watermarks.
Settings, in the order they appear on the tab (section "Images Settings"):
Image sizes
- Thumbnail Settings – Width and Height (px)
- Medium Image Settings – Width and Height (px)
- Large Image Settings – Max width size of image and Max height size of image (px)
- Background Color – the color used to fill the empty space (top, bottom or left, right) of medium or thumbnail photos
Watermark Settings
- Use Image Watermarks – Yes/No. Watermarks currently include a sold graphic for sold listings and a graphic for featured listings. The following options are shown only when this option is Yes:
- Apply for all Medium pictures – by default, only the first medium photo gets the watermark
- Image Quality (%)
- Water position – Top left, Top center, Top right, Middle right, Middle center, Middle left, Bottom right, Bottom center, or Bottom left
- Watermark type – Text or Image
- Font family, Watermark font-size for Thumb / Medium / Original, Watermark text color (Red, Green, Blue, Yellow, Orange, Black, White, Gray), Watermark text (Category, Property type, Business name, or Custom text), and Custom text
- Watermark Logo (Thumbnail), Watermark Logo (Medium), Watermark Logo (Large/Original) – image uploads, with a Remove current image checkbox for an uploaded logo
Impact of changes:
⚠️ Important note: Watermarks are applied at the time of image upload and are not applied retroactively. Images uploaded before the watermark configuration was changed will not be affected. Only images uploaded after the new configuration is saved will carry the new watermark settings.
Notes:
- On Joomla 5 and later, the Text watermark type and the text watermark options (font family, font sizes, text color, watermark text, and custom text) are not displayed; only image watermarks (logos) are available.
- The page shows a warning when watermarks are enabled with the Image type but no watermark image has been selected, or with a custom text watermark with no text entered.
2.8 Search
Purpose: Control the search form, price filtering, locator search, and advanced search.
Settings, in the order they appear on the tab:
General
- Show states/cities that have properties – only list states/cities that have properties available (turning this on makes OS Property load more slowly)
- Show My Location – note that the My Location function may not work in Chrome browsers
- Select property type – the property types shown in the search form; when specific types are selected they are displayed as tabs above the search form (the first option is All property types)
Price Filtering
- Price Filter Type – Drop-down select list with pre-defined options or Max-Min Slider Filter
- Min Price on Slider
- Max Price on Slider
- Price Slider Step Amount
- For each property type, an As above checkbox uses the slider values above; otherwise you can enter a separate Min Price on Slider, Max Price on Slider, and Step for that property type
Locator search setting
- Default location
- Default radius – 5, 10, 20, 100, or 200
- Radius type – Miles or Kilometer
- Maximum properties in results
- Show property type
- Show category
- Show address
Advance search setting
- Default Sorting by – Featured, Ref, Property title, List date, Price, or Square feet / Square meter (depending on the Land Area Unit of Measurement in the Properties tab)
- Default Ordering by – Descending or Ascending
- Show -More Option-
Impact of changes: Directly affects the search interface and users' ability to filter results.
2.9 Currencies
Purpose: Show the list of currencies available in the system.
Used Currencies: a table listing each currency by Currency Name, Currency Code, Currency Symbol, and Published. Clicking the star icon in the Published column publishes or unpublishes the currency immediately (via AJAX); this does not require clicking Save.
Notes: Only published currencies can be selected as the Default currency in the General tab (section 2.1).
2.10 Custom CSS
Purpose: Allow front-end interface customization without directly editing template files.
Configurable settings:
- A single code box containing the custom CSS for OS Property. The content is saved to the file
media/com_osproperty/assets/css/custom.css
Note: This tab is displayed only when the CodeMirror editor plugin is enabled.
2.11 Membership integration
Purpose: Integrate OS Property with the OS Membership extension.
Settings (section "Membership integration setting"):
- Membership integrate – select Yes if agents/owners must purchase a subscription before they can add normal or featured properties
- No subscription redirect link – the page users are redirected to when they do not have a subscription (the homepage of the website by default)
Notes:
- This tab is displayed only when OS Membership (
com_osmembership) is installed. When it is not installed, the integration option is automatically set to No when the Configuration page is opened.
2.12 OS Calendar
Purpose: Integrate OS Property with the OS Calendar extension.
Settings (section "OS Calendar integration setting"):
- OS Calendar integration – use the Availability Calendar and Reservation feature in OS Property
- Select property types – the property types for which the date range search will be shown
Notes:
- This tab is displayed only when OS Calendar (
com_oscalendar) is installed.
3. Configuration Management Workflow
3.1 Viewing and Reviewing Current Configuration
- Log in to the Joomla administration panel.
- Go to Components → OS Property → Configuration.
- Navigate through each tab to review the currently applied settings.
- No action is needed if only reviewing — the configuration will not change unless Save is clicked.
3.2 Updating Configuration
- Access the Configuration screen as described above.
- Select the tab containing the configuration group to be changed.
- Make the desired value changes.
- Click Save (or Apply to stay on the page) to save all changes.
- The system applies changes immediately — no cache clearing or restart is required.
Note: The Save action applies all tabs, not just the currently viewed tab. If a colleague is changing the configuration at the same time, two consecutive saves may overwrite each other.
3.3 Post-Change Verification
After saving, it is recommended to verify:
| Changed Configuration Group |
What to Check |
| Business information |
Print page, outgoing emails, page footer |
| Currency |
Prices displayed in listings and detail pages |
| Map |
Map on the property detail page |
| Search |
Search form and search results |
| Layouts |
Homepage, listing, category, and property details pages |
| Agents/Companies |
Registration form, agent listing page |
| Images/Watermark |
Upload a new image and check the applied watermark |
| Payment |
Listing submission process with payment step |
| Expiration |
Listing status of a test account |
3.4 Managing Sensitive Configuration Changes
Some configurations have wide-reaching effects and must be handled carefully:
| Sensitive Configuration |
Recommended Action Before Changing |
| Joomla group for agents/companies |
Notify the operations team in advance; all existing users will be moved |
| Enable listing expiration system |
Confirm how many existing listings will be affected |
| Auto-approve listings |
Ensure an alternative content control process is in place |
| Enable/disable payment feature |
Verify the current payment process is working |
| Change SEF URL format |
Check existing links before and after the change |
4. Business Rules and Operational Notes
4.1 General Principles
- All changes take effect immediately after saving, regardless of cache or system settings.
- There is no undo feature — to restore previous settings, the old values must be re-entered manually.
- Only users with OS Property component management permissions are allowed to access and change the configuration.
4.2 Dependencies Between Configurations
| Primary Configuration |
Dependent Configuration |
Notes |
| Use Image Watermarks |
Apply for all Medium pictures, Image Quality, Water position, Watermark type, text options, watermark logos |
These options are only displayed when watermarks are enabled |
| Activate Payment |
Cost per Standard property |
Only displayed when payment is enabled |
| Use expiration Management |
Live time of Standard/Featured property, Remove Property After |
Expiration notifications rely on a working cron job |
| Select Map type = Google Map |
Google API Key, Map Overlay, Show street view in Details |
Only displayed when Google Map is selected |
| Active Privacy Policy |
Privacy Policy Article, Turn on Profile opt-in |
Only displayed when the privacy policy is active |
| Show walked score tab |
Walked score ID, width, height, Unit |
Only displayed when enabled |
| Active Comment & Rating |
Auto approved Comment, Show rating icon, Only logged user can submit review, One user can write one review, Allow user to edit comment |
Only displayed when enabled |
| Activate Property Print |
Show amenities / custom fields in printing page |
Only displayed when enabled |
| Activate PDF Export feature |
Font, Show Map image in PDF, Show custom fields in PDF page |
Only displayed when enabled; the mPDF library must be installed |
| Show Related properties |
Max relate properties, columns, distance, same type, price filters |
Only displayed when enabled |
| Active Market Status |
Select Market status |
Only displayed when enabled |
| Enable Tweet Auto Posting |
Posting Properties and the API keys/tokens |
Only displayed when enabled |
| Membership integrate |
No subscription redirect link |
OS Membership must be installed, otherwise the tab is hidden |
| OS Calendar integration |
Select property types |
OS Calendar must be installed, otherwise the tab is hidden |
| Show Term and Condition (company, user, request form) |
Select Article |
The article must exist in Joomla |
4.3 Configuration Constraints
- The default user type is chosen from the list of selected user types.
- Only published currencies can be selected as the default currency.
- The Limit Zoom level of the map is between 0 and 18.
- If the energy or CO₂ class and value fields are left empty, they are filled with the defaults when the page is displayed (classes A,B,C,D,E,F,G; energy values 50,90,150,230,330,450; CO₂ values 5,10,20,35,55,80).
4.4 Invalid Changes or Cases Requiring Attention
- When disabling the comments system (Active Comment & Rating), saving the configuration automatically sets Show rating icon, Only logged user can submit review, and Allow user to edit comment to No.
- Watermarks are not applied retroactively — changing watermark settings does not affect images uploaded previously.
- Changing the Joomla group for agents or companies will move all existing users from the old group to the new group when the configuration is saved — this is a wide-impact operation that cannot be easily undone.
- Enabling listing expiration on a live system will start the countdown timer for existing listings — users should be notified in advance.
- Changing the SEF URL format after the website is live may cause 404 errors for old URLs that have been indexed by search engines.
4.5 Access and Permissions
- Only users with OS Property component management permissions (typically Super Administrators or Administrators with specifically granted rights) can view and change the configuration.
- These permissions are managed through Joomla's standard ACL system, under Options → Permissions for the component.
5. Common Scenarios
Scenario 1: Reviewing Configuration Before Going Live
Context: A newly installed system or after a version upgrade, a full configuration review is needed before opening to users.
Steps:
- Go to Configuration and open each tab in turn.
- Check business information (name, email, phone).
- Confirm that the default currency and price format are appropriate for the market.
- Verify the Google Maps API key is still valid.
- Confirm the listing approval process (auto or manual).
- Check whether required integrations (Membership, Calendar) have been enabled.
Scenario 2: Enabling the Listing Fee Feature
Context: Deciding to switch from a free model to a paid model.
Steps:
- Go to the Payment & Expiration tab.
- Enable the Activate Payment option.
- Enter the Cost per Standard property.
- Ensure at least one Payment Plugin (PayPal, Stripe, etc.) has been installed and configured in the plugin management area.
- Test the listing submission process from a test account.
Note: If no Payment Plugin is configured, enabling payment may prevent users from completing the listing submission process.
Scenario 3: Changing the Map Provider
Context: Switching from Google Maps to OpenStreetMap (or vice versa) due to a change in API cost policies.
Steps:
- Go to the General tab → Map section.
- Change the Select Map type option.
- If switching to Google Maps: enter a valid Google API Key.
- If switching to OpenStreetMap: no API key is required.
- Save the configuration and check the map on a property page.
Scenario 4: Configuring Brand Watermarks
Context: Wanting to add a logo or brand name to all property images.
Steps:
- Go to the Images tab.
- Enable Use Image Watermarks.
- Select the watermark type (text or image; on Joomla 5 and later only image watermarks are available).
- Configure the position, then upload the watermark logo files (for image watermarks) or configure the font, size, color, and text (for text watermarks).
- Save the configuration.
- Upload a new property image to verify the result.
Note: Previously uploaded images are not affected. To apply the watermark to old images, those images must be re-uploaded.
Scenario 5: Enabling the Listing Expiration System
Context: Wanting to automatically manage the listing lifecycle to prevent old listings from persisting indefinitely.
Steps:
- Notify existing users in advance about the new expiration policy.
- Go to the Payment & Expiration tab.
- Enable Use expiration Management.
- Set an appropriate Live time of Standard property and Live time of Featured property (e.g., 30 days and 15 days).
- Set Remove Property After (e.g., 15 days) so users can renew before the listing is deleted.
- Enable the expiration email option (Do you want to allow to send the approximates?) and set Send expire notification before (e.g., 4 days).
- Ensure a cron job has been configured on the server.
- Save the configuration and monitor the system for the first few days.
Scenario 6: Users Report Missing Property Types in the Search Form
Context: Users report that a property type is not shown as a tab in the search form.
Steps:
- Go to the Search tab.
- In the General section, check the Select property type option.
- Select the property types that should be shown (or All property types).
- Save the configuration and verify the search interface.
Scenario 7: Map Not Displaying on the Website
Context: Users report that the map displays an error or fails to load.
Steps:
- Go to the General tab → Map section.
- Check the Google API Key currently configured.
- Confirm the API key is still valid and has not exceeded its usage quota (check on Google Cloud Console).
- If the API key cannot be renewed, consider temporarily switching to OpenStreetMap.
- Save the configuration and reload the property page to verify.
Scenario 8: Restricting Allowed Registration User Types
Context: Only wanting to allow "Agent" and "Homeowner" account types to register, and no others.
Steps:
- Go to the User Type tab.
- Under Select User types, deselect the user types that should not be activated.
- Ensure the Default user type is still one of the selected user types.
- Save the configuration.
- Check the registration form on the frontend to confirm only the selected types are available.
6. Summary for Backend Administrators
What Configuration Currently Supports
| Feature Group |
Level of Control |
| Business brand information |
Full |
| Currency and price format |
Full |
| Map (Google Maps / OpenStreetMap) |
Full |
| Listing submission and approval workflow |
Full |
| Fee collection and listing expiration management |
Full |
| Agent management and user types |
Full |
| Real estate company management |
Full |
| Image processing and watermarks |
Full |
| Search and filters |
Full |
| Social features (sharing, favorites, comparison) |
Full |
| GDPR / Privacy |
Basic |
| OS Membership integration |
Basic (requires additional installation) |
| OS Calendar integration |
Basic (requires additional installation) |
| Walk Score |
Basic (requires a Walk Score key) |
| Custom interface CSS |
Yes (when the CodeMirror editor plugin is enabled) |
Key Points to Remember
- Changes take effect immediately — there is no staging or preview; all changes are applied directly to the live website.
- No undo — record old values before making changes if restoration may be needed.
- Watermarks are not retroactive — only applied to images uploaded after the new configuration is saved.
- Changing the Joomla group for agents/companies affects all existing users.
- Some features require additional infrastructure: cron jobs (expiration notifications, alert emails), API keys (Google Maps, Walk Score), payment plugins.
Configurations Requiring Strict Control
| Configuration |
Reason for Strict Control |
| Joomla group for agents/companies |
Wide impact on all existing users |
| Enable listing expiration system |
Affects all existing listings |
| Enable/disable auto-approve listings |
Affects content control |
| Enable/disable payment |
Affects revenue and listing submission workflow |
| Change SEF URL format |
May cause broken links after the change |
| Watermark configuration |
Cannot be retroactively applied to old images |
Ongoing Operational Monitoring Points
- API keys: Google Maps, Walk Score, and other service credentials such as Tweet Auto Posting — usage quotas and renewals should be monitored periodically.
- Cron jobs: Automated features (expiration notifications, alert emails) depend entirely on cron jobs running on the server — these should be checked periodically.
- Payment plugins: Payment gateway configuration (PayPal, Stripe, etc.) is managed separately under Payment Plugins, not within this Configuration screen.
- Currencies: The list and status of each currency is managed under the dedicated Currencies tab in Configuration (changes to a currency's Published status are applied immediately, without clicking Save).
- Advanced per-property-type configurations (separate price ranges, rental calendars) should be verified separately for each property type configured in the system.