1<?php
  2/**
  3 * Upgrader API: Language_Pack_Upgrader_Skin class
  4 *
  5 * @package WordPress
  6 * @subpackage Upgrader
  7 * @since 4.6.0
  8 */
  9
 10/**
 11 * Translation Upgrader Skin for WordPress Translation Upgrades.
 12 *
 13 * @since 3.7.0
 14 * @since 4.6.0 Moved to its own file from wp-admin/includes/class-wp-upgrader-skins.php.
 15 *
 16 * @see WP_Upgrader_Skin
 17 */
 18class Language_Pack_Upgrader_Skin extends WP_Upgrader_Skin {
 19	public $language_update        = null;
 20	public $done_header            = false;
 21	public $done_footer            = false;
 22	public $display_footer_actions = true;
 23
 24	/**
 25	 * Constructor.
 26	 *
 27	 * Sets up the language pack upgrader skin.
 28	 *
 29	 * @since 3.7.0
 30	 *
 31	 * @param array $args
 32	 */
 33	public function __construct( $args = array() ) {
 34		$defaults = array(
 35			'url'                => '',
 36			'nonce'              => '',
 37			'title'              => __( 'Update Translations' ),
 38			'skip_header_footer' => false,
 39		);
 40		$args     = wp_parse_args( $args, $defaults );
 41		if ( $args['skip_header_footer'] ) {
 42			$this->done_header            = true;
 43			$this->done_footer            = true;
 44			$this->display_footer_actions = false;
 45		}
 46		parent::__construct( $args );
 47	}
 48
 49	/**
 50	 * Performs an action before a language pack update.
 51	 *
 52	 * @since 3.7.0
 53	 */
 54	public function before() {
 55		$name = $this->upgrader->get_name_for_update( $this->language_update );
 56
 57		echo '<div class="update-messages lp-show-latest">';
 58
 59		/* translators: 1: Project name (plugin, theme, or WordPress), 2: Language. */
 60		printf( '<h2>' . __( 'Updating translations for %1$s (%2$s)&#8230;' ) . '</h2>', $name, $this->language_update->language );
 61	}
 62
 63	/**
 64	 * Displays an error message about the update.
 65	 *
 66	 * @since 3.7.0
 67	 * @since 5.9.0 Renamed `$error` to `$errors` for PHP 8 named parameter support.
 68	 *
 69	 * @param string|WP_Error $errors Errors.
 70	 */
 71	public function error( $errors ) {
 72		echo '<div class="lp-error">';
 73		parent::error( $errors );
 74		echo '</div>';
 75	}
 76
 77	/**
 78	 * Performs an action following a language pack update.
 79	 *
 80	 * @since 3.7.0
 81	 */
 82	public function after() {
 83		echo '</div>';
 84	}
 85
 86	/**
 87	 * Displays the footer following the bulk update process.
 88	 *
 89	 * @since 3.7.0
 90	 */
 91	public function bulk_footer() {
 92		$this->decrement_update_count( 'translation' );
 93
 94		$update_actions = array(
 95			'updates_page' => sprintf(
 96				'<a href="%s" target="_parent">%s</a>',
 97				self_admin_url( 'update-core.php' ),
 98				__( 'Go to WordPress Updates page' )
 99			),
100		);
101
102		/**
103		 * Filters the list of action links available following a translations update.
104		 *
105		 * @since 3.7.0
106		 *
107		 * @param string[] $update_actions Array of translations update links.
108		 */
109		$update_actions = apply_filters( 'update_translations_complete_actions', $update_actions );
110
111		if ( $update_actions && $this->display_footer_actions ) {
112			$this->feedback( implode( ' | ', $update_actions ) );
113		}
114	}
115}
116