[Documentation]: `total_unread` and `feed_count` do not work as advertised

[JKingweb]

Bug Summary

Categories in the API do not have total_unread and feed_count members

Description

The changelog for Miniflux 2.0.46 states in part:

Update categories API endpoint to return `total_unread` and `feed_count`

These properties do seem to exist in the code, but I haven't been able to make them show up in the API:

v2/internal/model/category.go

Lines 14 to 15 in 0ef21e8

	FeedCount *int `json:"feed_count,omitempty"`
	TotalUnread *int `json:"total_unread,omitempty"`

Am I missing something?

Steps to Reproduce

1. Have a category which has feeds which have unread entries
2. Make a request to GET /v1/categories
3. Note no counts are present in the output

Expected Behavior

As stated in the changelog

Actual Behavior

The changelog appears to be mistaken

Version

2.2.7

Browser

No response

Relevant Logs or Error Output

Additional Context

No response

Checklist

• I have searched existing issues to ensure this bug hasn't been reported before.

[fguillot]

You have to pass the argument ?counts=true to include total_unread and feed_count in the response.

See the original pull-request (#1928) and the corresponding implementation:

v2/internal/api/category.go

Lines 104 to 110 in d139d8a

	includeCounts := request.QueryStringParam(r, "counts", "false")
	if includeCounts == "true" {
	categories, err = h.store.CategoriesWithFeedCount(request.UserID(r))
	} else {
	categories, err = h.store.Categories(request.UserID(r))
	}

The documentation has been updated accordingly since it was missing: https://miniflux.app/docs/api.html#endpoint-get-categories