Set up a program/challenge based on points and activity badges.

If you have a program that allows people to achieve different levels by doing different things, a points program is probably for you! With a points program, you add a value to different actions.

Important Notes before setting up your challenge:

1. Sometimes administrators ask us if they can simply edit a past program rather than create a new program from scratch. You should definitely not do this! Instead, you will want to duplicate an existing program or create a new program.
2. Points will not be awarded retroactively. Points cannot be awarded until someone is enrolled in the program. Previous activity will not trigger points, even if it was during the dates of the program.
3. Confirm that points are active on your site by following the steps in this article.
4. Setup points increments by following the steps in this article. Although you can add points per program, point values are universal.

Create a Program

Follow the steps below to create a points based:

1. Login as a library administrator.
2. Go to Setup > Manage Program/Challenges.
3. Click on Create a Program.
   
4. Select Earning Points for the ways in which people can earn badges. If you would like to highlight any repeatable activities in your program, you will also select Completing Repeatable Activities here. If you would like for activities to be earned and completed, you will select Completing  Non-Repeatable Activities.
   
                      

Program Setup

The first part of you program you will work on is Program Setup. This is where you will enter some basic information for your program. Follow the instructions below to complete the Program Setup page: 

1. Enter Program Name: What do you want to call this program? The name will be visible to patrons.
2. Provide a Program Description: Tell your patrons all about your program! If you have a paper reading log, be sure to link to a PDF (printable) version of the log within the description. You may use html code in your description to add things like italics, boldface, color, and more to the description.
3. Set the Program Position:If you are offering more than one program, determine where it will appear on a patron's page. 
4. Add a Header Image: Include a program image. The ideal size for this image is 920x351.
5. Scope your Program by Age or Grade: What ages or grade level is this program available? Remember, if you are scoping a program according to grade level, you want that registration field to be required on your site.
6. Set the Program Dates: What are the dates on which this program will be live and available to readers? Note that in the date fields. If you leave this blank, the program will be considered “ongoing.”
7. Determine if the program is Staff Only: Is this program intended to be only for those with staff level access? If so, select “yes,” only for staff members. This is a setting you may change later but may be helpful for training/testing purposes!
8. Determine if you would like to enable Alternative Programs: Decide whether readers may participate in this program and any other program, or if they need to choose between this and another program. 
9. Select Additional Required Registration Information: Select which questions you want to require your readers to provide before enrolling in the program. Note that if they already provide this information when they register for Beanstack it is likely unnecessary to require your readers to provide this information again.

Badges

The next section of your program to setup is Badges. This is where you will determine the logging milestones, choose badge images, and attach any rewards or certificates you see fit.

• At the top of the page you will see the types of logging that you have enabled for your program/challenge. Remember, with a points program/challenge, patrons will earn points for the various log types available to them on your site. You should toggle on Enable Points here. When Enable Points is turned on, an option for adding Repeatable Activities is also be enabled. At this point you can confirm whether or not you'd like to also include activities that can earn points for patrons and thus points badges. Please note repeatable activity badges themselves can never be earned/ completed. If you would like activity badges to be earned please toggle on Completing Activities (non-repeatable). 
  
  
• You will also see the Earnable Points Types. This is where you can decide why types of logging should earn points.
  
  
  
• In the middle of the page you will see Badge Time Restrictions. Select "Any Time" if you want badges to be earned at any time during a program/challenge, or you select "Restricted" if you want badges to be earned within a specific time frame. Note that restricting your badges will change logging in your program from cumulative to episodic. 

Next, you will note the types of badges in a program based on reading and activities: Registration Badge, Completion Badge, Points Badges, and Activity Badges (non-repeatable or repeatable).

Including a registration badge is recommended for all programs! Follow the steps below to add a Registration Badge: 

1. Select Add a Badge.
   
   
2. Next, click on the badge you want to “pop up” upon registration for a reader.
3. Choose a badge image: Here you can select badges from different badge groups.  If you click on one of the groups, you will then only see badges associated with that group as options below. This is an optional action, and can save you time if you already know the group to which your preferred badges are attached.  If you have uploaded your own custom badges they will also show up in the filter options.
   

