class-ld-settings-section-courses-taxonomies.php 5.41 KB
<?php
/**
 * LearnDash Settings Section for Courses Taxonomies Metabox.
 *
 * @since 2.4.0
 * @package LearnDash\Settings\Sections
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( ( class_exists( 'LearnDash_Settings_Section' ) ) && ( ! class_exists( 'LearnDash_Settings_Courses_Taxonomies' ) ) ) {
	/**
	 * Class LearnDash Settings Section for Courses Taxonomies Metabox.
	 *
	 * @since 2.4.0
	 */
	class LearnDash_Settings_Courses_Taxonomies extends LearnDash_Settings_Section {

		/**
		 * Protected constructor for class
		 *
		 * @since 2.4.0
		 */
		protected function __construct() {

			// What screen ID are we showing on.
			$this->settings_screen_id = 'sfwd-courses_page_courses-options';

			// The page ID (different than the screen ID).
			$this->settings_page_id = 'courses-options';

			// This is the 'option_name' key used in the wp_options table.
			$this->setting_option_key = 'learndash_settings_courses_taxonomies';

			// This is the HTML form field prefix used.
			$this->setting_field_prefix = 'learndash_settings_courses_taxonomies';

			// Used within the Settings API to uniquely identify this section.
			$this->settings_section_key = 'taxonomies';

			// Section label/header.
			$this->settings_section_label = sprintf(
				// translators: placeholder: Course.
				esc_html_x( '%s Taxonomies', 'placeholder: Course', 'learndash' ),
				learndash_get_custom_label( 'course' )
			);

			// Used to show the section description above the fields. Can be empty.
			$this->settings_section_description = sprintf(
				// translators: placeholder: courses.
				esc_html_x( 'Control which taxonomies can be used to better organize your LearnDash %s.', 'placeholder: Course', 'learndash' ),
				learndash_get_custom_label_lower( 'course' )
			);

			parent::__construct();
		}

		/**
		 * Initialize the metabox settings values.
		 *
		 * @since 2.4.0
		 */
		public function load_settings_values() {
			parent::load_settings_values();

			$_init = false;
			if ( false === $this->setting_option_values ) {
				$__init                      = true;
				$this->setting_option_values = array(
					'ld_course_category' => 'yes',
					'ld_course_tag'      => 'yes',
					'wp_post_category'   => 'yes',
					'wp_post_tag'        => 'yes',
				);

				// If this is a new install we want to turn off WP Post Category/Tag.
				$ld_prior_version = learndash_data_upgrades_setting( 'prior_version' );
				if ( 'new' === $ld_prior_version ) {
					$this->setting_option_values['wp_post_category'] = '';
					$this->setting_option_values['wp_post_tag']      = '';
				}
			}

			$this->setting_option_values = wp_parse_args(
				$this->setting_option_values,
				array(
					'ld_course_category' => '',
					'ld_course_tag'      => '',
					'wp_post_category'   => '',
					'wp_post_tag'        => '',
				)
			);
		}

		/**
		 * Initialize the metabox settings fields.
		 *
		 * @since 2.4.0
		 */
		public function load_settings_fields() {

			$this->setting_option_fields = array(
				'ld_course_category' => array(
					'name'    => 'ld_course_category',
					'type'    => 'checkbox-switch',
					'label'   => sprintf(
						// translators: placeholder: Course.
						esc_html_x( '%s Categories', 'placeholder: Course', 'learndash' ),
						learndash_get_custom_label( 'course' )
					),
					'value'   => $this->setting_option_values['ld_course_category'],
					'options' => array(
						''    => '',
						'yes' => sprintf(
							// translators: placeholder: Course.
							esc_html_x( 'Manage %s Categories via the Actions dropdown', 'placeholder: Course', 'learndash' ),
							learndash_get_custom_label( 'course' )
						),
					),
				),
				'ld_course_tag'      => array(
					'name'    => 'ld_course_tag',
					'type'    => 'checkbox-switch',
					'label'   => sprintf(
						// translators: placeholder: Course.
						esc_html_x( '%s Tags', 'placeholder: Course', 'learndash' ),
						LearnDash_Custom_Label::get_label( 'course' )
					),
					'value'   => $this->setting_option_values['ld_course_tag'],
					'options' => array(
						''    => '',
						'yes' => sprintf(
							// translators: placeholder: Course.
							esc_html_x( 'Manage %s Tags via the Actions dropdown', 'placeholder: Course', 'learndash' ),
							learndash_get_custom_label( 'course' )
						),
					),
				),
				'wp_post_category'   => array(
					'name'    => 'wp_post_category',
					'type'    => 'checkbox-switch',
					'label'   => esc_html__( 'WP Post Categories', 'learndash' ),
					'value'   => $this->setting_option_values['wp_post_category'],
					'options' => array(
						''    => '',
						'yes' => esc_html__( 'Manage WP Categories via the Actions dropdown', 'learndash' ),
					),
				),
				'wp_post_tag'        => array(
					'name'    => 'wp_post_tag',
					'type'    => 'checkbox-switch',
					'label'   => esc_html__( 'WP Post Tags', 'learndash' ),
					'value'   => $this->setting_option_values['wp_post_tag'],
					'options' => array(
						''    => '',
						'yes' => esc_html__( 'Manage WP Tags via the Actions dropdown', 'learndash' ),
					),
				),
			);

			/** This filter is documented in includes/settings/settings-metaboxes/class-ld-settings-metabox-course-access-settings.php */
			$this->setting_option_fields = apply_filters( 'learndash_settings_fields', $this->setting_option_fields, $this->settings_section_key );

			parent::load_settings_fields();
		}
	}
}
add_action(
	'learndash_settings_sections_init',
	function() {
		LearnDash_Settings_Courses_Taxonomies::add_section_instance();
	}
);