<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Helper functions to perform various plugins and addons related actions.

[2] Fix | Delete

*

[3] Fix | Delete

* @since 1.8.2.2

[4] Fix | Delete

*/

[5] Fix | Delete

[6] Fix | Delete

use WPForms\Requirements\Requirements;

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Check if addon met requirements.

[10] Fix | Delete

*

[11] Fix | Delete

* @since 1.8.2.2

[12] Fix | Delete

*

[13] Fix | Delete

* @param array $requirements Addon requirements.

[14] Fix | Delete

*

[15] Fix | Delete

* @return bool

[16] Fix | Delete

*/

[17] Fix | Delete

function wpforms_requirements( array $requirements ): bool {

[18] Fix | Delete

[19] Fix | Delete

return Requirements::get_instance()->validate( $requirements );

[20] Fix | Delete

}

[21] Fix | Delete

[22] Fix | Delete

/**

[23] Fix | Delete

* Determine if an addon is active and passed all requirements.

[24] Fix | Delete

*

[25] Fix | Delete

* @since 1.9.2

[26] Fix | Delete

*

[27] Fix | Delete

* @param string $addon_slug Addon slug without `wpforms-` prefix.

[28] Fix | Delete

*

[29] Fix | Delete

* @return bool

[30] Fix | Delete

*/

[31] Fix | Delete

function wpforms_is_addon_initialized( string $addon_slug ): bool {

[32] Fix | Delete

[33] Fix | Delete

$basename = sprintf( 'wpforms-%1$s/wpforms-%1$s.php', $addon_slug );

[34] Fix | Delete

[35] Fix | Delete

if ( is_multisite() ) {

[36] Fix | Delete

$active_plugins = (array) get_option( 'active_plugins', [] );

[37] Fix | Delete

[38] Fix | Delete

if ( in_array( $basename, $active_plugins, true ) ) {

[39] Fix | Delete

return true;

[40] Fix | Delete

}

[41] Fix | Delete

}

[42] Fix | Delete

[43] Fix | Delete

return Requirements::get_instance()->is_validated( $basename );

[44] Fix | Delete

}

[45] Fix | Delete

[46] Fix | Delete

/**

[47] Fix | Delete

* Check addon requirements and activate addon or plugin.

[48] Fix | Delete

*

[49] Fix | Delete

* @since 1.8.4

[50] Fix | Delete

* @since 1.9.2 Keep addons active even if they don't meet requirements.

[51] Fix | Delete

*

[52] Fix | Delete

* @param string $plugin Path to the plugin file relative to the plugins' directory.

[53] Fix | Delete

*

[54] Fix | Delete

* @return null|WP_Error Null on success, WP_Error on invalid file.

[55] Fix | Delete

*/

[56] Fix | Delete

function wpforms_activate_plugin( string $plugin ) {

[57] Fix | Delete

[58] Fix | Delete

$activate = activate_plugin( $plugin );

[59] Fix | Delete

[60] Fix | Delete

if ( is_wp_error( $activate ) ) {

[61] Fix | Delete

return $activate;

[62] Fix | Delete

}

[63] Fix | Delete

[64] Fix | Delete

$requirements = Requirements::get_instance();

[65] Fix | Delete

[66] Fix | Delete

if ( $requirements->is_validated( $plugin ) ) {

[67] Fix | Delete

return null;

[68] Fix | Delete

}

[69] Fix | Delete

[70] Fix | Delete

return new WP_Error( 'wpforms_addon_incompatible', $requirements->get_notice( $plugin ) );

[71] Fix | Delete

}

[72] Fix | Delete

[73] Fix | Delete

/**

[74] Fix | Delete

* Compares two "PHP-standardized" version number strings.

[75] Fix | Delete

*

[76] Fix | Delete

* Removes any "-RCn", "-beta" from version numbers first.

[77] Fix | Delete

*

[78] Fix | Delete

* @since 1.9.4

[79] Fix | Delete

*

[80] Fix | Delete

* @param string $version1 Version number.

[81] Fix | Delete

* @param string $version2 Version number.

[82] Fix | Delete

* @param string $operator Comparison operator.

[83] Fix | Delete

*

[84] Fix | Delete

* @return bool

[85] Fix | Delete

*/

[86] Fix | Delete

function wpforms_version_compare( $version1, $version2, $operator ): bool {

[87] Fix | Delete

[88] Fix | Delete

// If the version is not a string, return false.

[89] Fix | Delete

if ( ! is_string( $version1 ) || ! is_string( $version2 ) ) {

[90] Fix | Delete

return false;

[91] Fix | Delete

}

[92] Fix | Delete

[93] Fix | Delete

// Strip dash and anything after it.

[94] Fix | Delete

$clean_version_number = function ( $version ) {

[95] Fix | Delete

return preg_replace( '/-.+/', '', $version );

[96] Fix | Delete

};

[97] Fix | Delete

[98] Fix | Delete

return version_compare(

[99] Fix | Delete

$clean_version_number( $version1 ),

[100] Fix | Delete

$clean_version_number( $version2 ),

[101] Fix | Delete

$operator

[102] Fix | Delete

);

[103] Fix | Delete

}

[104] Fix | Delete

[105] Fix | Delete