#!/usr/bin/perl -w
# program group1PlainText.pl
use strict;
use lib "/pathToYourWebspace/cgi-bin/gnu";

use CGI;
use CGI::Carp qw( fatalsToBrowser);

use subjectGroup1::SideIndex;
use Comments;
use MostRecentSideIndex;
use PageFormatterTemplate;

# techie stuff: clean up environment for taint mode before calling mail
BEGIN {
    $ENV{PATH} = "/bin:/usr/bin";
    delete @ENV{ qw( IFS CDPATH ENV BASH_ENV) };
} # end BEGIN
# end techie stuff

    # we'll be checking the environment for post parameters etc
    my $cgiObj    = new CGI();

    # do this bit of printing to allow for early error messages
    print "Content-type: text/html; charset=iso-8859-1\n\n";
    
    # To use this template
    # 1. modify the header content
    # 2. modify the contentAry
    # 3. modify $sideIndexObj
    
    
    # pathInfo determines the side index to use and whether we issue a payPal thank you page
    # when we return from there following a successful sale
    # Note that tests for informationType of any given type need only be conducted if 
    # the page features on one of the informationType indexes or has a payPal button
    # Note that $infoString is used to carry info (if any) specific to a given type e.g. 
    # in the case of PayPal where I may be selling different pictures on the same page then
    # $infoString will contain a picture identifier
    my $pathInfo    = $cgiObj->path_info;
    my ($dummy,$informationType,$infoString)    = split("/",$pathInfo);
    if ($pathInfo) {
        if ( (  $informationType eq "MostRecentSideIndex") || 
                ($informationType eq "payPalSale") || 
                ($informationType eq "WorkInProgressSideIndex") ) {
            # OK
        } else {
            # unrecognised pathInfo string (someone is fooling around)
            # send message but keep going - ignore it
            Mailer::sendErrorEmail("unrecognised pathInfo string","subjectGroup1","subjectGroup1");
        } # end if
    } # end if        

    # determine the side index to use
    my $sideIndexObj    = subjectGroup1::SideIndex->new();    
    if ($pathInfo && ($informationType eq "MostRecentSideIndex") ) {
            $sideIndexObj    = MostRecentSideIndex->new();
    } elsif ($pathInfo && ($informationType eq "WorkInProgressSideIndex") ) {
            $sideIndexObj    = WorkInProgressSideIndex->new();
    } # end if        

    
    
    
    # header content
    my $metaKeywords     = "I,hope,you,get,use,from,this,website,generation,program,by,julius,guzy,available,under,gnu,free,software,licence";
    my $metaDescription  = "I hope you get use from this website generation program by julius guzy available under,gnu free software licence";
    my $pageTitle        = "Example of how to encode a heading and some paragraphs of plain text";
    my $indexGroup       = "subjectGroup1";
    my $pageFileName     = "group1PlainText.pl";
  
    
    # the order of the elements determines the order in which the elements are written in the html
    my @contentAry = (    
    
    {
        contentType    => "heading",
        headingType    => "h2",
        headingText    => "Example of how to encode a heading and paragraphs of plain text",
},    # end anon hash

            {
        contentType         => "paragraphSequence",
        paraSequence        => [
        "Take a look at <a href='yourWebsiteDotCom/gnuCodeHtml/group1PlainText.html'><em>group1PlainText.pl</em></a> : the source code of used to generate this page",
        "The source shows you how to create a heading and several paragraphs of text",
],
},    # end anon hash
        

    );    # end contentAry
            



    # check for comments data having been sent to us
    # new will get these and validate them
    my $commentsObj    = Comments->new($cgiObj);
    
    # pass the PageFormatter all the information used to create the page other than the content itself
    my $pageObj        = PageFormatterTemplate->new($cgiObj,$indexGroup,$sideIndexObj,$commentsObj,$pageFileName,$pageTitle,$metaKeywords,$metaDescription);
    

    # if we are returning from a PayPal sale then we generate a special thank you page
    # Note that we only need this if statement if we have a PayPal button we can return from
    if ($pathInfo && ($informationType eq "payPalSale") ) {
        $pageObj->payPalThankYouContent($infoString);
    } else {
        # create the page
        $pageObj->standardContent(\@contentAry);
    } # end if