Site-wide data models

[solarissmoke]

I propose to use site-wide settings to store the following:

• Legal footer text: rich text (required)
• Top navigation menu links: orderable sequence of link blocks that can link either to a page on site or to an absolute URL (required)
• Footer links: orderable sequence of link blocks that can link either to a page on site or to an absolute URL (required)
• Language code to currency mapping (as defined in Confirm approach for localisation and currency detection #1).
• Currency information:
  • Code
  • Symbol
  • Allowed payment methods
  • Default donation amounts: for each currency, 4 default suggestion values for that currency.

It might be easier to store currency information in code instead - to make a call before starting work on this.

[solarissmoke]

I just realised that putting the legal footer text into a setting will complicate translations. If this text is not likely to change often then the simplest approach in my view is to hard-code it into the template, so that it can be translated in the normal way.

The same potentially applies for the navigation/footer menu items as well. I notice that on the current site, the top navigation is only available when viewing the site in English.

[alanmoo]

The top nav is only in English because the Foundation site itself is mainly only in English.

[solarissmoke]

I've been looking into how to store currency information, and feel that we're best off having a hard-coded dictionary very similar to the current one.

The rationale for this is that this data doesn't change frequently, and so it doesn't seem worth the cost of modeling in the database and making editable in Wagtail.

@alanmoo @TheoChevalier does this sound OK to you?

[TheoChevalier]

@solarissmoke No issue on my side, thanks for asking :)

[solarissmoke]

Closing on the basis that we've ended up storing all of this information in code, so no site-wide models necessary at present.

[alanmoo]

Out of curiosity (because we might need it on our other Wagtail site) is there any documentation on best practices for site-wide model implementation?

[solarissmoke]

Yes - use wagtail.contrib.settings: https://docs.wagtail.io/en/v2.5.1/reference/contrib/settings.html