From 4708aeceb3ec518a00069ad7a112ab0a5596275c Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Sat, 2 Aug 2008 16:40:46 -0400 Subject: [PATCH] websetup form display done --- IkiWiki.pm | 5 +- IkiWiki/Plugin/anonok.pm | 2 +- IkiWiki/Plugin/attachment.pm | 2 +- IkiWiki/Plugin/lockedit.pm | 2 +- IkiWiki/Plugin/websetup.pm | 133 ++++++++++++++++++++++++++--- IkiWiki/Setup/Standard.pm | 3 +- doc/plugins/write.mdwn | 7 +- doc/todo/online_configuration.mdwn | 2 +- po/ikiwiki.pot | 36 +++++--- 9 files changed, 158 insertions(+), 34 deletions(-) diff --git a/IkiWiki.pm b/IkiWiki.pm index d11ceb896..241a7c036 100644 --- a/IkiWiki.pm +++ b/IkiWiki.pm @@ -13,7 +13,8 @@ use open qw{:utf8 :std}; use vars qw{%config %links %oldlinks %pagemtime %pagectime %pagecase %pagestate %renderedfiles %oldrenderedfiles %pagesources - %destsources %depends %hooks %forcerebuild $gettext_obj}; + %destsources %depends %hooks %forcerebuild $gettext_obj + %loaded_plugins}; use Exporter q{import}; our @EXPORT = qw(hook debug error template htmlpage add_depends pagespec_match @@ -486,6 +487,7 @@ sub loadplugin ($) { #{{{ if (defined $dir && -x "$dir/plugins/$plugin") { require IkiWiki::Plugin::external; import IkiWiki::Plugin::external "$dir/plugins/$plugin"; + $loaded_plugins{$plugin}=1; return 1; } } @@ -495,6 +497,7 @@ sub loadplugin ($) { #{{{ if ($@) { error("Failed to load plugin $mod: $@"); } + $loaded_plugins{$plugin}=1; return 1; } #}}} diff --git a/IkiWiki/Plugin/anonok.pm b/IkiWiki/Plugin/anonok.pm index d5e409117..9d21fe367 100644 --- a/IkiWiki/Plugin/anonok.pm +++ b/IkiWiki/Plugin/anonok.pm @@ -13,7 +13,7 @@ sub import { #{{{ sub getsetup () { #{{{ return anonok_pagespec => { - type => "string", + type => "pagespec", example => "*/discussion", description => "PageSpec to limit which pages anonymous users can edit", description_html => htmllink("", "", "ikiwiki/PageSpec", noimageinline => 1). diff --git a/IkiWiki/Plugin/attachment.pm b/IkiWiki/Plugin/attachment.pm index bd21ed1ed..27f984c29 100644 --- a/IkiWiki/Plugin/attachment.pm +++ b/IkiWiki/Plugin/attachment.pm @@ -22,7 +22,7 @@ sub getsetup () { #{{{ rebuild => 0, }, allowed_attachments => { - type => "string", + type => "pagespec", example => "mimetype(image/*) and maxsize(50kb)", description => "enhanced PageSpec specifying what attachments are allowed", description_html => htmllink("", "", diff --git a/IkiWiki/Plugin/lockedit.pm b/IkiWiki/Plugin/lockedit.pm index 4e1b4f878..93a525677 100644 --- a/IkiWiki/Plugin/lockedit.pm +++ b/IkiWiki/Plugin/lockedit.pm @@ -15,7 +15,7 @@ sub import { #{{{ sub getsetup () { #{{{ return locked_pages => { - type => "string", + type => "pagespec", example => "!*/Discussion", description => "PageSpec controlling which pages are locked", description_html => htmllink("", "", "ikiwiki/PageSpec", noimageinline => 1). diff --git a/IkiWiki/Plugin/websetup.pm b/IkiWiki/Plugin/websetup.pm index a30475977..0a0d4480f 100644 --- a/IkiWiki/Plugin/websetup.pm +++ b/IkiWiki/Plugin/websetup.pm @@ -5,46 +5,114 @@ use warnings; use strict; use IkiWiki 2.00; +my @rcs_plugins=(qw{git svn bzr mercurial monotone tla norcs}); +my @default_force_plugins=(qw{amazon_s3}); + sub import { #{{{ - hook(type => "sessioncgi", id => "websetup", - call => \&sessioncgi); - hook(type => "formbuilder_setup", id => "websetup", + hook(type => "checkconfig", id => "websetup", call => \&checkconfig); + hook(type => "getsetup", id => "websetup", call => \&getsetup); + hook(type => "sessioncgi", id => "websetup", call => \&sessioncgi); + hook(type => "formbuilder_setup", id => "websetup", call => \&formbuilder_setup); } # }}} -sub addfields ($$@) { +sub getsetup () { #{{{ + return + websetup_force_plugins => { + type => "string", + example => \@default_force_plugins, + description => "list of plugins that cannot be enabled/disabled via the web interface", + safe => 0, + rebuild => 0, + }, +} #}}} + +sub checkconfig () { #{{{ + if (! exists $config{websetup_force_plugins}) { + $config{websetup_force_plugins}=\@default_force_plugins; + } +} #}}} + +sub formatexample ($) { #{{{ + my $example=shift; + + if (defined $example && ! ref $example && length $example) { + return "
Example: $example"; + } + else { + return ""; + } +} #}}} + +sub showfields ($$$@) { #{{{ my $form=shift; - my $section=shift; + my $plugin=shift; + my $enabled=shift; + my @show; while (@_) { my $key=shift; my %info=%{shift()}; - next if ! $info{safe} || $info{type} eq "internal"; + # skip complex, unsafe, or internal settings + next if ref $config{$key} || ! $info{safe} || $info{type} eq "internal"; + # these are handled specially, so don't show + next if $key eq 'add_plugins' || $key eq 'disable_plugins'; + + push @show, $key, \%info; + } - my $description=exists $info{description_html} ? $info{description_html} : $info{description}; + return 0 unless @show; - my $value=$config{$key}; - # multiple plugins can have the same key - my $name=$section.".".$key; + my $section=defined $plugin ? $plugin." ".gettext("plugin") : gettext("main"); + + if (defined $plugin) { + if (! showplugintoggle($form, $plugin, $enabled, $section) && ! $enabled) { + # plugin not enabled and cannot be, so skip showing + # its configuration + return 0; + } + } + + while (@show) { + my $key=shift @show; + my %info=%{shift @show}; + my $description=exists $info{description_html} ? $info{description_html} : $info{description}; + my $value=$config{$key}; + # multiple plugins can have the same field + my $name=defined $plugin ? $plugin.".".$key : $key; + if ($info{type} eq "string") { $form->field( name => $name, label => $description, - comment => exists $info{example} && length $info{example} && $info{example} ne $value ? "
Example: $info{example}" : "", + comment => defined $value && length $value ? "" : formatexample($info{example}), type => "text", value => $value, size => 60, fieldset => $section, ); } + elsif ($info{type} eq "pagespec") { + $form->field( + name => $name, + label => $description, + comment => formatexample($info{example}), + type => "text", + value => $value, + size => 60, + validate => \&IkiWiki::pagespec_valid, + fieldset => $section, + ); + } elsif ($info{type} eq "integer") { $form->field( name => $name, label => $description, type => "text", value => $value, + size => 5, validate => '/^[0-9]+$/', fieldset => $section, ); @@ -60,7 +128,29 @@ sub addfields ($$@) { ); } } -} + + return 1; +} #}}} + +sub showplugintoggle ($$$$) { #{{{ + my $form=shift; + my $plugin=shift; + my $enabled=shift; + my $section=shift; + + return 0 if (grep { $_ eq $plugin } @{$config{websetup_force_plugins}}, @rcs_plugins); + + $form->field( + name => "enable.$plugin", + label => "", + type => "checkbox", + options => [ [ 1 => sprintf(gettext("enable %s?"), $plugin) ] ], + value => $enabled, + fieldset => $section, + ); + + return 1; +} #}}} sub showform ($$) { #{{{ my $cgi=shift; @@ -81,6 +171,7 @@ sub showform ($$) { #{{{ charset => "utf-8", method => 'POST', javascript => 0, + reset => 1, params => $cgi, action => $config{cgiurl}, template => {type => 'div'}, @@ -97,14 +188,28 @@ sub showform ($$) { #{{{ $form->field(name => "do", type => "hidden", value => "setup", force => 1); - addfields($form, gettext("main"), IkiWiki::getsetup()); + showfields($form, undef, undef, IkiWiki::getsetup()); + + # record all currently enabled plugins before all are loaded + my %enabled_plugins=%IkiWiki::loaded_plugins; + + # per-plugin setup require IkiWiki::Setup; + my %plugins=map { $_ => 1 } IkiWiki::listplugins(); foreach my $pair (IkiWiki::Setup::getsetup()) { my $plugin=$pair->[0]; my $setup=$pair->[1]; - addfields($form, $plugin." ".gettext("plugin"), @{$setup}); + + # skip all rcs plugins except for the one in use + next if $plugin ne $config{rcs} && grep { $_ eq $plugin } @rcs_plugins; + + delete $plugins{$plugin} if showfields($form, $plugin, $enabled_plugins{$plugin}, @{$setup}); } + # list all remaining plugins (with no setup options) at the end + showplugintoggle($form, $_, $enabled_plugins{$_}, gettext("other plugins")) + foreach sort keys %plugins; + if ($form->submitted eq "Cancel") { IkiWiki::redirect($cgi, $config{url}); return; diff --git a/IkiWiki/Setup/Standard.pm b/IkiWiki/Setup/Standard.pm index f3d4994fb..0e640f8ac 100644 --- a/IkiWiki/Setup/Standard.pm +++ b/IkiWiki/Setup/Standard.pm @@ -32,8 +32,7 @@ sub dumpline ($$$$) { #{{{ # avoid quotes $dumpedvalue=$value; } - elsif ($type eq 'string' && ref $value eq 'ARRAY' && @$value && - ! grep { /[^-A-Za-z0-9_]/ } @$value) { + elsif (ref $value eq 'ARRAY' && @$value && ! grep { /[^-A-Za-z0-9_]/ } @$value) { # dump simple array as qw{} $dumpedvalue="[qw{ ".join(" ", @$value)." }]"; } diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn index 255be4207..b31722dd7 100644 --- a/doc/plugins/write.mdwn +++ b/doc/plugins/write.mdwn @@ -396,9 +396,10 @@ describing the option. For example: rebuild => 0, }, -* `type` can be "boolean", "string", "integer", or "internal" - (used for values that are not user-visible). The type is the type of - the leaf values; the `%config` option may be an array or hash of these. +* `type` can be "boolean", "string", "integer", "pagespec", + or "internal" (used for values that are not user-visible). The type is + the type of the leaf values; the `%config` option may be an array or + hash of these. * `example` can be set to an example value. * `description` is a short description of the option. * `description_html` is an optional short description, that can contain html diff --git a/doc/todo/online_configuration.mdwn b/doc/todo/online_configuration.mdwn index 3e18bbf43..8263c5d56 100644 --- a/doc/todo/online_configuration.mdwn +++ b/doc/todo/online_configuration.mdwn @@ -18,7 +18,7 @@ The plugin could have these config options: websetup_exclude => [qw{option_baz}], # list of plugins that cannot be enabled/disabled via the web # interface - websetup_unconfigurable_plugins => [qw{git svn bzr mercurial monotone tla}] + websetup_force_plugins => [qw{git svn bzr mercurial monotone tla}] Leaning toward just making it write out to the same setup file, rather than writing to a subsidiary setup file. However, this would mean that any diff --git a/po/ikiwiki.pot b/po/ikiwiki.pot index 69a1851f7..52a49ae9c 100644 --- a/po/ikiwiki.pot +++ b/po/ikiwiki.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2008-08-01 17:10-0400\n" +"POT-Creation-Date: 2008-08-02 15:27-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -24,7 +24,7 @@ msgstr "" msgid "login failed, perhaps you need to turn on cookies?" msgstr "" -#: ../IkiWiki/CGI.pm:189 ../IkiWiki/CGI.pm:539 +#: ../IkiWiki/CGI.pm:189 ../IkiWiki/CGI.pm:538 msgid "Your login session has expired." msgstr "" @@ -40,38 +40,38 @@ msgstr "" msgid "Admin" msgstr "" -#: ../IkiWiki/CGI.pm:280 +#: ../IkiWiki/CGI.pm:279 msgid "Preferences saved." msgstr "" -#: ../IkiWiki/CGI.pm:339 +#: ../IkiWiki/CGI.pm:338 #, perl-format msgid "%s is not an editable page" msgstr "" -#: ../IkiWiki/CGI.pm:450 ../IkiWiki/Plugin/brokenlinks.pm:24 +#: ../IkiWiki/CGI.pm:449 ../IkiWiki/Plugin/brokenlinks.pm:24 #: ../IkiWiki/Plugin/inline.pm:306 ../IkiWiki/Plugin/opendiscussion.pm:17 #: ../IkiWiki/Plugin/orphans.pm:28 ../IkiWiki/Render.pm:78 #: ../IkiWiki/Render.pm:148 msgid "discussion" msgstr "" -#: ../IkiWiki/CGI.pm:506 +#: ../IkiWiki/CGI.pm:505 #, perl-format msgid "creating %s" msgstr "" -#: ../IkiWiki/CGI.pm:524 ../IkiWiki/CGI.pm:552 ../IkiWiki/CGI.pm:562 -#: ../IkiWiki/CGI.pm:597 ../IkiWiki/CGI.pm:642 +#: ../IkiWiki/CGI.pm:523 ../IkiWiki/CGI.pm:551 ../IkiWiki/CGI.pm:561 +#: ../IkiWiki/CGI.pm:596 ../IkiWiki/CGI.pm:641 #, perl-format msgid "editing %s" msgstr "" -#: ../IkiWiki/CGI.pm:667 +#: ../IkiWiki/CGI.pm:666 msgid "You are banned." msgstr "" -#: ../IkiWiki/CGI.pm:784 ../IkiWiki/CGI.pm:785 ../IkiWiki.pm:1096 +#: ../IkiWiki/CGI.pm:783 ../IkiWiki/CGI.pm:784 ../IkiWiki.pm:1096 msgid "Error" msgstr "" @@ -707,6 +707,22 @@ msgstr "" msgid "failed to generate image from code" msgstr "" +#: ../IkiWiki/Plugin/websetup.pm:120 +msgid "you are not logged in as an admin" +msgstr "" + +#: ../IkiWiki/Plugin/websetup.pm:149 +msgid "main" +msgstr "" + +#: ../IkiWiki/Plugin/websetup.pm:158 +msgid "plugin" +msgstr "" + +#: ../IkiWiki/Plugin/websetup.pm:168 +msgid "Setup saved." +msgstr "" + #: ../IkiWiki/Render.pm:276 ../IkiWiki/Render.pm:297 #, perl-format msgid "skipping bad filename %s" -- 2.32.0.93.g670b81a890