Vieww Property Listings

Description

Vieww Property Listings gives you a beautiful, easy-to-manage property listings page on your WordPress site — without the complexity (or cost) of a full real estate platform.

Ideal for real estate agents, property managers, holiday rental owners, and small agencies, it lets you publish properties with all the details buyers and renters expect: price, bedrooms, bathrooms, parking, land and building sizes, location, and photo galleries. Visitors can browse a filterable grid by type, status, location, or bedroom count, then click through to a polished single-property page with a contact sidebar so enquiries land straight in your inbox.

Make it your own with built-in style controls for colours, contact text, currency symbol and area units — so the listings feel like part of your site, not a bolt-on.

What you get:

• A Dedicated Properties Section — listings live in their own area of your WordPress admin, separate from posts and pages
• All The Details That Matter — price, bedrooms, bathrooms, parking, land size, building size, and address
• Organised Your Way — group properties by Type (house, apartment, etc.), Status (for sale, sold, leased), and Location
• Filterable Property Grid — let visitors search by type, status, location and minimum bedrooms
• Beautiful Single Property Pages — featured image, features at a glance, full description, photo gallery with lightbox, and a contact sidebar
• Match Your Brand — pick your own colours, contact text, currency symbol and area units (m² or sq ft)
• Drop-In Shortcodes — place property grids, details, search forms and feature bars anywhere on your site
• Mobile Friendly — responsive layout that looks great on phones, tablets and desktops
• Designer Friendly — every template can be overridden from your theme for full design control
• Secure By Default — built following WordPress security best practices

Shortcodes

[vieww_grid] – Property Grid

Display a filterable grid of property listings.

Attributes:

• per_page – Number of properties (default: 12)
• columns – Grid columns, 2 or 3 (default: 3)
• show_filters – Show filter form, yes/no (default: yes)
• type – Filter by property type slug
• status – Filter by property status slug
• location – Filter by location slug
• bedrooms – Minimum bedrooms (default: 0)
• orderby – Order by: date, price, or title (default: date)
• order – Sort direction: ASC or DESC (default: DESC)

Examples:

[vieww_grid per_page="6" columns="2" show_filters="no"]
[vieww_grid type="house" status="for-sale" location="brisbane"]
[vieww_grid orderby="price" order="ASC" bedrooms="3"]

[vieww_details] – Single Property Details

Display the full details for a specific property including image, features, description, gallery, and contact sidebar.

Attributes:

• id – Property post ID (default: current post)

Example:

[vieww_details id="42"]

[vieww_search] – Search Form

Display a standalone property search/filter form that submits to the property archive.

Attributes:

• action – Custom form action URL (default: property archive)

Example:

[vieww_search]

[vieww_features] – Feature Bar

Display the feature bar (bedrooms, bathrooms, parking, land size, building size) for a specific property.

Attributes:

• id – Property post ID (default: current post)

Example:

[vieww_features id="42"]<h3>Template Overrides</h3>

The plugin provides default templates that work out of the box. To customise them, copy the template file to your theme:

• single-vieww-property.php → your-theme/single-vieww-property.php
• archive-vieww-property.php → your-theme/archive-vieww-property.php
• content-vieww-property-card.php → your-theme/vieww-property-listings/content-vieww-property-card.php
• content-vieww-property-features.php → your-theme/vieww-property-listings/content-vieww-property-features.php
• content-vieww-property-gallery.php → your-theme/vieww-property-listings/content-vieww-property-gallery.php
• content-vieww-property-sidebar.php → your-theme/vieww-property-listings/content-vieww-property-sidebar.php
• content-vieww-property-filters.php → your-theme/vieww-property-listings/content-vieww-property-filters.php

External Services

This plugin connects to a small number of free, optional external services. Each is described below along with when it is used and what data is sent.

Google Fonts API

Used to load web fonts chosen in the Design Settings. Only occurs when a Google Font (as opposed to a system font) is selected in Properties > Design > Typography.

• URL: https://fonts.googleapis.com
• When used: Only when a Google Font is selected in Design Settings (off by default — system fonts are the default)
• Data sent: The names of the selected font families (e.g. “Inter”, “Poppins”). No personal data or site data is transmitted.
• Privacy policy: https://policies.google.com/privacy
• Terms of service: https://developers.google.com/terms

If you prefer not to use Google Fonts, simply leave the heading and body font selectors set to a System Font — no external requests will be made.

Nominatim (OpenStreetMap) geocoding

Used to convert a property’s address into latitude/longitude coordinates so the listing can be shown on the property map. Runs on the server when a property is saved in the WordPress admin, and in the browser when an admin clicks the “Geocode Now” button on a property edit screen.

• URL: https://nominatim.openstreetmap.org/search
• When used: Only on the admin side — when a property is saved with a new/changed address, or when the “Geocode Now” button is pressed in the Property Details meta box. No lookups run on the front-end.
• Data sent: The property’s address text and the country string “Australia”. No personal data.
• Privacy policy: https://osmfoundation.org/wiki/Privacy_Policy
• Terms of use: https://operations.osmfoundation.org/policies/nominatim/

Leaving the latitude/longitude fields filled manually in the property edit screen prevents any Nominatim request from being sent for that property on save.

Photon (komoot.io) address autocomplete

Used to show a real-time address suggestion dropdown in the admin while typing into the Address field. Selecting a suggestion populates the full address line and coordinates at once.

• URL: https://photon.komoot.io/api/
• When used: Only on the admin side — while an editor is typing into the Address field of a property. Requests stop if the user stops typing or clicks elsewhere. No lookups run on the front-end.
• Data sent: The partial address text the user is typing, plus a geographic bias toward Australia. No personal data, no site data.
• Privacy policy: https://www.komoot.com/privacy
• Service info: https://photon.komoot.io/

If you prefer not to use Photon autocomplete, simply ignore the suggestions and type the address manually — no suggestions will be acted on unless you click or Enter one.

Credits

This plugin bundles the following GPL-compatible open-source libraries:

• Leaflet (BSD-2-Clause) — https://leafletjs.com
• Leaflet.markercluster (MIT) — https://github.com/Leaflet/Leaflet.markercluster
• Lightbox2 (MIT) by Lokesh Dhakar — https://lokeshdhakar.com/projects/lightbox2/

The full license text for each library is included in its respective assets/vendor/<library>/LICENSE.txt file.