effective_learndash 0.3.3 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d25f8c1921377617abd4004f3adbb82d9e38589462c259a37e547ab2ec27798
-  data.tar.gz: 90e18a4a91c097e933bc8488a2f93df434c804f4f66ad8d5520f9861bf80053f
+  metadata.gz: 6eb2371d420ae282aecca6fe59883224b3102dd09d202f56be75180765b65ff3
+  data.tar.gz: 9e95e8974c3756bc92b844c8545e8ab10b68dd3e2bc7e8c08755b28c99db886f
 SHA512:
-  metadata.gz: d2a6e4788833e47dba46b14a0055f54f7d183261e81f6e74672cd408406109f691a2b80f9f25f4576f05d9adc437ea3af50abd583d501b3092a429a52cad23da
-  data.tar.gz: e6fce4b599ff82a65b53859a95668462a97b7ba6509e81b00268d735802163c0cd271bc85fc9ae0c276425e1ab4a98ab07f3724cee4fe2f7162c42de4b648a1b
+  metadata.gz: a3b8229756fc75a69b03f0934a4eb7f8da253fc17cf37b6cf19d126d1999f3e145f2a10a74d3db4eb16f5752d8b324c18a9031827fb273b3249f0dc146236945
+  data.tar.gz: 101dd24f148d4356471482ac13ec54dab698e2690c368a10bf98e0672a6c3899623f2eff7ea6a5d026143c17f62d5ad5aea667eb94284c40bdf43c2aabf00769

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright 2022 Code and Effect Inc.
+Copyright 2023 Code and Effect Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/app/datatables/admin/effective_learndash_enrollments_datatable.rb

@@ -14,9 +14,9 @@ module Admin
         time_ago_in_words(enrollment.last_synced_at) + ' ago'
       end
 
-      col :owner
-      col :learndash_course
+      col :owner, visible: attributes[:learndash_user_id].blank?
       col :learndash_user
+      col :learndash_course
 
       col :progress_status
 

data/app/datatables/{effective_learndash_courses_datatable.rb → effective_learndash_available_courses_datatable.rb}

@@ -1,11 +1,5 @@
-# Dashboard Courses
-class EffectiveLearndashCoursesDatatable < Effective::Datatable
-  filters do
-    # Registerable should be first here, so when displayed as a simple datatable on the dashboard they only see registerable courses
-    scope :registerable
-    scope :all
-  end
-
+# Dashboard Available Courses
+class EffectiveLearndashAvailableCoursesDatatable < Effective::Datatable
   datatable do
     order :title
     col :id, visible: false
@@ -24,7 +18,10 @@ class EffectiveLearndashCoursesDatatable < Effective::Datatable
   end
 
   collection do
-    Effective::LearndashCourse.deep.learndash_courses(user: current_user)
+    enrolled = Effective::LearndashEnrollment.where(learndash_user: current_user.learndash_user).select(:learndash_course_id)
+    courses = Effective::LearndashCourse.deep.registerable.learndash_courses(user: current_user)
+
+    courses.where.not(id: enrolled)
   end
 
 end

data/app/models/concerns/effective_learndash_owner.rb

@@ -43,6 +43,22 @@ module EffectiveLearndashOwner
     learndash_users.first
   end
 
+  def in_progress_learndash_enrollments
+    learndash_enrollments.reject(&:completed?).sort_by(&:created_at)
+  end
+
+  def completed_learndash_enrollments
+    learndash_enrollments.select(&:completed?).sort_by(&:date_completed)
+  end
+
+  def completed_learndash_courses
+    learndash_enrollments.select(&:completed?).map(&:course).sort_by(&:id)
+  end
+
+  def learndash_enrolled_courses
+    learndash_enrollments.map { |enrollment| enrollment.learndash_course }
+  end
+
   # Find or create
   def create_learndash_user
     learndash_user || learndash_users.create!(owner: self)
@@ -67,11 +83,48 @@ module EffectiveLearndashOwner
     return false if enrollment.blank?
 
     # Return completed right away if previously marked completed
-    return true if enrollment.completed?
-
-    # Check the API
-    enrollment.refresh!
     enrollment.completed?
+
+    # DO NOT check API
+  end
+
+  def learndash_enroll!(courses:)
+    courses = Array(courses)
+
+    # Find or create the user
+    create_learndash_user
+    raise('expected a persisted learndash user') unless learndash_user&.persisted?
+
+    courses.each do |course|
+      # Find or Enroll in the course
+      create_learndash_enrollment(course: course)
+      raise('expected a persisted learndash enrollment') unless learndash_enrollment(course: course)&.persisted?
+    end
+
+    # This syncs the learndash enrollment locally
+    learndash_enrollments.select { |enrollment| courses.include?(enrollment.learndash_course) }.each do |enrollment|
+      enrollment.refresh! unless enrollment.completed?
+    end
+
+    save!
+
+    after_learndash_enroll() if respond_to?(:after_learndash_enroll)
+
+    true
+  end
+
+  def learndash_refresh!(force: false)
+    raise('expected a previously persisted learndash user') if learndash_user.blank?
+
+    learndash_enrollments.each do |enrollment|
+      enrollment.refresh!(force: force) unless (force || enrollment.completed?)
+    end
+
+    save!
+
+    after_learndash_refresh() if respond_to?(:after_learndash_refresh)
+
+    true
   end
 
 end

data/app/models/effective/learndash_enrollment.rb

@@ -8,7 +8,9 @@ module Effective
 
     log_changes(to: :learndash_course, except: [:last_synced_at]) if respond_to?(:log_changes)
 
-    PROGRESS_STATUSES = ['not-started', 'in-progress', 'completed']
+    # Only admin can mark finished
+    # Finished is treated as an admin override for completed?
+    PROGRESS_STATUSES = ['not-started', 'in-progress', 'completed', 'finished']
 
     effective_resource do
       last_synced_at      :string
@@ -26,7 +28,7 @@ module Effective
       timestamps
     end
 
-    scope :completed, -> { where(progress_status: 'completed') }
+    scope :completed, -> { where(progress_status: ['completed', 'finished']) }
     scope :in_progress, -> { where(progress_status: 'in-progress') }
     scope :not_started, -> { where(progress_status: 'not-started') }
 
@@ -61,8 +63,35 @@ module Effective
       progress_status == 'in-progress'
     end
 
+    # Admin override to completed
+    def finished?
+      progress_status == 'finished'
+    end
+
+    # Checked to see if the course is done throughout
     def completed?
-      progress_status == 'completed'
+      progress_status == 'completed' || finished?
+    end
+
+    def completed_on
+      date_completed || (created_at if finished?)
+    end
+
+    def mark_as_finished!
+      update!(progress_status: 'finished')
+    end
+
+    # Guess old status
+    def unfinish!
+      if date_completed.present?
+        assign_attributes(progress_status: 'completed')
+      elsif date_started.present?
+        assign_attributes(progress_status: 'in-progress')
+      else
+        assign_attributes(progress_status: 'not-started')
+      end
+
+      save!
     end
 
     def refresh!(force: false)
@@ -79,13 +108,16 @@ module Effective
 
       assign_attributes(
         last_synced_at: Time.zone.now,
-        progress_status: data[:progress_status],
         last_step: data[:last_step],
         steps_completed: data[:steps_completed],
         steps_total: data[:steps_total],
         date_started: Time.use_zone('UTC') { Time.zone.parse(data[:date_started]) },
         date_completed: (Time.use_zone('UTC') { Time.zone.parse(data[:date_completed]) } if data[:date_completed].present?)
       )
+
+      assign_attributes(progress_status: data[:progress_status]) unless finished?
+
+      true
     end
 
   end

data/app/views/admin/learndash_courses/_form.html.haml

@@ -8,6 +8,7 @@
       %p Click the New button from the below table to enroll a user into this course.
       %p Enrolling a user here will enroll them on the LearnDash site.
       %p Alternately, if this course is available for registration, the enrollment will be created upon registration purchase.
+      %p Marking the course finished will allow them to proceed without completing the course on the Learndash LMS.
 
       - datatable = Admin::EffectiveLearndashEnrollmentsDatatable.new(learndash_course: learndash_course)
       = render_datatable(datatable, inline: true)

data/app/views/admin/learndash_users/_learndash_user.html.haml

@@ -21,7 +21,10 @@
 
 %h3 LearnDash Course Enrollments
 
-%p Click the New button from the below table to manually enroll this user into a new course.
+%p 
+  Click the New button from the below table to manually enroll this user into a new course.
+  %br
+  %small.text-muted Marking the course finished will allow them to proceed without completing the course on the Learndash LMS.
 
 - datatable = Admin::EffectiveLearndashEnrollmentsDatatable.new(learndash_user: learndash_user)
 = render_datatable(datatable, inline: true)

data/app/views/effective/learndash/_dashboard.html.haml

@@ -1,12 +1,13 @@
 - learndash_user = current_user.try(:learndash_user)
-- authorized = learndash_user && EffectiveResources.authorized?(self, :show, learndash_user)
+- authorized_user = learndash_user && EffectiveResources.authorized?(self, :show, learndash_user)
+- authorized_registration = EffectiveResources.authorized?(self, :new, EffectiveLearndash.CourseRegistration)
 
 %h2 Courses
 
 - if learndash_user.blank?
   %p You do not have an account to access courses. When you are enrolled in a course, your account credentials will be displayed here.
 
-- if learndash_user.present? && authorized
+- if learndash_user.present? && authorized_user
   - learndash_user.refresh!
 
   %p Your course account credentials are:
@@ -22,8 +23,15 @@
   %p= link_to('Sign in to your course account', EffectiveLearndash.learndash_url, target: '_blank', class: 'btn btn-primary')
 
   - if learndash_user.learndash_enrollments.present?
+    %p You are enrolled in the following courses:
     - datatable = EffectiveResources.best('EffectiveLearndashEnrollmentsDatatable').new(self)
     = render_datatable(datatable, simple: true)
 
   - else
     %p You are not enrolled in any courses.
+
+- available = EffectiveResources.best('EffectiveLearndashAvailableCoursesDatatable').new(self)
+
+- if available.present? && authorized_registration
+  %p The following courses are available for registration:
+  = render_datatable(available, simple: true)

data/config/routes.rb

@@ -23,6 +23,8 @@ EffectiveLearndash::Engine.routes.draw do
 
     resources :learndash_enrollments, only: [:index, :new, :create, :update] do
       post :refresh, on: :member
+      post :mark_as_finished, on: :member
+      post :unfinish, on: :member
     end
 
     resources :learndash_courses, only: [:index, :edit, :update] do

data/db/migrate/{01_create_effective_learndash.rb.erb → 101_create_effective_learndash.rb}

@@ -1,4 +1,4 @@
-class CreateEffectiveLearndash < ActiveRecord::Migration[6.1]
+class CreateEffectiveLearndash < ActiveRecord::Migration[6.0]
   def change
     create_table :learndash_users do |t|
       t.integer :owner_id

data/lib/effective_learndash/version.rb

@@ -1,3 +1,3 @@
 module EffectiveLearndash
-  VERSION = '0.3.3'.freeze
+  VERSION = '0.5.0'.freeze
 end

data/lib/generators/effective_learndash/install_generator.rb

@@ -20,7 +20,7 @@ module EffectiveLearndash
       end
 
       def create_migration_file
-        migration_template ('../' * 3) + 'db/migrate/01_create_effective_learndash.rb.erb', 'db/migrate/create_effective_learndash.rb'
+        migration_template ('../' * 3) + 'db/migrate/101_create_effective_learndash.rb', 'db/migrate/create_effective_learndash.rb'
       end
 
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: effective_learndash
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.5.0
 platform: ruby
 authors:
 - Code and Effect
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-28 00:00:00.000000000 Z
+date: 2023-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -191,7 +191,7 @@ files:
 - app/datatables/admin/effective_learndash_users_datatable.rb
 - app/datatables/effective_course_registrants_datatable.rb
 - app/datatables/effective_course_registrations_datatable.rb
-- app/datatables/effective_learndash_courses_datatable.rb
+- app/datatables/effective_learndash_available_courses_datatable.rb
 - app/datatables/effective_learndash_enrollments_datatable.rb
 - app/helpers/effective_learndash_helper.rb
 - app/models/concerns/effective_learndash_course_registration.rb
@@ -229,7 +229,7 @@ files:
 - app/views/effective/learndash_courses/show.html.haml
 - config/effective_learndash.rb
 - config/routes.rb
-- db/migrate/01_create_effective_learndash.rb.erb
+- db/migrate/101_create_effective_learndash.rb
 - db/seeds.rb
 - lib/effective_learndash.rb
 - lib/effective_learndash/engine.rb
@@ -256,7 +256,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Create Wordpress users and read LearnDash course progress