MASTERSTUDY_QUIZPASSED::define_trigger()

Define and register the trigger by pushing it into the Automator object


Source Source

File: src/integrations/masterstudy-lms/triggers/masterstudy-quizpassed.php

	public function define_trigger() {



		$args = [
			'post_type'      => 'stm-courses',
			'posts_per_page' => 999,
			'orderby'        => 'title',
			'order'          => 'ASC',
			'post_status'    => 'publish',
		];

		$options = Automator()->helpers->recipe->options->wp_query( $args, true, __( 'Any course', 'uncanny-automator' ) );

		$course_relevant_tokens = [
			'MSLMSCOURSE'     => esc_attr__( 'Course title', 'uncanny-automator' ),
			'MSLMSCOURSE_ID'  => esc_attr__( 'Course ID', 'uncanny-automator' ),
			'MSLMSCOURSE_URL' => esc_attr__( 'Course URL', 'uncanny-automator' ),
		];

		$relevant_tokens = [
			$this->trigger_meta            => esc_attr__( 'Quiz title', 'uncanny-automator' ),
			$this->trigger_meta . '_ID'    => esc_attr__( 'Quiz ID', 'uncanny-automator' ),
			$this->trigger_meta . '_URL'   => esc_attr__( 'Quiz URL', 'uncanny-automator' ),
			$this->trigger_meta . '_SCORE' => esc_attr__( 'Quiz score', 'uncanny-automator' ),

		];

		$trigger = array(
			'author'              => Automator()->get_author_name( $this->trigger_code ),
			'support_link'        => Automator()->get_author_support_link( $this->trigger_code, 'integration/masterstudy-lms/' ),
			'integration'         => self::$integration,
			'code'                => $this->trigger_code,
			/* translators: Logged-in trigger - MasterStudy LMS */
			'sentence'            => sprintf( esc_attr__( 'A user passes {{a quiz:%1$s}}', 'uncanny-automator' ), $this->trigger_meta ),
			/* translators: Logged-in trigger - MasterStudy LMS */
			'select_option_name'  => esc_attr__( 'A user passes {{a quiz}}', 'uncanny-automator' ),
			'action'              => 'stm_lms_quiz_passed',
			'priority'            => 10,
			'accepted_args'       => 3,
			'validation_function' => array( $this, 'quiz_passed' ),
			'options'             => array(),
			'options_group'       => [
				$this->trigger_meta => [
					Automator()->helpers->recipe->field->select_field_ajax(
						'MSLMSCOURSE',
						esc_attr_x( 'Course', 'MasterStudy LMS', 'uncanny-automator' ),
						$options,
						'',
						'',
						false,
						true,
						[
							'target_field' => $this->trigger_meta,
							'endpoint'     => 'select_mslms_quiz_from_course_QUIZ',
						],
						$course_relevant_tokens
					),
					Automator()->helpers->recipe->field->select_field( $this->trigger_meta, esc_attr__( 'Quiz', 'uncanny-automator' ), array(), false, false, false, $relevant_tokens ),
				],
			],
		);

		Automator()->register->trigger( $trigger );

		return;
	}