coderedcorp / coderedcorp/coderedcms

Official theme support

Open
#44 20 comments 0 reactions 0 assignees View on GitHub
Area: Customization ✨ Type: Enhancement
Dominant language
Python
Stars
765
Forks
154
PR merge metrics
No merged PRs in 30d

Description

We already have the basis of a framework for 3rd party themes. But I think a good step would be actually trying to create an example 3rd party theme, documenting how this is done, and making whatever changes would be necessary in the cms to support this. The first example could be simple, still based on Bootstrap. It is possible to build a theme that swaps out bootstrap for something like foundation, materialize, skeleton, etc., but that is a task for a different day.

Requirements for the theme would be:
* Custom templates that override coderedcms templates
* Custom page and block templates in addition to coderedcms templates, utilizing the Layout or Adv Settings > Template chooser dropdown.
* Custom css and js added to base.html, to show how to properly do that.
* MAYBE some extra blocks or models that are part of the theme, to show how to integrate those into the cms as well.

The theme itself should be a separate pip package. But docs and any enhancements to support theming should be integrated into the CMS.

Theme support is currently possible, but is partially blocked by issues #8 and #56

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the existing framework for third-party themes and the blockers in issues #8 and #56. Use base.html and the Layout or Adv Settings > Template chooser as the named entry points, then verify that a separate pip package can demonstrate custom templates, CSS, JavaScript, and any additional blocks or models while the CMS documentation and enhancements are integrated.

Written by the indexing model from the issue text.

Assessment

Tech stack
bootstrap, django, python
Domain
documentation, frontend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.