Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

This feature is designed to be used by sites that wants want to take control of theme configuringconfiguration. A common use case would be having a hosted location for all the themes, and the dashboards are all which means that the dashboard will be configured with the predefined themes. A theme for all users. To support this, a new variable called PI_STYLES_EXTERNAL_THEME_PATH is  has been created.

  • when it’s not set, the theme path is the default theme path

  • when it’s set

    the theme path becomes a network path specified

    Please consider the following points when hosting a theme outside the dashboard:

    • If an external theme path has not been specified, the default theme for the dashboard will be theme shown in the PI_STYLES field. Please remember that you can also set different themes for individual users in the Users, Configuration screen and users will also be able to choose their own themes on the User account page (accessed by clicking their name on the More Options icon at the top right of the Dashboard). Please refer to this section in pi Documentation for further details.

    • If an external theme path has been specified

      • the theme path becomes the specified network path

      • the CSS Styles tab on the config Configuration screen is will be removed (network files are read only)

      • user account page doesn’t have the drop down for a user to select their own theme

      Successful or failed setup for system variables 
      • users will not be able to choose their own theme on the User account page and admin will not be able to set different themes for different users in the User, Configuration screen.

    The following points apply when using the system variable PI_STYLES_EXTERNAL_THEME_PATH

     (on the admin Settings page)

    :

    • When

      accessing

      access to the external theme

      has failed

      fails, the system

      falls back

      will revert to using the default system

      default theme

      theme specified in the PI_STYLES field.

    • When

      saving

      access to the external theme is successful, the system

      reflects

      will start to use the new theme

      setup straight away

      immediately.

    You can set the themes to come from a remote site. This would make them read-only which means you'd have to edit them on a separate dashboard and then upload them to that remote repository.

    This is done via editing the "PI_STYLES_EXTERNAL_THEME_PATH" variable setting (as per our variables documentation) in the Settings screen of Dashboard Configuration:

    Image Removed

    Image Added

    Info

    Please remember that when an external theme path has been specified, all dashboard users will see the same theme. Users will no longer be able to select their own theme.