MLSImport with WpResidence

On WpResidence, imported listings become ordinary WpResidence properties. They use the theme’s property post type, its taxonomies, its templates, its search and its agent pages, and nothing about them is an embed or an iframe.

That is the whole integration model: MLSImport supplies the data and the theme owns the presentation.

Before you start

WpResidence must be the active theme with its own plugin active, and the theme dropdown in MLSImport must be set to WpResidence. Setting the theme is what tells the plugin which fields and taxonomies to write to, so a mismatch here produces properties that look empty.

Where an imported listing lands

1. The listing becomes a property under Properties, editable like any other.
2. Price, size, bedrooms, bathrooms, postal code and the coordinates are written into the theme’s own fields, which is what makes sorting, search and map pins work.
3. The public remarks become the property description.
4. City fills City, county fills County / State, the specific property type fills Categories, the broad type fills Type, and status fills Property Status.
5. Feature style fields fill Features & Amenities, one term per value, so the theme’s feature checkboxes work on imported listings.
6. Photos are attached as the property gallery, served from the MLS image source rather than copied into your media library.

What MLSImport sets for you on a new property

On first import only, a property is created not featured, with the map zoom at 16 and the country set to United States, with the agent chosen on the import task assigned to it, and with every layout, header, sidebar and slider option set to inherit the theme default. Editing any of these afterwards is safe, because they are not rewritten on later syncs.

Extra MLS fields and the theme’s own field list

Any MLS field you switch on and do not map is registered in the WpResidence custom fields list, using the label and the order you set in Select Import fields. The theme prints it in the property details block in that order.

That same list feeds the theme’s advanced search builder, so a field you register also becomes selectable as a search criterion when you configure the search form.

What stays yours to configure

The theme continues to own everything visual: the property page layout, which details appear, the search form and its criteria, the map style, the agent and agency pages, and the contact forms. MLSImport writes no styles and replaces no templates.

Frequently asked questions

Can I edit an imported property by hand?

You can, and the next sync overwrites any field that comes from the MLS. Edits to fields the feed does not supply survive, so add your own content in fields MLSImport does not write.

Do manually created properties and imported ones live together?

Yes. They are the same post type and use the same templates and search. Only properties carrying an MLS identifier are managed by the sync and the daily cleanup, so your own listings are never touched by them.

Does MLSImport work with WpResidence page builder pages?

Yes. Any builder that can query the property post type lists imported properties, since they are normal posts with normal meta.

My properties import but the map is empty. What is wrong?

The theme places pins from the coordinates that came with the listing. Check that latitude and longitude are populated on a property in wp-admin. If they are empty, your feed did not supply them for that listing.

Related

1. Why a compatible theme or Standalone mode is needed
2. WpResidence: map zoomed out or listings clustered
3. Mapping for WpResidence, WpEstate and Real Homes
4. Choosing your theme mode

Send us your site and the page you are building and we will tell you which side owns the setting.