TACC / Core-CMS-Custom

Customized Core CMS code and builds
5 stars 0 forks source link

WP-519: APCD Custom getting started page - more standard & compatible #282

Closed wesleyboar closed 6 months ago

wesleyboar commented 6 months ago

Overview

Overwrite template, instead of creating a new one, so that settings need not be updated.*

What is wrong with updating the setting?
[Such a settings update][new setting] in my experience has **not** been backwards-compatible (prod page will break upon deploy) **nor** future-compatible (not using a custom template in future, prod page will break upon deploy). ### Fail Case 0. Deploy project - with guide template setting path "B" - to a server that guide template setting path "A". 1. Open existing page that uses "Guide: Getting Started" template. 2. Notice page _crash_… (**unless** someone updated page after deploy via `/admin` UI to use guide template setting path "A" before visiting the page) fail case example

Related

Changes

Testing

Local

  1. Follow "Start Project" instructions.
  2. Create/Update /apcd-cms/src/taccsite_cms/settings_custom.py with pre–WP-519 settings.
  3. Create a page.
  4. Set template to "Guide: Getting Started".
  5. Verify page content is from modified template.

Remote

  1. Deploy this to a server.
  2. If page is set to use new template, then expect page to fail to load.
  3. If so, then via /admin change template to original template path.
  4. Notice new template is used (at old template path).

UI

new content
chandra-tacc commented 6 months ago

Thanks for this fix, works great. Will follow this in future.