Core-CMS-Resources

Project-specific code that had been built into the Core CMS project

Caution

This repository is unmaintained. Learn how to develop a custom Core-CMS project.¹

Table of Contents

• Related Repositories
• Project Websites
• Project Architecture
• Prerequisites
• Start Project
• Update Project
• Run Multiple Projects
• Debug Project
• Build & Deploy Project
• Port Project

Related Repositories

• Core CMS, the base CMS code for TACC WMA CMS Websites
• Core CMS Custom, for custom assets of TACC WMA CMS Websites
• Core CMS Template, to build a custom TACC WMA CMS Website

Project Websites

Important

No more websites exist in this repository. All were moved to Core CMS Custom or a repository built from Core-CMS-Template.

Project Architecture

Within a /custom_project_dir can be:

directory	contents
static	static assets, organized as Django CMS expects
templates	templates and saved snippets
settings_custom.py2	project-specific values for Core CMS settings

Prerequisites

• Git Submodules
• Core CMS

A CMS project is run within Core CMS. Also, Git Submodules must be pre-installed on the system on which you will run the CMS project.

Note The Core CMS has its own prerequisites.

Start Project

Set up a new local CMS instance.

0. Set up Core CMS to run a local Core CMS Resources:

   1. If not already done:

      1. Clone Core CMS repository.
      2. Set up Core CMS completely.

   2. Be in your Core CMS clone:

      cd Core-CMS

   3. Register and populate /taccsite-custom.

      git submodule init
      # This registers this repository at `/taccsite_custom`.
      git submodule update
      # This populates from this repository into `/taccsite_custom`.

   4. Create /taccsite_cms/settings_custom.py² and populate it with respective cms.settings_custom.py from Core Portal Deployments e.g. /lccf/camino/cms.settings_custom.py.

1. Enter the CMS Docker Container:

   docker exec -it core_cms /bin/bash
   # This opens a command prompt within the container

2. Update the Django Application:

   (Run these commands within the container.)

   python manage.py migrate
   python manage.py createsuperuser
   # To use default "Username" and skip "Email address", press Enter at both prompts.
   # At "Password" prompts, you may use an easy-to-remember password.
   python manage.py collectstatic --no-input
   

3. Open Django CMS:

   1. Open http://localhost:8000/.
   2. Verify anything specific to the custom project is present e.g.
      • logo
      • custom applications
      • custom global colors
      • custom styles (may require specific markup)

Note A local machine CMS will be empty. It will not have content from staging nor production. To have that, follow and adapt instructions to copy a database.

Note A local machine CMS does not include nor integrate with an instance of Core Portal. To attempt to do that, follow How to Use a Custom Docker Compose File and Locally Develop CMS Portal Docs. Help welcome.

Update Project

Follow Core CMS: Update Project instructions.

Develop Project

Follow "via Core CMS Resources" section of Core CMS: Develop Custom Project.

Debug Project

Read Debug Project for miscellaneous tips.

Build & Deploy Project

Follow "Core-CMS-Resources" section of How To Build & Deploy.

Run Multiple Projects

Read Run Multiple Projects.

Port Project

To port a project to Core CMS Custom, read Port Project.

Footnotes

1. Deploying websites that are still in Core-CMS-Resources and have old custom templates will trigger a major problem. The prefered solution is migration. If you must deploy without migration, then upgrade the website for Core-CMS v3.12. ↩

2. The cms.settings_custom.py is committed in Core Portal Deployments. A settings_custom.py in Core CMS is .gitignore'd. ↩ ↩²