Difference between revisions of "Personalisation"

From InsightWiki
Jump to navigation Jump to search
 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Change the way Insight looks=
 
 
The appearance of Insight can be easily changed and amended to suit your taste or school colour scheme. There are various sections of Insight that can be changed, and methods for applying these changes, which are described below. <br> <br>
 
 
==Built-in colour schemes==
 
 
Insight has a number of preset colour schemes which you can select from when running the [[service controller]]. On the Commit tab there is a drop down which allows you to select a theme. Chose one and then click Begin. <br> <br>
 
 
{| style="text-align: center;"
 
|[[Image:theme_1.jpg|300px]]||[[Image:theme_2.jpg|300px]]||[[Image:theme_3.jpg|300px]]
 
|-
 
|'''Blue Plastic <br> <br>||'''Metropolis <br> <br>||'''Blue Metropolis <br> <br>
 
|-
 
|[[Image:theme_4.jpg|300px]]||[[Image:theme_5.jpg|300px]]||[[Image:theme_6.jpg|300px]]
 
|-
 
|'''Olive <br> <br>||'''Purple Grey <br> <br>||'''Red Wine <br> <br>
 
|-
 
|[[Image:theme_7.jpg|300px]]||[[Image:theme_8.jpg|300px]]
 
|-
 
|'''Soft Orange <br> <br>||'''Web 2 <br> <br>
 
|} <br>
 
 
 
==Custom colour schemes==
 
==Custom colour schemes==
  
To create a custom colour scheme for Insight you will need access to the IIS server on which Insight is installed. You can take copies of existing files that affect the Insight colour scheme and then change them to suit your needs. <br> <br>
+
The default colour scheme is a light grey background with dark grey toolbars. This colour scheme can be changed using files generated or downloaded online. See the '''[[themes]]''' page for more information about creating and importing custom colour schemes. <br> <br>
 
 
The appearance of Insight is defined by three separate files which affect different aspects of the appearance. The image below illustrates the areas of Insight that are affected by each file: <br> <br>
 
 
 
[[Image:insight_customise_help01.jpg|650px]] <br> <br>
 
 
 
{|class="wikitable"
 
!Colour!!Areas!!File
 
|-
 
|[[Image:red.jpg|24px]]||Background & workspace||styles.css
 
|-
 
|[[Image:blue.jpg|24px]]||Header, footer, title and menu||jquery-ui-1.8.custom.css
 
|-
 
|[[Image:green.jpg|24px]]||Grids||ASPxGridView.skin & ASPxGridView.skin.bak
 
|} <br>
 
 
 
On the Insight server, browse to the Insight folder. You will need to create two new folders for your colour scheme. These two folders must have exactly the same name, which will also be the name of your colour scheme. <br> <br>
 
 
 
*within the _Scripts\jQuery\css folder, create a folder with the name of your colour scheme
 
*within the App_Themes folder, create a folder with the name of your colour scheme <br> <br>
 
 
 
===Background & workspace (red section)===
 
 
 
The design and layout of these elements are taken from a .css file. Go to the App_Themes folder and you will see folders for the existing Insight themes. Go into one of these folders then copy and paste the styles.css file into your own folder (INSIGHT\App_Themes\YourFolder) <br> <br>
 
 
 
You can then edit this .css file to make any desired changes. <br> <br>
 
 
 
===Header, footer, title and menu (blue section)===
 
 
 
The design and layout of these elements are defined by a jQuery file. Go to the css folder (INSIGHT\Scripts\jQuery\css) and you will see one folder for each of the existing Insight themes. Go into one of these folders then copy and paste the jquery-ui-1.8.custom.css into your own folder (INSIGHT\Scripts\jQuery\css\YourFolder) <br> <br>
 
 
 
You can then edit this .css file to make any desired changes. <br> <br>
 
 
 
===Grid view changes (green section)===
 
 
 
