=== Datoden Media Replace ===
Contributors: datoden
Tags: replace media, replace image, media library, update image, file
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

Replace an image or file in the media library. The folder, name and address stay the same, so every page that uses it shows the new file.

== Description ==

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

Open an image or file in the media library and upload a new one under Replace file. The new file takes the old one's place: same folder, same name, same address. Pages, posts, slideshows and menus that use it show the new file at once – nothing has to be changed by hand.

* On the image's own page (Media → the image), in the media window (Replace file… in the details) and in the list view (Replace file under the name).
* Drag and drop or choose a file, with a progress bar.
* All sizes are made again from the new image. If the new image has other proportions or is smaller, the old sizes are made again under their old names, so images already placed in pages keep working.
* A PNG that replaces a JPG (or the other way round) is converted to the type of the old file, so the name can stay the same.
* Undo last replacement: the file from before is kept and can be brought back.
* Image addresses get a version number (?v=…) after a replacement, so browsers and image services (for example Optimole) fetch the new file.
* Common page caches are emptied after a replacement.
* The title, alt text, caption and description stay as they are.

= Pro add-on =

In the separate paid add-on Datoden Media Replace Pro (from Datoden, not part of this plugin): earlier versions – every replaced file is kept and can be brought back with one click – and scheduled replacement, where a campaign image is replaced on a set date and back again afterwards.

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

= Can I replace a file with a different type? =

Images can: a PNG, WebP or GIF that replaces a JPG is converted to JPG (and so on), as long as the server can convert images. Other files must be the same type – a PDF is replaced with a PDF.

= Where is the old file kept? =

In wp-content/uploads/dt-replace-media-backup/ – only the file from before the last replacement, and it is removed when the image is deleted. The folder cannot be opened from the web.

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

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

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

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

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

= 1.3.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.3.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.3.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.3.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.3.0 =
* Free and Pro: DT-media-replace gets a Pro add-on (DT-media-replace Pro) with Earlier versions – every replaced file is kept (the ten latest) and can be restored with one click – and Schedule a replacement – a file is replaced at a chosen time and can go back by itself afterwards. The free version works as before. Backups are removed with their subfolders when the attachment is deleted.

= 1.2.0 =
* Free and Pro: fully free, also on WordPress.org. DT-core 1.16.0 – the domain expiry is read from rdap.org only when the website is connected or you click Check again; updates from Datoden are Pro-only.

= 1.1.5 =
* 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.1.4 =
* 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.1.3 =
* Shared header script: in DT-addons, Messages go below Install or update in the sidebar.

= 1.1.2 =
* 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.1.1 =
* 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.1.0 =
* New name: DT-replace-media is now DT-media-replace. Settings are unchanged. If DT-replace-media is active it is turned off the first time an administrator opens the dashboard, its uninstall is made harmless, and a notice offers to delete it. Old addresses and bookmarks lead to the new page.

= 1.0.24 =
* 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.23 =
* 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.22 =
* Closed messages stay closed after reloading the page.

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

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

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

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

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

= 1.0.15 =
* 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.14 =
* 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.13 =
* The Datoden overview page has the same header as the plugins.

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

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

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

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

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

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

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

= 1.0.3 =
* 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.0.2 =
* 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.0.1 =
* 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.0.0 =
* First version.

== Upgrade Notice ==

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