Agent Edit Profile

[TOC]

Purpose

The Agent Edit Profile page is the personal management dashboard for registered OS Property users — including agents, owners, brokers, builders, landlords, and sellers. From this single page, a user can manage their own property listings, update their professional profile details, and maintain their Joomla account settings. It is the primary self-service area for any registered user who lists or manages properties on the site.

How It Works

When a logged-in OS Property user navigates to the Edit Profile page, the system loads a combined view showing:

  1. Their property listings — A paginated, filterable table of all properties they have submitted
  2. Their OS Property profile — Fields for professional and contact information
  3. Their Joomla account details — Name, username, password, and email

Each section may be presented in separate tabs or panels on the page, depending on the site configuration.

Users who do not yet have an OS Property agent profile (for example, a brand-new Joomla user who has not yet been registered as an agent) will have a profile automatically created for them when they first visit this page.

How to Use It

Managing your properties

  1. Log in to your site account.
  2. Navigate to the Edit Profile page from the site menu.
  3. Browse your property listings — The list shows all properties you have submitted. Use the filter controls to narrow the list.
  4. Edit a property — Click the property name or edit link to open the property edit form and modify its details.
  5. Change a property's status — Use the published/unpublished toggle or action buttons to control whether a listing is visible on the site.
  6. Request approval — If a property is unapproved, you can submit a request for the administrator to review and approve it.
  7. Upgrade a property to featured — If the site supports property upgrades, you can pay to feature a standard listing, making it more prominent in search results.
  8. Delete a property — Remove listings you no longer wish to keep by selecting them and using the delete action.

Updating your profile

  1. Go to the OS Property profile section (tab or panel) on the Edit Profile page.
  2. Update professional information — Fill in or update your name, phone numbers, mobile, fax, address (country, state, city), and professional details.
  3. Update contact and social links — Provide or update your email address, Skype handle, MSN, Facebook, and other social profile links as applicable.
  4. Upload a profile photo — Upload a new profile photo that will appear on your public agent profile page and alongside your property listings.
  5. Save your profile — Click the Save or Apply button to store your updated information.

Updating your Joomla account

  1. Go to the Joomla account section (tab or panel) on the Edit Profile page.
  2. Update your display name, username, email, or password as needed.
  3. Save the account changes — Your Joomla account will be updated immediately.

Practical Use Cases

  • New agent onboarding — A newly registered user completes their profile by adding professional information, a photo, and contact details so they appear correctly on their public agent profile page.
  • Property status management — An agent reviews their listings, publishes newly prepared properties, and unpublishes properties that are no longer available.
  • Requesting approval — An agent has submitted a property but it is awaiting admin review. They use the approval request feature to prompt the administrator to review it.
  • Featured upgrade — An agent decides to promote one of their standard listings to a Featured property to attract more attention. They use the upgrade option on the Edit Profile page.
  • Keeping contact details current — An agent changes their phone number or adds a new social media link and updates their profile so visitors can reach them with accurate information.
  • Password change — A registered user changes their Joomla account password from the profile page.

Key Elements on the Screen

Property list section A table showing all properties submitted by the logged-in user:

  • Thumbnail photo
  • Property name (with edit link)
  • Reference number
  • Property type
  • Location (city, state)
  • Price
  • Published / Featured / Approved status
  • Expiry date (if expiration is enabled and applicable)
  • View count (hits)
  • Action buttons (edit, delete, publish/unpublish, request approval, upgrade)

Property filter controls

  • Keyword search — Search within your own listings by property name, reference, type, or location
  • Category filter — Show only properties in a selected category
  • Type filter — Filter by property type
  • Status filter — Show published or unpublished listings
  • Featured filter — Show featured or non-featured listings
  • Approval filter — Show approved or unapproved listings

Sort controls

  • Sort by — Reference, Title, Address, State, City, Published, Featured, ID, Price
  • Order — Ascending or descending

OS Property profile section Fields for managing professional and contact information:

  • Display name
  • Phone, mobile, fax numbers
  • Address (country, state, city)
  • Email address
  • Social media and contact links (Skype, MSN, Facebook, etc.)
  • Profile photo upload
  • Privacy opt-in setting
  • Company assignment (if applicable)

Joomla account section Fields for updating account credentials:

  • Full name
  • Joomla username
  • Email address
  • Password (change password fields)

Pagination Controls at the bottom of the property list for navigating between pages when there are many listings.

Expected Results

After visiting the Edit Profile page, the user has a clear view of all their listings and their current status. They can update any property, change its visibility, request approvals, or remove it. Profile changes (professional details, photo, contact info) are saved and reflected immediately on their public agent profile page. Joomla account changes (name, email, password) take effect immediately.

Important Notes

  • Only logged-in users can access the Edit Profile page. Visitors who are not logged in will be redirected.
  • The page only shows properties belonging to the logged-in user. To manage all properties site-wide, a user with Front-End Manage permissions must use the Manage Properties layout instead.
  • Requesting approval for an unapproved property notifies the administrator but does not automatically approve it. Final approval is still at the administrator's discretion.
  • Upgrading a property to Featured may involve a payment, depending on the site's configuration. The upgrade cost is set in the OS Property configuration. If OS Membership Pro is integrated, featured credits may be used instead.
  • If OS Calendar is integrated, the Edit Profile page may also include an availability calendar section for managing booking calendars on properties.
  • Profile changes made here are reflected on the user's public agent profile page visible to all site visitors.
  • If no profile photo has been uploaded, a placeholder image is displayed on the public profile and alongside property listings.
  • Deleting a property from this page is permanent.