NAME

Koha::Contrib::ValueBuilder::RepeatableAutocomplete - Repeatable autcomplete value-builder for Koha

VERSION

version 1.000

SYNOPSIS

Koha::Contrib::ValueBuilder::RepeatableAutocomplete->build_builder_inline(
        {   field  => '700',
            target => '4',
            data   => [
              { label => 'ArchitektIn', value => 'arc' },
              # and more...
            ] ,
        }
    );
}

DESCRIPTION

Koha::Contrib::ValueBuilder::RepeatableAutocomplete helps building Koha Valuebuilder Plugins. Koha is the world's first free and open source library system.

This module implements some functions that will generate the JavaScript / jQuery needed by the Koha Edit Form to enable a simple autocomplete lookup, while also working with repeatable MARC21 fields.

Please take a look at the helper modules included in this distribution, which pack all the lookup values and their configuration into easy to use functions:

• Koha::Contrib::ValueBuilder::RepeatableAutocomplete::RDA

  Values for Field 100 and 700 subfields $e and $e, creator and additional persons.

Functions

build_builder_inline

Build JS to handle a short inline autocomplete lookup (data is provided to the function, not loaded via AJAX etc).

build_builder_inline(
      {   field     => '100',
          target    => '4',
          minlength => 3.
          data      => [ { label=>"Foo", value=>'foo', ... } ],
      }
  );

Parameters:

• field: required

  The MARC21 field.

• target: required

  The subfield of the MARC field into which the selected value is stored.

• data: required

  An ARRAY of HASHes, each hash has to contain a key label (which will be what the users enter) and a key value which has to contain the value to be stored in target

• minlength; optional, defaults to 3

  Input length that will trigger the autocomplete.

Usage in Koha

You will need to write a value_builder Perl script and put it into /usr/share/koha/intranet/cgi-bin/cataloguing/value_builder. You can find some example value-builder scripts in "" in example. The should look something like this:

#!/usr/bin/perl
use strict;
use warnings;

use Koha::Contrib::ValueBuilder::RepeatableAutocomplete::RDA qw(f100);

return f100('de');

You than will have to enable this value_builder as a Plugin in the respective MARC21 Framework / field / subfield.

Thanks

for supporting Open Source and giving back to the community:

• HKS3

• Steirmärkische Landesbibliothek

• Camera Austria

AUTHORS

• Thomas Klausner <domm@plix.at>

• Mark Hofstetter <cpan@trust-box.at>

COPYRIGHT AND LICENSE

This software is copyright (c) 2022 by Thomas Klausner.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.