FM / Builder

/home/techb158/public_html/wp-content/plugins/wpforms-lite/src/Admin/Education/Builder/

/home/techb158/public_html/wp-content/plugins/wpforms-lite/src/Admin/Education/Builder

Name	Size	Mode	Actions
AddonBanners.php	14572	0666	edit dl rm
Calculations.php	8248	0666	edit dl rm
Captcha.php	8106	0666	edit dl rm
Fields.php	1632	0666	edit dl rm
Gdpr.php	2677	0666	edit dl rm
Geolocation.php	3483	0666	edit dl rm
Panel.php	1297	0666	edit dl rm
Payments.php	1255	0666	edit dl rm
PDF.php	5487	0666	edit dl rm
Providers.php	1432	0666	edit dl rm
QrCode.php	2630	0666	edit dl rm
Quiz.php	5583	0666	edit dl rm
Ranking.php	4211	0666	edit dl rm
Settings.php	1234	0666	edit dl rm

Edit: /home/techb158/public_html/wp-content/plugins/wpforms-lite/src/Admin/Education/Builder/Ranking.php (4211B)

<?php

namespace WPForms\Admin\Education\Builder;

use WPForms\Admin\Education\AddonsItemBase;

/**
 * Builder/Ranking education notice for choice-based fields.
 *
 * @since 2.0.0.5
 */
class Ranking extends AddonsItemBase {

/**
	 * Indicate if the current Education feature is allowed to load.
	 *
	 * @since        2.0.0.5
	 *
	 * @return bool
	 *
	 * @noinspection ReturnTypeCanBeDeclaredInspection
	 * @noinspection PhpMissingReturnTypeInspection
	 */
	public function allow_load() {

return wpforms_is_admin_page( 'builder' ) || wp_doing_ajax();
	}

/**
	 * Hooks.
	 *
	 * @since        2.0.0.5
	 *
	 * @noinspection ReturnTypeCanBeDeclaredInspection
	 */
	public function hooks() {

add_action( 'wpforms_field_options_after_label', [ $this, 'ranking_fields' ], 10, 2 );
	}

/**
	 * Display the "Let People Rank Their Choices" education notice.
	 *
	 * @since        2.0.0.5
	 *
	 * @param array  $field    Field data.
	 * @param object $instance Builder instance.
	 *
	 * @noinspection ReturnTypeCanBeDeclaredInspection
	 * @noinspection PhpMissingParamTypeInspection
	 * @noinspection HtmlUnknownTarget
	 */
	public function ranking_fields( $field, $instance ) {

if ( ! in_array( $field['type'], [ 'radio', 'checkbox', 'select' ], true ) ) {
			return;
		}

if ( ! $this->is_ranking_edu_notice_needed() ) {
			return;
		}

$form_id         = ! empty( $instance->form_id ) ? (int) $instance->form_id : 0;
		$dismissed       = (array) get_user_meta( get_current_user_id(), 'wpforms_dismissed', true );
		$ranking_section = "builder-form-{$form_id}-field-options-ranking-notice";

if ( ! empty( $dismissed[ 'edu-' . $ranking_section ] ) ) {
			return;
		}

if ( $this->is_quiz_edu_notice_visible( $form_id, $dismissed ) ) {
			return;
		}

printf(
			'<div class="wpforms-alert wpforms-alert-info wpforms-educational-alert wpforms-field-educational-alert wpforms-dismiss-container">
				<button type="button" class="wpforms-dismiss-button" title="%1$s" data-section="%2$s"></button>
				<div class="wpforms-field-edu-alert-heading">
					<h3>%3$s</h3>
					<span class="wpforms-badge wpforms-badge-sm wpforms-badge-green wpforms-badge-rounded">%4$s</span>
				</div>
				<p>%5$s</p>
				<a href="%6$s" target="_blank" rel="noopener noreferrer">%7$s</a>
			</div>',
			esc_html__( 'Dismiss this notice.', 'wpforms-lite' ),
			esc_attr( $ranking_section ),
			esc_html__( 'Let People Rank Their Choices', 'wpforms-lite' ),
			esc_html__( 'NEW', 'wpforms-lite' ),
			esc_html__( 'Want to know what your visitors really prioritize? Add a Ranking Field and let them sort choices. Perfect for surveys, product feedback, and voting.', 'wpforms-lite' ),
			esc_url( wpforms_utm_link( 'https://wpforms.com/docs/ranking-field/', 'Ranking Education', 'Ranking Documentation' ) ),
			esc_html__( 'Learn More', 'wpforms-lite' )
		);
	}

/**
	 * Whether the ranking education notice should be shown based on the surveys-polls addon state.
	 *
	 * @since 2.0.0.5
	 *
	 * @return bool True when the notice is needed.
	 */
	private function is_ranking_edu_notice_needed(): bool {

$addon = (array) $this->addons->get_addon( 'surveys-polls' );

if ( empty( $addon ) || empty( $addon['action'] ) || empty( $addon['status'] ) ) {
			return false;
		}

return ! ( $addon['status'] === 'active' && $addon['action'] !== 'upgrade' );
	}

/**
	 * Whether the quiz education notice is currently visible (present but not yet dismissed).
	 *
	 * @since 2.0.0.5
	 *
	 * @param int   $form_id   Current form ID.
	 * @param array $dismissed User's dismissed notices keyed by section slug.
	 *
	 * @return bool
	 */
	private function is_quiz_edu_notice_visible( int $form_id, array $dismissed ): bool {

$quiz_addon = (array) $this->addons->get_addon( 'quiz' );

// When the quiz addon is active and requires no upgrade its education notice never renders.
		if (
			empty( $quiz_addon ) ||
			empty( $quiz_addon['action'] ) ||
			empty( $quiz_addon['status'] ) ||
			( $quiz_addon['status'] === 'active' && $quiz_addon['action'] !== 'upgrade' )
		) {
			return false;
		}

$quiz_section = "builder-form-{$form_id}-field-options-quiz-notice";

return empty( $dismissed[ 'edu-' . $quiz_section ] );
	}
}

