Work with Custom Web Pages

On this page:

Get Started

Take a quick moment to familiarize yourself with the page.

1. On the start page, choose System under Setup in the main menu. 
2. Click Page and Data Management. 
3. Click Custom Page Management. 

4. In the left pane, note the following items:

   Field	Description
   [Site Structure]	Copy of the PowerSchool web root directory structure.
   [Folder]	Folders within the web root directory structure.
   [File]	Files within the web root directory structure. Note: Custom files appear blue.

5. In the upper pane, note the following items:

   Field	Description
   [Editing Tools]	A toolbar appears providing standard HTML editing tools. In addition, the following PowerSchool editing tools are available: Click Snippets to choose one of the following formatted PowerSchool elements to insert in the page: Box Tabs Dynamic Tabs Toggle Dialog Calendar Table

6. Click Templates to choose one of the following formatted PowerSchool page templates:

• Admin
• Admin Student
• Teacher
• Teacher Backpack
• Parent

• Under the [Editing Tools], note the following items

  Field	Description
  Customize Page	Once a built-in PowerSchool file is selected from the site structure, click to copy the content from the currently active copy of the page to Editable text editor.
  Save Draft	Once content has been modified in the Editable text editor, click to save your changes.
  Preview Page	Click to preview the page in the browser view.
  Version	If you created a file or customized a built-in PowerSchool file, a Draft of the file appears. Once you publish the Draft, it will then appear as Active. Only two versions of a file, Active and Draft, may appear in the list box at any given time. Active versions cannot be edited or re-published. However, they can be deleted.
  Publish	Once you have finished customizing a file, click to make it available for users to access.
  Extract to Keys	Click to extract the selected text to a key for translation.
  Preview Keys	Click to preview the extracted keys for the page.

• In the central pane, note the following items:

  Field	Description
  Editable	If a built-in PowerSchool file is selected from the Site Structure, the contents of the file appear after clicking Customize Page.
  Original	If a built-in PowerSchool file is selected from the Site Structure, the contents of the file appear.

Work with Folders

Folders assist you in organizing the custom files you create or upload into the PowerSchool database. You can create folders within the Site Structure where needed:

• If you select the top-level folder, the new folder will appear at that same level.
• If you select a folder, the new folder will appear within the selected folder.
• If you select a file, the new folder will appear within the folder in which the selected file resides.

1. On the start page, choose System under Setup in the main menu. The System Administrator page appears.
2. Click Page and Data Management. The Page and Data Management page appears.
3. Click Custom Page Management. The Custom Web Page Management page appears.
4. To create a folder:
   1. Within the Site Structure, right-click in which you want to add a new folder.
   2. Select New > Folder. The New Folder pop-up appears.
   3. Enter the name of the folder in the Folder Name field.
   4. Verify the Folder location.
   5. Click Submit. The new folder appears in the specified location.
5. To delete a folder:
   Note: Deleting files and folder in Custom Page Management only deletes the customizations.
   
   1. Within the Site Structure, right-click the folder you want to delete.
   2. Select Delete.
   3. If the folder or any of its subfolders contain any customized files a confirmation popup will appear, click OK if you are sure you want to delete this folder and its customized contents.

Files and Images

When working with files and images, you can create your own custom files or you can customize PowerSchool built-in files.

Upload Custom Files

Using the Upload function, you can transfer individual files from your computer into the PowerSchool database. The following valid file types may be uploaded: binary, css, csv, dmg, exe, ftl, gif, hqx, htm, html, ico, ics, ifb, jar, javascript, jpeg, jpg, js, json, macbinary, mov, pdf, png, ps-savetodisk, rpt, sit, swf, text, tif, tiff, tsv, txt, xml, and zip. If uploading an image, be sure to upload the image to the same folder as the file in which the image is to appear. Otherwise, the image will not display.
Notes:

• A zip archive of multiple files or directories cannot be downloaded from the PowerSchool database. To "download" a zip archive of multiple files or directories, copy and paste the file content from the Customize Page text box. This applies only to customers with access to the PowerSchool web root directory (non-asp customers).
• A zip archive of multiple files or directories cannot be uploaded to the PowerSchool database. To "upload" a zip archive of multiple files or directories, perform the Migrate function. It is important to note that re-migrating overwrites any files currently in the database including files that have been modified using Custom Web Page Management. This applies only to customers with access to the PowerSchool web root directory (non-asp customers).
• When uploading a file that is 2.4 megabytes or greater, the file appears to upload successfully. However, a script error is generated and the file is not uploaded. Therefore, do not upload a file greater than 2.4 megabytes.
• When uploading a QuickTime file (.mov), the file appears as an asset. However, the file does not appear in the Site Structure and therefore cannot be customized.

