Autocomplete Plugin

• For an automated installation, run the configure script and follow "Find More Extensions" in the in the Extensions section.
  • See the installation supplement on TWiki.org for more information.

• Or, follow these manual installation steps:
  • Download the ZIP file from the Plugins home (see below).
  • Unzip AutocompletePlugin.zip in your twiki installation directory. Content:

    File:	Description:
    data/TWiki/AutocompletePlugin.txt	Plugin topic
    data/TWiki/VarAUTOCOMPLETE.txt	Variable documentation topic
    pub/TWiki/AutocompletePlugin/*.gif and *.png	Image files
    lib/TWiki/Plugins/AutocompletePlugin.pm	Plugin Perl module

  • Set the ownership of the extracted directories and files to the webserver user.

• Plugin configuration:
  • Run the configure script and enable the plugin in the Plugins section.

• Test if the configuration is successful:
  • See example in Use Autocomplete in HTML Forms

• If you run TWiki-6.0.1 or older and want to use key="value" parameters in field attributes of TWikiForms, you need to patch the core TWiki. Patch for lib/TWiki/Form.pm:

--- lib/TWiki/Form.pm   (revision 28279)
+++ lib/TWiki/Form.pm   (working copy)
@@ -220,7 +220,10 @@
 # Returns array of arrays
 #   1st - list fields
 #   2nd - name, title, type, size, vals, tooltip, attributes
-#   Possible attributes are "M" (mandatory field)
+# Possible attributes are:
+#   "M" (mandatory field - DEPRECATED - now mandatory="1"),
+#   "H" (hidden field - DEPRECATED - now hidden="1"),
+#   followed by type-specific name="value" configuration pairs
 sub _parseFormDefinition {
     my( $this, $meta, $text, $options ) = @_;
     $options ||= {};
@@ -279,9 +282,27 @@
 
             $tooltip ||= '';
 
+            # Item7577: TWikiForms field types with configure attributes:
+            # Attributes are represented by key="value" parameters.
+            # Example attributes cell: | mandatory="1" style="color: blue;" |
+            # Legacy single character attribute flags M and H are supported as well.
+            # Example attributes cell: | M style="color: blue;" |
+            # results in:
+            # - $attributes: 'M'
+            # - $parameters: TWiki::Attrs object with:
+            #   { mandatory => '1', style => 'color: blue;' }
             $attributes ||= '';
-            $attributes =~ s/\s*//go;
-            $attributes = '' if( ! $attributes );
+            my $parameters = '';
+            if( $attributes =~ s/([a-zA-Z0-9]+\=.*)$// ) {
+                $parameters = $1;
+            }
+            $parameters .= ' hidden="1"' if( $attributes =~ /H/ );
+            $parameters .= ' mandatory="1"' if( $attributes =~ /M/ );
+            require TWiki::Attrs;
+            $parameters = new TWiki::Attrs( $parameters );
+            $attributes = '';
+            $attributes .= 'H' if( $parameters->{hidden} );
+            $attributes .= 'M' if( $parameters->{mandatory} );
 
             my $definingTopic = "";
             if( $title =~ /\[\[(.+)\]\[(.+)\]\]/ )  {
@@ -305,6 +326,7 @@
                   value => $vals,
                   tooltip => $tooltip,
                   attributes => $attributes,
+                  parameters => $parameters,
                   definingTopic => $definingTopic,
                   web => $this->{web},
                   topic => $this->{topic}
@@ -612,8 +634,8 @@
     foreach my $fieldDef ( @{$this->{fields}} ) {
         my $fm = $meta->get( 'FIELD', $fieldDef->{name} );
         next unless $fm;
-        my $fa = $fm->{attributes} || '';
-        unless ( $fa =~ /H/ ) {
+        my $fp = $fm->{parameters};
+        unless ( $fp && $fp->{hidden} ) {
             $fieldFound = 1;
             my $row = $rowTemplate;
              # Legacy; was %A_TITLE% before it was $title