is_ranking_edu_notice_needed() ) { return; } $form_id = ! empty( $instance->form_id ) ? (int) $instance->form_id : 0; $dismissed = (array) get_user_meta( get_current_user_id(), 'wpforms_dismissed', true ); $ranking_section = "builder-form-{$form_id}-field-options-ranking-notice"; if ( ! empty( $dismissed[ 'edu-' . $ranking_section ] ) ) { return; } if ( $this->is_quiz_edu_notice_visible( $form_id, $dismissed ) ) { return; } printf( '

%3$s

%4$s

%5$s

%7$s

', esc_html__( 'Dismiss this notice.', 'wpforms-lite' ), esc_attr( $ranking_section ), esc_html__( 'Let People Rank Their Choices', 'wpforms-lite' ), esc_html__( 'NEW', 'wpforms-lite' ), esc_html__( 'Want to know what your visitors really prioritize? Add a Ranking Field and let them sort choices. Perfect for surveys, product feedback, and voting.', 'wpforms-lite' ), esc_url( wpforms_utm_link( 'https://wpforms.com/docs/ranking-field/', 'Ranking Education', 'Ranking Documentation' ) ), esc_html__( 'Learn More', 'wpforms-lite' ) ); } /** * Whether the ranking education notice should be shown based on the surveys-polls addon state. * * @since 2.0.0.5 * * @return bool True when the notice is needed. */ private function is_ranking_edu_notice_needed(): bool { $addon = (array) $this->addons->get_addon( 'surveys-polls' ); if ( empty( $addon ) || empty( $addon['action'] ) || empty( $addon['status'] ) ) { return false; } return ! ( $addon['status'] === 'active' && $addon['action'] !== 'upgrade' ); } /** * Whether the quiz education notice is currently visible (present but not yet dismissed). * * @since 2.0.0.5 * * @param int $form_id Current form ID. * @param array $dismissed User's dismissed notices keyed by section slug. * * @return bool */ private function is_quiz_edu_notice_visible( int $form_id, array $dismissed ): bool { $quiz_addon = (array) $this->addons->get_addon( 'quiz' ); // When the quiz addon is active and requires no upgrade its education notice never renders. if ( empty( $quiz_addon ) || empty( $quiz_addon['action'] ) || empty( $quiz_addon['status'] ) || ( $quiz_addon['status'] === 'active' && $quiz_addon['action'] !== 'upgrade' ) ) { return false; } $quiz_section = "builder-form-{$form_id}-field-options-quiz-notice"; return empty( $dismissed[ 'edu-' . $quiz_section ] ); } }