QPR Knowledge Base 2019.1

Transferring QPR Portal Customizations to a New Version

Transferring QPR Portal Customizations to a New Version

Previous topic Next topic  

Transferring QPR Portal Customizations to a New Version

Previous topic Next topic  

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.

2017.1

C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS\Booklet

 

Note: Templates are initially installed to <QPR 2017.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.

2017.1

C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS\Common

 

Note: Templates are initially installed to <QPR 2017.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.

2017.1

C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS\Portal

 

Note: Templates are initially installed to <QPR 2017.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.

2017.1

C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS\SC

 

Note: Templates are initially installed to <QPR 2017.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.

2017.1

C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS\PG

 

Note: Templates are initially installed to <QPR 2017.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.

 

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.