Add a release page

wordpress.org/public_html/wp-content/plugins/plugin-directory/api/class-base.php

@@ -40,6 +40,7 @@ public static function load_routes() {
 		new Routes\Plugin_Upload();
 		new Routes\Plugin_Blueprint();
 		new Routes\Plugin_Review();
+		new Routes\Plugin_Publish();
 	}
 
 	/**

wordpress.org/public_html/wp-content/plugins/plugin-directory/api/routes/class-plugin-publish.php

@@ -0,0 +1,66 @@
+<?php
+/**
+ * An API endpoint for publishing plugin releases.
+ *
+ * @package WordPressdotorg_Plugin_Directory
+ */
+
+namespace WordPressdotorg\Plugin_Directory\API\Routes;
+
+use WP_REST_Response;
+use WP_REST_Server;
+use WordPressdotorg\Plugin_Directory\Plugin_Directory;
+use WordPressdotorg\Plugin_Directory\Plugin_Release;
+use WordPressdotorg\Plugin_Directory\API\Base;
+
+/**
+ * An API endpoint for publishing a release of a plugin.
+ *
+ * @package WordPressdotorg_Plugin_Directory
+ */
+class Plugin_Publish extends Base {
+
+	/**
+	 * Plugin_Publish constructor.
+	 */
+	public function __construct() {
+		register_rest_route(
+			'plugins/v2',
+			'/plugin/(?P<plugin_slug>[^/]+)/release', // FIXME: 'release' or 'publish' or something else?
+			array(
+				'methods'             => \WP_REST_Server::CREATABLE,
+				'callback'            => array( $this, 'publish_release' ),
+				'args'                => array(
+					'plugin_slug' => array(
+						'validate_callback' => array( $this, 'validate_plugin_slug_callback' ),
+					),
+				),
+				'permission_callback' => array( $this, 'permission_can_access_plugin' ),
+			)
+		);
+	}
+
+	/**
+	 * Validate that the user can manage a given plugin.
+	 */
+	public function permission_can_access_plugin( $request ) {
+		$plugin = Plugin_Directory::get_plugin_post( $request['plugin_slug'] );
+		return current_user_can( 'plugin_manage_releases', $plugin );
+	}
+
+	/**
+	 * A simple endpoint to publish a release.
+	 *
+	 * @param WP_REST_Request $request The request object.
+	 * @return WP_REST_Response
+	 */
+	public function publish_release( $request ) {
+
+		$plugin = Plugin_Directory::get_plugin_post( $request['plugin_slug'] );
+		// Will return either a WP_Error, or the post ID of the published release CPT.
+		// Maybe it should return the version string instead, or an object with more details? The whole CPT?
+		$result = Plugin_Release::instance()->publish_release( $plugin );
+
+		return new WP_REST_Response( $result );
+	}
+}

wordpress.org/public_html/wp-content/plugins/plugin-directory/bin/get-release-info.php

