=== DIGISTARTER Immobilienverwaltung ===
Contributors: digistalter
Tags: immobilien, makler, real estate, property listings, crm
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Present and manage properties on a real estate website, with customer inquiries and an integrated financing calculator.

== Description ==

DIGISTARTER Immobilienverwaltung turns WordPress into a full property management and presentation system for real estate agents and property companies: a dedicated entry form for properties, a single property page and a filterable archive page that automatically inherit the design of the active theme, a customer inquiry CRM, and an integrated financing calculator. 

**Free and unrestricted**

DIGISTARTER Immobilienverwaltung is free, with no artificial limits on the number of properties you can manage and publish, and no functionality locked behind a paid tier.

**Property management**

* A dedicated entry form for properties: core data, property details, description, media gallery, energy certificate, marketing details.
* Property type (residential/land/commercial, including subcategories), marketing type (for sale/for rent), and availability as protected, system-managed classifications.
* Fields automatically show or hide to match the selected property type/marketing type and, once visible, are required -- preventing incomplete listings.
* An automatic, permanently stable property number for each listing, used as part of the URL, which stays unchanged even if the property is renamed.
* Assign a WordPress user account to each property as its contact person; they appear as a card on the property's frontend page and receive inquiry notifications for that property.

**Customer inquiries (CRM)**

* Inquiries from the frontend contact form land automatically in a dedicated inquiry management screen in the backend: status, notes, history.
* Email notification to the contact person assigned to the respective property.
* Spam protection without a CAPTCHA (honeypot, time trap, IP rate limiting).
* Consent is required (GDPR Art. 6(1)); IP addresses are stored in truncated form.
* Complete deletion of a contact, including all linked inquiries, is also available through WordPress' own tools for exporting/erasing personal data.

**Financing calculator**

Every property listed for sale shows a sample financing calculation (equity/amortization rate freely adjustable). If a prospect checks the box requesting a financing offer when submitting an inquiry, that inquiry is automatically forwarded to our licensed financing partner in the background. The agent simply sees, on the inquiry, that a financing offer was requested.

The same calculator is also available as a block and a matching pattern, for any page you like -- independent of a specific property. Visitors enter the purchase price, federal state and agent commission themselves; incidental costs, total cost and the monthly instalment are recalculated as they type. The inquiry form below it feeds into the same CRM, marked as coming from the financing calculator.

A representative example (Section 6a PAngV) can be maintained under Settings and is then shown below every calculator.

**Frontend**

* The single property page and the archive page with filtering/search inherit the design, typography, and colors of the active theme.
* Media carousel, price-per-square-meter calculation, energy efficiency class scale.
* Works with any block theme; classic themes are supported through a fallback.

== Third Party Services ==

If a prospect requests a financing offer through the inquiry form, this plugin sends their name, email address, phone number, the purchase price together with the incidental purchase costs calculated from it (real estate transfer tax, agent commission, notary and land registry fees), and the values set in the financing calculator (equity, amortization rate) to our own financing partner via a webhook, so that partner can contact the prospect directly with a real offer. The purchase price is the one on the property; for an inquiry from the standalone financing calculator, it is the price the prospect entered there. This only happens when a prospect actively opts in by checking that box; no data is sent otherwise.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or upload it via "Plugins -> Add New".
2. Activate the plugin.
3. Add your first property via "Immobilien -> Neu hinzufügen" (Add New).
4. Optionally assign a contact person to each property via its edit screen.

== Frequently Asked Questions ==

= Do I need to adapt my theme? =

No. The single property page and the archive page automatically inherit the header, footer, colors, and fonts of the active theme.

= Is there a limit on how many properties I can manage? =

No. All properties can be managed and published without limit.

= What happens to my data if I uninstall the plugin? =

By default, everything is kept when the plugin is uninstalled. Only if the "delete all data" option is enabled under "Einstellungen" (Settings) does uninstalling permanently remove properties, inquiries, contacts, and settings.

== Changelog ==

= 1.1.0 =
* New "Financing calculator" block and pattern: the calculator, with its own inquiry form, on any page you like -- with no property behind it. Purchase price, federal state and agent commission are entered by the visitor.
* Inquiries from that calculator land in the same inquiry management screen, marked "Financing calculator", including the values the visitor set.
* New under Settings: a representative example (Section 6a PAngV) with its own fields, shown below every calculator in place of the short sample-calculation note. The two-thirds statement is part of it and can no longer be lost by clearing a free-text field.
* Without a representative example, no financing calculator is displayed at all -- a monthly instalment may not be advertised without one. Users who can edit the settings see a note explaining this.
* The advertised instalment and the representative example are now tied together by a footnote marker. It is a superscript number, not an asterisk, because the asterisk marks required form fields.
* Forms now carry a "* Required field" legend and link to your privacy policy page, if one is set under Settings -> Privacy.
* In the standalone calculator, requesting a financing offer is a required field -- an inquiry from there is the financing request. On a property page it stays optional.
* The inquiry list column "Property" is now called "Inquiry about", because it holds either a property or the note that the inquiry is about financing. The detail screen uses the same wording, and the values from the calculator are grouped there.
* The incidental purchase costs (real estate transfer tax, agent commission, notary and land registry fees) are recorded with an inquiry, shown on its detail screen and forwarded to the financing partner -- from a property page as well as from the standalone calculator. They are stored as calculated at the time of the inquiry, so a later retry sends the same figures even if your rates have changed since.
* The debit interest rate preset for the financing calculator is now 4.12 %. An existing setting is not changed.
* Fixed: after moving the slider, the note below the calculator showed the amortization rate with a duplicated percent sign.

= 1.0.1 =
* All translatable strings are now in English, so the plugin can be translated on translate.wordpress.org.
* German is bundled with the plugin (informal and formal), including Austrian and Swiss variants.
* The built-in classification terms now follow your site language and may be renamed on update. Your properties and their assignments are not affected.

= 1.0.0 =
* First release: property management with required-field validation, single/archive pages in the active theme's design, customer inquiry CRM, financing calculator, contact-person assignment.

== Upgrade Notice ==

= 1.0.1 =
The built-in classification terms now follow your site language and may be renamed on update. Your properties and their assignments are not affected.

= 1.0.2 =
Minor bug fixes

= 1.1.0 =
The financing calculator is now also available as a block/pattern for any page. Check the representative example under Settings before you publish it.