The grid outlines, column headers and tick boxes are all defined by .skin files. Go to the App_Themes folder and you will see folders for the existing Insight themes. Go into one of these folders then copy and paste the ASPxGridView.skin and ASPxGridView.skin.bak files into your folder (INSIGHT\App_Themes\YourFolder) <br> <br>
 
 
 
You can then edit these files to make any desired changes. <br> <br>
 
 
 
===Further personalisation - jQuery===
 
 
 
If you want to make further changes to the appearance of Insight you will need to go to the jQuery website at http://www.jqueryui.com/themeroller . <br> <br>
 
 
 
You can then go to the gallery to make amendments or create a new view and download the files to your computer, placing them in the relevant folder for your Insight colour scheme. You may need to rename the downloaded .css file, so that the version in the filename is exactly 1.8. For example if your downloaded .css file is named "jquery-ui-1.8.21.custom.css" you should rename it to "jquery-ui-1.8.custom.css". <br> <br>
 
 
 
The Insight team will not be able to assist with specific jQuery questions/issues. <br> <br>
 
 
 
===web.config update===
 
 
 
Once you have made all desired changes, you need to select your custom theme. To do this, you can either run the [[service controller]] and select from the drop-down list of themes (see above) or you can edit the web.config file. <br> <br>
 
 
 
To edit the web.config file, you will need to change the "Theme" setting: <br> <br>
 
 
 
From
 
 
 
      <setting name="Theme" serializeAs="String">
 
        <value>'''Metropolis'''</value>
 
      </setting>
 
 
 
To
 
 
 
 
 
      <setting name="Theme" serializeAs="String">
 
        <value>'''YourCustomTheme'''</value>
 
      </setting>
 
 
 
 
 
 
 
Refresh Insight by pressing CTRL & F5 or logging-in and out to see your changes. <br> <br>
 
  
 
==Custom icons==
 
==Custom icons==
  
There is a list of the icons used in Insight, in the "_Personalisation" folder on the IIS server (usually c:\inetpub\wwwroot\insight\_Personalisation\BuiltInIcons.txt )
+
You can change the icons used for any of the menu items. Some pages in Insight also show subject icons (such as [[timetable]] and [[parents evenings]]). Subject icons can also be changed if desired. <br> <br>
 
This file is a list of built-in icons and buttons for menus and subjects. If you want to add your own icon for a specific menu item:
 
Ensure your image is a 32x32 PNG file
 
Save it in this folder with the same name as the icon
 
  
For example, if you want to update the achievements icon ensure your image is called achievements.png
+
In the _Personalisation folder, there is a file called "BuiltInIcons.txt". This file contains a list of the names of the icons that Insight uses for each icon. <br> <br>
  
This file is a list of built-in icons and buttons for menus and subjects.  If you want to add your own icon for a specific menu item:
+
If you want to use a custom icon, then you will need a 32x32 PNG file of your new icon. Save a copy of the new icon in the _Personalistion folder and name the icon according the to names in the BuiltInIcons.txt file. <br> <br>
*Ensure your image is a 32x32 PNG file
 
*Save it in this folder with the same name as the icon
 
  
For example, if you want to update the achievements icon ensure your image is called achievements.png
+
For example, if you wanted to use a new icon for the [[parents evenings]] menu item, you would save your 32x32 PNG file in the _Personalisation folder and name it "parentsevening_icon.png" <br> <br>
  
==Changing School Logo==
+
==Changing school logo==
  
This option will allow amendments to the logo.
+
The school logo will appear on the tab in the browser that is running Insight, and may also appear on the login page. There are two methods which can be used to change the school logo in Insight. <br> <br>
  
*The logo file must be a Logo.png file, for example "School Logo.png", and store it directly into the _Personalisation subfolder on the main webserver (usually c:\inetpub\wwwroot\insight\_Personalisation).
+
===Method 1 - SIMS===
  
Once everything is in place you will want to make the necessary change to the web.config file to apply the changes.
+
By default, Insight will take the school logo from SIMS. You can find and change the school logo in SIMS via: <br>
 +
Focus > School > School details <br> <br>
  
