=== Datoden Contact Form ===
Contributors: datoden
Tags: contact form, contact, form, email, spam
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 3.0.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple, safe contact form for any page. Works with page caching and stops spam without captchas.

== Description ==

In the WordPress admin the plugin is shown as "DT-contact" in the DT-addons menu (Datoden's menu).

DT-contact adds a contact form to any page with the block Contact form or the shortcode [datoden_contact]. Messages are sent to your inbox, and when you answer, the answer goes straight to the visitor.

* One contact form with the fields you choose, in the order you choose: name, first name, last name, email, phone, company, text (one or several lines) and a checkbox (for example consent).
* Labels, placeholders, help texts, half or full width, required or optional, and an icon in front of each field.
* Your own recipient addresses, subject line (with field names in braces), button text and thank-you message.
* Every field type is recognised: the right keyboard on phones, the browser's autofill, and a check on the server (for example a real phone number or email address).
* Spam protection without captchas: a hidden trap field, a signed time check (the form must have been open for at least 3 seconds) and a limit of messages per visitor and hour. Visitor IP addresses are only stored as a hash, for one hour.
* Works on cached pages – no need to exclude the contact page from your page cache.
* Nothing is stored in the database: the message only goes to your inbox.
* Follows your theme's fonts and colours; choose the colour of the button.
* Send a test email from the settings page to check that email from the website arrives.
* Shows a link to your privacy policy under the form.
* Invisible robot check built in – no external service, no keys: the visitor's browser solves a small calculation in the background while the form is filled in.
* Works with DT-language: write the form's texts in each language, and visitors see the form in their language.

The plugin does not change the sender address of your website's email. If messages end up as spam, use a plugin that sends email via SMTP.

= Free Datoden account (optional) =

Everything in the plugin works without an account. A free Datoden account adds DT-website-guard, an overview of all your websites and settings profiles you can use on other websites.

= Pro add-on =

In the separate paid add-on Datoden Contact Form Pro (from Datoden, not part of this plugin): as many forms as you need, each with its own shortcode; more field types (organisation number, address, website, numbers, dates and times, drop-down lists, choices, groups of checkboxes, file uploads, hidden values, headings and text); and Cloudflare Turnstile or Google reCAPTCHA v3 as the robot check. This plugin works fully on its own without it.

== Frequently Asked Questions ==

= Where do the messages go? =

To the email address under Datoden → DT-contact (the site's admin email from the start).

= How do I add a heading? =

Use the block's settings, or the shortcode [datoden_contact title="Send a message"].

= Is the form GDPR-friendly? =

Messages are not stored on the website, only sent by email. The IP address is only used as a hash to limit the number of messages per hour and is deleted after an hour.

= How does the built-in robot check work? =

When a visitor starts filling in the form, the browser fetches a small task from your own website and solves it in the background (about a second on a phone). The answer is checked when the form is sent, and each task can only be used once. Nothing is sent to anyone else, and no cookies are used.

= Does it work behind Cloudflare or another proxy? =

Yes. The limit per visitor uses the visitor's real address when the request comes from Cloudflare or from a proxy in your own network. Other proxies or load balancers can be added with the filter datoden_contact_trusted_proxies.

= What if emails do not arrive? =

Click Send a test email on the settings page. If it does not arrive, your web host does not send email reliably – install a plugin that sends email via SMTP with a real email address.

== Screenshots ==

1. The settings page.
2. The contact form on a page.

== External services ==

This plugin can connect to Datoden (https://datoden.com), a service run by Responsit AB, Sweden. The connection is optional – everything in the plugin works without it. Nothing is sent to Datoden until an administrator clicks "Start DT-website-guard" (or "Connect") in the WordPress admin and approves the connection on datoden.se or datoden.com. You can disconnect at any time with "Disconnect" (or by turning DT-website-guard off) on the DT-website-guard page; then nothing more is sent.

What is sent to Datoden, and when (only while the website is connected, except the connection itself):

* When you connect: the website address, the administrator's language (Swedish or English), the WordPress address that Datoden returns to and a random check value. After you approve on Datoden, the website sends the one-time code it got back, together with the website address and the language, and receives a website key that is stored in your database.
* Once a day (WordPress cron), and when an administrator opens a DT plugin page and the last contact is more than six hours old: the website key, the language, and the folder names, versions and active state of the installed Datoden plugins (for example datoden-cookie-consent). The answer can contain short messages from Datoden and updated wording for the DT plugins' texts, which are shown on the plugins' pages.
* When an administrator opens the DT-website-guard page or a DT plugin page (at most every five minutes), or clicks "Check again": the website key, to get the latest result of Datoden's monitoring (up or down, response time, and the expiry dates of the SSL certificate and the domain). "Check again" also asks Datoden to check the website once more.
* When the DT-website-guard page is shown and the DT-website-guard plugin is installed: the list of Datoden's plugins and their versions is fetched from datoden.se, at most every six hours. No data about the website is sent.
* When you click "My websites": the website key, the language and the email address of the logged-in WordPress user, so that Datoden can sign you in directly if it is the same address as your Datoden account.
* When you save, use or delete a settings profile: the website key, and when saving the settings of DT-cookie and DT-darkmode (no personal data; website-specific values such as the logo and the privacy page are left out). They are stored in or read from your Datoden account.
* When you disconnect: the website key, so that Datoden can remove it.
* While connected, Datoden visits the public website every five minutes (like any visitor) to check that it is up, reads its SSL certificate and looks up the domain's public registration data to find when it expires. The plugin shows the dates as Datoden reports them; the website does not contact any other service for this.

Datoden terms: https://datoden.com/terms/
Datoden privacy policy: https://datoden.com/privacy-policy/

== Source code ==

Everything in this plugin is the original, human-readable source code. The PHP, JavaScript and CSS files are written by hand and are neither minified nor generated by a build tool, so there is no build step: the files in the plugin folder are the source and can be read and edited directly.

== Changelog ==

= 3.0.8 =
Core 3.0.8: the return from Datoden (Connect) is also checked with a WordPress nonce (WordPress.org review); the readme describes the source code.

= 3.0.7 =
Datoden-core 3.0.7: the plugins' settings are checked with a single database query when the page loads – missing or non-autoloaded settings used to cost one query each on every page.

= 3.0.6 =
* Review fixes in all plugins: prefixed JavaScript names, the WordPress 6.9 template enhancement output buffer (older WordPress: the buffer is closed explicitly), cache paths from content_url(). Dark Mode: block theme palettes are converted per use. SVG Support: steps back while the SVG Support plugin is active. Code Snippets: the WPCode switch button is shown for all imported snippets.

= 3.0.5 =
* Datoden-core 3.0.5: the plugin icon shows its symbol at full size, cut by the corner with the Datoden logo.

= 3.0.4 =
* Datoden-core 3.0.4: plugin icons without the white background – the cut corner is transparent and the Datoden logo uses the icon's light colour.

= 3.0.3 =
* Datoden-core 3.0.3: new plugin icon design – a cut white corner with the Datoden logo.

= 3.0.2 =
* Datoden-core 3.0.2: the plugin's own icon (the same as on WordPress.org) is shown in the DT-addons overview and in the header of the plugin's page.

= 3.0.1 =
* Datoden-core 3.0.1: the header on the plugin's page shows the plugin's name as on WordPress.org.

= 3.0.0 =
* New name on WordPress.org: Datoden Contact Form (shown as DT-contact in the DT-addons menu). The free plugin contains no locked Pro features – they are only in the separate Datoden Contact Form Pro. Websites with the earlier version are moved to the new folder automatically; settings are kept.

= 2.0.1 =
* Plugin Check: redirects to Datoden use wp_safe_redirect, and the descriptions on the Datoden plugins overview are translated with WordPress' own function. Datoden-core 2.0.1.

= 2.0.0 =
* New prefix datoden_ instead of dt_ (WordPress.org). Settings and data are moved automatically on the first load; the old [dt_…] shortcodes, hooks and REST routes keep working. Works together with older DT plugins until they are updated. Datoden-core 2.0.0.

= 1.9.13 =
* Ready for WordPress.org: Plugin Check rules (sanitising, nonces, WordPress file functions), no inline scripts in admin pages, DT-core 1.17.22.

= 1.9.12 =
* DT-core 1.17.21: shared core cleaned up (unused code removed) – the same core in every plugin, no change in behaviour.

= 1.9.11 =
* Cleanup: unused code removed – no change in behaviour.

= 1.9.10 =
* Button text and thank-you message are shown in the fields instead of as placeholders.

= 1.9.8 =
* DT-core 1.17.12: the menu heading is called DT-addons and the overview section Datoden plugins.

= 1.9.7 =
* DT-core 1.17.11: the Pro features require a licence – the website must be connected to Datoden and have a purchased licence or be activated by Datoden. Without a licence the base plugin runs without Pro, with a notice saying why (three days to connect after installing or updating).

= 1.9.6 =
* DT-core 1.17.10: DT-website-guard includes itself in the list sent to Datoden – Control the website, Health and Updates show again in My websites, and DT-website-guard gets its updates from Datoden.

= 1.9.5 =
* DT-core 1.17.9: the menu heading is called Datoden Addons (DT-datoden-addons wrapped onto two lines).

= 1.9.4 =
* DT-core 1.17.8: the menu heading is called DT-datoden-addons (without the Pro badge); the first row in the menu and the overview are still called DT-website-guard.

= 1.9.3 =
* DT-core 1.17.7: the DT-website-guard overview shows every DT plugin – the ones that are not installed with Install (downloaded from Datoden) and Read more; deactivated ones with Activate.

= 1.9.2 =
* DT-addons is now called DT-website-guard (the menu, the overview, the plugins list and the texts in every DT plugin). The folder and the settings stay the same (dt-addons), so updates and everything saved work as before. DT-core 1.17.6.

= 1.9.1 =
* DT-core 1.17.5: the card about what Pro adds is shown at the top of the sidebar (only without Pro) – in every DT plugin.

= 1.9.0 =
* Free and Pro in one: Pro is now an add-on to DT-contact instead of a separate version that replaces it. DT-contact (the base plugin, free on WordPress.org) stays installed and active, keeps the settings and is updated from there; DT-contact Pro adds the Pro features and requires DT-contact. Upgrade, go back or remove Pro – settings and data stay. If DT-contact is newer than Pro, DT-contact runs without the Pro features until Pro has been updated. DT-core 1.17.0.

= 1.8.1 =
* Fix: critical error when DT-contact Pro was installed while an older free version was active. Pro now turns the free version off immediately and starts from the next request.

= 1.8.0 =
* Free and Pro: built as a free version (WordPress.org) and DT-contact Pro (Datoden). Pro takes over the free version and keeps the settings, is updated from Datoden while connected and shows Pro in the header. Nothing stops working when switching either way. DT-core 1.16.0.

= 1.7.31 =
* DT-core 1.15.1: the header (logo, Datoden badge, buttons, language switch, Saved) and the Made by Datoden line are rendered by the core – the plugin only provides its name, version, description and any tabs. The collapse/expand arrow always sits at the far right of the card.

= 1.7.30 =
* DT-core 1.14.0: the header, the DT-addons menu and everything else shared (dt-hub.php, dt-autosave.js, dt-admin.css and Datoden images) live in the dt-core/ folder. Of all active DT plugins only the newest copy is used – updating one plugin with a newer core gives every plugin the new header, and all pages load the same files (cached once by the browser).

= 1.7.29 =
* Shared header script: in DT-addons, Messages go below Install or update in the sidebar.

= 1.7.28 =
* The tab row sits at the top of the main column – above the main cards only, so the sidebar starts at the top beside it.

= 1.7.27 =
* Tabs (e.g. Languages | Menus in DT-language) are a full-width row right below the header, above the cards – no longer small inside the header, so they are not missed.

= 1.7.26 =
* Every card – also in the main column and the cards above it – collapses and expands with a click on its heading. The arrow sits right after the heading, so switches and buttons on the right stay visible when the card is collapsed.

= 1.7.25 =
* Sidebar cards collapse and expand with a click on their heading – remembered per card. Collapsed Messages shows the count. In DT-addons the Datoden account is at the top of the sidebar (DT-hub 1.13.2).

= 1.7.24 =
* Closed messages stay closed after reloading the page.

= 1.7.23 =
* Messages are shown in the sidebar (Messages card) instead of the header.

= 1.7.22 =
* The first item under DT-addons in the menu is called DT-addons instead of Overview.

= 1.7.21 =
* The Datoden menu is now called DT-addons; the overview has a larger DT-website-guard panel.

= 1.7.20 =
* Undo/Redo tooltips say what will be undone or redone. Undo, Redo and Saved are always in the same place, greyed out when there is nothing to do.

= 1.7.19 =
* Header: subtle dividers between the groups of controls.

= 1.7.18 =
* Undo now works everywhere, also right after a change, for added/removed rows, the form builder and the code editor.

= 1.7.17 =
* Undo / Redo in the header of every DT plugin. The save status keeps its width; other messages are shown on top so nothing moves.

= 1.7.16 =
* Header rearranged: version next to the plugin name, buttons top right, Saved after the language switch, the Datoden logo links to Datoden's apps.

= 1.7.15 =
* The Datoden overview page has the same header as the plugins.

= 1.7.14 =
* Dark mode: the header shows the light Datoden logo (datoden-logo-darkmode.svg).

= 1.7.13 =
* The sidebar toggle moved into the header; when hidden the content uses the full width. The collapsed header shows the Datoden logo.

= 1.7.12 =
* The sidebar now lines up with the content (no extra gap at the top).

= 1.7.11 =
* The sidebar toggle sits in the top right corner with a sidebar icon.

= 1.7.10 =
* Header buttons: keep the header at the top while scrolling (pin) and collapse it so only Saved and the language switch show. The sidebar can be collapsed to a small button. The language switch is greyed out on pages without texts to translate.

= 1.7.9 =
* The settings page uses the same colours as the other DT plugins.

= 1.7.8 =
* The plugin header now stays at the top when you scroll. Saved status and the SV | EN language switch moved from the admin bar into the header, below the badges.

= 1.7.7 =
* Unified names: the plugin is now called DT-contact - datoden (lowercase after DT, like all DT plugins). The folder, settings and shortcodes are unchanged.

= 1.7.6 =
* Saved in the admin bar no longer gets a different background on hover.

= 1.7.5 =
* Saved / Saving… is shown in the admin bar at the top, to the left of the SV | EN language switch (also on mobile) – no longer in the plugin's page header.

= 1.7.4 =
* Messages in the page header: WordPress and plugin notices, messages from Datoden and the Datoden account row (DT-website-guard, Datoden apps) now sit in the page header, to the left of Saved, instead of pushing the page down. Long messages show two lines – click for the full text.

= 1.7.3 =
* Autosave: the settings are saved as soon as something changes – the Save button is removed. The status (Saved / Saving… / Could not save) is shown in the page header, as in DT-slideshow.

= 1.7.2 =
* The fields with per-language texts are tagged, so that Text fields in the admin bar (DT-language 1.3.0) can highlight them.

= 1.7.1 =
* The language switch is always in the same place: SV | EN in the admin bar at the top (DT-language 1.2.0), the same choice as in Customize and DT-slideshow.

= 1.7.0 =
* Several languages (with DT-language 1.1.1): a language switch above the forms lets you write the form's texts (labels, placeholders, help texts, choices, button, thank-you message and subject line) in each language. Fields and settings are shared, and visitors see the form in their language (empty = the original).

= 1.6.1 =
* The form's own texts no longer say "we" or "us", so they suit any sender: the consent note, "Read the privacy policy", the default thank-you message and the error messages.

= 1.6.0 =
* Modern icons in front of the fields, chosen automatically by field type.
* Each field can use Automatic, No icon or any of 18 icons; one click sets or removes icons on all fields.

= 1.5.1 =
* A field can have no label – leave the label empty and nothing is shown above the field.

= 1.5.0 =
* The forms on the settings page are collapsed; click a form to open it.

= 1.4.0 =
* Create your own forms with any fields: 25 field types, from phone number and organisation number to choices, dates and file uploads.
* Each form has its own recipient, subject line, button text and thank-you message.
* Errors are shown at the field, with what the visitor wrote kept.

= 1.3.0 =
* Built-in invisible robot check without any external service or keys – on by default.

= 1.2.0 =
* Optional invisible robot check with Cloudflare Turnstile or Google reCAPTCHA v3 (off by default).

= 1.1.0 =
* The form is sent to the page it is on, so it also works when wp-admin is locked for visitors.
* The limit per visitor uses the visitor's real address behind Cloudflare and other proxies.

= 1.0.2 =
* DT-website-guard keeps its name in every language.

= 1.0.1 =
* Website monitoring is now called DT-website-guard.

= 1.0.0 =
* First version.

== Upgrade Notice ==

= 2.0.0 =
Install all DT plugins together; settings are moved automatically.
