websetup form display done
authorJoey Hess <joey@kodama.kitenet.net>
Sat, 2 Aug 2008 20:40:46 +0000 (16:40 -0400)
committerJoey Hess <joey@kodama.kitenet.net>
Sat, 2 Aug 2008 20:41:37 +0000 (16:41 -0400)
IkiWiki.pm
IkiWiki/Plugin/anonok.pm
IkiWiki/Plugin/attachment.pm
IkiWiki/Plugin/lockedit.pm
IkiWiki/Plugin/websetup.pm
IkiWiki/Setup/Standard.pm
doc/plugins/write.mdwn
doc/todo/online_configuration.mdwn
po/ikiwiki.pot

index d11ceb8963b2c2d123c623e99aa3a3ea8f59a130..241a7c036f41f73ebd5e7374f2b00afd9344464e 100644 (file)
@@ -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;
 } #}}}
 
index d5e409117e947cb202bbe49beb778278ead9a5cc..9d21fe3676e1f6e322139f2d43290127373751b5 100644 (file)
@@ -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).
index bd21ed1edd4549b2ba99ecbc85c620477b84b40c..27f984c299870b112600b054b7ab0062b3e44612 100644 (file)
@@ -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("", "", 
index 4e1b4f8787249c3e17a4c97d77442ca8f0e9bd8d..93a5256770981c20d2ac27127c128ad9440d5b04 100644 (file)
@@ -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).
index a30475977e2b07ef74d24666f3c8af6c3389bd09..0a0d4480f92458c3798f8b269293eec1469d44f7 100644 (file)
@@ -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 "<br/ ><small>Example: <tt>$example</tt></small>";
+       }
+       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 ? "<br/ ><small>Example: <tt>$info{example}</tt></small>" : "",
+                               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;
index f3d4994fb099a03fba7ee30a3071fbe4a37c9bf3..0e640f8ac85b4b1ae9b21df12b9a574090785f94 100644 (file)
@@ -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)." }]";
        }
index 255be4207c54ed5bc05062d421696719919c2b5d..b31722dd7f7337479809a8ed6754afba01439a78 100644 (file)
@@ -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
index 3e18bbf4337dac26228a3e870488d261bd9591cd..8263c5d563e30e213bb5d1dc9a3b9f02387fbd0f 100644 (file)
@@ -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
index 69a1851f7981a54d8b494e3b107f0ca319e98edb..52a49ae9c5d643cceb9670418528150cd33a6378 100644 (file)
@@ -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 <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\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"