feat: CMD-165 custom branding via setting

[wesleyboar]

Overview / Changes

• Deprecate setting BRANDING.
• Add setting PORTAL_BRANDING.
• Add _settings/brandings.py.

Related

• CMD-165
• documented by docs: CMD-164 CMD-165 custom assets via settings #843
• required by epic: CMD-164 CMD-165 custom assets via settings Core-CMS-Custom#292
• required by https://github.com/TACC/Core-Portal-Deployments/pull/45

Testing

New Settings

1. Do not have BRANDING in taccsite_cms/settings_local.py.
2. Load CMS in browser.
3. Verify branding is TACC, UTexas.

Old Setting

1. Add BRANDING to taccsite_cms/settings_local.py:

   Code

   TACC_BRANDING = [
       "tacc",
       "site_cms/img/org_logos/tacc-white.png",
       "branding-tacc",
       "https://www.tacc.utexas.edu/",
       "_blank",
       "TACC Logo",
       "anonymous",
       "True"
   ]
   UTEXAS_BRANDING = [
       "utexas",
       "site_cms/img/org_logos/utaustin-white.png",
       "branding-utaustin",
       "https://www.utexas.edu/",
       "_blank",
       "University of Texas at Austin Logo",
       "anonymous",
       "True"
   ]
   NSF_BRANDING = [
       "nsf",
       "site_cms/img/org_logos/nsf-white.png",
       "branding-nsf",
       "https://www.nsf.gov/",
       "_blank",
       "NSF Logo",
       "anonymous",
       "True"
   ]
   BRANDING = [ NSF_BRANDING, UTEXAS_BRANDING, TACC_BRANDING ]

2. Load CMS in browser.

3. Verify branding is NSF, UTexas, TACC.

Custom Setting

0. Do not have BRANDING in taccsite_cms/settings_local.py.

1. Use PORTAL_BRANDING in taccsite_cms/settings_local.py with different order:

   Code

   from taccsite_cms._settings.branding import *
   
   PORTAL_BRANDING = [ PORTAL_BRANDING_NSF, PORTAL_BRANDING_UTEXAS, PORTAL_BRANDING_TACC ]

2. Load CMS in browser.

3. Verify branding is NSF, UTexas, TACC.

UI

Core-CMS

new	old

standard	custom / local