v0.1.14

Improves WP FileTrace resilience during high-volume download campaigns and automated link scanning.

1. Moves download counting behind browser confirmation instead of the initial tracked-link request.
2. Prevents basic email/security link scanners and HEAD requests from being counted as downloads.
3. Replaces the full WordPress frontend handoff with a lightweight standalone download page.
4. Prevents unrelated theme and plugin assets from loading during the handoff.
5. Sends confirmed downloads directly to the target file without the normal retry round trip.
6. Keeps legacy retry behavior available for backwards compatibility.
7. Ensures tracking failures do not prevent visitors from reaching their download.
8. Improves handling of large bursts of simultaneous tracked-link requests.

v0.1.13

1. Added contextual return behavior on the download page.
2. Downloads originating from WordPress content now show Back to previous page.
3. External/email downloads continue to show Back to main site.
4. Added {{via_page_url}} and {{return_url}} Download Page variables.
5. Updated Analytics parameter fields with clear OPTIONAL badges.
6. Removed redundant optional wording from Analytics descriptions.
7. Added a reusable admin icon-button alignment class.
8. Improved Dashicon vertical alignment across Preview, Updates, Migration, Copy, and other action buttons.
9. Updated the GitHub Releases button to use a properly aligned Dashicon.
10. Changed the DEV badge styling so it is visually distinct from BETA.
11. Preserved existing download spinner/fallback behavior.

v0.1.12

1. Added optional Analytics mappings for via_page_id and via_page_title.
2. WP FileTrace shortcodes now capture the originating WordPress page or post.
3. Manually embedded WP FileTrace links can also capture the current page context.
4. External/email downloads remain correctly identified as having no originating page.
5. Added {{via_page_id}} and {{via_page_title}} Download Page variables.
6. Kept download_id as the stable WP FileTrace tracker ID.
7. Improved the default download-page loading sequence.
8. Download spinner now fades out shortly after the fallback download message appears.
9. Added a Media Library selector for setting a logo or icon on the default download page.
10. Added an option to hide the default site-name text.
11. Added a standalone Back to main site button below the download content.
12. Added {{logo_url}} and {{site_url}} Download Page variables.
13. Preview mode supports the new branding and page-context options without triggering downloads or analytics.
14. Retry and return-to-site actions do not create duplicate download counts or GA events.

v0.1.11

• Added a new Download Page tab for customizing the tracked download handoff screen.
• Added custom HTML and CSS editors for white-labeling the download experience.
• Added administrator-only preview mode that does not trigger a download, counter increment, or GA event.
• Added template variables for:
  • download title
  • actual file name
  • retry/download URL
  • download source
  • site name
• Improved the default download page with a centered, minimal card-style layout.
• Added an automatic download-start flow with a delayed manual fallback link.
• Added a dedicated no-track retry route so fallback clicks do not create duplicate download counts or analytics events.
• Added optional Google Analytics download source mapping.
• Analytics can now send tracker ID, file name, and whether the download originated from a shortcode or external link.
• Moved GitHub update controls into the Settings tab.
• Preserved compatibility with older Updates-tab URLs.

v0.1.10

1. Added a configurable Download ID Event Parameter to Analytics settings.
2. Custom Google Analytics download events can now receive the WP FileTrace tracker ID dynamically.
3. Existing File Name Event Parameter support remains available.
4. Download ID and file name mappings can be configured independently.
5. Supports events such as download_id and download_name.
6. Dynamic values work for both shortcode and external tracked downloads

v0.1.9

1. Added an SDM Usage Audit to the beta migration tools.
2. Reports the total number of Simple Download Monitor download records.
3. Shows how many unique SDM downloads are referenced by standard download shortcodes.
4. Detects direct sdm_process_download links.
5. Detects SDM counter, info, link, and hidden-download shortcode references.
6. Reports SDM references found in post meta/page-builder data.
7. Added a No Direct Reference Found category for downloads without an individually detected reference.
8. Detects SDM category/listing shortcodes that may expose downloads dynamically.
9. Added warnings so unreferenced downloads are not incorrectly assumed to be unused.
10. Added a detailed review table for auditing individual SDM download records and their detected usage.
11. Keeps the migration process conservative: the usage audit does not change which items are considered safe for automatic replacement.
12. Preserved existing migration rollback and dry-run behavior.
13. Included minor admin UI styling improvements for migration action icons.
14. Updated README and changelog documentation.

v0.1.8

WP FileTrace v0.1.8 adds a new beta migration system and expands the plugin’s settings and developer tools.

• Added a new Settings tab.
• Added a Beta Features section for optional experimental functionality.
• Added an Enable Simple Download Monitor Migration toggle.
• SDM migration tools are disabled by default.
• Added a dedicated Migration tab that only appears when SDM migration is enabled.
• Added a Beta notice inside the Migration tab to clearly identify the feature as experimental.
• Migration currently supports Simple Download Monitor only.
• Added dry-run scanning for [sdm_download] and legacy [sdm-download] shortcodes.
• Added a migration report showing affected pages/posts, SDM download IDs, resolved files, existing shortcodes, proposed WP FileTrace shortcodes, and migration status.
• Automatically resolves SDM download URLs to WordPress Media Library attachment IDs when possible.
• Automatically creates or reuses matching WP FileTrace tracker records.
• Preserves compatible custom download button text during migration.
• Flags unsupported or potentially unsafe SDM configurations as Needs Review instead of modifying them automatically.
• Detects SDM references stored in page-builder or post-meta content without blindly replacing them.
• Added Apply Safe Replacements for supported migrations.
• Added rollback backups of affected post content before migration changes are applied.
• Added Roll Back Content Changes and Discard Rollback Backup tools.
• Historical SDM download counts are not imported.
• Added a separate Developer / Testing Tools section in Settings.
• Added an Enable Test Row Generator toggle.
• The Generate 200 Test Rows button is now hidden by default and only appears when explicitly enabled.
• Test-row generation is also blocked server-side when the developer setting is disabled.
• Migration and Settings actions continue to use the existing AJAX admin workflow.
• Updated uninstall cleanup for migration state, rollback data, beta-feature settings, and developer-tool settings.

v0.1.7

• Added AJAX-powered admin interactions throughout WP FileTrace.
• Added loading/busy states and inline error feedback.
• Preserved existing non-JavaScript admin handlers as fallbacks.

v0.1.6

• Added a new Updates tab to WP FileTrace.
• Added a Check for Updates button for immediate GitHub release checks.
• Manual checks now clear WP FileTrace and WordPress update caches before checking.
• Added display of the currently installed version and latest GitHub release.
• Added Last Checked timestamp.
• Added GitHub Connection Status with visible error reporting.
• Added an update-available notice with a link to the WordPress Updates screen.
• Added a direct link to WP FileTrace GitHub Releases.
• Reduced GitHub release caching from 6 hours to 1 hour.
• Improved updater reliability for development and release testing.
• Updated uninstall cleanup, README, and changelog.

v0.1.5

• Added optional Google Analytics integration.
• Added a configurable Global Site Tag field for frontend tracking.
• Added a custom download-event snippet field for gtag() events.
• Added support for injecting the downloaded file name into a chosen GA event parameter.
• Analytics tracking works for both shortcode and external tracked downloads.
• Global tag and custom event settings can be used independently.
• Added a dedicated Analytics settings tab.
• Preserved the existing PHP download-tracking hook and added an analytics context filter.
• Updated uninstall cleanup to remove analytics settings.
• Updated documentation and changelog for the new analytics features.