%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
namespace WPForms\Admin\Splash;
use WPForms\Migrations\Base as MigrationsBase;
trait SplashTrait {
/**
* Get splash data version.
*
* @since 1.8.7
*
* @return string Splash data version.
*/
private function get_splash_data_version(): string {
return get_option( 'wpforms_splash_data_version', WPFORMS_VERSION );
}
/**
* Update splash data version.
*
* @since 1.8.7
*
* @param string $version Splash data version.
*/
private function update_splash_data_version( string $version ) {
update_option( 'wpforms_splash_data_version', $version );
}
/**
* Get the latest splash version.
*
* @since 1.8.7
*
* @return string Splash version.
*/
private function get_latest_splash_version(): string {
return get_option( 'wpforms_splash_version', '' );
}
/**
* Update option with the latest splash version.
*
* @since 1.8.7
*/
private function update_splash_version() {
update_option( 'wpforms_splash_version', $this->get_major_version( WPFORMS_VERSION ) );
}
/**
* Remove hide_welcome_block widget meta key for all users.
*
* @since 1.8.7
*/
private function remove_hide_welcome_block_widget_meta() {
global $wpdb;
// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
$wpdb->delete(
$wpdb->usermeta,
[
'meta_key' => 'wpforms_dash_widget_hide_welcome_block', // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key
]
);
}
/**
* Get user license type.
*
* @since 1.8.8
*
* @return string
*/
private function get_user_license(): string {
/**
* License type used for splash screen.
*
* @since 1.8.8
*
* @param string $license License type.
*/
return (string) apply_filters( 'wpforms_admin_splash_splashtrait_get_user_license', wpforms_get_license_type() );
}
/**
* Get default splash modal data.
*
* @since 1.8.7
*
* @return array Splash modal data.
*/
private function get_default_data(): array {
return [
'license' => $this->get_user_license(),
'buttons' => [
'get_started' => __( 'Get Started', 'wpforms-lite' ),
'learn_more' => __( 'Learn More', 'wpforms-lite' ),
],
'header' => [
'image' => WPFORMS_PLUGIN_URL . 'assets/images/splash/sullie.svg',
'title' => __( 'What’s New in WPForms', 'wpforms-lite' ),
'description' => __( 'Since you’ve been gone, we’ve added some great new features to help grow your business and generate more leads. Here are some highlights...', 'wpforms-lite' ),
],
'footer' => [
'title' => __( 'Start Building Smarter WordPress Forms', 'wpforms-lite' ),
'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' ),
'upgrade' => [
'text' => __( 'Upgrade to Pro Today', 'wpforms-lite' ),
'url' => wpforms_admin_upgrade_link( 'splash-modal', 'Upgrade to Pro Today' ),
],
],
];
}
/**
* Prepare buttons.
*
* @since 1.8.7
*
* @param array $buttons Buttons.
*
* @return array Prepared buttons.
*/
private function prepare_buttons( array $buttons ): array {
return array_map(
function ( $button ) {
return [
'url' => $this->prepare_url( $button['url'] ),
'text' => $button['text'],
];
},
$buttons
);
}
/**
* Prepare URL.
*
* @since 1.8.7
*
* @param string $url URL.
*
* @return string Prepared URL.
*/
private function prepare_url( string $url ): string {
$replace_tags = [
'{admin_url}' => admin_url(),
'{license_key}' => wpforms_get_license_key(),
];
return str_replace( array_keys( $replace_tags ), array_values( $replace_tags ), $url );
}
/**
* Get block layout.
*
* @since 1.8.7
*
* @param array $image Image data.
*
* @return string Block layout.
*/
private function get_block_layout( array $image ): string {
$image_type = $image['type'] ?? 'icon';
switch ( $image_type ) {
case 'icon':
$layout = 'one-third-two-thirds';
break;
case 'illustration':
$layout = 'fifty-fifty';
break;
default:
$layout = 'full-width';
break;
}
return $layout;
}
/**
* Get a major version.
*
* @since 1.8.7.2
*
* @param string $version Version.
*
* @return string Major version.
*/
private function get_major_version( $version ): string {
// Allow only digits and dots.
$clean_version = preg_replace( '/[^0-9.]/', '.', $version );
// Get version parts.
$version_parts = explode( '.', $clean_version );
// If a version has more than 3 parts - use only first 3. Get block data only for major versions.
if ( count( $version_parts ) > 3 ) {
$version = implode( '.', array_slice( $version_parts, 0, 3 ) );
}
return $version;
}
/**
* Get the WPForms plugin previous version.
*
* @since 1.8.8
*
* @return string Previous WPForms version.
*/
private function get_previous_plugin_version(): string {
$previous_version = get_option( MigrationsBase::PREVIOUS_CORE_VERSION_OPTION_NAME, '' );
if ( ! empty( $previous_version ) ) {
return $previous_version;
}
return '1.8.6'; // The last version before the "What's New?" feature.
}
}
Zerion Mini Shell 1.0