{"id":19617801,"url":"https://github.com/macagua/bellaelearning-edx-theme","last_synced_at":"2026-06-07T21:01:31.614Z","repository":{"id":137263917,"uuid":"543305879","full_name":"macagua/bellaelearning-edx-theme","owner":"macagua","description":"A open-edX platform theme for E-learning Web Solution development by BellaGLOBAL LLC.","archived":false,"fork":false,"pushed_at":"2022-09-29T21:22:45.000Z","size":1465,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-09T10:49:35.816Z","etag":null,"topics":["e-learning","edx","edx-theme","koa","open-edx","openedx-koa-theme"],"latest_commit_sha":null,"homepage":"","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/macagua.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-29T20:23:33.000Z","updated_at":"2024-08-24T23:43:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"5695d2ec-67bb-4ad7-bd78-3f11ccd92481","html_url":"https://github.com/macagua/bellaelearning-edx-theme","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macagua%2Fbellaelearning-edx-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macagua%2Fbellaelearning-edx-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macagua%2Fbellaelearning-edx-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macagua%2Fbellaelearning-edx-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macagua","download_url":"https://codeload.github.com/macagua/bellaelearning-edx-theme/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240907855,"owners_count":19876691,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["e-learning","edx","edx-theme","koa","open-edx","openedx-koa-theme"],"created_at":"2024-11-11T11:07:18.134Z","updated_at":"2026-06-07T21:01:31.562Z","avatar_url":"https://github.com/macagua.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"Bella Debraning theme for Open edX\n==================================\n\nBella Debraning is an elegant, customizable theme for `Open edX \u003chttps://open.edx.org\u003e`__.\n\n.. figure:: ./screenshots/01-landing-page-ecommerce.jpg\n  :alt: Platform landing page for E-learning Webapp\n  :align: center\n  :width: 1280px\n  :height: 960px\n\n  Platform landing page for E-learning Webapp\n\n.. figure:: ./screenshots/02-landing-page-studio.jpg\n  :alt: Platform landing page for Studio Webapp\n  :align: center\n  :width: 1280px\n  :height: 960px\n\n  Platform landing page for Studio Webapp\n\n**Note**: This version of the Bella Debraning theme is compatible with the Koa release of Open edX.\n\nYou can view the theme in action at http://demo.openedx.overhang.io.\n\nInstallation\n------------\n\nBella Debraning was specially developed to be used with `Tutor \u003chttps://docs.overhang.io\u003e`__ (at least v11.0.0). If you have not installed Open edX with Tutor, then installation instructions will vary.\n\nClone the theme repository::\n\n    git clone https://github.com/macagua/bellaelearning-edx-theme.git\n\nRender your theme::\n\n    tutor config render --extra-config ./bellaelearning-edx-theme/config.yml ./bellaelearning-edx-theme/theme \"$(tutor config printroot)/env/build/openedx/themes/bellaelearning-edx-theme\"\n\nRebuild the Openedx docker image::\n\n    tutor images build openedx\n\nRestart your platform::\n\n    tutor local start -d\n\nYou will then have to enable the \"bellaelearning-edx-theme\" theme, as per the `Tutor documentation \u003chttps://docs.tutor.overhang.io/local.html#setting-a-new-theme\u003e`__::\n\n    tutor local settheme bellaelearning-edx-theme localhost studio.localhost \\\n        $(tutor config printvalue LMS_HOST) $(tutor config printvalue CMS_HOST)\n\nUpgrade\n-------\n\nTo upgrade the Bella Debraning theme from a previous version, simply pull the changes from the git repository::\n\n    cd bellaelearning-edx-theme/\n    git pull\n\nThen run the commands above starting from ``tutor config render...``.\n\nCustomization\n-------------\n\nSetting custom values\n~~~~~~~~~~~~~~~~~~~~~\n\nA few settings in the theme can be easily customised: this includes the theme primary color, landing page tagline, footer legal links. Theme settings are defined in the `config.yml \u003chttps://github.com/macagua/bellaelearning-edx-theme/blob/master/config.yml\u003e`__ file at the root of the repository. You can override all or part of those settings by creating you own ``config-custom.yml`` file. Then, render the theme with::\n\n    tutor config render \\\n        --extra-config ./bellaelearning-edx-theme/config.yml \\\n        --extra-config ./bellaelearning-edx-theme/config-custom.yml \\\n        ./bellaelearning-edx-theme/theme \"$(tutor config printroot)/env/build/openedx/themes/bellaelearning-edx-theme\"\n\nChanging the default logo and other images\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe theme images are stored in `bellaelearning-edx-theme/theme/lms/static/images \u003chttps://github.com/macagua/bellaelearning-edx-theme/tree/master/theme/lms/static/images\u003e`__ for the LMS, and in `bellaelearning-edx-theme/theme/cms/static/images \u003chttps://github.com/macagua/bellaelearning-edx-theme/tree/master/theme/cms/static/images\u003e`__ for the CMS. To use custom images in your theme, just replace the files stored in these folders with your own prior to running ``tutor config render``.\n\nOverriding the default \"about\", \"contact\", etc. static pages\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nBy default, the ``/about`` and ``/contact`` pages contain a simple line of text: \"This page left intentionally blank. Feel free to add your own content\". This is of course unusable in production. In the following, we detail how to override just any of the static templates used in Open edX.\n\nThe static templates used by Open edX to render those pages are all stored in the `edx-platform/lms/templates/static_templates \u003chttps://github.com/edx/edx-platform/tree/open-release/koa.master/lms/templates/static_templates\u003e`__ folder. To override those templates, you should add your own in the following folder::\n\n    ls \"$(tutor config printroot)/env/build/openedx/themes/bellaelearning-edx-theme/lms/templates/static_templates\"\n\nFor instance, edit the \"donate.html\" file in this directory. We can derive the content of this file from the contents of the `donate.html \u003chttps://github.com/edx/edx-platform/blob/open-release/koa.master/lms/templates/static_templates/donate.html\u003e`__ static template in edx-platform::\n\n    \u003c%page expression_filter=\"h\"/\u003e\n    \u003c%! from django.utils.translation import ugettext as _ %\u003e\n    \u003c%inherit file=\"../main.html\" /\u003e\n\n    \u003c%block name=\"pagetitle\"\u003e${_(\"Donate\")}\u003c/%block\u003e\n\n    \u003cmain id=\"main\" aria-label=\"Content\" tabindex=\"-1\"\u003e\n        \u003csection class=\"container about\"\u003e\n            \u003ch1\u003e\n                \u003c%block name=\"pageheader\"\u003e${page_header or _(\"Donate\")}\u003c/%block\u003e\n            \u003c/h1\u003e\n            \u003cp\u003e\n                \u003c%block name=\"pagecontent\"\u003eAdd a compelling message here, asking for donations.\u003c/%block\u003e\n            \u003c/p\u003e\n        \u003c/section\u003e\n    \u003c/main\u003e\n\nThis new template will then be used to render the ``/donate`` url.\n\nLicense\n-------\n\nThis work is licensed under the terms of the `GNU Affero General Public License (AGPL) \u003chttps://github.com/macagua/bellaelearning-edx-theme/blob/master/LICENSE.txt\u003e`_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacagua%2Fbellaelearning-edx-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacagua%2Fbellaelearning-edx-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacagua%2Fbellaelearning-edx-theme/lists"}