@@ -0,0 +1,103 @@
+<?php
+namespace WordPressdotorg\Plugin_Directory;
+
+// CLI script for printing release CPT details for a plugin
+// Usage: php get-release-info.php --plugin hello-dolly
+
+// Intended for use while testing; this can probably be removed once everything is live; or turned into a fixer script.
+
+// This script should only be called in a CLI environment.
+if ( 'cli' != php_sapi_name() ) {
+	die();
+}
+
+ob_start();
+
+$opts = getopt( '', array( 'url:', 'abspath:', 'plugin:', 'changed-tags:', 'async', 'publish' ) );
+
+// Guess the default parameters:
+if ( empty( $opts ) && $argc == 2 ) {
+	$opts['plugin'] = $argv[1];
+	$argv[1]        = '--plugin ' . $argv[1];
+}
+if ( empty( $opts['url'] ) ) {
+	$opts['url'] = 'https://wordpress.org/plugins/';
+}
+if ( empty( $opts['abspath'] ) && false !== strpos( __DIR__, 'wp-content' ) ) {
+	$opts['abspath'] = substr( __DIR__, 0, strpos( __DIR__, 'wp-content' ) );
+}
+
+if ( empty( $opts['changed-tags'] ) ) {
+	$opts['changed-tags'] = array( 'trunk' );
+} else {
+	$opts['changed-tags'] = explode( ',', $opts['changed-tags'] );
+}
+
+$opts['async']  = isset( $opts['async'] );
+$opts['publish'] = isset( $opts['publish'] );
+
+foreach ( array( 'url', 'abspath', 'plugin' ) as $opt ) {
+	if ( empty( $opts[ $opt ] ) ) {
+		fwrite( STDERR, "Missing Parameter: $opt\n" );
+		fwrite( STDERR, "Usage: php {$argv[0]} --plugin hello-dolly --abspath /home/example/public_html --url https://wordpress.org/plugins/\n" );
+		fwrite( STDERR, "Optional: --async to queue a job to import, --create to create a Post if none exist.\n" );
+		fwrite( STDERR, "--url and --abspath will be guessed if possible.\n" );
+		die();
+	}
+}
+
+// Bootstrap WordPress
+$_SERVER['HTTP_HOST']   = parse_url( $opts['url'], PHP_URL_HOST );
+$_SERVER['REQUEST_URI'] = parse_url( $opts['url'], PHP_URL_PATH );
+
+require rtrim( $opts['abspath'], '/' ) . '/wp-load.php';
+
+if ( ! class_exists( '\WordPressdotorg\Plugin_Directory\Plugin_Directory' ) ) {
+	fwrite( STDERR, "Error! This site doesn't have the Plugin Directory plugin enabled.\n" );
+	if ( defined( 'WPORG_PLUGIN_DIRECTORY_BLOGID' ) ) {
+		fwrite( STDERR, "Run the following command instead:\n" );
+		fwrite( STDERR, "\tphp " . implode( ' ', $argv ) . ' --url ' . get_site_url( WPORG_PLUGIN_DIRECTORY_BLOGID, '/' ) . "\n" );
+	}
+	die();
+}
+
+$plugin_slug  = $opts['plugin'];
+$start_time   = microtime( 1 );
+
+$plugin = Plugin_Directory::get_plugin_post( $plugin_slug );
+if ( ! $plugin ) {
+	fwrite( STDERR, "Plugin not found: $plugin_slug\n" );
+	die();
+}
+
+echo "Showing releases for $plugin_slug ($plugin->ID)...\n";
+
+$releases = Plugin_Release::instance()->get_releases( $plugin );
+if ( is_wp_error( $releases ) ) {
+	fwrite( STDERR, "Failed to update releases for $plugin_slug: " . $updated->get_error_message() . "\n" );
+	die();
+}
+
+foreach( $releases as $release ) {
+	echo "ID:                     " . $release->ID . "\n";
+	echo "Status:                 " . $release->post_status . "\n";
+	echo "Release version:        " . $release->post_title . "\n";
+	echo "Tag:                    " . $release->release_tag . "\n";
+	echo "Post date GMT:          " . $release->post_date_gmt . "\n";
+	if ( $release->release_date ) {
+		echo "Date:                   " . ( new \DateTime( '@' . $release->release_date ) )->format( 'Y-m-d H:i:s' ) . "\n";
+	}
+	echo "Committers:             " . implode( ', ', $release->release_committer ) . "\n";
+	echo "Zips built:             " . ( $release->release_zips_built ? 'Yes' : 'No' ) . "\n";
+	echo "Confirmations required: " . ( $release->release_confirmations_required ? 'Yes' : 'No' ) . "\n";
+	echo "Release revision:       " . $release->revision_final . "\n";
+	echo "Previous version rev:   " . $release->revision_prior . "\n";
+	if ( $release->release_commit_log ) {
+		echo "Commit log:\n";
+		foreach( $release->release_commit_log as $commit ) {
+			echo "  " . ( new \DateTime( '@' . $commit['date'] ) )->format( 'Y-m-d' ) . " - ";
+			echo "  " . $commit['author'] . ' r' . $commit['revision'] . " - " . \wp_trim_words( $commit['message'] ) . "\n";
+		}
+	}
+	echo "-----------------------------------\n";
+}

wordpress.org/public_html/wp-content/plugins/plugin-directory/bin/update-release-cpt.php

