Table of Contents

ReadingRecord Setup Form Instructions

Overview

The following document is designed to help you fill out the ReadingRecord Setup Forms required to get your ReadingRecord site up and running. It is best read along with the field descriptions and options document to help explain the various fields and options. It may also be helpful to experiment with the demo sites.

FAQs, Tips & Tricks

Don't Panic!

To quote Douglas Adams:

Although the form does ask for quite a bit of information, it is safe to ignore the tabs for fields you aren't using. For example: if you aren't using the age field, simply leave the drop-down field on tab 3 set to “no” and ignore tab 9.

ReadingRecord is flexible

Try to fill out the form as completely & accurately as possible, but don't worry about getting everything perfect. ReadingRecord is flexible enough that making changes to your setup is generally quite easy.

Optional fields

Many fields in ReadingRecord are optional, and there are three types: drop-down lists, text boxes and checkboxes:

Drop-down fields

Tip: Because drop-down fields require an answer to be selected, you may want to include values like “other”, “not listed”, “don't know” or “prefer not to answer”.

Text boxes

Checkboxes

Tip: A required checkbox can provide an easy way to ensure patrons agree to your reading program policies, a photo release or anything else you want a “yes” answer to.

Play with the demo sites

Feel free to play with the demo sites to help you get a feel for what ReadingRecord can do and how you might want to configure your site.

Test your site before go-live

There's no substitute for seeing your site with your options and your data. In most cases you'll have a chance to test your site before self-registration begins. ReadingRecord is flexible enough that most changes can be requested via e-mail. (Complex changes may require you to refill out some of the setup form tabs.)

Be lazy

To save yourself (and me) some time, indicate when you want to use the same drop-down list for multiple programs. For example: You have 3 programs (kids, teens & adults) which all use the same drop-down list for the city field.

Be creative

Since field order, field labels and drop-down list can be customized, use fields to collect any information you'd like:

Note: Currently the built-in reports do not use customized field labels. Time permitting this will be changed before libraries begin running final reports for the 2018 summer reading season.)

Ask questions

Send questions to the ReadingRecord Google Group or e-mail me directly.

Request changes

Have I mentioned that ReadingRecord is designed with flexibility in mind? Making changes prior to (and even after) self-registration begins is generally possible, and in most cases, easy. Send me an e-mail with the changes you'd like and I will let you know when they've been made. (In some cases it may be necessary for you to refill out one or more tabs.)

Tab 1: General Information

This tab gathers information about the library as a whole.

Library name

Type the name of your library in the box. This information is displayed in the browser's title bar.

Contact information

Add the name, phone & e-mail address of staff who will be the primary contact(s) for your library. This information is used for support purposes (eg: questions about the form, site testing e-mail, etc.). It is NOT available in ReadingRecord or published to the ReadingRecord Wiki.

URL prefix

Choose a unique URL prefix for your site. (You will be notified if your prefix is already in use.) It will be used for both patron self-registration and access to the staff module. Sites end in “readingrecord.net”. For example, the demo site uses the prefix “demo” and is hosted on the readingrecord.net server, so the URLs are:

Timezone

Please enter your library's timezone. This ensures that the timestamp used in various places (registration added, registration updated, level completed, etc.) display correctly for your timezone.

Staff & volunteer accounts

Please list usernames & passwords for access to the staff module. You can have several user accounts if desired, please indicate if the user should have access to reports. For example, you might have a staff account with access to reports and a volunteer account without access to reports. Please don’t use a valuable password as it will be visible to ReadingRecord support staff.

Multi-program registration

Please indicate if patrons should be allowed to register for multiple programs. In most cases this is not desirable, but there may be exceptions. For example:

Please provide a library logo or banner attached as a separate file. This could be text with program information like start/end dates and a small library logo. The recommended size is 698px wide x 112px tall. If you don’t have a logo or banner, we will provide generic graphics for you.

Tab 2: Program Information

This tab gathers information about the program.

Program name

Add a short program name. This text will be displayed on the self-registration pages and in various places in the staff module.

Program start date

Indicate the date the program starts. This can be different than the self-registration start date and is often when patrons can begin submitting logs.

Program end date

Indicate the date the program ends. This is generally later then the self-registration end date.

Self-registration start date

Indicate the date patrons should be able to register themselves. Note: This does not affect access to the staff module.

Self-registration end

Indicate the date patrons should no longer be able to register themselves. Note: This does not affect access to the staff module.

Program range

Indicate the program's age or grade range. For example:

Program information

Add a longer description of the program. This text will be displayed on the self-registration index page. It could include general information about the program, such as start/end dates, program ages, etc.

Registration successful message

OPTIONAL: Add a customized “registration successful” message. This text will be displayed after a successful self-registration.

Tab 3: Reader Information

This tab gathers information about which reader information fields should be used, customized labels and other options. For details please see the field descriptions and options document.

Tab 4: Guardian Information

This tab gathers information about which guardian information fields should be used, customized labels and other options. For details please see the field descriptions and options document.

Tab 5: Additional Reader Information

This tab gathers information about which additional reader information fields should be used, customized labels and other options. For details please see the field descriptions and options document.

Tab 6: Additional Reader Information (Staff Only)

This tab gathers information about which additional reader information fields should be used, customized labels and other options. Note: These fields appear on the staff add/update pages only. For details please see the field descriptions and options document.

Tab 7: Field Order

This tab specifies a custom field order. The default order is:

The following custom fields are also available, in general you will need to specify where they should appear:

Tips for specifying a custom field order:

  • This tab determines field order only and has no effect on unused fields. Specifying which fields to use is configured on other tabs.
  • In many cases the default order works well. In some cases it may be useful to move the reader phone field to the guardian info section and change the label. See the field descriptions and options document.
  • If you plan to use any of the custom fields you will most likely want to specify a custom order.
  • Relax! 8-) If you're totally confused by this tab or don't know what order to put the fields in simply start with the default order. Once you've had a chance to see & test your site changing the field order is generally as easy as sending me an e-mail that says something like “Please move the phone number field to after the guardian last name. Thanks!”

Tab 8: Libraries

When using the library field, enter libraries in the order you wish them to be displayed in the drop-down list.

Tab 9: Ages

When using the age field, enter ages in the order you wish them to be displayed in the drop-down list.

Tab 10: Genders

When using the gender field, enter genders in the order you wish them to be displayed in the drop-down list.

Tab 11: Cities

When using the city field, enter cities in the order you wish them to be displayed in the drop-down list.

Tab 12: Zipcodes

When using the zipcode field, enter zipcodes in the order you wish them to be displayed in the drop-down list.

Tab 13: Grades

When using the grade field, enter grades in the order you wish them to be displayed in the drop-down list.

Tab 14: Schools

When using the school field, enter schools in the order you wish them to be displayed in the drop-down list.

Tab 15: Public drop-down

When using the public drop-down field, enter items in the order you wish them to be displayed in the drop-down list.

Tab 16: Staff drop-down

When using the staff drop-down field, enter items in the order you wish them to be displayed in the drop-down list.

Tab 17: Levels

List reading levels and optionally prize / staff instructions on this tab OR a combination of level and drop-down list items to indicate what prize was chosen or task was completed. A “level” can be just about anything you can think of, some examples include: