- use templates for signin form, error messages
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Sun, 12 Mar 2006 16:37:26 +0000 (16:37 +0000)
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>
Sun, 12 Mar 2006 16:37:26 +0000 (16:37 +0000)
- use FormBuilder for edit page forms (also use template)
- print debug to stderr in cgi mode to avoid breaking http headers
- fix links to page in parentlinks if $url is unset
- reorganise how wikilink is used in templates
- only make recentchanes link if svn is enabled
- change session id cookie to something we control
- add support for logging committer name for web commits from signed in
  users (untested)
- probably more changes I forgot

doc/setup.mdwn
doc/templates.mdwn
ikiwiki
templates/editpage.tmpl [new file with mode: 0644]
templates/misc.tmpl [new file with mode: 0644]
templates/page.tmpl
templates/recentchanges.tmpl

index 2167e26925d9a75ffb75b24093de1443392359f7..acb401cfced00cb5106e47f16039710534f909c0 100644 (file)
@@ -72,6 +72,6 @@ optional support for commits from the web.
 
 10. Add [[PageHistory]] links to the top of pages. This requires you to have setup [[ViewCVS]] or something similar to access your [[Subversion]] repository.  The --historyurl parameter makes ikiwiki add the links, and in that url, "[[]]" is replaced with the name of the file to view. So repeat step 9 to rebuild the wiki post commit wrapper and wiki, adding a historyurl something like this one:
 
-                --historyurl='http://svn.host/trunk/doc/[[]]?root=wiki'
+                --historyurl='http://svn.host/trunk/[[]]?root=wiki'
 
 11. Enjoy your new wiki! Add yourself to [[IkiWikiUsers]]
\ No newline at end of file
index 13d285d3cb3d544aba50e564dd81d5798b60abd6..6d4d8793d5618fdc9448170e6d153562e86e3261 100644 (file)
@@ -1,13 +1,24 @@
-ikiwiki uses the HTML::Template module as its template engine. This supports things like conditionals and loops in templates and is pretty easy to learn.
+ikiwiki uses the HTML::Template module as its template engine. This
+supports things like conditionals and loops in templates and is pretty easy
+to learn.
 
 It ships with some basic templates which can be customised:
 
 * `templates/page.tmpl` - Used for displaying all regular wiki pages.
+* `templates/misc.tmpl` - Generic template used for any page that doesn't
+  have a custom template.
 * `templates/recentchanges.tmpl` - Used for the RecentChanges page.
