LLMS_Frontend_Assets

LLMS_Frontend_Assets


Source Source

File: includes/class.llms.frontend.assets.php

class LLMS_Frontend_Assets {

	/**
	 * Inline script ids that have been enqueued.
	 *
	 * @var  array
	 */
	private static $enqueued_inline_scripts = array();

	/**
	 * Array of inline scripts to be output in the header / footer respectively.
	 *
	 * @var  array
	 */
	private static $inline_scripts = array(
		'header' => array(),
		'footer' => array(),
	);

	/**
	 * Initializer
	 *
	 * Replaces non-static __construct() from 3.4.0 & lower.
	 *
	 * @since 3.4.1
	 * @since 3.17.5 Unknown.
	 * @since 5.6.0 Add content protection inline script enqueue.
	 *
	 * @return void
	 */
	public static function init() {

		add_action( 'wp_enqueue_scripts', array( __CLASS__, 'enqueue_styles' ) );
		add_action( 'wp_enqueue_scripts', array( __CLASS__, 'enqueue_scripts' ) );
		add_action( 'wp_head', array( __CLASS__, 'output_header_scripts' ) );
		add_action( 'wp_print_footer_scripts', array( __CLASS__, 'output_footer_scripts' ), 1 );
		add_action( 'wp', array( __CLASS__, 'enqueue_content_protection' ) );

	}

	/**
	 * Enqueue inline copy prevention scripts.
	 *
	 * @since 5.6.0
	 *
	 * @return void
	 */
	public static function enqueue_content_protection() {

		$allow_copying = ! llms_parse_bool( get_option( 'lifterlms_content_protection', 'no' ) ) || llms_can_user_bypass_restrictions( get_current_user_id() );

		/**
		 * Filters whether or not content prevention is enabled.
		 *
		 * This hook runs on the `wp` action, at this point the current user is available and
		 * the global `$post` has already been set up.
		 *
		 * @since 5.6.0
		 *
		 * @param boolean $allow_copying Whether or not copying is allowed. If `true`, copying
		 *                               is allowed, otherwise copy prevention scripts are
		 *                               loaded.
		 */
		$allow_copying = apply_filters( 'llms_skip_content_prevention', $allow_copying );

		if ( $allow_copying ) {
			return;
		}

		ob_start();
		?>
		( function(){
			function dispatchEvent( type ) {
				document.dispatchEvent( new Event( type ) );
			}
			document.addEventListener( 'copy', function( event ) {
				event.preventDefault();
				event.clipboardData.setData( 'text/plain', '<?php echo __( 'Copying is not allowed.', 'lifterlms' ); ?>' );
				dispatchEvent( 'llms-copy-prevented' );
			}, false );
			document.addEventListener( 'contextmenu', function( event ) {
				if ( event.target && 'IMG' === event.target.nodeName ) {
					event.preventDefault();
					dispatchEvent( 'llms-context-prevented' );
				}
			}, false );
		} )();
		<?php
		$script = ob_get_clean();
		llms()->assets->enqueue_inline( 'llms-integrity', $script, 'header' );

	}

	/**
	 * Enqueue Styles
	 *
	 * @since 1.0.0
	 * @since 3.18.0 Unknown.
	 * @since 3.35.0 Explicitly define asset versions.
	 * @since 4.4.0 Enqueue & register scripts using `LLMS_Assets` methods.
	 * @since 5.0.0 Enqueue select2 on account and checkout pages for searchable dropdowns for country & state.
	 *
	 * @return void
	 */
	public static function enqueue_styles() {

		global $post_type;

		llms()->assets->register_style( 'llms-iziModal' );

		llms()->assets->enqueue_style( 'webui-popover' );
		llms()->assets->enqueue_style( 'lifterlms-styles' );

		if ( in_array( $post_type, array( 'llms_my_certificate', 'llms_certificate' ), true ) ) {
			llms()->assets->enqueue_style( 'certificates' );
		} elseif ( is_llms_account_page() ) {
			llms()->assets->enqueue_style( 'llms-iziModal' );
		} elseif ( is_singular( 'llms_quiz' ) ) {
			wp_enqueue_style( 'wp-mediaelement' );
		}

		if ( is_llms_account_page() || is_llms_checkout() ) {
			llms()->assets->enqueue_style( 'llms-select2-styles' );
		}

	}