There are two methods to changing the school logo in Insight:
+
This will be overruled if the web.config file has been told to use a different file. See below for details. <br> <br>
  
Method 1:
+
===Method 2 - web.config===
*Log on to the machine that Insight was installed onto.
 
*Browse to the INSIGHT folder - this is often found via C:\inetpub\wwwroot\INSIGHT or C:\inetpub\INSIGHT
 
*Copy and paste your new school logo into the INSIGHT folder. The new image file must be named "logo.png" - if this file already exists then overwrite or move it.
 
  
Method 2:
+
You can upload a .PNG file to the Insight root folder on the IIS server and change the settings in the web.config file to use your chosen .PNG . This can either be done using the [[service controller]] or by manually uploaded the file and updated the web.config. <br> <br>
*Log on to SIMS and go to Focus > School > School Details
 
*Update the school logo by clicking on the magnifying glass button in section 1 on this screen.
 
*Log on to the machine that Insight was installed onto.
 
*Browse to the INSIGHT folder - this is often found via C:\inetpub\wwwroot\INSIGHT or C:\inetpub\INSIGHT
 
*Check that there is not a file in the INSIGHT folder called "logo.png" - if there is then rename, move or delete it.
 
  
 +
If you want to use the service controller then run the service controller and look for a logo option on the Commit tab. Click the browse button and select a .PNG file that you would like Insight to use for the school logo, then click Begin. The service controller will upload the file to the Insight root folder and make the appropriate changes to the web.config file. <br> <br>
  
===web.config update - logo===
+
Alternatively, you can upload the .PNG file to the Insight root folder yourself and then edit the web.config folder. You will need to change the "Logo" setting: <br> <br>
 
 
*Open the Insight web.config file (usually c:\inetpub\wwwroot\insight\web.config) and amend the logo name to the name of your .png file, for example 'School Logo.png', by amending the data between the 'value' fields, here is an example.
 
  
 
From
 
From
  
 
       <setting name="Logo" serializeAs="String">
 
       <setting name="Logo" serializeAs="String">
         <value>aboutblank.png</value>
+
         <value>logo.png</value>
 
       </setting>
 
       </setting>
  
Line 145: Line 41:
  
 
       <setting name="Logo" serializeAs="String">
 
       <setting name="Logo" serializeAs="String">
         <value>School Logo.png</value>
+
         <value>YourFile.png</value>
 
       </setting>
 
       </setting>
  
*Refresh Insight by pressing CTRL and F5 or logging-in and out then you will see your changes.
+
*Refresh Insight by pressing CTRL & F5 or logging-in and out then you will see your changes. <br> <br>
 
 
=Change the way Insight works=
 
 
 
_Personalisation files will allow you to make more specific changes within Insight which cannot be put in place through either the role option settings or preference settings.  Sometime it is the case that these changes may only be required for your school.
 
 
 
All the files will initially have an extension of 'unused'; in addition to any actions below you will need to remove the 'unused' extension to start using the files.
 
 
 
Here are explanations of various _Personalisation options used in Insight.
 
 
 
==aspect.priorities==
 
 
 
This folder allows you to make amendments to the priority of Aspects and the priority of the Subject and Year Group within the Aspect.
 
 
 
In order for this to work the settings for the role must be set correctly.  Within subjects ensure the setting for 'use_Personalisation\aspect.priorities file' is set to 'on'.
 
 
 
 
 
==autosynch.answer==
 
 
 
This file holds the settings for an automatic synchronisation of data from SIMS to be performed once a day just after midnight. 
 
 
 
In order for it to work you have to have KeepAlive installed and running.  To check this run the ServiceController.exe possibly on your shared drive in the Insight folder.  Open the 'Services' option and you can check the current state of Keep Alive.  Close the window once you have finished checking.
 
 
 
If Keep Alive is running it will "prod" the web site to keep the application loaded in memory on the web server every 10 minutes. At the first check it does after midnight, providing this file exists, the values within it are correct and set as follows:
 
 
 
