=== Datoden Code Snippets ===
Contributors: datoden
Tags: code snippets, header and footer, custom css, javascript, php
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 3.0.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add your own CSS, JavaScript, HTML and PHP to the website – in the right place, on all pages or only the front page – without editing the theme.

== Description ==

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

A snippet is a piece of code: CSS that changes a color, a tracking code, a small PHP function. Write it under Datoden → DT-code, choose where it goes, and it is added to the website at once.

* Four types: CSS, JavaScript, HTML and PHP, with WordPress' own code editor.
* Places: in the head, right after <body>, in the footer, before or after the content, run everywhere (PHP), only on the website, only in the admin, the admin head and footer – or only where you write the shortcode [datoden_code id="…"].
* Pages: all pages or only the front page. Priority decides the order when several snippets share a place.
* Saved as you type, like the other DT plugins. Snippets can be duplicated.
* Safe PHP: the code is checked before it runs. If something is wrong, the website keeps using the last version that worked and the editor shows the error and the line. A snippet that stops with an error on the website is paused – the page loads again without it. Safe mode (define('DATODEN_CODE_SAFE', true); in wp-config.php) turns all PHP snippets off.
* The page cache is emptied when something changes.
* Move from WPCode (Insert Headers and Footers) with one click: all snippets – also the inactive ones – and the header, body and footer boxes come along with type, place, priority and status. Shortcodes like [wpcode id="12"] keep working when WPCode is off.

= Pro add-on =

In the separate paid add-on Datoden Code Snippets Pro (from Datoden, not part of this plugin): conditions for chosen pages or all except chosen pages, logged-in or logged-out visitors, computer or mobile, language (with DT-language), a time span (also every year), and earlier versions of each snippet. This plugin does not contain these features. A snippet that has such settings saved (for example after going back from Pro) is paused here, so that it does not run in more places than intended; the settings are kept.

= 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.

== Frequently Asked Questions ==

= Who can change the code? =

Administrators who may add unfiltered HTML (on a multisite network: super admins).

= Something broke the website – what do I do? =

A PHP snippet that stops with an error is paused automatically. If you still cannot reach the admin, add define('DATODEN_CODE_SAFE', true); to wp-config.php: no PHP snippets run until you remove the line.

= I use WPCode today =

Open Datoden → DT-code and click Import from WPCode. If WPCode is on, the snippets that are active there are imported turned off, so no code runs twice. Then one click turns WPCode off and them on.

== 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.9 =
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.8 =
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.7 =
Imported snippets now turn on as soon as WPCode is deactivated on the Plugins page (and pause again if WPCode is reactivated).

= 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 Code Snippets (shown as DT-code in the DT-addons menu). The free plugin contains no locked Pro features – they are only in the separate Datoden Code Snippets 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.2.10 =
* Ready for WordPress.org: Plugin Check rules (sanitising, nonces, WordPress file functions), no inline scripts in admin pages, DT-core 1.17.22.

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

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

= 1.2.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.2.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.2.5 =
* DT-core 1.17.9: the menu heading is called Datoden Addons (DT-datoden-addons wrapped onto two lines).

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

= 1.1.1 =
* Fix: critical error when DT-code 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.1.0 =
* Free and Pro: built as a free version (WordPress.org) and DT-code 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.0.25 =
* 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.0.24 =
* 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.0.23 =
* Shared header script: in DT-addons, Messages go below Install or update in the sidebar.

= 1.0.22 =
* 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.0.21 =
* 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.0.20 =
* 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.0.19 =
* 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.0.18 =
* Closed messages stay closed after reloading the page.

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

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

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

= 1.0.14 =
* 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.0.13 =
* Header: subtle dividers between the groups of controls.

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

= 1.0.11 =
* 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.0.10 =
* 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.0.9 =
* The Datoden overview page has the same header as the plugins.

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

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

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

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

= 1.0.4 =
* 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.0.3 =
* Shared stylesheet updated, same as the other DT plugins.

= 1.0.2 =
* 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.0.1 =
* Unified names: the plugin is now called DT-code - datoden (lowercase after DT, like all DT plugins). The folder, settings and shortcodes are unchanged.

= 1.0.0 =
* First version: CSS, JavaScript, HTML and PHP snippets with places, conditions, timing (also every year), autosave, earlier versions, safe PHP and import from WPCode.

== Upgrade Notice ==

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