	/**
	 * Enqueue Scripts
	 *
	 * @since 1.0.0
	 * @since 3.22.0 Unknown.
	 * @since 3.35.0 Explicitly define asset versions.
	 * @since 3.36.0 Localize tracking with client-side settings.
	 * @since 4.0.0 Remove dependencies "collapse" and "transition".
	 * @since 4.4.0 Enqueue & register scripts using `LLMS_Assets` methods.
	 *              Add Add `window.llms.ajax_nonce` data to replace `wp_ajax_data.nonce`.
	 *              Moved inline scripts to `enqueue_inline_scripts()`.
	 * @since 5.0.0 Enqueue locale data and dependencies on account and checkout pages for searchable dropdowns for country & state.
	 *               Remove password strength inline enqueue.
	 * @since 7.5.0 Enqueue `llms-favorites` script on lesson and course page.
	 *
	 * @return void
	 */
	public static function enqueue_scripts() {

		// I don't think we need these next 3 scripts.
		wp_enqueue_script( 'jquery-ui-tooltip' );
		wp_enqueue_script( 'jquery-ui-datepicker' );
		wp_enqueue_script( 'jquery-ui-slider' );

		llms()->assets->enqueue_script( 'webui-popover' );

		llms()->assets->register_script( 'llms-jquery-matchheight' );
		if ( is_llms_account_page() || is_course() || is_membership() || is_lesson() || is_memberships() || is_courses() || is_tax( array( 'course_cat', 'course_tag', 'course_difficulty', 'course_track', 'membership_tag', 'membership_cat' ) ) ) {
			llms()->assets->enqueue_script( 'llms-jquery-matchheight' );
		}

		llms()->assets->enqueue_script( 'llms' );

		llms()->assets->register_script( 'llms-notifications' );
		if ( get_current_user_id() ) {
			llms()->assets->enqueue_script( 'llms-notifications' );
		}

		// Doesn't seem like there's any reason to enqueue this script on the frontend.
		wp_enqueue_script( 'llms-ajax', LLMS_PLUGIN_URL . 'assets/js/llms-ajax' . LLMS_ASSETS_SUFFIX . '.js', array( 'jquery' ), llms()->version, true );

		// I think we only need this on account and checkout pages.
		llms()->assets->enqueue_script( 'llms-form-checkout' );

		if ( is_singular( 'llms_quiz' ) ) {
			llms()->assets->enqueue_script( 'llms-quiz' );
		}

		llms()->assets->register_script( 'llms-favorites' );
		if ( ( is_lesson() || is_course() ) && true === llms_is_favorites_enabled() ) {
			llms()->assets->enqueue_script( 'llms-favorites' );
		}

		llms()->assets->register_script( 'llms-iziModal' );
		if ( is_llms_account_page() ) {
			llms()->assets->enqueue_script( 'llms-iziModal' );
		}

		self::enqueue_inline_scripts();
		self::enqueue_locale_scripts();

	}