<answer activated="true" role="Standard" invalidate-existing="true" purge-ad="false" />
 
 
 
then the synchronisation will run.
 
 
 
==blacklisted.aspect.resultsets==
 
 
 
This folder allows you to add the aspect name and the resultset name that you do not want to see by blacklisting them.
 
 
 
==notice.footer and notice.header==
 
 
 
These two folders allow you to setup the header and footer for emails initiated through Notice composer.
 
 
 
==sessiontimes.csv==
 
 
 
This file holds the timings for registration periods during a week and any specific session times required.
 
 
 
SIMS will let you set the registration period timings but only once so, if these are incorrect using this file within Insight will allow you to amend and overwrite the SIMS version.
 
 
 
You can see this in the Timetable and Snapshot menu items under attendance.
 
 
 
In order for this to work the settings for the role must be set correctly.  Within snapshot ensure the setting for 'show lesson times' is set to 'on'. You may also have to re-start Insight.
 
 
 
==snapshot.(snapshot name).bolton==
 
 
 
This file allows for additional web pages, external or from within _Personalisation, to be added to the snapshot page.
 
 
 
In this file add the following information:
 
 
 
*An appropriate title between the 'title' fields
 
*The link to the website between the 'url' fields
 
*The height of the item between the 'height' fields (this will be the height of the item when displayed within snapshot).
 
 
 
==TimetableJump.aspx and TimetableJump.rar==
 
 
 
This file allows you to jump to an external application page, for example a page about a specific subject.  You will need to make sure the path in this folder and the SIMS data is correct.
 
 
 
 
 
==WML2HTML.xsl==
 
 
 
If you choose to use this file it will replace the ASPOS option in SIMS.
 
 
 
However, a more up-to-date method to do the same task is to use Batch PDF conversion within the Manage menu option in the Insight application.
 
 
 
[[Category:Configuration]]
 
[[Category:Technical]]
 

Latest revision as of 16:00, 21 September 2018

Custom colour schemes

The default colour scheme is a light grey background with dark grey toolbars. This colour scheme can be changed using files generated or downloaded online. See the themes page for more information about creating and importing custom colour schemes.

Custom icons

You can change the icons used for any of the menu items. Some pages in Insight also show subject icons (such as timetable and parents evenings). Subject icons can also be changed if desired.

In the _Personalisation folder, there is a file called "BuiltInIcons.txt". This file contains a list of the names of the icons that Insight uses for each icon.

If you want to use a custom icon, then you will need a 32x32 PNG file of your new icon. Save a copy of the new icon in the _Personalistion folder and name the icon according the to names in the BuiltInIcons.txt file.

For example, if you wanted to use a new icon for the parents evenings menu item, you would save your 32x32 PNG file in the _Personalisation folder and name it "parentsevening_icon.png"

The school logo will appear on the tab in the browser that is running Insight, and may also appear on the login page. There are two methods which can be used to change the school logo in Insight.

Method 1 - SIMS

By default, Insight will take the school logo from SIMS. You can find and change the school logo in SIMS via:
Focus > School > School details

This will be overruled if the web.config file has been told to use a different file. See below for details.

Method 2 - web.config

You can upload a .PNG file to the Insight root folder on the IIS server and change the settings in the web.config file to use your chosen .PNG . This can either be done using the service controller or by manually uploaded the file and updated the web.config.

If you want to use the service controller then run the service controller and look for a logo option on the Commit tab. Click the browse button and select a .PNG file that you would like Insight to use for the school logo, then click Begin. The service controller will upload the file to the Insight root folder and make the appropriate changes to the web.config file.

Alternatively, you can upload the .PNG file to the Insight root folder yourself and then edit the web.config folder. You will need to change the "Logo" setting:

From

     <setting name="Logo" serializeAs="String">
       <value>logo.png</value>
     </setting>

To

     <setting name="Logo" serializeAs="String">
       <value>YourFile.png</value>
     </setting>
  • Refresh Insight by pressing CTRL & F5 or logging-in and out then you will see your changes.