** Using WeBWorK **

Primary Changes

• LTI Grade Passback: This is a complete rewrite of the LTI authentication module including upgrades to allow grades to be passed back from WeBWorK to the LMS (e.g. Blackboard, Moodle, etc...). The authentication feature includes the ability to automatically create students logging into WeBWorK for the first time. The grading feature has two modes. You can either have WeBWorK pass back a single "homework" grade for the entire course, or you can set it up on a set by set basis. You can read more about this module at the following links. Note: The new LTIAdvanced module not a strict upgrade from the older LTI authentication module LTIBasic. The older module still works, but should be considered legacy code.
  • http://webworkgoehle.blogspot.com/2016/03/webwork-lti-authentication.html - This contains information about how to set up the new module and use it for authentication. See also LTI-Advanced Authentication
  • http://webworkgoehle.blogspot.com/2016/03/webwork-lti-grading.html - This contains information about how to use the grade passback features of the module. See also LTI-Advanced Grading
• Hardcopy Themes: This adds support for different hardcopy themes. Instructors will set the theme that students have access to on the Course Configuration page, and can also select the different themes on the instructor download handouts page. Right now there are two themes: the traditional two column WeBWorK theme and a new "one column" theme which the full page width. The system is also set up so that universities can add their own themes for tests or with branding. Note: You will need to make sure the fullpage latex package is available on your server to use this feature.
  • http://webworkgoehle.blogspot.com/2016/02/hardcopy-themes.html - This contains information about how to use the hardcopy themes feature, and also how to set up your own themes.
• Past Answer Refactor: This is a rewrite of the existing Past Answer's page. First, it replaces the old "wildcard/regex" feature in Past Answers with multiselect lists. Now instructors will explicitly select which sets, users and problems they would like to search for past answers. It also adds the ability to download answers from the Past Answer page as a CSV.
• OPL Statistics: This adds problem usage statistics to the Library Browser. When enabled and configured you should see both local and 'global' statistics on how many times problems have been assigned, students average scores and, average attempt numbers. Here local statistics are generated from the data on your WeBWorK server and reflects how your courses use problems. Global statistics are generated from over a dozen different universities and includes information on 23000 problems.
  • You can donate data from your school by running update-OPL-statistics and then upload-OPL-statistics.
  • http://webworkgoehle.blogspot.com/2016/01/opl-statistics.html - This page contains more information about the statistics feature.
• Translator Refactor: This is an extensive under the hood revamping of how PG tracks problem resources, aliases, answer blanks and evaluators. In general the new approach uses less "dead reckoning" and is smarter about treating answer blanks and evaluators as different components of the same "object". You should not see any changes in functionality.
• Advanced Problem Debugging: Users with admin privileges will have the ability to see detailed debugging information about problems. There are four options available. AnswerGroupInfo shows information about answer "groups". This is most helpful for multianswer style problems. Show Auxiliary Resources shows information about auxiliary files used by the problem. AnswerHashInfo shows information about the answer hash, including answers, filters and evaluators. PGInfo prints the PG environment, including all available variables.
• Periodic Randomization: This feature allows you to force problems to generate a new seed after a fixed number of attempts. It is sort of "max attempts lite" in that students can keep trying, but they have to start over. The feature is enabled via the Course Configuration page (in the Optional Modules section). Instructors can set the default number of attempts before re-randomization. The number of attempts before re-randomization can also be set on a per problem basis.
  • http://webwork.maa.org/wiki/Periodic_Randomization: This is a wiki resource for this feature.
• parserWordCompletion: This new macro allows authors to ask free response fill in the blank questions with interactive help. As a student types their answer into the answer blank, jQuery's autocomplete feature generates a drop-down list of allowable answers that match what has already been typed.
  • https://github.com/openwebwork/pg/blob/master/macros/parserWordCompletion.pl - As with many macro files, the best documentation is actually contained at the beginning of the macro itself
• Grades: The Grades page was overhauled with an number of small modifications. The total percentage score for homeworks is now shown and the "C" has been replaced by a 100. There is also a course homework grade at the bottom of the Grades table. This score is generated from the total number of points earned divided by the total number of points available and should match the score generated by selecting all sets on the Scoring Tools page. (This can be turned off on the Course Configuration page if WeBWorK's grading scheme doesn't match with what you use.)
  • http://webworkgoehle.blogspot.com/2016/03/grades-external-grades-and-email.html - You can read more about the changes here.