	/**
	 * Enqueue inline scripts.
	 *
	 * @since 4.4.0
	 * @since 7.0.0 Include checkout page script data for AJAX-powered gateways.
	 *
	 * @return void
	 */
	protected static function enqueue_inline_scripts() {

		// Ensure the main llms object exists.
		llms()->assets->enqueue_inline( 'llms-obj', 'window.llms = window.llms || {};', 'footer', 5 );

		// Define inline scripts.
		$scripts = array(
			'llms-ajaxurl'           => 'window.llms.ajaxurl = "' . admin_url( 'admin-ajax.php', is_ssl() ? 'https' : 'http' ) . '";',
			'llms-ajax-nonce'        => 'window.llms.ajax_nonce = "' . wp_create_nonce( LLMS_AJAX::NONCE ) . '";',
			'llms-tracking-settings' => "window.llms.tracking = '" . wp_json_encode( llms()->events()->get_client_settings() ) . "';",
			'llms-LLMS-obj'          => 'window.LLMS = window.LLMS || {};',
			'llms-l10n'              => 'window.LLMS.l10n = window.LLMS.l10n || {}; window.LLMS.l10n.strings = ' . LLMS_L10n::get_js_strings( true ) . ';',
		);

		$checkout_urls = self::get_checkout_urls();
		if ( ! empty( $checkout_urls ) ) {
			$scripts['llms-checkout-urls'] = "window.llms.checkoutUrls = JSON.parse( '" . wp_json_encode( $checkout_urls ) . "' );";
		}

		// Enqueue them.
		foreach ( $scripts as $handle => $script ) {
			llms()->assets->enqueue_inline( $handle, $script, 'footer' );
		}

	}

	/**
	 * Enqueue dependencies and inline script data for form localization
	 *
	 * @since 5.0.0
	 *
	 * @return void
	 */
	protected static function enqueue_locale_scripts() {

		if ( is_llms_account_page() || is_llms_checkout() ) {
			llms()->assets->enqueue_script( 'llms-select2' );
			llms()->assets->enqueue_inline(
				'llms-countries-locale',
				"window.llms.address_info = '" . wp_json_encode( llms_get_countries_address_info() ) . "';",
				'footer',
				20
			);
		}

	}

	/**
	 * Retrieves AJAX checkout URLs used for checkout and switching payment source on the student dashboard.
	 *
	 * @since 7.0.0
	 *
	 * @return array
	 */
	private static function get_checkout_urls() {
		$urls       = array();
		$controller = LLMS_Controller_Checkout::instance();

		if ( is_llms_checkout() ) {
			$urls = array(
				'createPendingOrder'  => $controller->get_url( $controller::ACTION_CREATE_PENDING_ORDER ),
				'confirmPendingOrder' => $controller->get_url( $controller::ACTION_CONFIRM_PENDING_ORDER ),
			);
		} elseif ( is_llms_account_page() && 'orders' === LLMS_Student_Dashboard::get_current_tab( 'slug' ) && is_numeric( get_query_var( 'orders', false ) ) ) {
			$urls = array(
				'switchPaymentSource' => $controller->get_url( $controller::ACTION_SWITCH_PAYMENT_SOURCE ),
			);
		}

		return $urls;

	}

	/**
	 * Output inline scripts in the footer
	 *
	 * @since 3.4.1
	 * @since 4.4.0 Use `LLMS_Assets::output_inline()` to output scripts.
	 *
	 * @return void
	 */
	public static function output_footer_scripts() {
		llms()->assets->output_inline( 'footer' );
	}

	/**
	 * Output inline scripts in the header
	 *
	 * @since 3.4.1
	 * @since 4.4.0 Use `LLMS_Assets::output_inline()` to output scripts.
	 *
	 * @return void

Top ↑

Methods Methods


Top ↑

Changelog Changelog

Changelog
Version Description
6.0.0 Removed deprecated items.
  • LLMS_Frontend_Assets::enqueue_inline_pw_script() method
  • LLMS_Frontend_Assets::enqueue_inline_script() method
  • LLMS_Frontend_Assets::is_inline_script_enqueued() method
4.4.0 Method enqueue_inline_script() is deprecated in favor of LLMS_Assets::enqueue_inline(). Method is_inline_script_enqueued() is deprecated in favor of LLMS_Frontend_Assets::is_inline_enqueued(). Private properties $enqueued_inline_scripts and $inline_scripts have been removed. Removed private methods get_inline_scripts() and output_inline_scripts().
4.0.0 Remove JS dependencies "collapse" and "transition".
3.36.0 Localize tracking with client-side settings.
3.35.0 Explicitly define asset versions.
1.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.