=head1 DESCRIPTION

    # add an upload (see tools/upload-file.pl)

    my $upload = Koha::Upload->new( public => 1, category => 'A' );

    This class

    my $cgi = $upload->cgi;

    # Do something with $upload->count, $upload->result or $upload->err

=head1 METHODS

    # get some upload records

    my @uploads = Koha::Upload->new->get( term => $term );

=head2 new

    $template->param( uploads => \@uploads );

    Create object (via Class::Accessor).

    # download

    my $rec = Koha::Upload->new->get({ id => $id, filehandle => 1 });

    my $fh = $rec->{fh};

    my @hdr = Koha::Upload->httpheaders( $rec->{name} );

    print Encode::encode_utf8( $input->header( @hdr ) );

    while( <$fh> ) { print $_; }

    $fh->close;

=head1 PROPERTIES

    # delete an upload

    my ( $fn ) = Koha::Upload->new->delete({ id => $id });

=head2 ???

=head1 DESCRIPTION

    ???

    This module is a refactored version of C4::UploadedFile but adds on top

    of that the new functions from report 6874 (Upload plugin in editor).

    That report added module UploadedFiles.pm. This module contains the

    functionality of both.

=head1 ADDITIONAL COMMENTS

=head1 METHODS

    Returns new object based on Class::Accessor.

    Returns CGI object. The CGI hook is used to store the uploaded files.

    Returns new object based on Class::Accessor.

    Returns a string of id's for each successful upload separated by commas.

    Returns array

    Returns arrayref of uploaded records (hash) or one uploaded record.

    optional parameter: filehandle => 1 (name, path only by default)

    You can pass id => $id or hashvalue => $hash or term => $term.

    Optional parameter filehandle => 1 returns you a filehandle too.

    Marcel de Rooy, Rijksmuseum Amsterdam, The Netherlands

    Koha Development Team

    Larger parts from Galen Charlton, Julian Maurice and Marcel de Rooy