Smaller Changes

• Updated the orientation and demo sets to more accurately reflect how things currently work. 
• Refactored the attempts table code out into its own module. 
• Refactored the show me another feature out into its own module. 
• Changed how options are grouped on the config page. Now there is a "Optional Modules" tab which has all of the different module options in one place. 
• When generating individual set scores from the Scoring Tools page just-in-time sets now provide information about sub problems as well as top level problems 
• Fixed a bug where apache child processes had the same random seed.
• Polished two existing features to make them more obvious. The first is the ability to display extra grade information to students on the Grades page by using email merge and the second is to restrict which students instructors can see to a particular section or group sections. 
• Started making changes about how reduced scoring dates are reported to make it clearer that the reduced scoring date occurs before the due/close date.
• Fixed a bug where students may be unable to open a problem they previously attempted. 
• Added localization files for Russian 
• Add differentiation to parserRoot 
• Added video macros to pg so that you can use the video command to deliver video hints via html5 
• Fixed bugs with correct answers
• Changed the ? popups to click instead of hover since the hover detection was spotty 
• Added better "more like this" messages to the library browser 
• Refactored all of the server rendering scripts to one big script sendXMLRPC.pl. In particular this enables automated sanity checking of the OPL 
• Fixed a bug with gateways with multiple pages and checkboxes 
• Fixed a bug where the reduced credit date wasn't set on newly created sets 
• Polished the hide scores feature on Gateways. Now if hide scores is selected scores aren't shown in grades and you cannot check answers or see correct answers. 
• Changed the default text in the welcome message for a course and made it so that students do not see the info box if the welcome message is the default text. 
• Fixed a bug where on very new installations the Library Browser would fail with MySQL errors 
• Added ability to reorder problems on tables using the Problem Set Detail 2 using touch-punch
• Made scaffold problems more accessible by allowing the closed tab headings to be navigated to and opened using the keyboard. 

git pull origin master

# These flags control if statistics on opl problems are shown in the library
# browser.  If you want to include local statistics you will need to
# run webwork2/bin/update-OPL-statistics on a regular basis.
$problemLibrary{showLibraryLocalStats} = 1;
# This flag controls whether global statistics will be displayed
$problemLibrary{showLibraryGlobalStats} = 1;

# The default prPeriod value  to use for the newly created problem.
# It is suggested to use the value of -1, (i.e. course default)
# Setting this to -1 defaults to the use of course-wide settings (suggested)
# Setting this to 0 disables periodic randomization
# Setting this to a positive value will override the course-wide setting
$problemDefaults{prPeriod} = -1;

################################################################################
# Periodic re-randomization
################################################################################
# switch to enable periodic re-randomization
$pg{options}{enablePeriodicRandomization} = 0;
# course-wide default period for re-randomization, should be an integer
# the value of 0 disables re-randomization
$pg{options}{periodicRandomizationPeriod} = 5;

$WeBWorK::Constants::PG_DIRECTORY = $pg_dir;
$ENV{PG_ROOT} = $pg_dir;

$ENV{WEBWORK_SERVER_ADMIN} = $webwork_server_admin_email;

# The following hashes control which users are allowed to see students from which
# sections.  This is used for large multi-section classes with many ta's and
# professors.  When set users will only see students from their section:
# -  Instructor Tools
# -  Student Progress
# -  Email
# -  Problem Grader
# -  Show Answers
# They will be able to see students from other sections on other pages.
# These variables generally should be set here and not in defaults.conf.

# $viewable_sections = { user_id1 => [1 ,2 ,3] ,
#		       user_id2 => [1],
#		     };

# $viewable_recitations = { user_id1 => [1 ,2 ,3] ,
#			  user_id2 => [1],
#		     };

sudo apachectl restart

upgrade_admin_db.pl

cd /opt/webwork/libraries/webwork-open-problem-library
git pull origin
OPL-update

cd /opt/webwork/MathJax
git pull