Once you select the badge, the ability to add a reward will also become available. You may select an existing reward on your site or create a new reward.Once you add a reward, it will be available to use for other programs as well. Keep in mind that the “Instructions for recipients” will appear with a badge when it is earned, will remain on the reader’s dashboard, and will also go to their email as a notification. For example, you may want to indicate a “pick up by” date for a prize in the instructions.

Follow the instructions below to add a reward to your Registration Badge: 

1. Return to the Badges page of your program setup and scroll to Registration Badge.
2. To add a new reward click on +Add New.
   
3. Add instructions on how readers can receive their reward. 
4. Then, click "Save and add".
   
5. You can now select your new reward from the registration badge's drop-down menu.

Next, you have the opportunity to add a Completion Badge. Ask yourself, at what increments do we want to acknowledge achievement with a virtual badge, or virtual badge and a prize? For example, consider completing this phrase, “I want a reader to earn a badge for having read ___ books/mins/hrs, etc.” You will have the chance to determine what a completion is for a program later in the setup process. 

Follow the instructions below to add a Completion Badge:

1. Return to the Badges page of your program setup and scroll to Completion Badge.
2. Select Add a Badge.
3. Select the badge image you would like to use.
4. Determine if you would like to add an existing reward or create a new reward for the Completion Badge. Is there a reward available for having completed the whole program? If so, add the badge and reward here. If you plan to connect a completion reward to a logging badge or activity badge, then do not add a completion reward or it will be awarded twice!  Set up a completion badge reward the same way you would a registration badge reward.
   

Time to setup Points Badges!

Follow the instructions below to add Points Badges: 

1. Return to the Badges page of your program setup and scroll to Points Badges.
2. Select Create a Badge.
3. Click on Choose Badge to select the badge image you would like to use.
4. Choose the Points Goal. In this example, we are creating a badge that will be awarded to those who earn 10 points.
   
   Note that unless you added badge date restrictions to your points badges, earning points is cumulative. This means you would set points badges for 10 points, 20 points, 30 points, and so on, rather than three badges for 10 points
   
5. Determine if you would like to add an existing reward or create a new reward for the Logging Badge. Add an existing reward by selecting from the drop-down menu or create a new one by selecting "Create A Reward".
   Readers will receive a notification when they earn a reward, and this will also be indicated for staff to see on the reader's page.
6. Determine Time Restrictions if necessary. If a badge may be earned at any time during your program, simply leave this section blank. If not, indicate the dates during which it may be earned. 
   
7. Click Save and Add! 
8. Repeat for as many points badges as you'd like to setup!

Now that you've set up your Points badges, you may wish to set up Repeatable Activity Badges. Repeatable Activity Badges can house as many or as few activities as you desire but the badge can never be completed. 

Follow the instructions below to setup Repeatable Activity Badges: 

1. First, make sure that Repeatable Activities is toggled on in Earnable Badges Types.

2. Then, scroll down to Repeatable Activities. Remember, repeatable badges can never be earned/completed. Instead patrons will be able to perform these activities multiple times to earn points over and over again. 
3. Select, Create a Badge. 
4. Create a title for the repeatable activity badge. 
5. Enter a description.
6. Choose a badge image by clicking, Choose a Badge
   
7. Decide if you want this badge to be active now or later. Active badges may be completed at any time. Inactive badges will have to be manually activated when you are ready for them to be completed. 
   
8. Activity badges that are attached to a challenge are always available to be seen by those in the challenge. Even if you select "staff," they would be visible to patrons if attached to a patron level challenge. 
   
9. Should someone complete a specific activity badge before being able to complete this one? If so, select a prerequisite learning track. If not, leave that field blank. Note, only a non-repeatable activity track/badge can a prerequisite learning track. To select that non-repeatable activity track/badge, you must first set it up. Scroll down for instructions on how to set up a non-repeatable activity track/badge. 
   
   
   
