diff --git wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/assets/images/github-mark.svg wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/assets/images/github-mark.svg
new file mode 100644
index 000000000..99b0878c1
--- /dev/null
+++ wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/assets/images/github-mark.svg
@@ -0,0 +1,3 @@
+
diff --git wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/inc/class-handbook.php wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/inc/class-handbook.php
new file mode 100644
index 000000000..3884ff220
--- /dev/null
+++ wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/inc/class-handbook.php
@@ -0,0 +1,125 @@
+ ) ) . ')
Edit';
+ }
+
+ /**
+ * Hosting Handbook pages are maintained in the GitHub repo, so the edit
+ * link should ridirect to there.
+ */
+ public static function redirect_edit_link_to_github( $link, $post_id, $context ) {
+ if ( is_admin() ) {
+ return $link;
+ }
+ $post = get_post( $post_id );
+ if ( ! $post ) {
+ return $link;
+ }
+
+ if ( 'handbook' !== $post->post_type ) {
+ return $link;
+ }
+
+ $markdown_source = self::get_markdown_edit_link( $post_id );
+ if ( ! $markdown_source ) {
+ return $link;
+ }
+
+ if ( 'display' === $context ) {
+ $markdown_source = esc_url( $markdown_source );
+ }
+
+ return $markdown_source;
+ }
+
+ /**
+ * o2 does inline editing, so we also need to remove the class name that it looks for.
+ *
+ * o2 obeys the edit_post capability for displaying the edit link, so we also need to manually
+ * add the edit link if it isn't there - it always redirects to GitHub, so it doesn't need to
+ * obey the edit_post capability in this instance.
+ */
+ public static function redirect_o2_edit_link_to_github( $actions, $post_id ) {
+ $post = get_post( $post_id );
+ if ( ! $post ) {
+ return $actions;
+ }
+
+ if ( 'handbook' !== $post->post_type ) {
+ return $actions;
+ }
+
+ $markdown_source = self::get_markdown_edit_link( $post_id );
+ if ( ! $markdown_source ) {
+ return $actions;
+ }
+
+ /*
+ * Define our own edit post action for o2.
+ *
+ * Notable differences from the original are:
+ * - the 'href' parameter always goes to the GitHub source.
+ * - the 'o2-edit' class is missing, so inline editing is disabled.
+ */
+ $edit_action = array(
+ 'action' => 'edit',
+ 'href' => $markdown_source,
+ 'classes' => array( 'edit-post-link' ),
+ 'rel' => $post_id,
+ 'initialState' => 'default'
+ );
+
+ // Find and replace the existing edit action.
+ $replaced = false;
+ foreach( $actions as &$action ) {
+ if ( 'edit' === $action['action'] ) {
+ $action = $edit_action;
+ $replaced = true;
+ break;
+ }
+ }
+ unset( $action );
+
+ // If there was no edit action replaced, add it in manually.
+ if ( ! $replaced ) {
+ $actions[30] = $edit_action;
+ }
+
+ return $actions;
+ }
+
+ private static function get_markdown_edit_link( $post_id ) {
+ $markdown_source = Markdown_Import::get_markdown_source( $post_id );
+ if ( is_wp_error( $markdown_source ) ) {
+ return '';
+ }
+ if ( 'github.com' !== parse_url( $markdown_source, PHP_URL_HOST )
+ || false !== stripos( $markdown_source, '/edit/master/' ) ) {
+ return $markdown_source;
+ }
+ $markdown_source = str_replace( '/blob/master/', '/edit/master/', $markdown_source );
+ return $markdown_source;
+ }
+}
diff --git wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/inc/class-markdown-import.php wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/inc/class-markdown-import.php
new file mode 100644
index 000000000..59287b5c1
--- /dev/null
+++ wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/inc/class-markdown-import.php
@@ -0,0 +1,280 @@
+ self::$supported_post_types,
+ 'post_status' => 'publish',
+ 'posts_per_page' => self::$posts_per_page,
+ ) );
+ $existing = $q->posts;
+ $created = 0;
+ foreach( $manifest as $doc ) {
+ // Already exists
+ if ( wp_filter_object_list( $existing, array( 'post_name' => $doc['slug'] ) ) ) {
+ continue;
+ }
+ $post_parent = null;
+ if ( ! empty( $doc['parent'] ) ) {
+ // Find the parent in the existing set
+ $parents = wp_filter_object_list( $existing, array( 'post_name' => $doc['parent'] ) );
+ if ( ! empty( $parents ) ) {
+ $parent = array_shift( $parents );
+ } else {
+ // Create the parent and add it to the stack
+ if ( isset( $manifest[ $doc['parent'] ] ) ) {
+ $parent_doc = $manifest[ $doc['parent'] ];
+ $parent = self::create_post_from_manifest_doc( $parent_doc );
+ if ( $parent ) {
+ $created++;
+ $existing[] = $parent;
+ } else {
+ continue;
+ }
+ } else {
+ continue;
+ }
+ }
+ $post_parent = $parent->ID;
+ }
+ $post = self::create_post_from_manifest_doc( $doc, $post_parent );
+ if ( $post ) {
+ $created++;
+ $existing[] = $post;
+ }
+ }
+ if ( class_exists( 'WP_CLI' ) ) {
+ \WP_CLI::success( "Successfully created {$created} handbook pages." );
+ }
+ }
+
+ /**
+ * Create a new handbook page from the manifest document
+ */
+ private static function create_post_from_manifest_doc( $doc, $post_parent = null ) {
+ $post_data = array(
+ 'post_type' => 'handbook',
+ 'post_status' => 'publish',
+ 'post_parent' => $post_parent,
+ 'post_title' => sanitize_text_field( wp_slash( $doc['title'] ) ),
+ 'post_name' => sanitize_title_with_dashes( $doc['slug'] ),
+ );
+ $post_id = wp_insert_post( $post_data );
+ if ( ! $post_id ) {
+ return false;
+ }
+ if ( class_exists( 'WP_CLI' ) ) {
+ \WP_CLI::log( "Created post {$post_id} for {$doc['title']}." );
+ }
+ update_post_meta( $post_id, self::$meta_key, esc_url_raw( $doc['markdown_source'] ) );
+ return get_post( $post_id );
+ }
+
+ public static function action_wporg_hosting_handbook_markdown_import() {
+ $q = new WP_Query( array(
+ 'post_type' => self::$supported_post_types,
+ 'post_status' => 'publish',
+ 'fields' => 'ids',
+ 'posts_per_page' => self::$posts_per_page,
+ ) );
+ $ids = $q->posts;
+ $success = 0;
+ foreach( $ids as $id ) {
+ $ret = self::update_post_from_markdown_source( $id );
+ if ( class_exists( 'WP_CLI' ) ) {
+ if ( is_wp_error( $ret ) ) {
+ \WP_CLI::warning( $ret->get_error_message() );
+ } else {
+ \WP_CLI::log( "Updated {$id} from markdown source" );
+ $success++;
+ }
+ }
+ }
+ if ( class_exists( 'WP_CLI' ) ) {
+ $total = count( $ids );
+ \WP_CLI::success( "Successfully updated {$success} of {$total} handbook pages." );
+ }
+ }
+
+ /**
+ * Handle a request to import from the markdown source
+ */
+ public static function action_load_post_php() {
+ if ( ! isset( $_GET[ self::$submit_name ] )
+ || ! isset( $_GET[ self::$nonce_name ] )
+ || ! isset( $_GET['post'] ) ) {
+ return;
+ }
+ $post_id = (int) $_GET['post'];
+ if ( ! current_user_can( 'edit_post', $post_id )
+ || ! wp_verify_nonce( $_GET[ self::$nonce_name ], self::$input_name )
+ || ! in_array( get_post_type( $post_id ), self::$supported_post_types, true ) ) {
+ return;
+ }
+
+ $response = self::update_post_from_markdown_source( $post_id );
+ if ( is_wp_error( $response ) ) {
+ wp_die( $response->get_error_message() );
+ }
+
+ wp_safe_redirect( get_edit_post_link( $post_id, 'raw' ) );
+ exit;
+ }
+
+ /**
+ * Add an input field for specifying Markdown source
+ */
+ public static function action_edit_form_after_title( $post ) {
+ if ( ! in_array( $post->post_type, self::$supported_post_types, true ) ) {
+ return;
+ }
+ $markdown_source = get_post_meta( $post->ID, self::$meta_key, true );
+ ?>
+ 'import',
+ self::$nonce_name => wp_create_nonce( self::$input_name ),
+ ), get_edit_post_link( $post->ID, 'raw' ) );
+ ?>
+ Import
+
+
+ 15 * MINUTE_IN_SECONDS,
+ 'display' => '15 minutes'
+ );
+ return $schedules;
+ }
+
+ /**
+ * Update a post from its Markdown source
+ */
+ private static function update_post_from_markdown_source( $post_id ) {
+ $markdown_source = self::get_markdown_source( $post_id );
+ if ( is_wp_error( $markdown_source ) ) {
+ return $markdown_source;
+ }
+ if ( ! function_exists( 'jetpack_require_lib' ) ) {
+ return new WP_Error( 'missing-jetpack-require-lib', 'jetpack_require_lib() is missing on system.' );
+ }
+
+ // Transform GitHub repo HTML pages into their raw equivalents
+ $markdown_source = preg_replace( '#https?://github\.com/([^/]+/[^/]+)/blob/(.+)#', 'https://raw.githubusercontent.com/$1/$2', $markdown_source );
+ $markdown_source = add_query_arg( 'v', time(), $markdown_source );
+ $response = wp_remote_get( $markdown_source );
+ if ( is_wp_error( $response ) ) {
+ return $response;
+ } elseif ( 200 !== wp_remote_retrieve_response_code( $response ) ) {
+ return new WP_Error( 'invalid-http-code', 'Markdown source returned non-200 http code.' );
+ }
+
+ $markdown = wp_remote_retrieve_body( $response );
+ // Strip YAML doc from the header
+ $markdown = preg_replace( '#^---(.+)---#Us', '', $markdown );
+
+ $title = null;
+ if ( preg_match( '/^#\s(.+)/', $markdown, $matches ) ) {
+ $title = $matches[1];
+ $markdown = preg_replace( '/^#\s(.+)/', '', $markdown );
+ }
+
+ // Transform to HTML and save the post
+ jetpack_require_lib( 'markdown' );
+ $parser = new \WPCom_GHF_Markdown_Parser;
+ $html = $parser->transform( $markdown );
+ $post_data = array(
+ 'ID' => $post_id,
+ 'post_content' => wp_filter_post_kses( wp_slash( $html ) ),
+ );
+ if ( ! is_null( $title ) ) {
+ $post_data['post_title'] = sanitize_text_field( wp_slash( $title ) );
+ }
+ wp_update_post( $post_data );
+ return true;
+ }
+
+ /**
+ * Retrieve the markdown source URL for a given post.
+ */
+ public static function get_markdown_source( $post_id ) {
+ $markdown_source = get_post_meta( $post_id, self::$meta_key, true );
+ if ( ! $markdown_source ) {
+ return new WP_Error( 'missing-markdown-source', 'Markdown source is missing for post.' );
+ }
+
+ return $markdown_source;
+ }
+}
diff --git wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/wporg-hosting-handbook.php wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/wporg-hosting-handbook.php
new file mode 100644
index 000000000..b7c0762ad
--- /dev/null
+++ wordpress.org/public_html/wp-content/plugins/wporg-hosting-handbook/wporg-hosting-handbook.php
@@ -0,0 +1,100 @@
+
+
+