@@ -0,0 +1,95 @@
+<?php
+namespace WordPressdotorg\Plugin_Directory;
+
+// CLI script for creating/updating plugin release CPTs for a specific plugin.
+// Usage: php update-release-cpt.php --plugin hello-dolly
+
+// Intended for use while testing; this can probably be removed once everything is live; or turned into a fixer script.
+
+// This script should only be called in a CLI environment.
+if ( 'cli' != php_sapi_name() ) {
+	die();
+}
+
+ob_start();
+
+$opts = getopt( '', array( 'url:', 'abspath:', 'plugin:', 'changed-tags:', 'async', 'publish' ) );
+
+// Guess the default parameters:
+if ( empty( $opts ) && $argc == 2 ) {
+	$opts['plugin'] = $argv[1];
+	$argv[1]        = '--plugin ' . $argv[1];
+}
+if ( empty( $opts['url'] ) ) {
+	$opts['url'] = 'https://wordpress.org/plugins/';
+}
+if ( empty( $opts['abspath'] ) && false !== strpos( __DIR__, 'wp-content' ) ) {
+	$opts['abspath'] = substr( __DIR__, 0, strpos( __DIR__, 'wp-content' ) );
+}
+
+if ( empty( $opts['changed-tags'] ) ) {
+	$opts['changed-tags'] = array( 'trunk' );
+} else {
+	$opts['changed-tags'] = explode( ',', $opts['changed-tags'] );
+}
+
+$opts['async']  = isset( $opts['async'] );
+$opts['publish'] = isset( $opts['publish'] );
+
+foreach ( array( 'url', 'abspath', 'plugin' ) as $opt ) {
+	if ( empty( $opts[ $opt ] ) ) {
+		fwrite( STDERR, "Missing Parameter: $opt\n" );
+		fwrite( STDERR, "Usage: php {$argv[0]} --plugin hello-dolly --abspath /home/example/public_html --url https://wordpress.org/plugins/\n" );
+		fwrite( STDERR, "Optional: --async to queue a job to import, --create to create a Post if none exist.\n" );
+		fwrite( STDERR, "--url and --abspath will be guessed if possible.\n" );
+		die();
+	}
+}
+
+// Bootstrap WordPress
+$_SERVER['HTTP_HOST']   = parse_url( $opts['url'], PHP_URL_HOST );
+$_SERVER['REQUEST_URI'] = parse_url( $opts['url'], PHP_URL_PATH );
+
+require rtrim( $opts['abspath'], '/' ) . '/wp-load.php';
+
+if ( ! class_exists( '\WordPressdotorg\Plugin_Directory\Plugin_Directory' ) ) {
+	fwrite( STDERR, "Error! This site doesn't have the Plugin Directory plugin enabled.\n" );
+	if ( defined( 'WPORG_PLUGIN_DIRECTORY_BLOGID' ) ) {
+		fwrite( STDERR, "Run the following command instead:\n" );
+		fwrite( STDERR, "\tphp " . implode( ' ', $argv ) . ' --url ' . get_site_url( WPORG_PLUGIN_DIRECTORY_BLOGID, '/' ) . "\n" );
+	}
+	die();
+}
+
+$plugin_slug  = $opts['plugin'];
+$start_time   = microtime( 1 );
+
+$plugin = Plugin_Directory::get_plugin_post( $plugin_slug );
+if ( ! $plugin ) {
+	fwrite( STDERR, "Plugin not found: $plugin_slug\n" );
+	die();
+}
+
+if ( empty( $plugin->releases ) ) {
+	fwrite( STDERR, "No releases found for $plugin_slug\n" );
+	die();
+}
+
+echo "Updating releases for $plugin_slug...\n";
+
+$updated = Plugin_Release::instance()->maybe_backfill_releases( $plugin, true ); // true = force update
+if ( is_wp_error( $updated ) ) {
+	fwrite( STDERR, "Failed to update releases for $plugin_slug: " . $updated->get_error_message() . "\n" );
+	die();
+}
+echo "Updated " . number_format( $updated ) . " releases for $plugin_slug\n";
+
+if ( $opts['publish'] ) {
+	$published = Plugin_Release::instance()->publish_release( $plugin );
+	if ( is_wp_error( $published ) ) {
+		fwrite( STDERR, "Failed to publish releases for $plugin_slug: " . $published->get_error_message() . "\n" );
+		die();
+	}
+	echo "Published release post ID = " . $published . "\n";
+}
+