|
|
Transferring QPR Portal Customizations to a New Version |
|
|
|
||
Transferring QPR Portal Customizations to a New Version |
|
|
|
|
|
|
Transferring QPR Portal Customizations to a New Version |
|
|
|
||
Transferring QPR Portal Customizations to a New Version |
|
|
|
|
|
|
||
The custom stylesheet structure of the QPR package makes it easier to transfer old Portal customizations to the new version when upgrading the QPR suite. For instructions concerning the customization itself, refer to the QPR Developer's Guide.
Provided that you have inserted all your modifications to the custom.css file, you will only need to copy your changes from the old custom.css file into the current custom.css file under the qprsoftware/stylesheets/custom.css folder. Copy also your customimages folder in the case you had any customized images in use. Do not overwrite the existing custom.css file as there can be some new styles included in the new file. Copy only your existing customizations to the matching classes.
Note also that the web content folder structure has changed a bit between QPR 8.1 and QPR 2012.1/2012.2, so you may need to modify some templates if you have referenced files located in earlier web content directories. See below for details about the changes. In addition, templates from an earlier version are unlikely to work as such in a newer version, so when upgrading for example from QPR 8.1 to QPR 2017.1, the old templates folder should not be dropped into the new installation as such, but the customizations should be ported instead. Porting means that the differences between the original QPR 8.1 templates and new QPR 2017.1 templates are analyzed and customizations done manually where applicable or necessary.
QPR WAS and Portal Templates
See the tables below for information about where QPR Portal templates are located in different versions so that you can properly port any customizations you might have in your templates.
Briefing Booklet templates
Version |
Folder location |
|---|---|
8.1 |
C:\ProgramData\QPR Software\QPR 8\8.1\Templates\WAS\Booklet
Note: Templates are initially installed to <QPR 8 installation root>\Web Application Server\Templates\Booklet, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.1 |
C:\ProgramData\QPR Software\QPR 2012\2012.1\Servers\Templates\WAS\Booklet
Note: Templates are initially installed to <QPR 2012.1 Servers installation root>\Web Application Server\Templates\Booklet, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.2 |
C:\ProgramData\QPR Software\QPR 2012\2012.2\Servers\Templates\WAS\Booklet
Note: Templates are initially installed to <QPR 2012.2 Servers installation root>\Web Application Server\Templates\Booklet, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2014.1 |
C:\ProgramData\QPR Software\QPR 2014\2014.1\Servers\Templates\WAS\Booklet
Note: Templates are initially installed to <QPR 2014.1 Servers installation root>\Web Application Server\Templates\Booklet, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2015.1 |
C:\ProgramData\QPR Software\QPR 2015\2015.1\Servers\Templates\WAS\Booklet
Note: Templates are initially installed to <QPR 2015.1 Servers installation root>\Web Application Server\Templates\Booklet, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2016.1 |
C:\ProgramData\QPR Software\QPR 2016\2016.1\Servers\Templates\WAS\Booklet
Note: Templates are initially installed to <QPR 2016.1 Servers installation root>\Web Application Server\Templates\Booklet, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
Common templates
Version |
Folder location |
|---|---|
8.1 |
C:\ProgramData\QPR Software\QPR 8\8.1\Templates\WAS\Common
Note: Templates are initially installed to <QPR 8 installation root>\Web Application Server\Templates\Common, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.1 |
C:\ProgramData\QPR Software\QPR 2012\2012.1\Servers\Templates\WAS\Common
Note: Templates are initially installed to <QPR 2012.1 Servers installation root>\Web Application Server\Templates\Common, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.2 |
C:\ProgramData\QPR Software\QPR 2012\2012.2\Servers\Templates\WAS\Common
Note: Templates are initially installed to <QPR 2012.2 Servers installation root>\Web Application Server\Templates\Common, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2014.1 |
C:\ProgramData\QPR Software\QPR 2014\2014.1\Servers\Templates\WAS\Common
Note: Templates are initially installed to <QPR 2014.1 Servers installation root>\Web Application Server\Templates\Common, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2015.1 |
C:\ProgramData\QPR Software\QPR 2015\2015.1\Servers\Templates\WAS\Common
Note: Templates are initially installed to <QPR 2015.1 Servers installation root>\Web Application Server\Templates\Common, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2016.1 |
C:\ProgramData\QPR Software\QPR 2016\2016.1\Servers\Templates\WAS\Common
Note: Templates are initially installed to <QPR 2016.1 Servers installation root>\Web Application Server\Templates\Common, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
Portal templates
Version |
Folder location |
|---|---|
8.1 |
C:\ProgramData\QPR Software\QPR 8\8.1\Templates\WAS\Portal
Note: Templates are initially installed to <QPR 8 installation root>\Web Application Server\Templates\Portal, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.1 |
C:\ProgramData\QPR Software\QPR 2012\2012.1\Servers\Templates\WAS\Portal
Note: Templates are initially installed to <QPR 2012.1 Servers installation root>\Web Application Server\Templates\Portal, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.2 |
C:\ProgramData\QPR Software\QPR 2012\2012.2\Servers\Templates\WAS\Portal
Note: Templates are initially installed to <QPR 2012.2 Servers installation root>\Web Application Server\Templates\Portal, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2014.1 |
C:\ProgramData\QPR Software\QPR 2014\2014.1\Servers\Templates\WAS\Portal
Note: Templates are initially installed to <QPR 2014.1 Servers installation root>\Web Application Server\Templates\Portal, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2015.1 |
C:\ProgramData\QPR Software\QPR 2015\2015.1\Servers\Templates\WAS\Portal
Note: Templates are initially installed to <QPR 2015.1 Servers installation root>\Web Application Server\Templates\Portal, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2016.1 |
C:\ProgramData\QPR Software\QPR 2016\2016.1\Servers\Templates\WAS\Portal
Note: Templates are initially installed to <QPR 2016.1 Servers installation root>\Web Application Server\Templates\Portal, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
SC templates
Version |
Folder location |
|---|---|
8.1 |
C:\ProgramData\QPR Software\QPR 8\8.1\Templates\WAS\SC
Note: Templates are initially installed to <QPR 8 installation root>\Web Application Server\Templates\SC, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.1 |
C:\ProgramData\QPR Software\QPR 2012\2012.1\Servers\Templates\WAS\SC
Note: Templates are initially installed to <QPR 2012.1 Servers installation root>\Web Application Server\Templates\SC, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2012.2 |
C:\ProgramData\QPR Software\QPR 2012\2012.2\Servers\Templates\WAS\SC
Note: Templates are initially installed to <QPR 2012.2 Servers installation root>\Web Application Server\Templates\SC, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2014.1 |
C:\ProgramData\QPR Software\QPR 2014\2014.1\Servers\Templates\WAS\SC
Note: Templates are initially installed to <QPR 2014.1 Servers installation root>\Web Application Server\Templates\SC, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2015.1 |
C:\ProgramData\QPR Software\QPR 2015\2015.1\Servers\Templates\WAS\SC
Note: Templates are initially installed to <QPR 2015.1 Servers installation root>\Web Application Server\Templates\SC, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2016.1 |
C:\ProgramData\QPR Software\QPR 2016\2016.1\Servers\Templates\WAS\SC
Note: Templates are initially installed to <QPR 2016.1 Servers installation root>\Web Application Server\Templates\SC, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
PG templates
Version |
Folder location |
8.1 |
C:\ProgramData\QPR Software\QPR 8\8.1\Templates\WAS\PG
Note: Templates are initially installed to <QPR 8 installation root>\Web Application Server\Templates\PG, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates.
The templates for static web publishing (Basic, Frames, and No Frames) are located under C:\ProgramData\QPR Software\QPR 8\8.1\Templates\PGStatic. |
2012.1 |
C:\ProgramData\QPR Software\QPR 2012\2012.1\Servers\Templates\WAS\PG
Note: Templates are initially installed to <QPR 2012.1 Servers installation root>\Web Application Server\Templates\PG, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates.
The templates for static web publishing (Basic, Frames, and No Frames) are located under C:\ProgramData\QPR Software\QPR 2012\2012.1\Clients\Templates\PGStatic |
2012.2 |
C:\ProgramData\QPR Software\QPR 2012\2012.2\Servers\Templates\WAS\PG
Note: Templates are initially installed to <QPR 2012.2 Servers installation root>\Web Application Server\Templates\PG, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates.
The templates for static web publishing (Basic, Frames, and No Frames) are located under C:\ProgramData\QPR Software\QPR 2012\2012.2\Clients\Templates\PGStatic |
2014.1 |
C:\ProgramData\QPR Software\QPR 2014\2014.1\Servers\Templates\WAS\PG
Note: Templates are initially installed to <QPR 2014.1 Servers installation root>\Web Application Server\Templates\PG, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates.
The templates for static web publishing (Basic, Frames, and No Frames) are located under C:\ProgramData\QPR Software\QPR 2014\2014.1\Clients\Templates\PGStatic |
2015.1 |
C:\ProgramData\QPR Software\QPR 2015\2015.1\Servers\Templates\WAS\PG
Note: Templates are initially installed to <QPR 2015.1 Servers installation root>\Web Application Server\Templates\PG, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
2016.1 |
C:\ProgramData\QPR Software\QPR 2016\2016.1\Servers\Templates\WAS\PG
Note: Templates are initially installed to <QPR 2016.1 Servers installation root>\Web Application Server\Templates\PG, but they are copied to the path indicated above during the first startup and used from the ProgramData folder location, so all customizations should be made to those templates. |
Note: During upgrades between different releases of QPR 2017.1 (for example 2017.1.1 and 2017.1.2) the old template folder is backed up to C:\ProgramData\QPR Software\QPR 2017\2017.1\Templates_before_<current service pack>, and you can restore customizations from there.
Preparing for Future Upgrades
Make all the customizations to the custom.css file and store all the modified images to the qprsoftware/stylesheets/customimages folder. Doing this ensures that the future upgrades will be simple, as you will only need to copy the styles in the custom.css stylesheet and the customimages folder to the new installation folder. It is also good to mark all customizations with easily searchable comments to make it easier to transfer them into a new version.