[MM3-users] Setting base_url for the domain to use it in the templates.

Hi all!

I'm trying to use extended placeholders for the templated texts in the message footer that are sent to the members:

Along with these, Mailman supports placeholder as URLs for web interface when base_url property is set at the Domain level. These include: domain_url - URL to homepage for a domain. mailinglist_url - URL to homepage for a mailinglist. held_message_url - URL to page for handling all held messages. pending_subscriptions_url - URL to page for handling pending subscription requests. pending_unsubscriptions_url - URL to page for handling pending unsubscriptions.

The REST API docs mention base_url as the property of the domain: domain URLs

But my attempts to use REST API to set it fail:

curl --user 'restapi:restpass' \
    -X PATCH \
    -H "Content-Type: application/json" \
    -H 'Accept: application/json' \
    -d '{ "base_url": "https://example.net/mailman3" }' \
    http://localhost:8001/3.1/domains/example.net | jq '.'
{
  "title": "400 Bad Request",
  "description": "Unexpected parameters: base_url"
}

My MM3 instance is the latest(3.3.9), provided by the maxking mailman-core docker image.

It looks like there is a lot of confusion about base_url in general, as hyperkitty seems also use the property with the same name, for example: https://lists.mailman3.org/hyperkitty/list/mailman-users@mailman3.org/thread...

So what is the correct way to get those extended placeholders to work in the templates?

It's also not clear to me, what the the primary domain should be for the installation - server hostname, as in lists.mailman3.org or the domain, used in the mailing list(s) itself, like mailman3.org for mailman-users@mailman3.org...

With best regards, Timour Bakeev