Using Custom Web Root

Overview

Using Custom Page Manager is one way to customize PowerSchool, but an approach that has been around longer and still used by some is the method of customizing pages on the server itself.  PowerSchool consists of web pages that either display or allow input of data into it's database.  There are hundreds of web pages that make up the application, and they are stored in the main PowerSchool folder in a series of subfolders.  If you try to customize any of those pages though, your changes will be overwritten whenever the server resets or you do an upgrade.  Therefore, you can customize an existing page in PowerSchool by putting a copy of it in the custom web root folders area and PowerSchool will display it instead of the original page.  You can also create new pages and place them in the custom web root, but you'll need to create links to the pages for your users to see them.


Getting Started

Make sure Customization Enabled is checked on the System, System Settings, Customization page for your custom web root folders to be recognized by PowerSchool.  To customize an existing PowerSchool page, copy it from it's system web_root folder location to it's custom web_root folder.  You'll find the system web_root folder in the \Program Files\PowerSchool\application\components\powerschool-core-xx.xxxxx\system\server\resources area (the x's after core will be the version of PowerSchool you're using) and the custom folder location is in the \Program Files\PowerSchool\data\custom\web_root area.   If you're on an array, the custom folder location is usually a shared folder called the sharepoint.  If the custom web_root folder you need to copy the page to does not exist, create the folder using the same name(s) and case and path as the system folder and then copy the page into the folder and modify the page.  As long as Customization Enabled is checked, the page in the custom folder will be used instead of the original page in the system folder.  

Custom pages can also consist of new pages instead of those replacing existing PowerSchool pages.  They can be placed anywhere you want as long as they're in the appropriate main custom folder (admin pages in the admin folder, parent pages in the guardian folder, etc.).  You can also create sub folders and place pages in them, for example, sqlReports 5 goes in the admin/sqlReports5 folder, so you can create that folder structure within the custom web_root area.  To view the custom page you'll either need to type in the location of the file in the url - for example, if xyz.html is in the custom admin/reports folder, then go to /admin/reports/xyz.html - or create a link to the custom page on another page.

If you ever uncheck Customization Enabled, none of your custom pages, images, or wildcards will be used.  To quit using just one page, image, or wildcard, just delete it from the custom web root or rename it, and PowerSchool will use the original instead.   If you delete a custom student or faculty screen, you must run the Rebuild Custom Page Links special operation.  

Custom pages in the custom web_root area are not stored in the database, so you should back up a copy of your entire custom web_root folder to another location on a regular basis.

Important - if you have Custom Page Manager enabled, pages in it will be used before similar pages in the custom web root.  Also, pages in the /studentpages folder will not work and must be in CPM instead.

 

  Back to the List of Articles