Expiring Discord roles and donation targets

Changes

New features

I'm pleased to announce the availability of the following new functionality within the server donation tool:

• Expiring discord roles: Same as with priority queue, the Discord Role perk now can have an expiration in days when the role should be removed from the donator again
• Donation targets: Better communicate what amount of donation you target for in order to keep the services running. You can configure a monthly donation target, where donations are counted up to. You can change the message that is visible with the donation target text using the Message Overrides feature. See the documentation for donation targets for more information.
• Privacy Policy: With the recent changes to the Server Donation Tool, it is wise to also explain your donators what data the tool is collecting, processing and for what reason it does so. The privacy policy is generated automatically based on partials and should suit most use cases. However, if you see the need to update it or use your own policy, you can configure your own partials as well (with the app.privacyPolicy.partials configuration options).

Other changes

• Improved how links to the donation tool are rendered in social media (e.g. Discord)
• You can now disable donation packages (use this in order to "remove" a package instead of deleting it's definition)
• You can configure a Google Analytics measurement ID to analyze the usage of the Donation tool with Google Analytics (the privacy policy is updated automatically to include a section for GA once it is configured). IP anonymization is enabled by default and can not be disabled for privacy reasons.

Changes to Perks

The following Perk integrations where changed:

• Discord role assignment: A new optional configuration parameter, amountInDays, was added in order to enable expiring discord roles

Changes to the config.yml

The following changes were made to the structure of the config.yml file:

• Added a new object under the community section: donationTarget, it has the following structure (parent keys are included for better orientation):

app:
  community:
    donationTarget:
      monthly: 100.00

See the config.full.yml for a full description and documentation about the new configuration options. See the corresponding donation targets documentation as well.

• Added a new configuration setting to configure Google Analytics:

app:
  googleAnalytics:
    trackingId: GA-ABC123

• The packages configuration now has a disabled option to disable a package for new donations (see the Packages and Perks documentation for more information)

Update notes

In order to update to this release, follow these steps (additionally to any steps mentioned in the official documentation):

• Download the source code of this release (either with a git pull to the tag or by downloading the zip file from this page
• Run npm ci to update the required dependencies