-* `templates/edit.tmpl' - Edit page.
-* `templates/create.tmpl' - Creating a new page.
-* `templates/signin.tmpl` - Used for the SignIn form and all assciated forms, if it exists.
-   
-  Note that the SignIn form is implemented using CGI::FormBuilder, which interfaces to HTML::Template, so not all of it can be customised with templates, although most of it can, by creating this template. Without the template, CGI::FormBuilder creates the page by itself.
+* `templates/editpage.tmpl' - Create/edit page.
+
+If you like, you can add these to further customise it:
+
+* `templates/signin.tmpl` - If it exists, it is used for customising the
+  layout of the SignIn form and all assciated forms. The misc.tmpl is
+  wrapped around this, so it should only be a template for the form.
+  
+  Note that the SignIn form is implemented using CGI::FormBuilder, which
+  interfaces to HTML::Template, so not all of it can be customised with
+  templates, although most of it can, by creating this template. Without
+  the template, CGI::FormBuilder creates the page body by itself.
 
 I aim to keep almost all html out of ikiwiki and in the templates.
diff --git a/ikiwiki b/ikiwiki
index ce89112de9fb02e263abd5804323bb645756bbb0..1ea8d082a547957932bb829c360f9c16b81a487d 100755 (executable)
--- a/ikiwiki
+++ b/ikiwiki
@@ -35,7 +35,7 @@ sub usage { #{{{
 sub error ($) { #{{{
        if ($cgi) {
                print "Content-type: text/html\n\n";
-               print "Error: @_\n";
+               print misctemplate("Error", "<p>Error: @_</p>");
                exit 1;
        }
        else {
@@ -44,7 +44,12 @@ sub error ($) { #{{{
 } #}}}
 
 sub debug ($) { #{{{
-       print "@_\n" if $verbose;
+       if (! $cgi) {
+               print "@_\n" if $verbose;
+       }
+       else {
+               print STDERR "@_\n" if $verbose;
+       }
 } #}}}
 
 sub mtime ($) { #{{{
@@ -115,6 +120,7 @@ sub writefile ($$) { #{{{
 
        my $dir=dirname($file);
        if (! -d $dir) {
+               print STDERR ">>$dir<<\n";
                my $d="";
                foreach my $s (split(m!/+!, $dir)) {
                        $d.="$s/";
@@ -240,6 +246,7 @@ sub backlinks ($) { #{{{
                }
        }
 
+       # TODO sort by page name
        return @links;
 } #}}}
        
@@ -259,11 +266,12 @@ sub parentlinks ($) { #{{{
                }
                $path.="../";
        }
+       unshift @ret, { url => $path , page => $wikiname };
        return @ret;
 } #}}}
 
 sub indexlink () { #{{{
-       return "<a href=\"$url\">$wikiname</a>";
+       return "<a href=\"$url\">$wikiname</a>";
 } #}}}
        
 sub finalize ($$) { #{{{
@@ -278,7 +286,9 @@ sub finalize ($$) { #{{{
        
        if (length $cgiurl) {
                $template->param(editurl => "$cgiurl?do=edit&page=$page");
-               $template->param(recentchangesurl => "$cgiurl?do=recentchanges");
+               if ($svn) {
+                       $template->param(recentchangesurl => "$cgiurl?do=recentchanges");
+               }
        }
 
        if (length $historyurl) {
@@ -289,7 +299,6 @@ sub finalize ($$) { #{{{
        
        $template->param(
                title => $title,
-               indexlink => $url,
                wikiname => $wikiname,
                parentlinks => [parentlinks($page)],
                content => $content,
@@ -657,6 +666,21 @@ EOF
        print "successfully generated ikiwiki-wrap\n";
        exit 0;
 } #}}}
+               
+sub misctemplate ($$) { #{{{
+       my $title=shift;
+       my $pagebody=shift;
+       
+       my $template=HTML::Template->new(
+               filename => "$templatedir/misc.tmpl");
+       $template->param(
+               title => $title,
+               indexlink => indexlink(),
+               wikiname => $wikiname,
+               pagebody => $pagebody,
+       );
+       return $template->output;
+}#}}}
 
 sub cgi_recentchanges ($) { #{{{
        my $q=shift;
@@ -665,7 +689,7 @@ sub cgi_recentchanges ($) { #{{{
                filename => "$templatedir/recentchanges.tmpl");
        $template->param(
                title => "RecentChanges",
-               indexlink => $url,
+               indexlink => indexlink(),
                wikiname => $wikiname,
                changelog => [rcs_recentchanges(100)],
        );
@@ -693,10 +717,10 @@ sub cgi_signin ($$) { #{{{
                javascript => 0,
                params => $q,
                action => $q->request_uri,
+               header => 0,
                template => (-e "$templatedir/signin.tmpl" ? "$templatedir/signin.tmpl" : "")
        );
        
-       $form->sessionid($session->id);
        $form->field(name => "name", required => 0);
        $form->field(name => "do", type => "hidden");
        $form->field(name => "page", type => "hidden");
@@ -761,131 +785,105 @@ sub cgi_signin ($$) { #{{{
                        $form->field(name => "confirm_password", type => "hidden");
                        $form->field(name => "email", type => "hidden");
                        $form->text("Registration successful. Now you can Login.");
-                       print $form->render(submit => ["Login"]);;
+                       print $session->header();
+                       print misctemplate($form->title, $form->render(submit => ["Login"]));
                }
                elsif ($form->submitted eq 'Mail Password') {
                        # TODO mail password
                        $form->text("Your password has been emailed to you.");
-                       print $form->render(submit => ["Login", "Register", "Mail Password"]);;
+                       print $session->header();
+                       print misctemplate($form->title, $form->render(submit => ["Login", "Register", "Mail Password"]));
                }
        }
        else {
-               print $form->render(submit => ["Login", "Register", "Mail Password"]);;
+               print $session->header();
+               print misctemplate($form->title, $form->render(submit => ["Login", "Register", "Mail Password"]));
        }
 } #}}}
 
-sub cgi () { #{{{
-       eval q{use CGI};
-       eval q{use CGI::Session};
-       
-       my $q=CGI->new;
-       
-       my $do=$q->param('do');
-       if (! defined $do || ! length $do) {
-               error("\"do\" parameter missing");
-       }
-       
-       # This does not need a session.
-       if ($do eq 'recentchanges') {
-               cgi_recentchanges($q);
-               return;
-       }
-       
-       # session id has to be _sessionid for CGI::FormBuilder to work.
-       # TODO: stop having the formbuilder emit cookies and change session
-       # id to something else.
-       CGI::Session->name("_sessionid");
-       my $session = CGI::Session->new(undef, $q,
-               { Directory=> "$srcdir/.ikiwiki/sessions" });
-       
-       # Everything below this point needs the user to be signed in.
-       if ((! $anonok && ! defined $session->param("name")) || $do eq 'signin') {
-               cgi_signin($q, $session);
-               return;
-       }
+sub cgi_editpage ($$) { #{{{
+       my $q=shift;
+       my $session=shift;
+
+       eval q{use CGI::FormBuilder};
+       my $form = CGI::FormBuilder->new(
+               fields => [qw(do from page content comments)],
+               header => 1,
+               method => 'POST',
+               validate => {},
+               required => [qw{}],
+               javascript => 0,
+               params => $q,
+               action => $q->request_uri,
+               table => 0,
+               template => "$templatedir/editpage.tmpl"
+       );
        
-       my ($page)=$q->param('page')=~/$wiki_file_regexp/;
+       my ($page)=$form->param('page')=~/$wiki_file_regexp/;
        if (! defined $page || ! length $page || $page ne $q->param('page') ||
            $page=~/$wiki_file_prune_regexp/ || $page=~/^\//) {
                error("bad page name");
        }
        $page=lc($page);
-       
-       my $action=$q->request_uri;
-       $action=~s/\?.*//;
-       
-       if ($do eq 'create') {
-               if (exists $pagesources{lc($page)}) {
-                       # hmm, someone else made the page in the meantime?
-                       print $q->redirect("$url/".htmlpage($page));
-               }
 
-               my @page_locs;
-               my ($from)=$q->param('from')=~/$wiki_file_regexp/;
-               if (! defined $from || ! length $from ||
-                   $from ne $q->param('from') ||
-                   $from=~/$wiki_file_prune_regexp/ || $from=~/^\//) {
-                       @page_locs=$page;
-               }
-               else {
-                       my $dir=$from."/";
-                       $dir=~s![^/]+/$!!;
-                       push @page_locs, $dir.$page;
-                       push @page_locs, "$from/$page";
-                       while (length $dir) {
+       $form->field(name => "do", type => 'hidden');
+       $form->field(name => "from", type => 'hidden');
+       $form->field(name => "page", value => "$page", force => 1);
+       $form->field(name => "comments", type => "text", size => 80);
+       $form->field(name => "content", type => "textarea", rows => 20,
+               cols => 80);
+       
+       if (! $form->submitted || ! $form->validate) {
+               if ($form->field("do") eq "create") {
+                       if (exists $pagesources{lc($page)}) {
+                               # hmm, someone else made the page in the
+                               # meantime?
+                               print $q->redirect("$url/".htmlpage($page));
+                               return;
+                       }
+                       
+                       my @page_locs;
+                       my ($from)=$form->param('from')=~/$wiki_file_regexp/;
+                       if (! defined $from || ! length $from ||
+                           $from ne $form->param('from') ||
+                           $from=~/$wiki_file_prune_regexp/ || $from=~/^\//) {
+                               @page_locs=$page;
+                       }
+                       else {
+                               my $dir=$from."/";
                                $dir=~s![^/]+/$!!;
                                push @page_locs, $dir.$page;
+                               push @page_locs, "$from/$page";
+                               while (length $dir) {
+                                       $dir=~s![^/]+/$!!;
+                                       push @page_locs, $dir.$page;
+                               }
                        }
+
+                       $form->tmpl_param("page_select", 1);
+                       $form->field(name => "page", type => 'select',
+                               options => \@page_locs);
+                       $form->title("creating $page");
                }
-               
-               $q->param("do", "save");
-               print $q->header,
-                     $q->start_html("Creating $page"),
-                     $q->h1(indexlink()." Creating $page"),
-                     $q->start_form(-action => $action),
-                     $q->hidden('do'),
-                     "Select page location:",
-                     $q->popup_menu('page', \@page_locs),
-                     $q->textarea(-name => 'content',
-                              -default => "",
-                              -rows => 20,
-                              -columns => 80),
-                     $q->br,
-                     "Optional comment about this change:",
-                     $q->br,
-                     $q->textfield(-name => "comments", -size => 80),
-                     $q->br,
-                     $q->submit("Save Page"),
-                     $q->end_form,
-                     $q->end_html;
-       }
-       elsif ($do eq 'edit') {
-               my $content="";
-               if (exists $pagesources{lc($page)}) {
-                       $content=readfile("$srcdir/$pagesources{lc($page)}");
-                       $content=~s/\n/\r\n/g;
+               elsif ($form->field("do") eq "edit") {
+                       my $content="";
+                       if (exists $pagesources{lc($page)}) {
+                               $content=readfile("$srcdir/$pagesources{lc($page)}");
+                               $content=~s/\n/\r\n/g;
+                       }
+                       $form->tmpl_param("page_select", 0);
+                       $form->field(name => "content", value => $content,
+                               force => 1);
+                       $form->field(name => "page", type => 'hidden');
+                       $form->title("editing $page");
                }
-               $q->param("do", "save");
-               print $q->header,
-                     $q->start_html("Editing $page"),
-                     $q->h1(indexlink()." Editing $page"),
-                     $q->start_form(-action => $action),
-                     $q->hidden('do'),
-                     $q->hidden('page'),
-                     $q->textarea(-name => 'content',
-                              -default => $content,
-                              -rows => 20,
-                              -columns => 80),
-                     $q->br,
-                     "Optional comment about this change:",
-                     $q->br,
-                     $q->textfield(-name => "comments", -size => 80),
-                     $q->br,
-                     $q->submit("Save Page"),
-                     $q->end_form,
-                     $q->end_html;
-       }
-       elsif ($do eq 'save') {
+               
+               $form->tmpl_param("can_commit", $svn);
+               $form->tmpl_param("indexlink", indexlink());
+               print $form->render(submit => ["Save Page"]);
+       }
+       else {
+               # save page
                my $file=$page.$default_pagetype;
                my $newfile=1;
                if (exists $pagesources{lc($page)}) {
@@ -893,14 +891,20 @@ sub cgi () { #{{{
                        $newfile=0;
                }
                
-               my $content=$q->param('content');
+               my $content=$form->field('content');
                $content=~s/\r\n/\n/g;
                $content=~s/\r/\n/g;
                writefile("$srcdir/$file", $content);
                
-               my $message="web commit from $ENV{REMOTE_ADDR}";
-               if (defined $q->param('comments')) {
-                       $message.=": ".$q->param('comments');
+               my $message="web commit ";
+               if ($session->param("name")) {
+                       $message.="by ".$session->param("name");
+               }
+               else {
+                       $message.="from $ENV{REMOTE_ADDR}";
+               }
+               if (length $form->field('comments')) {
+                       $message.=": ".$form->field('comments');
                }
                
                if ($svn) {
@@ -917,6 +921,38 @@ sub cgi () { #{{{
                
                print $q->redirect("$url/".htmlpage($page));
        }
+} #}}}
+
+sub cgi () { #{{{
+       eval q{use CGI};
+       eval q{use CGI::Session};
+       
+       my $q=CGI->new;
+       
+       my $do=$q->param('do');
+       if (! defined $do || ! length $do) {
+               error("\"do\" parameter missing");
+       }
+       
+       # This does not need a session.
+       if ($do eq 'recentchanges') {
+               cgi_recentchanges($q);
+               return;
+       }
+       
+       CGI::Session->name("ikiwiki_session");
+       my $session = CGI::Session->new(undef, $q,
+               { Directory=> "$srcdir/.ikiwiki/sessions" });
+       
+       # Everything below this point needs the user to be signed in.
+       if ((! $anonok && ! defined $session->param("name")) || $do eq 'signin') {
+               cgi_signin($q, $session);
+               return;
+       }
+       
+       if ($do eq 'create' || $do eq 'edit') {
+               cgi_editpage($q, $session);
+       }
        else {
                error("unknown do parameter");
        }
diff --git a/templates/editpage.tmpl b/templates/editpage.tmpl
new file mode 100644 (file)
index 0000000..8b75574
--- /dev/null
@@ -0,0 +1,21 @@
+<html>
+<head><title><TMPL_VAR FORM-TITLE></title></head>
+<body>
+<TMPL_VAR FORM-START>
+<h1><TMPL_VAR INDEXLINK>/ <TMPL_VAR FORM-TITLE></h1>
+<TMPL_VAR FIELD-DO>
+<TMPL_VAR FIELD-FROM>
+<TMPL_IF NAME="PAGE_SELECT">
+Page location: <TMPL_VAR FIELD-PAGE><br>
+<TMPL_ELSE>
+<TMPL_VAR FIELD-PAGE>
+</TMPL_IF>
+<TMPL_VAR FIELD-CONTENT><br>
+<TMPL_IF NAME="CAN_COMMIT">
+Optional comment about this change:</br>
+<TMPL_VAR FIELD-COMMENTS><br>
+</TMPL_IF>
+<TMPL_VAR FORM-SUBMIT>
+<TMPL_VAR FORM-END>
+</body>
+</html>
diff --git a/templates/misc.tmpl b/templates/misc.tmpl
new file mode 100644 (file)
index 0000000..a8ee168
--- /dev/null
@@ -0,0 +1,14 @@
+<html>
+<head><title><TMPL_VAR TITLE></title></head>
+<body>
+
+<h1>
+<TMPL_VAR INDEXLINK>/ <TMPL_VAR TITLE>
+</h1>
+
+<TMPL_VAR PAGEBODY>
+
+<!-- from <TMPL_VAR NAME=WIKINAME> -->
+
+</body>
+</html>
index 44cbd3812eb285b7602366b6f532b43da419271f..619b437b93a3de6940cbdc341d4b3a14b253690a 100644 (file)
@@ -3,9 +3,8 @@
 <body>
 
 <h1>
-<a href="<TMPL_VAR INDEXLINK>"><TMPL_VAR WIKINAME></a>/
 <TMPL_LOOP NAME="PARENTLINKS">
-<a href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a> 
+<a href="<TMPL_VAR NAME=URL>"><TMPL_VAR NAME=PAGE></a>/ 
 </TMPL_LOOP>
 <TMPL_VAR TITLE>
 </h1>
@@ -34,5 +33,7 @@
 </p>
 </TMPL_IF>
 
+<!-- from <TMPL_VAR NAME=WIKINAME> -->
+
 </body>
 </html>
index 4637906e280f548d79f18876b801be2f78920206..ae708ea80e0fa962d67c1f00463bec660580841a 100644 (file)
@@ -3,7 +3,7 @@
 <body>
 
 <h1>
-<a href="<TMPL_VAR INDEXLINK>"><TMPL_VAR WIKINAME></a>/ <TMPL_VAR TITLE>
+<TMPL_VAR INDEXLINK>/ <TMPL_VAR TITLE>
 </h1>
 
 <hr>