All notable changes to this project will be documented in this file.
The project now uses GitHub Releases as the source of truth for versioned release notes. Create releases with tags like v3.0.1 or v3.1.0-rc.1 and keep this changelog in sync with the published release.
- Placeholder for upcoming changes before the next GitHub release is published.
CancellationTokensupport across the public async API surface.PagedResult<T>plus paged query/get helpers for exposing pagination metadata without parsing headers manually.- First-class
IServiceCollectionregistration helpers forWordPressClient. - Opt-in structured logging diagnostics for the HTTP request/response lifecycle.
- Versioned reference docs for 3.x, while restoring dedicated 2.x and 1.x reference sets.
- Expanded documentation for endpoint coverage, custom fields, and updated HTTPS quickstart/auth examples.
- Retargeted the library, tests, and CI/tooling to .NET 10, dropping previous .NET Standard and .NET 6 test targets.
- Centralized shared .NET configuration via
Directory.Build.propsandDirectory.Packages.props. - Enabled nullable reference types across the public API and the full solution.
- Migrated serialization from
Newtonsoft.JsontoSystem.Text.Json. - Standardized
GetByIdAsyncnaming across the API surface and aligned remaining public async method names/signatures. - Modernized
HttpClientownership so DI-managed clients can be injected cleanly. - Cleaned build warnings and aligned analyzer usage with the .NET 10 SDK.
- Adopted GitHub Release-based publishing with tag-driven versioning and changelog-driven release notes.
- Updated GitHub Actions workflows for the
mainbranch, Docker Compose v2, and newer action runtimes.
- Comment status updates now serialize correctly.
- Comment updates skip null-only meta payloads that should not be sent.
- Docker-based self-hosted integration test setup is more reliable.
- Documentation and examples were refreshed to match current API names and behavior.
- Upgraded dependencies.
- Fixed
GetCurrentUserAsync()naming. - Allowed
HttpClientinjection without a base address. - Added optional
ignoreDefaultPathonCustomRequestmethods.
- Support for plugins.
- Support for statuses in
UsersQueryBuilder.
- Upgraded
Newtonsoft.Jsonto 13.0.3.
- Upgraded
Newtonsoft.Jsonto 13.0.1.
WordPressClientaccepts the endpoint as aUri.- Support for getting the total post count without fetching the posts.
- Generic JWT and Basic Auth support.
- Dropped
netstandard1.xsupport. - Added the
Asyncsuffix to all public async methods. - Moved auth-related functionality to the auth sub-client.
- Moved settings functionality to the settings sub-client.
- Improved error handling for
WP_DEBUG_DISPLAY.
- Support for application passwords.
- Raised the minimum target from
netstandard1.1tonetstandard1.3.
- Query builder now appends default enum values to the query string for easier debugging.
HttpClientinjection.
- Support for the JWT Auth plugin.
- Support for posts trash status.
- Support for providing an
HttpClienttoWordPressClient.
- Package icon.
- Updated the license expression.
- Optional MIME type override for media upload.
- Improved handling of
HttpClientheaders. - Downgraded JSON.NET to 11.0.1.
- Refactored exceptions.
.kmzand.kmlMIME types (#162).
- Cleaned up the file stream after upload (#166).
Capabilitiescan now contain strings instead of only booleans (#147).
- Marked all
Metaproperties as dynamic because the structure can be volatile.
MediaSizesheight and width are now optional (#143).
- Enhanced error handling.
- Addressed issue #138.
- Added
DefaultValueHandlingto the comment status property.
- Added
NullValueHandlingtoFeaturedMedia.
- Yoast taxonomy terms.
- Added default serializer settings with
MissingMemberHandling.Ignore.
- Delete requests now return
boolinstead ofHttpResponseMessage.
- Experimental WordPress.com support (read-only).
- Experimental descending threaded comments support.
- Made
HttpClientstatic.
- Exceptions are now thrown instead of being hidden.
- Stopped auto-appending
/wp-jsonto the WordPress URI.
- Updating
Comment.Status.
Comment.Statushandling.
maxDepthoption for threaded comments.
ToThreadedmethod for transforming comments..NET Standard 2.0support.- Uploading media directly from a file path (
.NET Standard 2.0only).
- Passed deserialization settings into
HttpHelper.
- JWT getter and setter methods.
- Helper method to sort comments for a threaded view.
- Method to get all comments for a post id.
- Logout method.
- Improved async performance in several code paths.