eXtropia ADT Guide

Table of Contents:

Introduction to eXtropia Applications

• Overview
• Acknowledgements, Incentives, and Credits
• How To Read This Guide

Installation

• Introduction
• The 12-Step CheckList
• Step One: Prepare Your Site
• Step Two: Obtain an Installation File
• Step Three: Unpack The Installation File
  • Unpacking on UNIX
  • Unpacking on Windows and Macintosh
  • What You Get When You Have Unpacked The Application
• Step Four: Assign File Permissions
• Step Five: Modify The Perl Path Line
• Step Six: Customize The Application
• Step Seven: Modify The Application Look-And-Feel
• Step Eight: Run The Application
• Step Nine: Debugging The Application
• Step Ten: Application Security
• Step Eleven: Test The Application
  • Does the application send email?
  • Do all the templates display?
  • Can you input 'bad' data into the forms?
• Step Twelve: Register The Application

Configuration By Example

• Overview
• Configuration Example 1: Mailing Configuration
  • Step 1: Configure a Mail Driver
  • Step 2: Change the Send Params
  • Step 3: Change the Email Body Views
  • Step 4: Turn on the Mailing Flags
• Configuration Example 2: Modifying the Look-and-Feel
  • Step 1: Modify PageTopView.ttml
  • Step 2: Modify PageBottomView.ttml
  • Step 3: Modify the View parameters
  • Step 4: Modify the Default View name
  • Step 5: Optionally add new view to the @VALID_VIEWS array
• Configuration Example 3: Add a Field
  • Step 1: Modify the input widget variables
  • Step 2: Add the new field to the datasource field array
  • Step 3: Add the new field to the email display fields array
  • Step 4: Add any data handler routines that might be necessary

Customizing eXtropia Applications

• Overview
• Modifying the Application Executable
  • Understanding the Application Executable Preamble
• How to Modify and Test Configuration Options
• Spotting Configuration Errors
  • Declaring Configuration Variables
  • Name/Value Pairs
  • Configuration Name Formatting
  • Name/Value Pair Separation Rule
  • Another Name/Value Pair Separation Rule
  • Enclose Values in Quotes
  • Named Parameter Naming Convention
  • Delimit Config Setting with Parentheses and Semi-Colons
• How To Modify List-Based Configuration Parameters
• Understanding Reference-Based Config Parameters
  • References In eXtropia Config Files
  • Reference Syntax Reference
• Standard Config Options for eXtropia Applications
  • Session and Session Manager Configuration
  • Authentication Configuration
  • Authentication Manager Configuration
  • Datahandler Manager Configuration
  • DataSource Configuration
  • Logging Configuration
  • Mail Configuration
  • Encryption Configuration
  • View Configuration
  • Filter Configuration
  • Application Configuration

Modifying the Look-and-Feel of eXtropia Applications

• Overview
• How Extropia::View Implements Look-And-Feel
  • Defining the Package Name
  • Importing Supporting Modules
  • Declaring View Inheritance
  • Defining the display() Method
  • Sticky Forms
  • Error Messages
  • Maintaining Application State
  • Views Within Other Views
  • Adding Your own Parameters
  • Walking Through Record Sets

Look and Feel

• Intro
• The View Model
• Templates and Data.
  • Simple Introduction into Template Toolkit
  • Setting Data for the Templates
  • Template's Local Data
  • Configuration Data
  • Nesting Templates
• HTML templates
  • Setting HTTP Headers
• Default ADT versus Custom Templates
• Using Cascading Style Sheets
• ...

Advanced Topics

• Overview
• Loading Setup Files
  • Reason 1: Security issues
  • Mod_perl Issues
• Using a Setup File with Mod_Perl
• Enhancing eXtropia Application Performance
  • Performance Tuning eXtropia Module Usage
  • Perl Accelerators

Debugging Web Applications

• Overview
  • The Virtue of Nothingness
  • CGI debugging is a state of mind.
  • The Scientific Method and The Nitty Gritty of Debugging
• Starting with Hello World
  • Figuring Our Where You Are
  • Where are we?
  • What The Application Sees
  • Debugging From The Command Line
• Advanced Error Hunting
  • Command Line Tactics
  • Taint Mode Issues From The Command Line
  • Log File Analysis
  • Dressing Up As a Web Browser
  • USING print "Content-type: text/html\n\ntest";exit;
  • Using Data::Dumper
  • Confess, Croak, and Die
• In Conclusion

Web Security and eXtropia Applications

• Overview
  • What is the Worst That Can Happen
  • Security and Web Servers
  • Web Security and CGI Applications
  • Reviewing Applications
• Writing Safe CGI Applications
  • Stopping Snoopers
  • Writable Directories
  • User Input
  • Cross Site Scripting Problem
• Taint Mode: Perl's Personal Paranoid Mode
  • What is Taint Mode
  • Using Taint Mode In CGI Scripts
  • What To Do After Taint Mode Is On
  • How Do We Program For Taint Mode
  • Shell Metacharacters
  • Untainting Using Regular Expressions
  • How To Choose An Untaint Regular Expression
  • Fixing Script Problems In Taint Mode
  • Final Taint Mode Tips
  • Taint Mode Summary

Installing MySQL and related Perl modules locally.

• Installing MySQL and related Perl modules locally.
• AUTHOR

Appendix A: Further References

• References
• Acknowledgements
• Changes

Changes:

• The Guide's Changes file.

Download: