<?php

[0] Fix | Delete

[1] Fix | Delete

namespace WPForms\Admin\Education\Pointers;

[2] Fix | Delete

[3] Fix | Delete

use WPForms\Integrations\Stripe;

[4] Fix | Delete

use WPForms\Admin\Payments\Views\Overview\Page as PaymentsPage;

[5] Fix | Delete

[6] Fix | Delete

/**

[7] Fix | Delete

* Education class for handling Payments education pointer functionality.

[8] Fix | Delete

*

[9] Fix | Delete

* This class extends the abstract Pointers class and provides functionality

[10] Fix | Delete

* specific to the Payments feature in WPForms.

[11] Fix | Delete

*

[12] Fix | Delete

* @since 1.8.8

[13] Fix | Delete

*/

[14] Fix | Delete

class Payment extends Pointer {

[15] Fix | Delete

[16] Fix | Delete

/**

[17] Fix | Delete

* Unique ID for the pointer.

[18] Fix | Delete

*

[19] Fix | Delete

* @since 1.8.8

[20] Fix | Delete

*

[21] Fix | Delete

* @var string

[22] Fix | Delete

*/

[23] Fix | Delete

protected $pointer_id = 'admin_menu_payments';

[24] Fix | Delete

[25] Fix | Delete

/**

[26] Fix | Delete

* Selector for the pointer.

[27] Fix | Delete

*

[28] Fix | Delete

* @since 1.8.8

[29] Fix | Delete

*

[30] Fix | Delete

* @var string

[31] Fix | Delete

*/

[32] Fix | Delete

protected $selector = '[href$="-payments"]';

[33] Fix | Delete

[34] Fix | Delete

/**

[35] Fix | Delete

* Make sure that pointer is visible across other dashboard pages.

[36] Fix | Delete

*

[37] Fix | Delete

* @since 1.8.8

[38] Fix | Delete

*

[39] Fix | Delete

* @var bool

[40] Fix | Delete

*/

[41] Fix | Delete

protected $top_level_visible = true;

[42] Fix | Delete

[43] Fix | Delete

/**

[44] Fix | Delete

* Determine if the Payments feature pointer is allowed to load.

[45] Fix | Delete

*

[46] Fix | Delete

* Checks various conditions to determine if the Payments feature pointer

[47] Fix | Delete

* should be allowed to load for the current user.

[48] Fix | Delete

*

[49] Fix | Delete

* @since 1.8.8

[50] Fix | Delete

*

[51] Fix | Delete

* @return bool

[52] Fix | Delete

*/

[53] Fix | Delete

protected function allow_load(): bool {

[54] Fix | Delete

[55] Fix | Delete

// Bail early if the user doesn't have a Lite, Basic, or Plus license.

[56] Fix | Delete

if ( ! in_array( $this->get_license_type(), [ 'lite', 'basic', 'plus' ], true ) ) {

[57] Fix | Delete

return false;

[58] Fix | Delete

}

[59] Fix | Delete

[60] Fix | Delete

// Bail early if it has been less than 90 days since activation or the installation wasn't upgraded.

[61] Fix | Delete

if ( ! get_option( 'wpforms_version_upgraded_from' ) || wpforms_get_activated_timestamp() > ( time() - 90 * DAY_IN_SECONDS ) ) {

[62] Fix | Delete

return false;

[63] Fix | Delete

}

[64] Fix | Delete

[65] Fix | Delete

// Bail early if Stripe account is connected.

[66] Fix | Delete

if ( Stripe\Helpers::has_stripe_keys() ) {

[67] Fix | Delete

return false;

[68] Fix | Delete

}

[69] Fix | Delete

[70] Fix | Delete

// Bail early if the user doesn't have the capability to manage options.

[71] Fix | Delete

if ( ! wpforms_current_user_can() ) {

[72] Fix | Delete

return false;

[73] Fix | Delete

}

[74] Fix | Delete

[75] Fix | Delete

// Bail early if there are no published forms.

[76] Fix | Delete

if ( ! wpforms()->obj( 'form' )->forms_exist() ) {

[77] Fix | Delete

return false;

[78] Fix | Delete

}

[79] Fix | Delete

[80] Fix | Delete

// All conditions passed, allow loading the Payments feature pointer.

[81] Fix | Delete

return true;

[82] Fix | Delete

}

[83] Fix | Delete

[84] Fix | Delete

/**

[85] Fix | Delete

* Enqueue assets for the pointer.

[86] Fix | Delete

*

[87] Fix | Delete

* @since 1.8.8

[88] Fix | Delete

*/

[89] Fix | Delete

public function enqueue_assets() {

[90] Fix | Delete

[91] Fix | Delete

// Enqueue the pointer static assets.

[92] Fix | Delete

parent::enqueue_assets();

[93] Fix | Delete

[94] Fix | Delete

$min = wpforms_get_min_suffix();

[95] Fix | Delete

[96] Fix | Delete

wp_enqueue_script(

[97] Fix | Delete

'wpforms-education-pointers-payment',

[98] Fix | Delete

WPFORMS_PLUGIN_URL . "assets/js/admin/education/pointers/payment{$min}.js",

[99] Fix | Delete

[ 'wp-pointer' ],

[100] Fix | Delete

WPFORMS_VERSION,

[101] Fix | Delete

true

[102] Fix | Delete

);

[103] Fix | Delete

[104] Fix | Delete

$admin_l10n = [

[105] Fix | Delete

'pointer' => sanitize_key( $this->pointer_id ),

[106] Fix | Delete

'nonce' => sanitize_text_field( $this->get_nonce_token() ),

[107] Fix | Delete

];

[108] Fix | Delete

[109] Fix | Delete

wp_localize_script(

[110] Fix | Delete

'wpforms-education-pointers-payment',

[111] Fix | Delete

'wpforms_education_pointers_payment',

[112] Fix | Delete

$admin_l10n

[113] Fix | Delete

);

[114] Fix | Delete

}

[115] Fix | Delete

[116] Fix | Delete

/**

[117] Fix | Delete

* Set arguments for the Payments feature pointer.

[118] Fix | Delete

*

[119] Fix | Delete

* @since 1.8.8

[120] Fix | Delete

*/

[121] Fix | Delete

protected function set_args() {

[122] Fix | Delete

[123] Fix | Delete

$this->args['title'] = __( 'Payment and Donation Forms are here!', 'wpforms-lite' );

[124] Fix | Delete

$this->args['message'] = sprintf( /* translators: %1$s - Payments page URL. */

[125] Fix | Delete

__(

[126] Fix | Delete

'Now available for you: create forms that accept credit cards, Apple Pay, and Google Pay payments. Visit our new <a href="%1$s" id="wpforms-education-pointers-payments">Payments area</a> to get started.',

[127] Fix | Delete

'wpforms-lite'

[128] Fix | Delete

),

[129] Fix | Delete

esc_url( PaymentsPage::get_url() )

[130] Fix | Delete

);

[131] Fix | Delete

}

[132] Fix | Delete

[133] Fix | Delete

/**

[134] Fix | Delete

* Retrieve the current installation license type in lowercase.

[135] Fix | Delete

* If no license type is found, defaults to 'lite'.

[136] Fix | Delete

*

[137] Fix | Delete

* @since 1.8.8

[138] Fix | Delete

*

[139] Fix | Delete

* @return string

[140] Fix | Delete

*/

[141] Fix | Delete

private function get_license_type(): string {

[142] Fix | Delete

[143] Fix | Delete

$type = wpforms_get_license_type();

[144] Fix | Delete

[145] Fix | Delete

// Set default to 'lite' if no license type is detected.

[146] Fix | Delete

if ( empty( $type ) ) {

[147] Fix | Delete

$type = 'lite';

[148] Fix | Delete

}

[149] Fix | Delete

[150] Fix | Delete

return $type;

[151] Fix | Delete

}

[152] Fix | Delete

}

[153] Fix | Delete

[154] Fix | Delete