Changing the default content of Openedx UI-Theme

273 views
Skip to first unread message

Rafiat Aliyu

unread,
Dec 11, 2017, 7:40:22 AM12/11/17
to Open edX operations
Good day.
Thought I can get some pointers here.
I am absolutely new to Openedx. I had it installed it on GCP and it works but now I need to customise the interface, like replace the logo, change the header and footer text as well as some general descriptive information. I have been reading the theming documentation from here: http://edx.readthedocs.io/projects/edx-installing-configuring-and-running/en/latest/configuration/changing_appearance/theming/create_theme.html

I understand the structure and replacing the default theme with a custom one but when I actually look up the default one to copy contents over to the custom for modification I don't seem to understand for instance, Where and how do I change the content footer "© Your Platform Name Here...". the logo and the content of the modal page that appears on the hope page.

I also am looking for documentation of how to use the Django Admin part, wondering what goes in that part and in what format. Sorry not familiar with framework or what it does right now.  Any help to understand will be appreciated andy vidoe walkthrough and examples will be helpful.

Thank you.

Liubov Fomicheva

unread,
Dec 13, 2017, 11:04:31 AM12/13/17
to Open edX operations
Hello Rafiat,

The templates for edx-platform are rather complicated and sometimes include information taken from various settings. This is implemented with mako variables. If you simply copy-paste the existing templates, you can either replace these constructions with your custom text or change corresponding settings of the platform, e.g.
  • The platform name is basically extracted from /edx/app/edxapp/lms.env.json (cms.env.json) settings files (the default is exactly "Your Platform Name Here");
  • The logo could be just replaced in theme by putting file named logo.png to lms/static/images/ subdirectory of your theme;
  • The content of the modal dialog could be changed via setting homepage_overlay_html variable, implying you use microsites feature (one "default" microsite is enough for your case) or more powerful sites feature.
  The Django admin site is just a simple interface to the database, basics for programmers are described in Django docs (see the tutorial for example). In Open edX platform source, it's extensively used for configuration without server reloading. There are plenty of settings, most of them keeping logs of all changes. If you need any help with it, you'd better describe your particular case in details.

Kind regards,
  Liubov.

понедельник, 11 декабря 2017 г., 15:40:22 UTC+3 пользователь Rafiat Aliyu написал:

José Miguel Henao Cardona

unread,
Jan 29, 2018, 7:50:54 AM1/29/18
to Open edX operations
Hi Liubov:

I have been creating my own theme, I have already modified the variables "ENABLE_COMPREHENSIVE_THEMING": true, and "COMPREHENSIVE_THEME_DIRS": [ ],
but at the time of activating it in the Django admin, I do not know what to put in the fields ''site'', and ''theme dir name'';

I would appreciate any suggestions. Thak you.

José Miguel Henao
Reply all
Reply to author
Forward
0 new messages