10. Click Save and Add.
11. Once the “shell” of the track is saved, you may click Save and add to add activities. 
12. Select Add an Activity.
    
13. Enter a Description: What is the activity/action required? For example, “Attend an event at your library."
14. Optional: Add a Link Title. This will be the text that is hyperlinked should you want to include a link.
15. Optional: Add Link URL. This is the link to which you may send someone for further information
    
    
16. Decide what type of activity this activity will be. There are three types of Activities in Beanstack:
    - General Activity: May include a link, and once complete, a patron simply clicks on the check.
    - Text Box Challenge Activity: You may add a text-box challenge to an activity that requires the reader to add written text to an activity before it may be checked off as completed.
17. Indicate the number of points you would like to add to this activity. 
    
    You can always add or remove activities, and you and easily drag and drop the activities to change their order.
18. Click Add. Continue to add activities to your badge as you see fit. 
19. Click Done when you have added all of the activities you would like to add to this badge.

You may want to add activity tracks/badges that can be earned/completed. You may set up one or a series of activities in a “track,” and then require that all or a subset of them be complete. Non-repeatable Activity badges can house as many or as few activities as you desire. 

Follow the instructions below to set up Non-Repeatable Activity Badges:

1. Return to the Badges page of your program setup and scroll to Activity Badges.
2. Select Create a Badge.
3. Enter a title and a short description.
   
4. Select the badge that will be earned when this learning track is complete. 
   
5. Decide if you want this badge to be active now or later? Active badges may be completed at any time.
   
6. Do you want this learning track to be visible by patrons? If so, select visible to “Patrons.” Should the program just be available for staff to see? If so, select, “Staff only.” 
   
7. Are all of the activities in this badge required? You can enter the minimum number of activities required to complete the badge. If you leave this blank, every activity must be completed to earn the badge.
8. Should someone complete a specific activity badge before being able to complete this one? If so, select a prerequisite learning track. If not, leave that field blank. There are no prerequisite options if you have selected “repeatable” activities for the track.
   
9. Optional: Add a reward for completing this track by either clicking on an existing reward from the drop-down menu, or creating a new reward by clicking Create a Reward.
   
10. Once the “shell” of the track is saved, you may click Save and add to add activities. 
11. Select Add an Activity.
    
12. Enter a Description: What is the activity/action required? For example, “Attend an event at your library."
13. Optional: Add a Link Title. This will be the text that is hyperlinked should you want to include a link.
14. Optional: Add Link URL. This is the link to which you may send someone for further information
15. Decide what type of activity this activity will be. There are three types of Activities in Beanstack:
    - General Activity: May include a link, and once complete, a patron simply clicks on the check.
    - Secret Code Activity: You may add a secret code to an activity that a reader must have and enter in order to complete the activity. 
    - Text Box Challenge Activity: You may add a text-box challenge to an activity that requires the reader to add written text to an activity before it may be checked off as completed.
16. Indicate the number of points you would like to add to this activity. 
    
    You can always add or remove activities, and you and easily drag and drop the activities to change their order.
17. Click Add. Continue to add activities to your badge as you see fit. 
18. Click Done when you have added all of the activities you would like to add to this badge.

Tickets

Adding Ticket Drawings to your program is optional. Ticket Drawings allow readers to determine where they want their entries to go if you have multiple drawing options available to them. 

For example, if a reader earns three ticket, they may decide where to allot their tickets based on the drawings available. See this helpdesk article to setup a ticket drawing. 

Completion Requirements

Determine the Completion Requirements. This is where you can decide how many badges/which badges are required to complete a program. Which badges must someone earn in order to complete the program, versus which are going the extra mile?

Save your program! Now it's time to setup repeatable activities on your site.

Saving a Program 

Last step! Ready to finalize your program? Determine if this program is still a draft or if it should be published. 

Draft: Save as a draft if you do not want this program to be visible to any readers or staff members.
Published: Once you save a program in a “published” state, it is live on your site. Even if the start date for the program is in the future, if the program is published, it would then be available for pre-registration.

Remember to click Save!

You did it! REPEAT for any additional programs you plan to offer!