<?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

use WPForms\Migrations\Base as MigrationsBase;

[6] Fix | Delete

[7] Fix | Delete

/**

[8] Fix | Delete

* Education class for handling Payments education pointer functionality.

[9] Fix | Delete

*

[10] Fix | Delete

* This class extends the abstract Pointers class and provides functionality

[11] Fix | Delete

* specific to the Payments feature in WPForms.

[12] Fix | Delete

*

[13] Fix | Delete

* @since 1.8.8

[14] Fix | Delete

*/

[15] Fix | Delete

class Payment extends Pointer {

[16] Fix | Delete

[17] Fix | Delete

/**

[18] Fix | Delete

* Unique ID for the pointer.

[19] Fix | Delete

*

[20] Fix | Delete

* @since 1.8.8

[21] Fix | Delete

*

[22] Fix | Delete

* @var string

[23] Fix | Delete

*/

[24] Fix | Delete

protected $pointer_id = 'admin_menu_payments';

[25] Fix | Delete

[26] Fix | Delete

/**

[27] Fix | Delete

* Selector for the pointer.

[28] Fix | Delete

*

[29] Fix | Delete

* @since 1.8.8

[30] Fix | Delete

*

[31] Fix | Delete

* @var string

[32] Fix | Delete

*/

[33] Fix | Delete

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

[34] Fix | Delete

[35] Fix | Delete

/**

[36] Fix | Delete

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

[37] Fix | Delete

*

[38] Fix | Delete

* @since 1.8.8

[39] Fix | Delete

*

[40] Fix | Delete

* @var bool

[41] Fix | Delete

*/

[42] Fix | Delete

protected $top_level_visible = true;

[43] Fix | Delete

[44] Fix | Delete

/**

[45] Fix | Delete

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

[46] Fix | Delete

*

[47] Fix | Delete

* Checks various conditions to determine if the Payments feature pointer

[48] Fix | Delete

* should be allowed to load for the current user.

[49] Fix | Delete

*

[50] Fix | Delete

* @since 1.8.8

[51] Fix | Delete

*

[52] Fix | Delete

* @return bool

[53] Fix | Delete

*/

[54] Fix | Delete

protected function allow_load(): bool {

[55] Fix | Delete

[56] Fix | Delete

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

[57] Fix | Delete

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

[58] Fix | Delete

return false;

[59] Fix | Delete

}

[60] Fix | Delete

[61] Fix | Delete

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

[62] Fix | Delete

if (

[63] Fix | Delete

! get_option( MigrationsBase::PREVIOUS_CORE_VERSION_OPTION_NAME ) ||

[64] Fix | Delete

wpforms_get_activated_timestamp() > ( time() - 90 * DAY_IN_SECONDS )

[65] Fix | Delete

) {

[66] Fix | Delete

return false;

[67] Fix | Delete

}

[68] Fix | Delete

[69] Fix | Delete

// Bail early if a Stripe account is connected.

[70] Fix | Delete

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

[71] Fix | Delete

return false;

[72] Fix | Delete

}

[73] Fix | Delete

[74] Fix | Delete

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

[75] Fix | Delete

if ( ! wpforms_current_user_can() ) {

[76] Fix | Delete

return false;

[77] Fix | Delete

}

[78] Fix | Delete

[79] Fix | Delete

// Bail early if there are no published forms.

[80] Fix | Delete

$forms_obj = wpforms()->obj( 'form' );

[81] Fix | Delete

[82] Fix | Delete

return $forms_obj && $forms_obj->forms_exist();

[83] Fix | Delete

}

[84] Fix | Delete

[85] Fix | Delete

/**

[86] Fix | Delete

* Enqueue assets for the pointer.

[87] Fix | Delete

*

[88] Fix | Delete

* @since 1.8.8

[89] Fix | Delete

*/

[90] Fix | Delete

public function enqueue_assets() {

[91] Fix | Delete

[92] Fix | Delete

// Enqueue the pointer static assets.

[93] Fix | Delete

parent::enqueue_assets();

[94] Fix | Delete

[95] Fix | Delete

$min = wpforms_get_min_suffix();

[96] Fix | Delete

[97] Fix | Delete

wp_enqueue_script(

[98] Fix | Delete

'wpforms-education-pointers-payment',

[99] Fix | Delete

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

[100] Fix | Delete

[ 'wp-pointer' ],

[101] Fix | Delete

WPFORMS_VERSION,

[102] Fix | Delete

true

[103] Fix | Delete

);

[104] Fix | Delete

[105] Fix | Delete

$admin_l10n = [

[106] Fix | Delete

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

[107] Fix | Delete

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

[108] Fix | Delete

];

[109] Fix | Delete

[110] Fix | Delete

wp_localize_script(

[111] Fix | Delete

'wpforms-education-pointers-payment',

[112] Fix | Delete

'wpforms_education_pointers_payment',

[113] Fix | Delete

$admin_l10n

[114] Fix | Delete

);

[115] Fix | Delete

}

[116] Fix | Delete

[117] Fix | Delete

/**

[118] Fix | Delete

* Set arguments for the Payments feature pointer.

[119] Fix | Delete

*

[120] Fix | Delete

* @since 1.8.8

[121] Fix | Delete

*

[122] Fix | Delete

* @noinspection HtmlUnknownTarget

[123] Fix | Delete

*/

[124] Fix | Delete

protected function set_args() {

[125] Fix | Delete

[126] Fix | Delete

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

[127] Fix | Delete

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

[128] Fix | Delete

__(

[129] 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.',

[130] Fix | Delete

'wpforms-lite'

[131] Fix | Delete

),

[132] Fix | Delete

esc_url( PaymentsPage::get_url() )

[133] Fix | Delete

);

[134] Fix | Delete

}

[135] Fix | Delete

[136] Fix | Delete

/**

[137] Fix | Delete

* Retrieve the current installation license type in the lowercase.

[138] Fix | Delete

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

[139] Fix | Delete

*

[140] Fix | Delete

* @since 1.8.8

[141] Fix | Delete

*

[142] Fix | Delete

* @return string

[143] Fix | Delete

*/

[144] Fix | Delete

private function get_license_type(): string {

[145] Fix | Delete

[146] Fix | Delete

$type = wpforms_get_license_type();

[147] Fix | Delete

[148] Fix | Delete

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

[149] Fix | Delete

if ( empty( $type ) ) {

[150] Fix | Delete

$type = 'lite';

[151] Fix | Delete

}

[152] Fix | Delete

[153] Fix | Delete

return $type;

[154] Fix | Delete

}

[155] Fix | Delete

}

[156] Fix | Delete

[157] Fix | Delete