Actions

Difference between revisions of "Custom Admin Themes"

From LimeSurvey Manual

(added steps for 3.0 and highlight editing AdminTheme.php)
Line 35: Line 35:
  
 
==Creating a new theme==  
 
==Creating a new theme==  
*Same procedure as in 2.5 to copy a theme folder, rename and modify the config.xml
+
*Copy one of the themes from '''/yourLimeSurveyDirectory/themes/admin''' to '''/yourLimeSurveyDirectory/upload/admintheme/''' and rename it (let's say "yourTheme")
*Add the new admin theme name in '''/application/models/AdminTheme.php'''
+
*Modify '''/yourLimeSurveyDirectory/upload/admintheme/yourTheme/config.xml''' to change the name, description and any other items in the <span style="color: red; font-weight:bold;"><metadatas></span> tag you see fit
*'''Clear the cache''' in the Global Settings > General tab /surveys/index.php/admin/globalsettings#general
+
*In [[Global_settings#General|Global settings --> General]], activate the new theme
 +
*After any modifications to CSS/JS '''Clear the cache''' in the Global Settings > General tab /surveys/index.php/admin/globalsettings#general

Revision as of 16:48, 3 October 2019

LimeSurvey Version 2.06

Creating a new theme

  • In /yourLimeSurveyDirectory/styles/, copy and rename one of the core admin theme directories
  • In Global settings --> General, activate the new theme

Insert a JavaScript file into a custom theme

See the workaround here.

LimeSurvey Version 2.5

Creating a new theme

  • Copy one of the themes from /yourLimeSurveyDirectory/styles to /yourLimeSurveyDirectory/upload/admintheme/ and rename it (let's say "'yourTheme'")
  • Modify /yourLimeSurveyDirectory/upload/admintheme/yourTheme/config.xml to change the name, description and any other items in the <metadatas> tag you see fit
  • In Global settings --> General, activate the new theme

Insert a JavaScript file into a custom theme

  • Add a custom.js file to /yourLimeSurveyDirectory/upload/admintheme/yourTheme/scripts/
  • Modify the <js> tag in /upload/admintheme/yourTheme/config.xml to include the new file so it would end up looking something like this:
        <js>
            <filename>notify.js</filename>
            <filename>save.js</filename>
            <filename>panelclickable.js</filename>
            <filename>panelsanimation.js</filename>
            <filename>sidemenu.js</filename>
            <filename>bootstrap-switch.min.js</filename>
            <filename>jquery.jcarousel.min.js</filename>
            <filename>jcarousel.responsive.js</filename>
            <filename>custom.js</filename>
        </js>

LimeSurvey Version 3.0+

Creating a new theme

  • Copy one of the themes from /yourLimeSurveyDirectory/themes/admin to /yourLimeSurveyDirectory/upload/admintheme/ and rename it (let's say "yourTheme")
  • Modify /yourLimeSurveyDirectory/upload/admintheme/yourTheme/config.xml to change the name, description and any other items in the <metadatas> tag you see fit
  • In Global settings --> General, activate the new theme
  • After any modifications to CSS/JS Clear the cache in the Global Settings > General tab /surveys/index.php/admin/globalsettings#general