is_wp_version_compatible()
Порівнює передану версію WordPress із встановленою версією WordPress.
Працює з урахуванням функції version_compare() з умовою >=.
Дивіться також аналогічне порівняння версій PHP: is_php_version_compatible() .
Основа для:
validate_plugin_requirements()
validate_plugin_requirements()
1 раз – 0.000001 сек
(швидкість світла) | 50000 разів – 0.03 сек
(швидкість світла) |
PHP 7.2.16, WP 5.2
(швидкість світла) | 50000 разів – 0.03 сек
(швидкість світла) |
PHP 7.2.16, WP 5.2
Хуків немає.
Повертає
true|false. True – вказана версія WordPress сумісна або версія для перевірки сумісності не вказана ( ”, false тощо). False – вказана версія не сумісна.
Використання
is_wp_version_compatible( $required );
-
$required
(рядок) (обов’язковий) - Мінімальна потрібна версія WordPress.
Приклади
#1 Приклади результатів перевірки
get_bloginfo('version'); // 5.2
is_wp_version_compatible( '4.9' ); // true
is_wp_version_compatible( '5.2' ); // true
is_wp_version_compatible( '5.2.1' ) // false
is_wp_version_compatible( '5.5' ); // false#2 Виведемо повідомлення про застарілу версію WordPress
Нехай ми написали плагін, який буде працювати лише на WordPress 5.2 та вище. Тоді потрібно передбачити, щоб основний код плагіна не запускався, якщо версія встановленого WordPress нижче.
Допустимо на сервері користувача встановлений WP 4.9, тоді:
<?php
if ( is_wp_version_compatible( '5.2' ) ) {
require_once __DIR__ . '/main-file-plugin.php';
}
else {
add_action( 'admin_notices', 'admin_php_version__error' );
}
function admin_php_version__error() {
?>
<div class="notice notice-error">
<p>Для роботи плагіна потрібно WordPress не нижче версії 5.2.</p>
</div>
<?php
}Код вище неповний і показує лише принцип того, як має працювати повідомлення.
нотатки
- Global. Рядок. $wp_version The WordPress version string.
список змін
| З версії 5.2.0 | Введено. |
Код is_wp_version_compatible() is wp version compatible WP 6.0.2
function is_wp_version_compatible( $required ) {
Global $wp_version;
// Strip off any-alpha, -RC, -beta, -src suffixes.
list($version) = explode('-', $wp_version);
return empty( $required ) || version_compare($version, $required, '>=');
}