[Koha-bugs] [Bug 17855] Updated Koha web installer and new onboarding tool feature to guide users through setting up Koha

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17855

--- Comment #12 from Alex Buckley <alexbuckley at catalyst.net.nz> ---
Created attachment 58668
  -->
https://bugs.koha-community.org/bugzilla3/attachment.cgi?id=58668&action=edit
Bug 17855 - Finished updated web installer  and onboarding tool.

 Test plan:
 1. Go through the web installer
 as outlined in the below link. But go through the web installer 4
 times to test the basic and advanced setup modes of the web
 installer:
 https://koha-community.org/manual/installation/html/

 Note: Each time you have finished
 the web installer restart memcached service with: sudo service memcached
restart
 and drop and recreate the database.

 2.
 Attempt 1 : Choose basic and MARC21. Notice the bulletpoints for
 default sample data on web installer step 3, and unticked checkboxes for
 optional data values.

 Attempt 2: Choose basic and UNIMARC, make the same observation as
 above.

 Attempt 3: Choose advanced and MACR21 notice all data values have
 unticked checkboxes (including the default data values)

 Attempt 4: Choose advanced and UNIMARC and make same observation as
 above.

 3. After your fourth attempt do not restart memcached or drop and
 recreate the database. You will be redirected to the onboarding tool
 automatically after finishing the web installer.

 4. Go through the onboarding tool as outlined here:
 https://koha-community.org/manual/installation/html/

 5. Whilst going through the onboarding tool write in special characters to all
text input fields of the
 onboarding tool and try to submit the form. You should not be able to,
 due to html regexes being implemented.

 6. In the create patron category form try to input a value into both the
 'Months:' and 'Until date:' input fields. A message should appear
 beside the input boxes telling the you to only write in one date value

 7. Select a date from the datepicker of the create patron category form

 8. Continue through the rest of the onboarding tool as outlined in that
 above link

 9. Once you have finished the onboarding tool and have logged in with
 the patron account you created in the onboarding tool, try to create a
 library, patron category, patron, item type and circulation rule.

 If you can create these then you know that the onboarding tool has
 successfully set up Koha for you. Therefore the onboarding tool is
 working as intended.

Bug 17855 - In the onboarding tool the following
has been implemented:
* Pre-filled card number input field to prevent
the user having to write in a number which could
already exist thereby causing a duplicate
cardnumber entry error.

* Working html regexes on all inputs in the
create patron category form as well as all
other input fields in the onboarding tool.

* Working datepicker in the create patron category form.
It is working because when the user clicks on the calendar
icon by the 'Until date:' input box a calendar appears and
the user may select a date which is displayed in the said
input box.

* Working detection of invalid dates in
the create patron category form

* Fixed the bug in categories.pl
which allowed users to write in an invalid
date to the date input box and submit the form
So now if the user writes in an invalid date a
message box appears telling them what they entered was
invalid

Test plan:
1. Go through the web installer and onboarding tool (further
instructions for onboaridng tool below) as outlined here:
https://koha-community.org/manual/installation/html/

2. Test every text input fields html regex in the onboarding tool
by writing in special characters and then trying to submit the form.
None of the forms should submit with special characters in any of the
text input fields

3. Use the datepicker in the first create patron category screen, to choose a
date from the calendar.

4. Try writing in an invalid date (e.g. 40/20/2018) to the 'Until Date:' field
of the
create patron category form. A messagebox should appear immediately and
tell you the date you entered is invalid

5. Try writing a date in the 'Until date:' input
and a number of months in the 'Months:' input. Because only one of these
two fields should contain a value a message should appear alongside
these fields to tell you to only input one date value.

6. Continue the onboarding tool as specified in the above link

7. Login using the newly created patron account

8. Go to More->Administration->Patron categories->New category
try writing an invalid date into the 'Until date:' input. As with the
onboarding tool a messagebox should appear asutomatically to tell you
that the date you entered was invalid

Bug 17855 - Implemented in the onboarding tool
working html validation on all fields except
the text inputs fields in the create patron category
screen

Test plan:
1. Go through the web installer as outlined here:
https://koha-community.org/manual/installation/html/

2. Try writing in special characters to all text input
fields in the onboarding tool (except the create patron
form text input fields which do not yet have working html regexes)

You should not be able to submit the form with special characters
in the text input fields

Working html data validation of
all onboarding tool steps

Testing of the onboarding version

Testing of version (second test)

Working data validation of the patron
categories

Testing of version (second test)

Testing the patron category

Working insertion of all fields, and all except patron categories
have successful data validation

Tidied code with additional comments added and
test text removed

Valid cardnumber pre-written into patron form

Prevents duplicate cardnumber entry

Working regex on patron catgeory form

Working patron category datepicker

Does not allow user to use datepicker

Working datepicker and month input check

Form now only allows only one dateperiod input

Working detection of invalid dates

Fixed categories.pl invalid date check

All neccisary functionality in onboarding tool

User can still choose any patron category in patron form

-- 
You are receiving this mail because:
You are the assignee for the bug.
You are watching all bug changes.