[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

title

Body

[close]

/wp-admin/ -> plugin-install.php (source)

   1  <?php
   2  /**
   3   * Install plugin administration panel.
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   */
   8  // TODO route this pages via a specific iframe handler instead of the do_action below
   9  if ( ! defined( 'IFRAME_REQUEST' ) && isset( $_GET['tab'] ) && ( 'plugin-information' == $_GET['tab'] ) ) {
  10      define( 'IFRAME_REQUEST', true );
  11  }
  12  
  13  /**
  14   * WordPress Administration Bootstrap.
  15   */
  16  require_once( dirname( __FILE__ ) . '/admin.php' );
  17  
  18  if ( ! current_user_can( 'install_plugins' ) ) {
  19      wp_die( __( 'Sorry, you are not allowed to install plugins on this site.' ) );
  20  }
  21  
  22  if ( is_multisite() && ! is_network_admin() ) {
  23      wp_redirect( network_admin_url( 'plugin-install.php' ) );
  24      exit();
  25  }
  26  
  27  $wp_list_table = _get_list_table( 'WP_Plugin_Install_List_Table' );
  28  $pagenum       = $wp_list_table->get_pagenum();
  29  
  30  if ( ! empty( $_REQUEST['_wp_http_referer'] ) ) {
  31      $location = remove_query_arg( '_wp_http_referer', wp_unslash( $_SERVER['REQUEST_URI'] ) );
  32  
  33      if ( ! empty( $_REQUEST['paged'] ) ) {
  34          $location = add_query_arg( 'paged', (int) $_REQUEST['paged'], $location );
  35      }
  36  
  37      wp_redirect( $location );
  38      exit;
  39  }
  40  
  41  $wp_list_table->prepare_items();
  42  
  43  $total_pages = $wp_list_table->get_pagination_arg( 'total_pages' );
  44  
  45  if ( $pagenum > $total_pages && $total_pages > 0 ) {
  46      wp_redirect( add_query_arg( 'paged', $total_pages ) );
  47      exit;
  48  }
  49  
  50  $title       = __( 'Add Plugins' );
  51  $parent_file = 'plugins.php';
  52  
  53  wp_enqueue_script( 'plugin-install' );
  54  if ( 'plugin-information' != $tab ) {
  55      add_thickbox();
  56  }
  57  
  58  $body_id = $tab;
  59  
  60  wp_enqueue_script( 'updates' );
  61  
  62  /**
  63   * Fires before each tab on the Install Plugins screen is loaded.
  64   *
  65   * The dynamic portion of the action hook, `$tab`, allows for targeting
  66   * individual tabs, for instance 'install_plugins_pre_plugin-information'.
  67   *
  68   * @since 2.7.0
  69   */
  70  do_action( "install_plugins_pre_{$tab}" );
  71  
  72  /*
  73   * Call the pre upload action on every non-upload plugin installation screen
  74   * because the form is always displayed on these screens.
  75   */
  76  if ( 'upload' !== $tab ) {
  77      /** This action is documented in wp-admin/plugin-install.php */
  78      do_action( 'install_plugins_pre_upload' );
  79  }
  80  
  81  get_current_screen()->add_help_tab(
  82      array(
  83          'id'      => 'overview',
  84          'title'   => __( 'Overview' ),
  85          'content' =>
  86                  '<p>' . sprintf(
  87                      /* translators: %s: https://wordpress.org/plugins/ */
  88                      __( 'Plugins hook into WordPress to extend its functionality with custom features. Plugins are developed independently from the core WordPress application by thousands of developers all over the world. All plugins in the official <a href="%s">WordPress Plugin Directory</a> are compatible with the license WordPress uses.' ),
  89                      __( 'https://wordpress.org/plugins/' )
  90                  ) . '</p>' .
  91                  '<p>' . __( 'You can find new plugins to install by searching or browsing the directory right here in your own Plugins section.' ) . ' <span id="live-search-desc" class="hide-if-no-js">' . __( 'The search results will be updated as you type.' ) . '</span></p>',
  92  
  93      )
  94  );
  95  get_current_screen()->add_help_tab(
  96      array(
  97          'id'      => 'adding-plugins',
  98          'title'   => __( 'Adding Plugins' ),
  99          'content' =>
 100                  '<p>' . __( 'If you know what you&#8217;re looking for, Search is your best bet. The Search screen has options to search the WordPress Plugin Directory for a particular Term, Author, or Tag. You can also search the directory by selecting popular tags. Tags in larger type mean more plugins have been labeled with that tag.' ) . '</p>' .
 101                  '<p>' . __( 'If you just want to get an idea of what&#8217;s available, you can browse Featured and Popular plugins by using the links above the plugins list. These sections rotate regularly.' ) . '</p>' .
 102                  '<p>' . __( 'You can also browse a user&#8217;s favorite plugins, by using the Favorites link above the plugins list and entering their WordPress.org username.' ) . '</p>' .
 103                  '<p>' . __( 'If you want to install a plugin that you&#8217;ve downloaded elsewhere, click the Upload Plugin button above the plugins list. You will be prompted to upload the .zip package, and once uploaded, you can activate the new plugin.' ) . '</p>',
 104      )
 105  );
 106  
 107  get_current_screen()->set_help_sidebar(
 108      '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
 109      '<p>' . __( '<a href="https://wordpress.org/support/article/plugins-add-new-screen/">Documentation on Installing Plugins</a>' ) . '</p>' .
 110      '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
 111  );
 112  
 113  get_current_screen()->set_screen_reader_content(
 114      array(
 115          'heading_views'      => __( 'Filter plugins list' ),
 116          'heading_pagination' => __( 'Plugins list navigation' ),
 117          'heading_list'       => __( 'Plugins list' ),
 118      )
 119  );
 120  
 121  /**
 122   * WordPress Administration Template Header.
 123   */
 124  include ( ABSPATH . 'wp-admin/admin-header.php' );
 125  ?>
 126  <div class="wrap <?php echo esc_attr( "plugin-install-tab-$tab" ); ?>">
 127  <h1 class="wp-heading-inline">
 128  <?php
 129  echo esc_html( $title );
 130  ?>
 131  </h1>
 132  
 133  <?php
 134  if ( ! empty( $tabs['upload'] ) && current_user_can( 'upload_plugins' ) ) {
 135      printf(
 136          ' <a href="%s" class="upload-view-toggle page-title-action"><span class="upload">%s</span><span class="browse">%s</span></a>',
 137          ( 'upload' === $tab ) ? self_admin_url( 'plugin-install.php' ) : self_admin_url( 'plugin-install.php?tab=upload' ),
 138          __( 'Upload Plugin' ),
 139          __( 'Browse Plugins' )
 140      );
 141  }
 142  ?>
 143  
 144  <hr class="wp-header-end">
 145  
 146  <?php
 147  /*
 148   * Output the upload plugin form on every non-upload plugin installation screen, so it can be
 149   * displayed via JavaScript rather then opening up the devoted upload plugin page.
 150   */
 151  if ( 'upload' !== $tab ) {
 152      ?>
 153      <div class="upload-plugin-wrap">
 154          <?php
 155          /** This action is documented in wp-admin/plugin-install.php */
 156          do_action( 'install_plugins_upload' );
 157          ?>
 158      </div>
 159      <?php
 160      $wp_list_table->views();
 161      echo '<br class="clear" />';
 162  }
 163  
 164  /**
 165   * Fires after the plugins list table in each tab of the Install Plugins screen.
 166   *
 167   * The dynamic portion of the action hook, `$tab`, allows for targeting
 168   * individual tabs, for instance 'install_plugins_plugin-information'.
 169   *
 170   * @since 2.7.0
 171   *
 172   * @param int $paged The current page number of the plugins list table.
 173   */
 174  do_action( "install_plugins_{$tab}", $paged );
 175  ?>
 176  
 177      <span class="spinner"></span>
 178  </div>
 179  
 180  <?php
 181  wp_print_request_filesystem_credentials_modal();
 182  wp_print_admin_notice_templates();
 183  
 184  /**
 185   * WordPress Administration Template Footer.
 186   */
 187  include ( ABSPATH . 'wp-admin/admin-footer.php' );


Generated: Sat Nov 23 20:47:33 2019 Cross-referenced by PHPXref 0.7