1. On the start page, choose System under Setup in the main menu. The System Administrator page appears.
2. Click Page and Data Management. The Page and Data Management page appears.
3. Click Custom Page Management. The Custom Web Page Management page appears.
4. Within the Site Structure, right-click the folder in which you want to upload a file.
5. Select Upload > File. The File Upload pop-up appears.
6. Click Choose File and select the file you want to upload. The name of the selected file appears.
7. Verify the Folder location.
8. Click Submit. The uploaded file appears in blues within the selected location.

Work with Custom Files

Using the New File function, you can also create your own files. The following valid file types may be created: css, csv, ftl, htm, html, javascript, js, json, rpt, text, tsv, txt, and xml.

Note: Once a file is created, it cannot be renamed or moved. However, you can create a new file with a new name/location and copy/paste the content of the previous file into the new file, and then delete the old file. Deleting a file removes all versions of the file permanently from the PowerSchool database.

1. On the start page, choose System under Setup in the main menu. The System Administrator page appears.
2. Click Page and Data Management. The Page and Data Management page appears.
3. Click Custom Page Management. The Custom Web Page Management page appears.
4. To create a custom file:
   1. Within the Site Structure, right-click the folder in which you want to create a new file.
   2. Select New > File. The New File pop-up appears.
   3. Enter the name of the file in the File Name field.
   4. Verify the location.
   5. Click Submit. The new file appears in blue within the specified location.
5. To delete a custom file:
   1. Within the Site Structure, right-click the file you want to delete.
   2. Click Delete. A confirmation message appears.
6. To create custom file content:
   1. From the Site Structure, select the new file for which you want to create content.
   2. Enter file content in the Editable text editor, as needed.
   3. Use the editing tools at the top of the page to assist you in your content.
   4. Click Save Draft. A confirmation message appears.
      Note: If you navigate away from the custom file currently being edited before saving your changes, your changes will not be saved.
   5. Click Preview Page to view the page as it would be rendered in PowerSchool.
7. To edit custom file content:
   1. Within the Site Structure, select the custom file you want to edit.
   2. Select the Draft version.
      Note: If both an Active and Draft version appear in the Version list box, the Active version cannot be edited as it has already been published. Published files cannot be edited.
   3. Enter file content in the Editable text editor, as needed.
   4. Use the editing tools at the top of the page to assist you in your content.
   5. Click Save Draft. A confirmation message appears.
   6. Click Preview Page to view the page as it would be rendered in PowerSchool.

Customize Built In PowerSchool Files

Using the Customize Page function, you can customize existing built in PowerSchool files. At any time, you can delete a customized built in PowerSchool file and revert to the original built in PowerSchool file. Reverting a file removes all customized versions of the file permanently from the PowerSchool database.

1. On the start page, choose System under Setup in the main menu. The System Administrator page appears.
2. Click Page and Data Management. The Page and Data Management page appears.
3. Click Custom Page Management. The Custom Web Page Management page appears.
4. To customize a built in PowerSchool file:
   1. Within the Site Structure, select the built in PowerSchool file you want to customize.
   2. Click Customize Page. A copy of the page contents appears in the Editable text editor.
   3. Edit the content in the Editable text editor, as needed.
   4. Use the editing tools at the top of the page to assist you in your content.
   5. Click Save Draft. A confirmation message appears.
      Note: If you navigate away from the custom file currently being edited before saving your changes, your changes will not be saved.
   6. Click Preview Page to view the page as it would be rendered in PowerSchool.
5. To revert a customized built in PowerSchool file:
   1. Within the Site Structure, select the customized built in PowerSchool file you want to revert. The file appears highlighted.
   2. Click Delete. A confirmation message appears.

Publish Files

Once you have finished customizing a file and want to make it available for users to access, you can publish the file to PowerSchool. Publishing a draft version of the custom file changes the status of the file from Draft to Active. Only one Draft version and one Active version of a file are allowed at any given time.

1. On the start page, choose System under Setup in the main menu. The System Administrator page appears.
2. Click Page and Data Management. The Page and Data Management page appears.
3. Click Custom Page Management. The Custom Web Page Management page appears.
4. Within the Site Structure, select the file you want to publish.
5. Select the Draft version. The Draft version appears highlighted.
6. Click Publish. A confirmation message appears.
   Note: To view the file, log in to the appropriate PowerSchool application and navigate to the page of the application you customized.

Extract Custom Page Text for Translation

Using the Extract to Keys function, you can covert customized file content to display on the Language Translation page in PowerSchool for batch translation.

1. On the start page, choose System under Setup in the main menu. The System Administrator page appears.
2. Click Page and Data Management. The Page and Data Management page appears.
3. Click Custom Page Management. The Custom Web Page Management page appears.
4. Within the Site Structure, select the file you want to translate.
5. In the Editable text editor, select the text you want to convert for translation, and then click the Extract to Keys.
6. Repeat for each text string to be translated.
7. Click the Preview Keys button to display all of the extracted keys and the current text value.
8. Click Save Draft. A confirmation message appears, and the extracted keys are now available for batch translation on the Language Translation page in PowerSchool.