Bulk Enrollment for Courses & Memberships

[actual-saurabh]

• Using manage_users_extra_tablenav action here: https://github.com/WordPress/WordPress/blob/master/wp-admin/includes/class-wp-users-list-table.php#L300, it'd be easy to add a select2 box for memberships and courses and have a simple UI for bulk enrollment. The choice would be limited to only one course or membership at a time.

• Set a custom administrative action called 'enroll' (https://github.com/WordPress/WordPress/blob/master/wp-admin/includes/class-wp-list-table.php#L478-L499 & https://github.com/WordPress/WordPress/blob/master/wp-admin/users.php#L99

• Filter the default case of the switch statement here: https://github.com/WordPress/WordPress/blob/master/wp-admin/users.php#L444 to get the array of user_ids and the rest of the $_POST data and then loop through each user and run llms_enroll_studenthttps://github.com/gocodebox/lifterlms/blob/master/includes/functions/llms.functions.person.php#L156-L171 to complete enrollment

[actual-saurabh]

Looks like the last 2 are not possible in the way I assumed they would be. However, I was able to find workarounds and am still able to run the bulk enrollment.

Will be able to push this in a day or so.

[actual-saurabh]

Finished all the code for bulk enrollment here: https://github.com/actual-saurabh/lifterlms/blob/feature/bulk-enroll/includes/admin/class.llms.student.bulk.enroll.php

Added select2 extension here: https://github.com/actual-saurabh/lifterlms/blob/feature/bulk-enroll/assets/js/llms-bulk-enroll.js

Wasn't able to test thoroughly but the js doesn't seem to load at all. Will test and fine tune before sending in a PR

[actual-saurabh]

Tested all scenarios manually by adding the js through console. Works beautifully 😄 :

Select users and memberships:

Everybody gets enrolled:

Select membership, but not users:

Expected error!

Select users but no product

Expected error!

Try enrolling already enrolled students

Expected error!

[actual-saurabh]

Not sure why JS isn't getting enqueued at all. Will look at it afresh tomorrow.

[actual-saurabh]

A side thought, similar functionality can be added to the Edit User screen to bulk enroll one user into many courses/memberships with a few tweaks.

[thomasplevy]

@actual-saurabh I'm wondering if it would be better to group the notices into a single notice with a <ul> instead of multiple notices. 3 - 6 notices isn't that bad but what if a user enrolls 20? What if they extend the default number of users / screen to 50 or 100 and then bulk enroll all 50 / 100? That's a lot of notices... I guess it'd be a giant list as well but at least it could be dismissed in one click instead of 20 - 100.

Just a thought

[actual-saurabh]

@thomasplevy I did think about this. I considered 3 scenarios:

1. Frequent bulk enrollment for a small number of users (~10)
2. Rare bulk enrollment for a large number of students (>10, <20-30 )
3. Extremely rare bulk enrollment for a humongous number (>50)

Most common use cases, afaik, would be 1 & 2. If someone does perform 3, that'll be a one off, very rare user experience.

I felt that since each enrollment is a separate operation, it makes sense to keep the notice separate to distinguish the state (success, error) in line with WordPress's default functionality. I'm banking on WordPress core taking care of grouping notifications in the near future. See: https://core.trac.wordpress.org/ticket/43484

In any case, simply refreshing the page or navigating away from the screen would clear all the notifications by default.

So, I decided to keep it as it is, even if it is unelegant, for the sake of consistency with WP's admin experience. In that vein, I feel it is more consistent with the idea of being able to clear the success notices and have only the failed notifications on screen, if and when enrollment fails for some users.