# Canonical Pages Changelog
Canonical Pages WordPress plugin.

All notable changes to this project will be documented in this file.

**Keep a Changelog**
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

Each version section should start with a H2 (`## `), the version number in hard brackets, a space-dash-space (` - `), 
and the release date in ISO date format (ISO 8601), *YYYY-MM-DD*.
The proceeding line may contain 1 or more sentences describing the purpose of the release.
A blank line is added to separate the heading/paragraph from the list of changes.
Changes are listed, each item prefixed with a minus (-) character. Tabs may be used to indent the list.
A blank line is added to separate the list from the next heading/paragraph.

```markdown
## [0.0.0] - 2025-01-02
This is an example changelog entry.

- Fixed this
  - and this,
  - and this
  - and that
- Added that
- Removed other
```

**Semantic Versioning**
This project adheres _somewhat_ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). 
The first version of a MAJOR or MINOR release will exclude the second dot followed by zero (`.0`).
For example `2.0` will be used rather than `2.0.0`. Otherwise Semantic Versioning is strictly followed.

## [Unreleased]
TBD

## [1.1.0] - 2026-08-27
Added the "UTM Source Variants" feature

- Added a plugin settings page under Settings > Canonical Pages
  - Added the "Variant Canonical Pages to UTM Sources" setting (disabled by default)
- Added the "Canonical UTM Sources" custom post type to manage lists of slug values (one per line)
- Added a "Variant UTM List" dropdown to the page editor when "This Link" is selected
- Variant paths now load the base page while keeping the base page as the canonical URL
- Exposed the matched variant value to analytics as `window.utm_source` and a `dataLayer` push
- Tested with WordPress 7.1

## [1.0.2] - 2026-05-24
Official release of plugin

- Tested with WordPress 7.0

## [1.0.1] - 2025-12-16
Official release of plugin

- Tested with WordPress 6.9

## [1.0] - 2025-04-19
Official release of plugin

- Tested with WordPress 6.8

## [0.0.4] - 2025-04-18
Release on WordPress.org

- Added .github workflow actions
- Added .wordpress-org folder for wordpress.org assets

## [0.0.3] - 2025-04-12
Issues addressed for wordpress.org submission review process

- Removed `load_plugin_textdomain()` function call, no longer necessary
- Set "Requires at least:" to 6.0 (was 6.0.9)

## [0.0.2] - 2025-04-07
Bug fixes and added CHANGELOG.md

- Added CHANGELOG.md
- Fixed bug where canonical disabled when no settings saved

## [0.0.1] - 2025-04-06
Hello from Canonical Pages plugin!

- First release of plugin