=== Plotviora ===
Contributors: mujahidsarfraz
Requires at least: 6.6
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: blog, one-column, two-columns, three-columns, four-columns, full-site-editing, block-patterns, block-styles, custom-colors, custom-logo, custom-menu, editor-style, featured-images, full-width-template, grid-layout, wide-blocks, style-variations, template-editing, threaded-comments, translation-ready

A premium-feel block theme for real estate agencies, property dealers, builders and realtors.

== Description ==

Plotviora is an elegant, accessible block theme for real estate websites. It ships with more than 35 hand-crafted patterns, eight ready-made page layouts, four style variations and original illustrations, so a complete property website can be assembled in minutes with the Site Editor.

Patterns include:

* Hero sections: dusk illustration with property search, split hero with image, page intro
* Properties: property showcase cards, live listing grid, property of the month, browse by type, neighbourhoods, market insights
* About & services: company story, why choose us, statistics, buying process, service cards, detailed services, mission & values, timeline
* Agents & reviews: team grid, testimonials, featured testimonial, partners
* Conversion: call to action banner, free valuation, service packages, FAQ accordion
* Contact: contact cards, contact section with map
* Headers and footers: header with contact bar, centred header, rich footer, minimal footer

Full page layouts: Home, About, Services, Properties, Agents, Sell Your Property, FAQ and Contact. When you add a new page, WordPress offers these layouts in the "Choose a pattern" window. They are also available in the inserter under "Plotviora: Full Pages".

Templates: front page, blog, archive, search, 404, single property (with viewing sidebar), single without sidebar, page, wide page and full width page.

Style variations: Default (Ink & Brass), Midnight, Emerald Estate, Terracotta and Coastal.

Property listings use standard posts so your content stays portable: use categories such as For Sale, For Rent or New Project, tags for features (Pool, Garage, Garden) and the featured image for the property photo.

== Installation ==

1. In your admin panel, go to Appearance > Themes > Add New > Upload Theme.
2. Upload the plotviora.zip file and click Activate.
3. Go to Appearance > Editor to customise templates, patterns, colours and fonts.

== Frequently Asked Questions ==

= How do I create the About, Services or Contact page? =

Go to Pages > Add New. In the "Choose a pattern" window select one of the Plotviora page layouts, for example "About Page". You can also insert them later from the block inserter under Patterns > Plotviora: Full Pages.

= How do I create a homepage like the demo? =

The front page template already uses the Home layout. To edit it, open Appearance > Editor > Templates > Pages: Front Page. If you prefer a static page, create a page with the "Home Page" layout and assign the "Full Width (No Title)" template.

= How do I add a property? =

Create a new post, add a title, description and featured image, then assign a category such as For Sale or For Rent. Add features as tags.

= Does the theme add a custom post type? =

No. Content types belong in plugins, so Plotviora uses regular posts for listings. Your content stays intact if you switch themes.

= Where is the contact form? =

Themes cannot include forms. The Contact Page layout includes a placeholder card; replace it with the block of any contact form plugin.

== Changelog ==

= 1.1.0 =
* Complete redesign with a refined typographic system and new colour palette.
* Added 35+ patterns, eight full page layouts and new templates.
* Added four style variations, custom block styles and original illustrations and icons.

= 1.0.0 =
* Initial release.

== Copyright ==

Plotviora WordPress Theme, (C) 2026 Muhammad Mujahid Sarfraz.
Plotviora is distributed under the terms of the GNU GPL v2 or later.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

This theme bundles no third-party fonts, images, icons or scripts. It uses system font stacks.

== Resources ==

* All illustrations in assets/images (hero-villa.svg, prop-*.svg, about-interior.svg, contact-map.svg, agent-*.svg), (C) 2026 Muhammad Mujahid Sarfraz, created for this theme, GPLv2 or later.
* All icons in assets/icons, (C) 2026 Muhammad Mujahid Sarfraz, created for this theme, GPLv2 or later.
* screenshot.png, (C) 2026 Muhammad Mujahid Sarfraz, a capture of the theme using the illustrations above, GPLv2 or later.
