<?php

[0] Fix | Delete

[1] Fix | Delete

namespace WPForms\Admin\Splash;

[2] Fix | Delete

[3] Fix | Delete

use WPForms\Migrations\Base as MigrationsBase;

[4] Fix | Delete

[5] Fix | Delete

trait SplashTrait {

[6] Fix | Delete

[7] Fix | Delete

/**

[8] Fix | Delete

* Default plugin version.

[9] Fix | Delete

*

[10] Fix | Delete

* @since 1.9.3

[11] Fix | Delete

*

[12] Fix | Delete

* @var string

[13] Fix | Delete

*/

[14] Fix | Delete

private $default_plugin_version = '1.8.6'; // The last version before the "What's New?" feature.

[15] Fix | Delete

[16] Fix | Delete

/**

[17] Fix | Delete

* Previous plugin version.

[18] Fix | Delete

*

[19] Fix | Delete

* @since 1.9.3

[20] Fix | Delete

*

[21] Fix | Delete

* @var string

[22] Fix | Delete

*/

[23] Fix | Delete

private $previous_plugin_version;

[24] Fix | Delete

[25] Fix | Delete

/**

[26] Fix | Delete

* Latest splash version.

[27] Fix | Delete

*

[28] Fix | Delete

* @since 1.9.3

[29] Fix | Delete

*

[30] Fix | Delete

* @var string

[31] Fix | Delete

*/

[32] Fix | Delete

private $latest_splash_version;

[33] Fix | Delete

[34] Fix | Delete

/**

[35] Fix | Delete

* Get the latest splash version.

[36] Fix | Delete

*

[37] Fix | Delete

* @since 1.8.7

[38] Fix | Delete

*

[39] Fix | Delete

* @return string Splash version.

[40] Fix | Delete

*/

[41] Fix | Delete

private function get_latest_splash_version(): string {

[42] Fix | Delete

[43] Fix | Delete

if ( $this->latest_splash_version ) {

[44] Fix | Delete

return $this->latest_splash_version;

[45] Fix | Delete

}

[46] Fix | Delete

[47] Fix | Delete

$this->latest_splash_version = get_option( 'wpforms_splash_version', '' );

[48] Fix | Delete

[49] Fix | Delete

// Create option if it doesn't exist.

[50] Fix | Delete

if ( empty( $this->latest_splash_version ) ) {

[51] Fix | Delete

$this->latest_splash_version = $this->default_plugin_version;

[52] Fix | Delete

[53] Fix | Delete

update_option( 'wpforms_splash_version', $this->latest_splash_version );

[54] Fix | Delete

}

[55] Fix | Delete

[56] Fix | Delete

return $this->latest_splash_version;

[57] Fix | Delete

}

[58] Fix | Delete

[59] Fix | Delete

/**

[60] Fix | Delete

* Update option with the latest splash version.

[61] Fix | Delete

*

[62] Fix | Delete

* @since 1.8.7

[63] Fix | Delete

*/

[64] Fix | Delete

private function update_splash_version(): void {

[65] Fix | Delete

[66] Fix | Delete

update_option( 'wpforms_splash_version', $this->get_major_version( WPFORMS_VERSION ) );

[67] Fix | Delete

}

[68] Fix | Delete

[69] Fix | Delete

/**

[70] Fix | Delete

* Get user license type.

[71] Fix | Delete

*

[72] Fix | Delete

* @since 1.8.8

[73] Fix | Delete

*

[74] Fix | Delete

* @return string

[75] Fix | Delete

*/

[76] Fix | Delete

private function get_user_license(): string {

[77] Fix | Delete

[78] Fix | Delete

$license = wpforms_get_license_type();

[79] Fix | Delete

[80] Fix | Delete

if ( empty( $license ) ) {

[81] Fix | Delete

$license = 'lite';

[82] Fix | Delete

}

[83] Fix | Delete

[84] Fix | Delete

/**

[85] Fix | Delete

* License type used for splash screen.

[86] Fix | Delete

*

[87] Fix | Delete

* @since 1.8.8

[88] Fix | Delete

*

[89] Fix | Delete

* @param string $license License type.

[90] Fix | Delete

*/

[91] Fix | Delete

return (string) apply_filters( 'wpforms_admin_splash_splashtrait_get_user_license', $license );

[92] Fix | Delete

}

[93] Fix | Delete

[94] Fix | Delete

/**

[95] Fix | Delete

* Get user version.

[96] Fix | Delete

*

[97] Fix | Delete

* @since 1.9.7

[98] Fix | Delete

*

[99] Fix | Delete

* @return string User version.

[100] Fix | Delete

*/

[101] Fix | Delete

private function get_user_version(): string {

[102] Fix | Delete

[103] Fix | Delete

/**

[104] Fix | Delete

* User version used for splash screen.

[105] Fix | Delete

*

[106] Fix | Delete

* @since 1.9.7

[107] Fix | Delete

*

[108] Fix | Delete

* @param string $version User version.

[109] Fix | Delete

*/

[110] Fix | Delete

return (string) apply_filters( 'wpforms_admin_splash_splashtrait_get_user_version', $this->get_major_version( WPFORMS_VERSION ) );

[111] Fix | Delete

}

[112] Fix | Delete

[113] Fix | Delete

/**

[114] Fix | Delete

* Get default splash modal data.

[115] Fix | Delete

*

[116] Fix | Delete

* @since 1.8.7

[117] Fix | Delete

*

[118] Fix | Delete

* @return array Splash modal data.

[119] Fix | Delete

*/

[120] Fix | Delete

private function get_default_data(): array {

[121] Fix | Delete

[122] Fix | Delete

return [

[123] Fix | Delete

'license' => $this->get_user_license(),

[124] Fix | Delete

'display_notice' => false,

[125] Fix | Delete

'update_url' => $this->get_update_url(),

[126] Fix | Delete

'buttons' => [

[127] Fix | Delete

'get_started' => __( 'Get Started', 'wpforms-lite' ),

[128] Fix | Delete

'learn_more' => __( 'Learn More', 'wpforms-lite' ),

[129] Fix | Delete

],

[130] Fix | Delete

'header' => [

[131] Fix | Delete

'image' => WPFORMS_PLUGIN_URL . 'assets/images/splash/sullie.svg',

[132] Fix | Delete

'title' => __( 'What’s New in WPForms', 'wpforms-lite' ),

[133] Fix | Delete

'description' => __( 'We\'ve added some great new features to help grow your business and generate more leads. Here are the highlights...', 'wpforms-lite' ),

[134] Fix | Delete

],

[135] Fix | Delete

'footer' => [

[136] Fix | Delete

'title' => __( 'Start Building Smarter WordPress Forms', 'wpforms-lite' ),

[137] Fix | Delete

'description' => __( 'Add advanced form fields and conditional logic, plus offer more payment options, manage entries, and connect to your favorite marketing tools – all when you purchase a premium plan.', 'wpforms-lite' ),

[138] Fix | Delete

'upgrade' => [

[139] Fix | Delete

'text' => __( 'Upgrade to Pro Today', 'wpforms-lite' ),

[140] Fix | Delete

'url' => wpforms_admin_upgrade_link( 'splash-modal', 'Upgrade to Pro Today' ),

[141] Fix | Delete

],

[142] Fix | Delete

],

[143] Fix | Delete

];

[144] Fix | Delete

}

[145] Fix | Delete

[146] Fix | Delete

/**

[147] Fix | Delete

* Get plugin update URL.

[148] Fix | Delete

*

[149] Fix | Delete

* @since 1.9.7

[150] Fix | Delete

*

[151] Fix | Delete

* @return string Update URL.

[152] Fix | Delete

*/

[153] Fix | Delete

private function get_update_url(): string {

[154] Fix | Delete

[155] Fix | Delete

$plugin_slug = defined( 'WPFORMS_PLUGIN_DIR' ) ? plugin_basename( WPFORMS_PLUGIN_DIR ) : 'wpforms';

[156] Fix | Delete

$plugin_path = $plugin_slug . '/wpforms.php';

[157] Fix | Delete

[158] Fix | Delete

return wp_nonce_url(

[159] Fix | Delete

self_admin_url( 'update.php?action=upgrade-plugin&plugin=' . $plugin_path ),

[160] Fix | Delete

'upgrade-plugin_' . $plugin_path

[161] Fix | Delete

);

[162] Fix | Delete

}

[163] Fix | Delete

[164] Fix | Delete

/**

[165] Fix | Delete

* Prepare buttons.

[166] Fix | Delete

*

[167] Fix | Delete

* @since 1.8.7

[168] Fix | Delete

*

[169] Fix | Delete

* @param array $buttons Buttons.

[170] Fix | Delete

*

[171] Fix | Delete

* @return array Prepared buttons.

[172] Fix | Delete

*/

[173] Fix | Delete

private function prepare_buttons( array $buttons ): array {

[174] Fix | Delete

[175] Fix | Delete

return array_map(

[176] Fix | Delete

function ( $button ) {

[177] Fix | Delete

return [

[178] Fix | Delete

'url' => $this->prepare_url( $button['url'] ),

[179] Fix | Delete

'text' => $button['text'],

[180] Fix | Delete

];

[181] Fix | Delete

},

[182] Fix | Delete

$buttons

[183] Fix | Delete

);

[184] Fix | Delete

}

[185] Fix | Delete

[186] Fix | Delete

/**

[187] Fix | Delete

* Prepare URL.

[188] Fix | Delete

*

[189] Fix | Delete

* @since 1.8.7

[190] Fix | Delete

*

[191] Fix | Delete

* @param string $url URL.

[192] Fix | Delete

*

[193] Fix | Delete

* @return string Prepared URL.

[194] Fix | Delete

*/

[195] Fix | Delete

private function prepare_url( string $url ): string {

[196] Fix | Delete

[197] Fix | Delete

$replace_tags = [

[198] Fix | Delete

'{admin_url}' => admin_url(),

[199] Fix | Delete

'{license_key}' => wpforms_get_license_key(),

[200] Fix | Delete

];

[201] Fix | Delete

[202] Fix | Delete

return str_replace( array_keys( $replace_tags ), array_values( $replace_tags ), $url );

[203] Fix | Delete

}

[204] Fix | Delete

[205] Fix | Delete

/**

[206] Fix | Delete

* Get block layout.

[207] Fix | Delete

*

[208] Fix | Delete

* @since 1.8.7

[209] Fix | Delete

*

[210] Fix | Delete

* @param array $image Image data.

[211] Fix | Delete

*

[212] Fix | Delete

* @return string Block layout.

[213] Fix | Delete

*/

[214] Fix | Delete

private function get_block_layout( array $image ): string {

[215] Fix | Delete

[216] Fix | Delete

$image_type = $image['type'] ?? 'icon';

[217] Fix | Delete

[218] Fix | Delete

switch ( $image_type ) {

[219] Fix | Delete

case 'icon':

[220] Fix | Delete

$layout = 'one-third-two-thirds';

[221] Fix | Delete

break;

[222] Fix | Delete

[223] Fix | Delete

case 'illustration':

[224] Fix | Delete

$layout = 'fifty-fifty';

[225] Fix | Delete

break;

[226] Fix | Delete

[227] Fix | Delete

default:

[228] Fix | Delete

$layout = 'full-width';

[229] Fix | Delete

break;

[230] Fix | Delete

}

[231] Fix | Delete

[232] Fix | Delete

return $layout;

[233] Fix | Delete

}

[234] Fix | Delete

[235] Fix | Delete

/**

[236] Fix | Delete

* Get a major version.

[237] Fix | Delete

*

[238] Fix | Delete

* @since 1.8.7.2

[239] Fix | Delete

*

[240] Fix | Delete

* @param string $version Version.

[241] Fix | Delete

*

[242] Fix | Delete

* @return string Major version.

[243] Fix | Delete

*/

[244] Fix | Delete

private function get_major_version( $version ): string {

[245] Fix | Delete

[246] Fix | Delete

// Allow only digits and dots.

[247] Fix | Delete

$clean_version = preg_replace( '/[^0-9.]/', '.', $version );

[248] Fix | Delete

[249] Fix | Delete

// Get version parts.

[250] Fix | Delete

$version_parts = explode( '.', $clean_version );

[251] Fix | Delete

[252] Fix | Delete

// If a version has more than 3 parts - use only first 3. Get block data only for major versions.

[253] Fix | Delete

if ( count( $version_parts ) > 3 ) {

[254] Fix | Delete

$version = implode( '.', array_slice( $version_parts, 0, 3 ) );

[255] Fix | Delete

}

[256] Fix | Delete

[257] Fix | Delete

return $version;

[258] Fix | Delete

}

[259] Fix | Delete

[260] Fix | Delete

/**

[261] Fix | Delete

* Get the WPForms plugin previous version.

[262] Fix | Delete

*

[263] Fix | Delete

* @since 1.8.8

[264] Fix | Delete

*

[265] Fix | Delete

* @return string Previous WPForms version.

[266] Fix | Delete

*/

[267] Fix | Delete

private function get_previous_plugin_version(): string {

[268] Fix | Delete

[269] Fix | Delete

if ( $this->previous_plugin_version ) {

[270] Fix | Delete

return $this->previous_plugin_version;

[271] Fix | Delete

}

[272] Fix | Delete

[273] Fix | Delete

$this->previous_plugin_version = get_option( MigrationsBase::PREVIOUS_CORE_VERSION_OPTION_NAME, '' );

[274] Fix | Delete

[275] Fix | Delete

if ( empty( $this->previous_plugin_version ) ) {

[276] Fix | Delete

$this->previous_plugin_version = $this->default_plugin_version; // The last version before the "What's New?" feature.

[277] Fix | Delete

}

[278] Fix | Delete

[279] Fix | Delete

return $this->previous_plugin_version;

[280] Fix | Delete

}

[281] Fix | Delete

}

[282] Fix | Delete

[283] Fix | Delete