Application Systems Design, Development, Training, Support & Support Services
Ready-made Customizable Solutions
Solutions: Page Generators : Item Compare: Install & Use
Item Compare - Installation and Use
PURPOSE: Describes Item Compare dependencies, requirements, installation and use.
jhzcs.pl - JHZ-CS configuration and common logic modules (see: jhzcs.html)
IID (Item Information Dataset)
e.htm ( Item Compare results template)
Support for Text Search and Banner Rotator System requires those components to be installed and configured according to their specifications. Inclusion of Special Template markup supporting those components must also be included within the templates supported by this product.
PACKING (PARTS) LIST
PRODUCT ID: IC
*AUTH - Authorization/permissions octal equilvalents where:
7=RWX, 6=RW, 5=RX, 4=R (R=Read W=Write X=Executable)
1 char indicates Octal number
2 char Owner
3 char Group
4 char All Others
It is recommended that you read the entire installation process steps prior to performing installation. Each solution has specific instructions.
- Download solution to desktop
- Expand installation package (use any standard archive application; such as WinZip®, StuffIt Expander® or TAR command)
- Set configuration settings
- Upload components to server
- Set file permissions
- Test installation
- Customize Templates as desired
- Test customizations
Modify Logic Components
Modify all logic components "*.cgi" and "*.pl" logic modules as follows:
- First line of code (#!) correctly points to the PERL executable binary on the server (use command "which perl" or consult your server administrator)
- All PERL "requires" statements contained in "*.cgi" and "*.pl" logic modules must use "absolute" directory paths (beginning with a forward slash "/")
Customize Item Compare results template for content and appearance as desired.
Uploading to Web Server
All dependent and required components must be successfully installed and configured. All components, with the exception of images, must be FTP uploaded as TEXT. Images must be FTP uploaded as BINARY.
Test installation and configuration by invoking e.cgi from a web browser from a page containing Item Compare controls. These controls consist of:
- HTML Form definition
- Item Compare button(s)
- Item Compare check boxes
- hidden Item Compare item number text fields
- HTML Form terminator
The values for Item Compare markup and controls must be hard coded within static page. Within dynamic page templates the values for the Item Compare markup and controls must be coded using special markup variables to assure proper dynamic generation of the appropriate values when the list pages containing them are produced. JHZ-CS Dynamic Real-time Page Generators supporting Item Compare markup and controls are:
c.cgi - Category List
s.cgi - Subcategory List
m.cgi - Manufacture List
Verify generated links to item categories, subcategories, manufacture and detail page for the items displayed in the Item Compare results page.
Any variable contained in IID may be referenced using the variables (column header name) wrapped in less than greater than pairs. Variable names may not contain spaces.
Two special keywords support variable reference for translation to web page anchor names, anchor references and CGI URL parameters. This allows use of referenced variables that equates to an item value containing embedded spaces causing them to be translated/escaped:
Special mark-up within Item Compare Template must respect group order sequence to support nested repeating groups.
Indentation illustrates nesting relationships:
<!-- Page Header End --> <!-- Categories List Header Start --> <!-- Categories List Header End --> <!-- Categories Repeat Line Start --> <!-- Categories Repeat Line End --> <!-- Categories List Footer Start --> <!-- Categories List Footer End --> <!-- Cat Group Start --> <!-- Cat Header Start --> <!-- Cat Header End --> <!-- Cat Entry Start --> <!-- Cat Entry End --> <!-- Cat Group End --> <!-- Page Footer Start -->
Following successful installation and satisfaction of dependencies and requirements, "e.cgi" may be invoked via an HTML Form using either GET or POST methods. The invoking page must contain the required Item Compare markup and controls. Both static and dynamic page templates may contain the Item Compare markup and controls. JHZ-CS Page Generators (except Item Detail with parameters), Item Search and Text Search resulting output automatic generate Item Compare Controls.
Display the page containing the Item Compare controls. Select the items to compare by clicking the check boxes for the desired items, then click the Compare button and the Item Compare results page will display its results.
JHZ-CS Solutions are offered exclusively under the terms and conditions of the JHZ-CS Software License Agreement.