X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/58f607a1de715c9bca69340a4d6fb9e1b9c2bed2..refs/tags/wordpress-4.4:/wp-admin/includes/export.php diff --git a/wp-admin/includes/export.php b/wp-admin/includes/export.php index a9e8f22d..4b18c9c0 100644 --- a/wp-admin/includes/export.php +++ b/wp-admin/includes/export.php @@ -11,287 +11,360 @@ * * Bump this when something changes that might affect compatibility. * - * @since unknown - * @var string + * @since 2.5.0 */ -define('WXR_VERSION', '1.0'); +define( 'WXR_VERSION', '1.2' ); /** - * {@internal Missing Short Description}} + * Generates the WXR export file for download. * - * @since unknown + * @since 2.1.0 * - * @param unknown_type $args + * @global wpdb $wpdb + * @global WP_Post $post + * + * @param array $args Filters defining what should be included in the export. */ function export_wp( $args = array() ) { - global $wpdb, $post_ids, $post, $wp_taxonomies; - - if ( ! is_array( $args ) ) - $args = array( 'author' => $args ); + global $wpdb, $post; - $defaults = array( 'author' => null, 'taxonomy' => null, 'post_type' => null, 'post_status' => null, 'start_date' => null, 'end_date' => null ); + $defaults = array( 'content' => 'all', 'author' => false, 'category' => false, + 'start_date' => false, 'end_date' => false, 'status' => false, + ); $args = wp_parse_args( $args, $defaults ); - extract($args); - - do_action('export_wp'); + /** + * Fires at the beginning of an export, before any headers are sent. + * + * @since 2.3.0 + * + * @param array $args An array of export arguments. + */ + do_action( 'export_wp', $args ); - if( strlen( $start_date ) > 4 && strlen( $end_date ) > 4 ) - $filename = 'wordpress.' . $start_date . '.' . $end_date . '.xml'; - else - $filename = 'wordpress.' . date( 'Y-m-d' ) . '.xml'; + $sitename = sanitize_key( get_bloginfo( 'name' ) ); + if ( ! empty( $sitename ) ) { + $sitename .= '.'; + } + $date = date( 'Y-m-d' ); + $wp_filename = $sitename . 'wordpress.' . $date . '.xml'; + /** + * Filter the export filename. + * + * @since 4.4.0 + * + * @param string $wp_filename The name of the file for download. + * @param string $sitename The site name. + * @param string $date Today's date, formatted. + */ + $filename = apply_filters( 'export_wp_filename', $wp_filename, $sitename, $date ); header( 'Content-Description: File Transfer' ); header( 'Content-Disposition: attachment; filename=' . $filename ); header( 'Content-Type: text/xml; charset=' . get_option( 'blog_charset' ), true ); - if ( $post_type && $post_type != 'all' ) - $where = $wpdb->prepare("WHERE post_type = %s ", $post_type); - else - $where = "WHERE post_type != 'revision' "; + if ( 'all' != $args['content'] && post_type_exists( $args['content'] ) ) { + $ptype = get_post_type_object( $args['content'] ); + if ( ! $ptype->can_export ) + $args['content'] = 'post'; - if ( $author && $author != 'all' ) { - $author_id = (int) $author; - $where .= $wpdb->prepare( "AND post_author = %d ", $author_id ); + $where = $wpdb->prepare( "{$wpdb->posts}.post_type = %s", $args['content'] ); + } else { + $post_types = get_post_types( array( 'can_export' => true ) ); + $esses = array_fill( 0, count($post_types), '%s' ); + $where = $wpdb->prepare( "{$wpdb->posts}.post_type IN (" . implode( ',', $esses ) . ')', $post_types ); } - if ( $start_date && $start_date != 'all' ) - $where .= $wpdb->prepare( "AND post_date >= %s ", $start_date ); - - if ( $end_date && $end_date != 'all' ) - $where .= $wpdb->prepare( "AND post_date < %s ", $end_date ); + if ( $args['status'] && ( 'post' == $args['content'] || 'page' == $args['content'] ) ) + $where .= $wpdb->prepare( " AND {$wpdb->posts}.post_status = %s", $args['status'] ); + else + $where .= " AND {$wpdb->posts}.post_status != 'auto-draft'"; - if ( $taxonomy && is_array( $taxonomy ) ) { - foreach ( $taxonomy as $term_id ) { - if ( $term_id != 'all' ) - $where .= $wpdb->prepare( "AND ID IN (SELECT object_id FROM $wpdb->term_relationships WHERE term_taxonomy_id = %d) ", $term_id ); + $join = ''; + if ( $args['category'] && 'post' == $args['content'] ) { + if ( $term = term_exists( $args['category'], 'category' ) ) { + $join = "INNER JOIN {$wpdb->term_relationships} ON ({$wpdb->posts}.ID = {$wpdb->term_relationships}.object_id)"; + $where .= $wpdb->prepare( " AND {$wpdb->term_relationships}.term_taxonomy_id = %d", $term['term_taxonomy_id'] ); } } - if ( $post_status && $post_status != 'all' ) - $where .= $wpdb->prepare( "AND post_status = %s", $post_status ); + if ( 'post' == $args['content'] || 'page' == $args['content'] || 'attachment' == $args['content'] ) { + if ( $args['author'] ) + $where .= $wpdb->prepare( " AND {$wpdb->posts}.post_author = %d", $args['author'] ); - // grab a snapshot of post IDs, just in case it changes during the export - $post_ids = $wpdb->get_col( "SELECT ID FROM $wpdb->posts $where ORDER BY post_date_gmt ASC" ); + if ( $args['start_date'] ) + $where .= $wpdb->prepare( " AND {$wpdb->posts}.post_date >= %s", date( 'Y-m-d', strtotime($args['start_date']) ) ); - $categories = (array) get_categories( array( 'get' => 'all' ) ); - $tags = (array) get_tags( array( 'get' => 'all' ) ); + if ( $args['end_date'] ) + $where .= $wpdb->prepare( " AND {$wpdb->posts}.post_date < %s", date( 'Y-m-d', strtotime('+1 month', strtotime($args['end_date'])) ) ); + } - $custom_taxonomies = $wp_taxonomies; - unset( $custom_taxonomies['category'] ); - unset( $custom_taxonomies['post_tag'] ); - unset( $custom_taxonomies['link_category'] ); - $custom_taxonomies = array_keys( $custom_taxonomies ); - $terms = (array) get_terms( $custom_taxonomies, array( 'get' => 'all' ) ); + // Grab a snapshot of post IDs, just in case it changes during the export. + $post_ids = $wpdb->get_col( "SELECT ID FROM {$wpdb->posts} $join WHERE $where" ); - /** - * {@internal Missing Short Description}} - * - * @since unknown - * - * @param unknown_type $categories + /* + * Get the requested terms ready, empty unless posts filtered by category + * or all content. */ - function wxr_missing_parents( $categories ) { - if ( ! is_array( $categories ) || empty( $categories ) ) - return array(); - - foreach ( $categories as $category ){ - $parents[$category->term_id] = $category->parent; + $cats = $tags = $terms = array(); + if ( isset( $term ) && $term ) { + $cat = get_term( $term['term_id'], 'category' ); + $cats = array( $cat->term_id => $cat ); + unset( $term, $cat ); + } elseif ( 'all' == $args['content'] ) { + $categories = (array) get_categories( array( 'get' => 'all' ) ); + $tags = (array) get_tags( array( 'get' => 'all' ) ); + + $custom_taxonomies = get_taxonomies( array( '_builtin' => false ) ); + $custom_terms = (array) get_terms( $custom_taxonomies, array( 'get' => 'all' ) ); + + // Put categories in order with no child going before its parent. + while ( $cat = array_shift( $categories ) ) { + if ( $cat->parent == 0 || isset( $cats[$cat->parent] ) ) + $cats[$cat->term_id] = $cat; + else + $categories[] = $cat; } - $parents = array_unique( array_diff( $parents, array_keys( $parents ) ) ); - - if ( $zero = array_search( '0', $parents ) ) - unset( $parents[$zero] ); - - return $parents; - } - - while ( $parents = wxr_missing_parents( $categories ) ) { - $found_parents = get_categories( array( 'include' => join( ', ', $parents) ) ); - if ( is_array( $found_parents ) && count( $found_parents ) ) - $categories = array_merge( $categories, $found_parents ); - else - break; - } + // Put terms in order with no child going before its parent. + while ( $t = array_shift( $custom_terms ) ) { + if ( $t->parent == 0 || isset( $terms[$t->parent] ) ) + $terms[$t->term_id] = $t; + else + $custom_terms[] = $t; + } - // Put them in order to be inserted with no child going before its parent - $pass = 0; - $passes = 1000 + count( $categories ); - while ( ( $cat = array_shift( $categories ) ) && ++$pass < $passes ) { - if ( $cat->parent == 0 || isset( $cats[$cat->parent] ) ) - $cats[$cat->term_id] = $cat; - else - $categories[] = $cat; + unset( $categories, $custom_taxonomies, $custom_terms ); } - unset( $categories ); /** - * Place string in CDATA tag. + * Wrap given string in XML CDATA tag. * - * @since unknown + * @since 2.1.0 * - * @param string $str String to place in XML CDATA tag. + * @param string $str String to wrap in XML CDATA tag. + * @return string */ function wxr_cdata( $str ) { - if ( seems_utf8( $str ) == false ) + if ( ! seems_utf8( $str ) ) { $str = utf8_encode( $str ); - + } // $str = ent2ncr(esc_html($str)); - $str = ""; + $str = '', ']]]]>', $str ) . ']]>'; return $str; } /** - * {@internal Missing Short Description}} + * Return the URL of the site * - * @since unknown + * @since 2.5.0 * * @return string Site URL. */ function wxr_site_url() { - global $current_site; - - // mu: the base url - if ( isset( $current_site->domain ) ) + // Multisite: the base URL. + if ( is_multisite() ) return network_home_url(); - // wp: the blog url + // WordPress (single site): the blog URL. else return get_bloginfo_rss( 'url' ); } /** - * {@internal Missing Short Description}} + * Output a cat_name XML tag from a given category object * - * @since unknown + * @since 2.1.0 * - * @param object $c Category Object + * @param object $category Category Object */ - function wxr_cat_name( $c ) { - if ( empty( $c->name ) ) + function wxr_cat_name( $category ) { + if ( empty( $category->name ) ) return; - echo '' . wxr_cdata( $c->name ) . ''; + echo '' . wxr_cdata( $category->name ) . ''; } /** - * {@internal Missing Short Description}} + * Output a category_description XML tag from a given category object * - * @since unknown + * @since 2.1.0 * - * @param object $c Category Object + * @param object $category Category Object */ - function wxr_category_description( $c ) { - if ( empty( $c->description ) ) + function wxr_category_description( $category ) { + if ( empty( $category->description ) ) return; - echo '' . wxr_cdata($c->description) . ''; + echo '' . wxr_cdata( $category->description ) . ''; } /** - * {@internal Missing Short Description}} + * Output a tag_name XML tag from a given tag object * - * @since unknown + * @since 2.3.0 * - * @param object $t Tag Object + * @param object $tag Tag Object */ - function wxr_tag_name( $t ) { - if ( empty( $t->name ) ) + function wxr_tag_name( $tag ) { + if ( empty( $tag->name ) ) return; - echo '' . wxr_cdata($t->name) . ''; + echo '' . wxr_cdata( $tag->name ) . ''; } /** - * {@internal Missing Short Description}} + * Output a tag_description XML tag from a given tag object * - * @since unknown + * @since 2.3.0 * - * @param object $t Tag Object + * @param object $tag Tag Object */ - function wxr_tag_description( $t ) { - if ( empty( $t->description ) ) + function wxr_tag_description( $tag ) { + if ( empty( $tag->description ) ) return; - echo '' . wxr_cdata($t->description) . ''; + echo '' . wxr_cdata( $tag->description ) . ''; } /** - * {@internal Missing Short Description}} + * Output a term_name XML tag from a given term object * - * @since unknown + * @since 2.9.0 * - * @param object $t Term Object + * @param object $term Term Object */ - function wxr_term_name( $t ) { - if ( empty( $t->name ) ) + function wxr_term_name( $term ) { + if ( empty( $term->name ) ) return; - echo '' . wxr_cdata($t->name) . ''; + echo '' . wxr_cdata( $term->name ) . ''; } /** - * {@internal Missing Short Description}} + * Output a term_description XML tag from a given term object * - * @since unknown + * @since 2.9.0 * - * @param object $t Term Object + * @param object $term Term Object */ - function wxr_term_description( $t ) { - if ( empty( $t->description ) ) + function wxr_term_description( $term ) { + if ( empty( $term->description ) ) return; - echo '' . wxr_cdata($t->description) . ''; + echo '' . wxr_cdata( $term->description ) . ''; } /** - * {@internal Missing Short Description}} + * Output list of authors with posts + * + * @since 3.1.0 + * + * @global wpdb $wpdb WordPress database abstraction object. * - * @since unknown + * @param array $post_ids Array of post IDs to filter the query by. Optional. + */ + function wxr_authors_list( array $post_ids = null ) { + global $wpdb; + + if ( !empty( $post_ids ) ) { + $post_ids = array_map( 'absint', $post_ids ); + $and = 'AND ID IN ( ' . implode( ', ', $post_ids ) . ')'; + } else { + $and = ''; + } + + $authors = array(); + $results = $wpdb->get_results( "SELECT DISTINCT post_author FROM $wpdb->posts WHERE post_status != 'auto-draft' $and" ); + foreach ( (array) $results as $result ) + $authors[] = get_userdata( $result->post_author ); + + $authors = array_filter( $authors ); + + foreach ( $authors as $author ) { + echo "\t"; + echo '' . intval( $author->ID ) . ''; + echo '' . wxr_cdata( $author->user_login ) . ''; + echo '' . wxr_cdata( $author->user_email ) . ''; + echo '' . wxr_cdata( $author->display_name ) . ''; + echo '' . wxr_cdata( $author->first_name ) . ''; + echo '' . wxr_cdata( $author->last_name ) . ''; + echo "\n"; + } + } + + /** + * Ouput all navigation menu terms + * + * @since 3.1.0 + */ + function wxr_nav_menu_terms() { + $nav_menus = wp_get_nav_menus(); + if ( empty( $nav_menus ) || ! is_array( $nav_menus ) ) + return; + + foreach ( $nav_menus as $menu ) { + echo "\t"; + echo '' . intval( $menu->term_id ) . ''; + echo 'nav_menu'; + echo '' . wxr_cdata( $menu->slug ) . ''; + wxr_term_name( $menu ); + echo "\n"; + } + } + + /** + * Output list of taxonomy terms, in XML tag format, associated with a post + * + * @since 2.3.0 */ function wxr_post_taxonomy() { - global $post; + $post = get_post(); - $the_list = ''; - $filter = 'rss'; + $taxonomies = get_object_taxonomies( $post->post_type ); + if ( empty( $taxonomies ) ) + return; + $terms = wp_get_object_terms( $post->ID, $taxonomies ); - $taxonomies = get_object_taxonomies( 'post' ); - $terms = wp_get_post_terms( $post->ID, $taxonomies ); foreach ( (array) $terms as $term ) { - $domain = ( 'post_tag' == $term->taxonomy ) ? 'tag' : $term->taxonomy; - $term_name = sanitize_term_field( 'name', $term->name, $term->term_id, $term->taxonomy, $filter ); - // Back compat. - if ( 'category' == $term->taxonomy ) - $the_list .= "\n\t\t\n"; - elseif ( 'post_tag' == $term->taxonomy ) - $the_list .= "\n\t\t\n"; - // forwards compatibility as above - $the_list .= "\n\t\tslug}\">\n"; + echo "\t\ttaxonomy}\" nicename=\"{$term->slug}\">" . wxr_cdata( $term->name ) . "\n"; } - echo $the_list; } - echo '\n"; + /** + * + * @param bool $return_me + * @param string $meta_key + * @return bool + */ + function wxr_filter_postmeta( $return_me, $meta_key ) { + if ( '_edit_lock' == $meta_key ) + $return_me = true; + return $return_me; + } + add_filter( 'wxr_export_skip_postmeta', 'wxr_filter_postmeta', 10, 2 ); + + echo '\n"; ?> - - + + - - - - - - - - - - - - - - + + + + + + + + + + + + + + + <?php bloginfo_rss( 'name' ); ?> - - - - http://wordpress.org/?v= - + + + + - - slug; ?>parent ? $cats[$c->parent]->name : ''; ?> - - - slug; ?> - - - taxonomy; ?>slug; ?>parent ? $custom_taxonomies[$t->parent]->name : ''; ?> - - - - - in_the_loop = true; // Fake being in the loop. - // fetch 20 posts at a time rather than loading the entire table into memory - while ( $next_posts = array_splice( $post_ids, 0, 20 ) ) { - $where = "WHERE ID IN (" . join( ',', $next_posts ) . ")"; - $posts = $wpdb->get_results( "SELECT * FROM $wpdb->posts $where ORDER BY post_date_gmt ASC" ); - - // Begin Loop - foreach ($posts as $post) { - setup_postdata( $post ); + - $is_sticky = 0; - if ( is_sticky( $post->ID ) ) - $is_sticky = 1; + + term_id ); ?>slug ); ?>parent ? $cats[$c->parent]->slug : '' ); ?> + + + term_id ); ?>slug ); ?> + + + term_id ); ?>taxonomy ); ?>slug ); ?>parent ? $terms[$t->parent]->slug : '' ); ?> + + + + +in_the_loop = true; + + // Fetch 20 posts at a time rather than loading the entire table into memory. + while ( $next_posts = array_splice( $post_ids, 0, 20 ) ) { + $where = 'WHERE ID IN (' . join( ',', $next_posts ) . ')'; + $posts = $wpdb->get_results( "SELECT * FROM {$wpdb->posts} $where" ); + + // Begin Loop. + foreach ( $posts as $post ) { + setup_postdata( $post ); + $is_sticky = is_sticky( $post->ID ) ? 1 : 0; +?> - <?php echo apply_filters( 'the_title_rss', $post->post_title ); ?> + <?php + /** This filter is documented in wp-includes/feed.php */ + echo apply_filters( 'the_title_rss', $post->post_title ); + ?> - - - - + + - post_content ) ); ?> - post_excerpt ) ); ?> - ID; ?> - post_date; ?> - post_date_gmt; ?> - comment_status; ?> - ping_status; ?> - post_name; ?> - post_status; ?> - post_parent; ?> - menu_order; ?> - post_type; ?> - post_password; ?> - - post_type == 'attachment' ) { ?> - ID ); ?> - - get_results( $wpdb->prepare( "SELECT * FROM $wpdb->postmeta WHERE post_id = %d", $post->ID ) ); - if ( $postmeta ) { + post_content ) ); + ?> + post_excerpt ) ); + ?> + ID ); ?> + post_date ); ?> + post_date_gmt ); ?> + comment_status ); ?> + ping_status ); ?> + post_name ); ?> + post_status ); ?> + post_parent ); ?> + menu_order ); ?> + post_type ); ?> + post_password ); ?> + +post_type == 'attachment' ) : ?> + ID ) ); ?> + + +get_results( $wpdb->prepare( "SELECT * FROM $wpdb->postmeta WHERE post_id = %d", $post->ID ) ); + foreach ( $postmeta as $meta ) : + /** + * Filter whether to selectively skip post meta used for WXR exports. + * + * Returning a truthy value to the filter will skip the current meta + * object from being exported. + * + * @since 3.3.0 + * + * @param bool $skip Whether to skip the current post meta. Default false. + * @param string $meta_key Current meta key. + * @param object $meta Current meta object. + */ + if ( apply_filters( 'wxr_export_skip_postmeta', false, $meta->meta_key, $meta ) ) + continue; ?> - - meta_key; ?> - meta_value ); ?> + meta_key ); ?> + meta_value ); ?> - - - get_results( $wpdb->prepare( "SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d", $post->ID ) ); - if ( $comments ) { foreach ( $comments as $c ) { ?> +get_results( $wpdb->prepare( "SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND comment_approved <> 'spam'", $post->ID ) ); + $comments = array_map( 'get_comment', $_comments ); + foreach ( $comments as $c ) : ?> - comment_ID; ?> - comment_author ); ?> - comment_author_email; ?> - comment_author_url ); ?> - comment_author_IP; ?> - comment_date; ?> - comment_date_gmt; ?> - comment_content ) ?> - comment_approved; ?> - comment_type; ?> - comment_parent; ?> - user_id; ?> + comment_ID ); ?> + comment_author ); ?> + comment_author_email ); ?> + comment_author_url ); ?> + comment_author_IP ); ?> + comment_date ); ?> + comment_date_gmt ); ?> + comment_content ) ?> + comment_approved ); ?> + comment_type ); ?> + comment_parent ); ?> + user_id ); ?> +get_results( $wpdb->prepare( "SELECT * FROM $wpdb->commentmeta WHERE comment_id = %d", $c->comment_ID ) ); + foreach ( $c_meta as $meta ) : + /** + * Filter whether to selectively skip comment meta used for WXR exports. + * + * Returning a truthy value to the filter will skip the current meta + * object from being exported. + * + * @since 4.0.0 + * + * @param bool $skip Whether to skip the current comment meta. Default false. + * @param string $meta_key Current meta key. + * @param object $meta Current meta object. + */ + if ( apply_filters( 'wxr_export_skip_commentmeta', false, $meta->meta_key, $meta ) ) { + continue; + } + ?> + + meta_key ); ?> + meta_value ); ?> + + - + - @@ -405,5 +539,3 @@ function export_wp( $args = array() ) {