improve contract with plugin classes
ensure handling of empty values is done well
improve documentation
correct argument name to avoid name conflict in url preventing processing of form.