# GradeBook for LearnDash

`meteorgpl-plugin/learndash-gradebook` — a WordPress plugin as a Composer package.

Adds Grade Book functionality to LearnDash LMS.

- Author: Real Big Plugins — https://realbigplugins.com
- Homepage: https://realbigplugins.com/plugins/gradebook-for-learndash
- License: not declared
- Buy a license from the vendor: https://realbigplugins.com/plugins/gradebook-for-learndash
- Page: https://meteorgpl.com/packages/meteorgpl-plugin/learndash-gradebook
- Requires WordPress: 4.8.0
- Tested up to WordPress: 6.1.0
- Requires PHP: 5.3.0
- Vendor: Real Big Plugins — https://meteorgpl.com/vendors/realbigplugins.com

## About

Adds Gradebook functionality to LearnDash LMS.

## Changelog

### 4.0.2

- Fixes a possible issue when "All Courses" is chosen for a Grade Book but a Student doesn't have any Course Progress stored yet

### 4.0.1

- Fixes some deprecation warnings in PHP 8.x

### 4.0.0

- Multiple Courses can now be selected for a single Grade Book!
  - This will allow you to create a Grade Book that only include Grades for 2 or more Courses rather than requiring "All Courses" to be used or to otherwise have a separate Grade Book for every single Course.
- Now compatible with Elementor!
  - Previously the necessary styling and scripts for the Report Card and Frontend Grade Book would not load if the page were created using Elementor, but this has now been addressed with GradeBook for LearnDash v4.0.0
- Lesson and Topic Completion can now be shown as complete/incomplete when "All Courses" or more than one Course has been added to the Grade Book!
  - Previously this was not supported and any Lessons/Topics that were selected for the Grade Book would not show if "All Courses" were enabled, but this limitation has been removed as of GradeBook for LearnDash v4.0.0
- A new "Per Page" input has been added under "Screen Options" in the upper-right hand of the screen while viewing the Backend Grade Book.
- Timestamps are now saved for Manual Grades!
  - Any time a Manual Grade is created or updated a timestamp will be saved along with it.
  - This will show within the View/Edit Grades view for the Student within a Grade Book.
- The Specific Assignment Selector has been removed
  - This was not a particularly useful feature as it had you select specific _submissions_ for an Assignment Upload to include in your Grade Book rather than choosing the Lesson or Topic that the Assignments are to be uploaded to. 
  - It is recommended to either use the "All Assignments" toggle or to use the "Assignments from Lessons" or "Assignments from Topics" fields as is approrpriate for your setup.
- The "Users" meta box has been removed from the Grade Book Edit screen
  - This meta box acted as a way to view a specific User's Grades while editing the Grade Book, but given that until you saved your changes to the Grade Book you wouldn't see anything you may have adjusted anyway, it was removed in favor of accessing the View/Edit Grades screen from the Backend (or Frontend) Grade Book itself.
- Adds the `ld_gb_backend_gradebook_grade_format` filter for adjusting the Grade Format that is used by the Backend Grade Book and its views
- Adds the `learndash_update_manual_grade` filter so that the saved data for a Manual Grade can be programmatically adjusted or added to if needed

### 3.3.0

- Right to Left (RTL) Language support!
- Improved translation file to assist with setting up the plugin within an RTL environment
  - The following template files were updated to accomodate this:
    - ./templates/frontend-gradebook/gradebook-dropdown.php
    - ./templates/frontend-gradebook/group-dropdown.php
    - ./templates/frontend-gradebook/edit-panel/edit-panel-user-grade.php
    - ./templates/frontend-gradebook/edit-panel/components/edit-panel-component-override.php
    - ./templates/frontend-gradebook/edit-panel/components/edit-panel-component.php
    - ./templates/frontend-gradebook/edit-panel/components/edit-panel-grade-add.php
    - ./templates/frontend-gradebook/edit-panel/components/edit-panel-grade-edit.php
    - ./templates/frontend-gradebook/edit-panel/components/edit-panel-grade-row.php
    - ./templates/frontend-gradebook/table/table-head.php
    - ./templates/frontend-gradebook/table/table-row.php
    - ./templates/report-card/expand-collapse.php
    - ./templates/report-card/overall-grade.php
    - ./templates/report-card/title.php
    - ./templates/report-card/component/grades-header.php
    - ./templates/report-card/component/title.php

### 3.2.0

- Fixes an issue with the Overall Grade Shortcode and Gutenberg Block where extra space would show above and below it
  - This will allow you to utilize it inline within a Certificate more easily
- Adds missing WordPress Filters for the CSV Headers in the All Grade Book Grades export

Full changelog: https://meteorgpl.com/packages/meteorgpl-plugin/learndash-gradebook/changelog

## Install

```sh
composer config repositories.meteorgpl composer https://composer.meteorgpl.com
composer require meteorgpl-plugin/learndash-gradebook
```

The repository needs a token (see https://meteorgpl.com/docs). The vendor's license checks are intact: activate the plugin in WordPress with a key bought from the vendor.

## Versions

No version has been published yet.

