Updates) & optionally prevents updating them.
*
* @since 1.2.0
*/
class UpdatesPage {
/**
* Class instance.
*
* @since 1.2.0
*
* @var UpdatesPage|null;
*/
private static $_instance = null;
/**
* Returns class instance.
*
* @since 1.2.0
*
* @return UpdatesPage
*/
public static function get_instance() {
if ( is_null( self::$_instance ) ) {
self::$_instance = new self();
}
return self::$_instance;
}
/**
* Initializes the class.
*
* @since 1.2.0
*
* @return void
*/
public function init() {
static $initialized = false;
if ( $initialized ) {
return;
}
add_action( 'init', [ $this, 'modify_display_of_updates_table' ] );
add_filter( 'upgrader_pre_install', [ $this, 'prevent_update' ], 10, 2 );
$initialized = true;
}
/**
* Modifies the display of the Updates table.
*
* @since 1.2.0
*
* @return void
*/
public function modify_display_of_updates_table() {
if ( ! $this->is_updates_page() ) {
return;
}
if ( ! AdminMenu::should_initialize() ) {
return;
}
$products = array_filter(
ProductManager::get_instance()->get_products_data( [ 'key_by' => 'path' ] ),
function ( $product ) {
return ! $product['third_party'] && $product['update_available'] && ( ! $product['checked_dependencies'][ $product['server_version'] ]['status'] );
}
);
$product_html_markup = array_map(
function ( $product ) {
$product_logo_text = strtr(
esc_html__( '[product] logo', 'gk-gravityexport' ),
[
'[product]' => $product['name'],
]
);
$update_description_text = strtr(
esc_html_x( 'You have version [current_version] installed. Before updating to [new_version], please [link]review the requirements[/link].', 'Placeholders inside [] are not to be translated.', 'gk-gravityexport' ),
[
'[current_version]' => $product['installed_version'],
'[new_version]' => $product['server_version'],
'[link]' => '',
'[/link]' => '',
]
);
return <<
|
{$product['name']}
{$update_description_text}
|
HTML;
},
$products
);
$product_html_markup = wp_json_encode( array_combine( array_keys( $products ), $product_html_markup ) );
// Update table row of each product with unmet dependencies.
add_filter(
'gk/foundation/inline-scripts',
function ( $scripts ) use ( $product_html_markup ) {
$scripts[]['script'] = << {
if ( product_rows[ input.value ] === undefined ) {
return;
}
input.closest( 'tr' ).outerHTML = product_rows[ input.value ];
} );
} );
JS;
return $scripts;
}
);
}
/**
* Optionally prevents updating a product if it has unmet dependencies.
* While we prevent that from the Plugins and Updates pages, let's take a step further and prevent it in the backend when WP is about to install the product.
*
* @since 1.2.0
*
* @param bool|WP_Error $response Update response.
* @param array $args Extra arguments passed to hooked filters.
*
* @return bool|WP_Error
*/
public function prevent_update( $response, $args ) {
if ( is_wp_error( $response ) || ! isset( $args['plugin'] ) ) {
return $response;
}
if ( ! AdminMenu::should_initialize() ) {
return $response;
}
$products = array_filter(
ProductManager::get_instance()->get_products_data( [ 'key_by' => 'path' ] ),
function ( $product ) {
return ! $product['third_party'] && $product['update_available'];
}
);
$product = $products[ $args['plugin'] ] ?? null;
if ( ! $product || ( $product['checked_dependencies'][ $product['server_version'] ]['status'] ?? false ) ) {
return $response;
}
return new WP_Error(
'gk_product_unmet_dependency',
strtr(
esc_html_x( 'This product has unmet dependencies. [link]Review the requirements[/link] and try updating again.', 'Placeholders inside [] are not to be translated.', 'gk-gravityexport' ),
[
'[link]' => '',
'[/link]' => '',
]
)
);
}
/**
* Determines whether the current page is an Updates page.
*
* @since 1.2.0
*
* @return bool
*/
public function is_updates_page() {
global $pagenow;
return is_admin() && 'update-core.php' === $pagenow;
}
}