Skip to content

[v1.20] Move the options of the dissolved stream, ui and web modules - #241

Open
luke- wants to merge 1 commit into
masterfrom
docs/v1-20-dissolved-modules
Open

[v1.20] Move the options of the dissolved stream, ui and web modules#241
luke- wants to merge 1 commit into
masterfrom
docs/v1-20-dissolved-modules

Conversation

@luke-

@luke- luke- commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

HumHub 1.20 dissolves the stream, ui and web core modules (humhub/humhub#8479, #8471, #8457). Their configuration options did not disappear — they moved, and config-options.md still documents them at their old place.

Merge this when 1.20 ships, not before: until then the page would describe options that do not exist yet in the released version.

What changed on the page

Option Before After
streamExcludes, streamSuppressQueryIgnore, defaultStreamSuppressQueryIgnore, streamSuppressLimit, showDeactivatedUserContent modules.stream modules.content
iconAlias modules.ui params.icon.alias
enableServiceWorker modules.web params.pwa.enabled
security modules.web components.response.defaultHeaders

The stream options join the existing Content section. The other three are no longer module options at all, so the ### UI and ### Web sections go and the options move into two new top-level sections, Application Parameters and Components — the page only had ## Core Modules until now.

A :::note in the Content section points out that a leftover stream section is ignored without an error: nothing reads the configuration of a module id that no longer exists, so there is no log entry and no warning, and the defaults quietly apply again. The same holds for ui and web.

For defaultHeaders the note also records that the old csp and csp-report-only sections and the separate nonce switch were removed rather than renamed — a policy expressed that way has to be rewritten as a header string.

Two fixes along the way

  • defaultStreamSuppressQueryIgnore was documented as []. It has never been empty; the default is Post and Activity.
  • streamSuppressLimit was missing entirely. Added with its default of 2.

The administrator-facing side of the move is described in docs/admin/upgrade-v1.20.md in the core repository; this page is the reference counterpart.

HumHub 1.20 dissolves three core modules. Their configuration options did not
disappear, they moved:

- the five stream options are configured on the content module now
- iconAlias became the icon.alias application parameter
- enableServiceWorker became the pwa.enabled application parameter
- the web security settings became response.defaultHeaders on the response
  component

The last three are no longer module options, so they leave the "Core Modules"
section for two new ones.

A leftover section for any of the three module ids is ignored without an error,
which is what makes this worth calling out in the content section.

Also corrects the documented default of defaultStreamSuppressQueryIgnore, which
is Post and Activity rather than an empty array, and adds streamSuppressLimit,
which was never listed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant