Course-level lesson drip

.changelogs/feature_course-level-lesson-drip.yml

@@ -0,0 +1,3 @@
+significance: minor
+type: added
+entry: Adds course-level lesson drip settings.

assets/js/builder/Schemas/Lesson.js

@@ -87,13 +87,36 @@ define( [], function() {
 							return this.get_available_prereq_options();
 						},
 			},
+				], [
+					{
+						label: LLMS.l10n.translate( 'Course Drip Method' ),
+						id: 'course-drip',
+						type: 'heading',
+						condition: function() {
+							return ( this.get_course() && 'yes' === this.get_course().get( 'lesson_drip' ) && this.get_course().get( 'drip_method' ) );
+						},
+						detail: LLMS.l10n.translate( 'Drip settings are currently set at the course level, under the Restrictions settings tab. Disable to allow lesson level drip settings.' ) + ' <a href=\"javascript:document.getElementById(\'llms-exit-button\').click()\">' + LLMS.l10n.translate( 'Edit Course' ) + '</a>',
+					},
+				], [
+					{
+						label: LLMS.l10n.translate( 'Course Drip Method' ),
+						id: 'course-drip',
+						type: 'heading',
+						condition: function() {
+							return ( ! this.get_course() || 'yes' !== this.get_course().get( 'lesson_drip' ) || ! this.get_course().get( 'drip_method' ) );
+						},
+						detail: LLMS.l10n.translate( 'Drip settings can be set at the course level to release course content at a specified interval, in the Restrictions settings tab.' ) + ' <a href=\"javascript:document.getElementById(\'llms-exit-button\').click()\">' + LLMS.l10n.translate( 'Edit Course' ) + '</a>',
+					},
 				], [
 					{
 						attribute: 'drip_method',
 						id: 'drip-method',
 						label: LLMS.l10n.translate( 'Drip Method' ),
 						switch_attribute: 'drip_method',
 						type: 'select',
+						condition: function() {
+							return ( ! this.get_course() || 'yes' !== this.get_course().get( 'lesson_drip' ) || ! this.get_course().get( 'drip_method' ) );
+						},
 						options: function() {
 
 							var options = [
@@ -132,6 +155,10 @@ define( [], function() {
 					{
 						attribute: 'days_before_available',
 						condition: function() {
+							if ( this.get_course() && 'yes' === this.get_course().get( 'lesson_drip' ) && this.get_course().get( 'drip_method' ) ) {
+								return false;
+							}
+
 							return ( -1 !== [ 'enrollment', 'start', 'prerequisite' ].indexOf( this.get( 'drip_method' ) ) );
 						},
 						id: 'days-before-available',
@@ -143,6 +170,10 @@ define( [], function() {
 						attribute: 'date_available',
 						date_format: 'Y-m-d',
 						condition: function() {
+							if ( this.get_course() && 'yes' === this.get_course().get( 'lesson_drip' ) && this.get_course().get( 'drip_method' ) ) {
+								return false;
+							}
+
 							return ( 'date' === this.get( 'drip_method' ) );
 						},
 						id: 'date-available',
@@ -153,6 +184,10 @@ define( [], function() {
 					{
 						attribute: 'time_available',
 						condition: function() {
+							if ( this.get_course() && 'yes' === this.get_course().get( 'lesson_drip' ) && this.get_course().get( 'drip_method' ) ) {
+								return false;
+							}
+
 							return ( 'date' === this.get( 'drip_method' ) );
 						},
 						datepicker: 'false',

includes/admin/post-types/meta-boxes/class.llms.meta.box.course.options.php

@@ -328,7 +328,51 @@ public function get_fields() {
 						'label'            => __( 'Choose Prerequisite Course Track', 'lifterlms' ),
 						'value'            => $course_tracks,
 					),
-
+					array(
+						'type'          => 'checkbox',
+						'label'         => __( 'Enable Lesson Drip', 'lifterlms' ),
+						'desc'          => __( 'Set global drip restrictions so lesson content becomes available at an interval you define for the course.', 'lifterlms' ),
+						'id'            => $this->prefix . 'lesson_drip',
+						'is_controller' => true,
+						'value'         => 'yes',
+						'class'         => '',
+						'desc_class'    => 'd-3of4 t-3of4 m-1of2',
+					),
+					array(
+						'class'            => 'llms-select2',
+						'controller'       => '#' . $this->prefix . 'lesson_drip',
+						'controller_value' => 'yes',
+						'is_controller'    => true,
+						'type'             => 'select',
+						'id'               => $this->prefix . 'drip_method',
+						'label'            => __( 'Drip Method', 'lifterlms' ),
+						'value'            => array(
+							array(
+								'key' => 'start',
+								'title' => __( 'After course start or enrollment', 'lifterlms' ),
+							),
+						),
+					),
+					array(
+						'controller'       => '#' . $this->prefix . 'lesson_drip',
+						'controller_value' => 'yes',
+						'class'            => 'input-full',
+						'id'               => $this->prefix . 'ignore_lessons',
+						'label'            => __( 'Number of lessons to make immediately available on course start', 'lifterlms' ),
+						'type'             => 'number',
+						'step'             => 1,
+						'min'              => 1,
+					),
+					array(
+						'controller'       => '#' . $this->prefix . 'lesson_drip',
+						'controller_value' => 'yes',
+						'class'            => 'input-full',
+						'id'               => $this->prefix . 'days_before_available',
+						'label'            => __( 'Delay (in days) ', 'lifterlms' ),
+						'type'             => 'number',
+						'step'             => 1,
+						'min'              => 1,
+					),
 					array(
 						'is_controller' => true,
 						'type'          => 'checkbox',

includes/admin/post-types/meta-boxes/class.llms.meta.box.lesson.php

@@ -73,7 +73,7 @@ public function get_fields() {
 			unset( $methods['start'] );
 		}
 
-		return array(
+		$fields = array(
 			array(
 				'title'  => __( 'General', 'lifterlms' ),
 				'fields' => array(
@@ -134,44 +134,13 @@ public function get_fields() {
 					),
 				),
 			),
-			array(
+			'drip' => array(
 				'title'  => __( 'Drip Settings', 'lifterlms' ),
 				'fields' => array(
 					array(
-						'class'         => 'llms-select2',
-						'desc_class'    => 'd-all',
-						'id'            => $this->prefix . 'drip_method',
-						'is_controller' => true,
-						'label'         => __( 'Method', 'lifterlms' ),
-						'type'          => 'select',
-						'value'         => $methods,
-					),
-					array(
-						'controller'       => '#' . $this->prefix . 'drip_method',
-						'controller_value' => 'lesson,enrollment,start,prerequisite',
-						'class'            => 'input-full',
-						'id'               => $this->prefix . 'days_before_available',
-						'label'            => __( 'Delay (in days) ', 'lifterlms' ),
-						'type'             => 'number',
-						'step'             => 1,
-						'min'              => 0,
-					),
-					array(
-						'controller'       => '#' . $this->prefix . 'drip_method',
-						'controller_value' => 'date',
-						'class'            => 'llms-datepicker',
-						'id'               => $this->prefix . 'date_available',
-						'label'            => __( 'Date Available', 'lifterlms' ),
-						'type'             => 'date',
-					),
-					array(
-						'controller'       => '#' . $this->prefix . 'drip_method',
-						'controller_value' => 'date',
-						'class'            => '',
-						'desc'             => __( 'Optionally enter a time when the lesson should become available. If no time supplied, lesson will be available at 12:00 AM. Format must be HH:MM AM', 'lifterlms' ),
-						'id'               => $this->prefix . 'time_available',
-						'label'            => __( 'Time Available', 'lifterlms' ),
-						'type'             => 'text',
+						'type' => 'custom-html',
+						'id' => $this->prefix . 'drip_course_settings_info',
+						'value' => $this->get_drip_course_settings_info_html( $course ),
 					),
 				),
 			),
@@ -191,8 +160,67 @@ public function get_fields() {
 				),
 			),
 		);
+
+		if ( 'yes' !== $course->get( 'lesson_drip' ) || ! $course->get( 'drip_method' ) ) {
+			$fields['drip']['fields'][] = array(
+				'class'         => 'llms-select2',
+				'desc_class'    => 'd-all',
+				'id'            => $this->prefix . 'drip_method',
+				'is_controller' => true,
+				'label'         => __( 'Method', 'lifterlms' ),
+				'type'          => 'select',
+				'value'         => $methods,
+			);
+			$fields['drip']['fields'][] = array(
+				'controller'       => '#' . $this->prefix . 'drip_method',
+				'controller_value' => 'lesson,enrollment,start,prerequisite',
+				'class'            => 'input-full',
+				'id'               => $this->prefix . 'days_before_available',
+				'label'            => __( 'Delay (in days) ', 'lifterlms' ),
+				'type'             => 'number',
+				'step'             => 1,
+				'min'              => 0,
+			);
+			$fields['drip']['fields'][] = array(
+				'controller'       => '#' . $this->prefix . 'drip_method',
+				'controller_value' => 'date',
+				'class'            => 'llms-datepicker',
+				'id'               => $this->prefix . 'date_available',
+				'label'            => __( 'Date Available', 'lifterlms' ),
+				'type'             => 'date',
+			);
+			$fields['drip']['fields'][] = array(
+				'controller'       => '#' . $this->prefix . 'drip_method',
+				'controller_value' => 'date',
+				'class'            => '',
+				'desc'             => __( 'Optionally enter a time when the lesson should become available. If no time supplied, lesson will be available at 12:00 AM. Format must be HH:MM AM', 'lifterlms' ),
+				'id'               => $this->prefix . 'time_available',
+				'label'            => __( 'Time Available', 'lifterlms' ),
+				'type'             => 'text',
+			);
+		}
+
+		return $fields;
 	}
 
+	/**
+	 * Helpful messaging depending on whether the course for this lesson has drip settings enabled or not.
+	 *
+	 * @since [version]
+	 *
+	 * @param LLMS_Course $course Course object.
+	 * @return string
+	 */
+	public function get_drip_course_settings_info_html( $course ) {
+		$output = 'yes' === $course->get( 'lesson_drip' ) && $course->get( 'drip_method' ) ?
+			__( 'Drip settings are currently set at the course level, under the Restrictions settings tab. If you would like to set individual drip settings for each lesson, you must disable the course level drip settings first.', 'lifterlms' )
+		:
+			__( 'Drip settings can be set at the course level to release course content at a specified interval, in the Restrictions settings tab.', 'lifterlms' );
+
+		$output .= ' <a href="' . admin_url( 'post.php?post=' . $course->get( 'id' ) . '&action=edit#lifterlms-course-options' ) . '">' . __( 'Edit Course', 'lifterlms' ) . '</a>';
+
+		return $output;
+	}
 }
 
 new LLMS_Meta_Box_Lesson();

includes/admin/views/builder/settings-fields.php

@@ -138,6 +138,9 @@ class="llms-input standard"
 						<span class="llms-label llms-label--after">{{{ field.label_after }}}</span>
 					<# } #>
 
+					<# if ( field.detail ) { #>
+						<div class="llms-detail">{{{ field.detail }}}</div>
+					<# } #>
 				</div>
 			<# } ); #>
 			</div>

includes/models/model.llms.course.php

@@ -87,6 +87,10 @@ class LLMS_Course extends LLMS_Post_Model implements LLMS_Interface_Post_Instruc
 		'tile_featured_video'        => 'yesno',
 		'time_period'                => 'yesno',
 		'start_date'                 => 'text',
+		'lesson_drip'                => 'yesno',
+		'drip_method'                => 'text',
+		'ignore_lessons'             => 'absint',
+		'days_before_available'      => 'absint',
 
 		// Private.
 		'temp_calc_data'             => 'array',