Release notes for WeBWorK 2.19

From WeBWorK_wiki
Revision as of 15:38, 23 April 2024 by Glennric (talk | contribs)
Jump to navigation Jump to search
Construction.png This article is under construction. Use the information herein with caution until this message is removed.
Warning : This page should be considered incomplete until the release of 2.19 has been announced

New WeBWorK Features

  • The attempts table has been removed. Feedback for correct/incorrect answers is now associated directly with each answer blank.
  • PGML native syntax for tables
  • Add a PGML converter to the PG editor
  • Rename the "Hmwk Sets Editor" and "Classlist Editor" to "Sets Manager" and "Accounts Manager"
  • Links to file bugs now go to the appropriate GitHub page.
  • File Manager updates
    • archive and unarchive zip files
    • editing problem files (pg) opens the problem editor.
  • Improvements to the Instructor Tools
    • new sort options on users/sets
  • Redesign of the PGML lab
    • All of the examples have been updated.
    • Now there are examples that include all PGML features.
    • Listing of references

New PG Features

Deprecated Functionality

  • All versions of PGcompoundproblem have been deprecated. Problems should be migrated to scaffold.

Upgrade Notes and Cautions

  • New Prerequisites:
    • Mojolicious::Plugin::RenderFile
  • Update site.conf: need to define $admin_course_id
  • Imagemagick configuration

Upgrade Instructions

  • First update the webwork2 and pg code. For this run
    > cd /opt/webwork/webwork2
    > git fetch origin
    > git checkout main
    > git pull
    > cd /opt/webwork/pg
    > git fetch origin
    > git checkout main
    > git pull
  • Update the javascript and css assets for webwork2 and pg with
    > cd /opt/webwork/webwork2/htdocs
    > npm ci
    > cd /opt/webwork/pg/htdocs
    > npm ci
  • The following perl packages will need to be installed (run bin/check_modules.pl to ensure you have all programs/modules)
    • Archive::Zip::SimpleZip (on Ubuntu install from cpan)
    • File::Copy::Recursive (on Ubuntu install libfile-copy-recursive-perl)
    • GD::Barcode::QRcode (on Ubuntu install libgd-barcode-perl)
    • MIME::Base32 (on Ubuntu install libmime-base32-perl)
    • SQL::Abstract (on Ubuntu install libsql-abstract-perl)
  • Compare your site.conf file to site.conf.dist, your localOverrides.conf file to localOverrides.conf.dist, your webwork2.mojolicious.yml file to webwork2.mojolicious.dist.yml and update as needed.
  • Compare any other files in the /opt/webwork/webwork2/conf directory that have been copied from a .dist file and update as needed.
  • Upgrade the admin course by executing the upgrade_admin_db.pl script.
  • Make sure to upgrade courses from the admin course to relegate changes to the database.