QPR Knowledge Base 2012.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 7.5 and QPR 7.6/8.0, 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 7.6 to QPR 8.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 7.6 templates and new QPR 8.1 templates are analyzed and customizations ported 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

7.5

<QPR 7 installation root>\Web Application Server\Templates\Booklet

7.6

<path to All Users profile>\Application Data\QPR Software\QPR 7\7.6\Templates\WAS\Booklet

 

Note: Templates are initially installed to <QPR 7 installation root>\Web Application Server\Templates\Booklet, but they are copied to the path indicated above during the first startup and used from the All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.0

<path to All Users profile>\Application Data\QPR Software\QPR 8\8.0\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.1

<path to All Users profile>\Application Data\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

 

Common templates

Version

Folder location

7.5

<QPR 7 installation root>\Web Application Server\Templates\Common

7.6

<path to All Users profile>\Application Data\QPR Software\QPR 7\7.6\Templates\WAS\Common

 

Note: Templates are initially installed to <QPR 7 installation root>\Web Application Server\Templates\Common, but they are copied to the path indicated above during the first startup and used from the All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.0

<path to All Users profile>\Application Data\QPR Software\QPR 8\8.0\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.1

<path to All Users profile>\Application Data\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

 

Portal templates

Version

Folder location

7.5

<QPR 7 installation root>\Web Application Server\Templates\Portal

7.6

<path to All Users profile>\Application Data\QPR Software\QPR 7\7.6\Templates\WAS\Portal

 

Note: Templates are initially installed to <QPR 7 installation root>\Web Application Server\Templates\Portal, but they are copied to the path indicated above during the first startup and used from the All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.0

<path to All Users profile>\Application Data\QPR Software\QPR 8\8.0\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.1

<path to All Users profile>\Application Data\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

 

SC templates

Version

Folder location

7.5

<QPR 7 installation root>\Web Application Server\Templates\SC

7.6

<path to All Users profile>\Application Data\QPR Software\QPR 7\7.6\Templates\WAS\SC

 

Note: Templates are initially installed to <QPR 7 installation root>\Web Application Server\Templates\SC, but they are copied to the path indicated above during the first startup and used from the All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.0

<path to All Users profile>\Application Data\QPR Software\QPR 8\8.0\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

8.1

<path to All Users profile>\Application Data\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

 

PG templates

Version

Folder location

7.5

<QPR 7 installation root>\Web Application Server\Templates\PG (Basic, Frames, and No Frames folders are now found only under QPR 7\ProcessGuide\WebLayouts

7.6

<path to All Users profile>\Application Data\QPR Software\QPR 7\7.6\Templates\WAS\PG

 

Note: Templates are initially installed to <QPR 7 installation root>\Web Application Server\Templates\PG, but they are copied to the path indicated above during the first startup and used from the All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

 

The templates for static web publishing (Basic, Frames, and No Frames) are located under <path to All Users profile>\Application Data\QPR Software\QPR 7\7.6\Templates\PGStatic.

8.0

<path to All Users profile>\Application Data\QPR Software\QPR 8\8.0\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

 

The templates for static web publishing (Basic, Frames, and No Frames) are located under <path to All Users profile>\Application Data\QPR Software\QPR 8\8.0\Templates\PGStatic.

8.1

<path to All Users profile>\Application Data\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 All Users profile (ProgramData folder in Vista and later versions) location, so all customizations should be made to those templates.

 

The templates for static web publishing (Basic, Frames, and No Frames) are located under <path to All Users profile>\Application Data\QPR Software\QPR 8\8.1\Templates\PGStatic.

 

Note: During upgrades between different releases of QPR 2012.1 (for example 2012.1 and 2012.1 SP1) the old template folder is backed up to <path to All Users profile>\Application Data\QPR Software\QPR 2012\2012.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.