'all',
'author' => false,
'category' => false,
'start_date' => false,
'end_date' => false,
'status' => false,
'offset' => 0,
'limit' => -1,
'meta_query' => [], // If specified `meta_key` then will include all post(s) that have this meta_key.
'query_args' => []
];
/**
* @var array
*/
private $args;
/**
* @var wpdb
*/
private $wpdb;
private $terms;
private $nav_menu_terms;
public function run(): array {
// Handle glossaries export (as taxonomy)
if ('glossaries' === $this->args['content']) {
return $this->handle_glossaries_export();
}
// Early return for invalid post types
if ($this->args['content'] !== 'docs') {
return [];
}
// Build the base query
$query_parts = $this->build_base_query();
$where = $query_parts['where'];
$join = $query_parts['join'];
// Handle post status
$where .= $this->build_status_condition();
// Handle specific posts selection
if (!empty($this->args['post__in'])) {
$where .= $this->build_post_in_condition();
}
// Handle category terms
if (isset($this->args['category_terms'])) {
$category_query = $this->build_category_query();
$join .= $category_query['join'];
$where .= $category_query['where'];
}
// Handle knowledge base terms
if (isset($this->args['kb_terms'])) {
$kb_query = $this->build_kb_query();
$join .= $kb_query['join'];
$where .= $kb_query['where'];
}
// Handle additional filters (author, dates, meta)
$where .= $this->build_additional_filters();
// Get the main doc post IDs
$post_ids = $this->wpdb->get_col("SELECT DISTINCT {$this->wpdb->posts}.ID FROM {$this->wpdb->posts} $join WHERE $where");
// Handle FAQ posts separately
$faq_post_ids = [];
if (!empty($this->args['include_faq'])) {
$faq_post_ids = $this->get_faq_posts();
}
// Combine post IDs
$all_post_ids = array_merge($post_ids, $faq_post_ids);
// Handle featured images
$thumbnail_ids = $this->get_thumbnail_ids($all_post_ids);
// Generate final post IDs array
$final_post_ids = array_unique(array_merge($all_post_ids, $thumbnail_ids));
return [
'success' => true,
'data' => [
'filename' => 'betterdocs.' . date('Y-m-d') . '.xml',
'filetype' => 'text/xml',
'download' => $this->get_xml_export($final_post_ids),
]
];
}
private function handle_glossaries_export(): array {
if ( isset( $this->args['glossary_terms'] ) && ( count( $this->args['glossary_terms'] ) > 0 ) ) {
$glossary_term_ids = [];
foreach( $this->args['glossary_terms'] as $glossary_slug ) {
$term_object = get_term_by('slug', $glossary_slug , 'glossaries');
if( isset( $term_object->term_id ) && ! empty( $term_object->term_id ) ){
array_push($glossary_term_ids, $term_object->term_id);
}
}
} else {
$glossary_term_ids = $this->wpdb->get_col( "SELECT term_id from {$this->wpdb->term_taxonomy} where taxonomy='{$this->args['content']}';" );
}
$filename = 'betterdocs.' . date( 'Y-m-d' ) . '.xml';
return [
'success' => true,
'data' => [
'filename' => $filename,
'filetype' => 'text/xml',
'download' => $this->get_xml_export($glossary_term_ids),
]
];
}
private function build_base_query(): array {
$where = $this->wpdb->prepare("{$this->wpdb->posts}.post_type = %s", 'docs');
return [
'where' => $where,
'join' => ''
];
}
private function build_status_condition(): string {
if ($this->args['status']) {
return $this->wpdb->prepare(" AND {$this->wpdb->posts}.post_status = %s", $this->args['status']);
}
return " AND {$this->wpdb->posts}.post_status != 'auto-draft'";
}
private function build_post_in_condition(): string {
$ids = $this->args['post__in'];
$ids_placeholder = implode(', ', array_fill(0, count($ids), '%d'));
return $this->wpdb->prepare(" AND {$this->wpdb->posts}.ID IN ($ids_placeholder)", $ids);
}
private function build_category_query(): array {
$join = "INNER JOIN {$this->wpdb->term_relationships} tr ON ({$this->wpdb->posts}.ID = tr.object_id)
INNER JOIN {$this->wpdb->term_taxonomy} tt ON (tr.term_taxonomy_id = tt.term_taxonomy_id)";
$where = " AND tt.taxonomy = 'doc_category'";
if (!empty($this->args['category_terms'])) {
$term_ids = [];
foreach ($this->args['category_terms'] as $term_id) {
$term = term_exists($term_id, 'doc_category');
if ($term) {
$term_ids[] = $term['term_taxonomy_id'];
}
}
if (!empty($term_ids)) {
$term_placeholder = implode(', ', array_fill(0, count($term_ids), '%d'));
$where .= $this->wpdb->prepare(" AND tt.term_taxonomy_id IN ($term_placeholder)", $term_ids);
}
}
return [
'join' => $join,
'where' => $where
];
}
private function build_kb_query(): array {
$join = "INNER JOIN {$this->wpdb->term_relationships} tr ON ({$this->wpdb->posts}.ID = tr.object_id)
INNER JOIN {$this->wpdb->term_taxonomy} tt ON (tr.term_taxonomy_id = tt.term_taxonomy_id)";
$where = " AND tt.taxonomy = 'knowledge_base'";
if (!empty($this->args['kb_terms'])) {
$term_ids = [];
foreach ($this->args['kb_terms'] as $term_id) {
$term = term_exists($term_id, 'knowledge_base');
if ($term) {
$term_ids[] = $term['term_taxonomy_id'];
}
}
if (!empty($term_ids)) {
$term_placeholder = implode(', ', array_fill(0, count($term_ids), '%d'));
$where .= $this->wpdb->prepare(" AND tt.term_taxonomy_id IN ($term_placeholder)", $term_ids);
}
}
return [
'join' => $join,
'where' => $where
];
}
private function build_additional_filters(): string {
$where = '';
if ($this->args['author']) {
$where .= $this->wpdb->prepare(" AND {$this->wpdb->posts}.post_author = %d", $this->args['author']);
}
if ($this->args['start_date']) {
$where .= $this->wpdb->prepare(" AND {$this->wpdb->posts}.post_date >= %s",
gmdate('Y-m-d', strtotime($this->args['start_date'])));
}
if ($this->args['end_date']) {
$where .= $this->wpdb->prepare(" AND {$this->wpdb->posts}.post_date < %s",
gmdate('Y-m-d', strtotime('+1 month', strtotime($this->args['end_date']))));
}
return $where;
}
private function get_faq_posts(): array {
return get_posts([
'numberposts' => -1,
'post_type' => 'betterdocs_faq',
'fields' => 'ids',
'post_status' => 'publish'
]);
}
private function get_thumbnail_ids(array $post_ids): array {
$thumbnail_ids = [];
if (!empty($this->args['include_post_featured_image_as_attachment'])) {
foreach ($post_ids as $post_id) {
$thumbnail_id = get_post_meta($post_id, '_thumbnail_id', true);
if ($thumbnail_id && !in_array($thumbnail_id, $post_ids, true)) {
$thumbnail_ids[] = $thumbnail_id;
}
}
}
return $thumbnail_ids;
}
/**
* Return tabulation characters, by `$columns`.
*
* @param int $columns
*
* @return string
*/
private function indent( int $columns = 1 ): string {
$output = str_repeat( "\t", $columns );
return (string) $output;
}
/**
* Return wrapped given string in XML CDATA tag.
*
* @param string $str String to wrap in XML CDATA tag.
*
* @return string
*/
private function wxr_cdata( $str ): string {
$str = (string) $str;
if ( ! seems_utf8( $str ) ) {
$str = utf8_encode( $str );
}
$str = '', ']]]]>', $str ) . ']]>';
return $str;
}
/**
* Return the URL of the site.
*
* @return string Site URL.
*/
private function wxr_site_url(): string {
if ( is_multisite() ) {
// Multisite: the base URL.
return network_home_url();
} else {
// WordPress (single site): the blog URL.
return get_bloginfo_rss( 'url' );
}
}
/**
* Return a cat_name XML tag from a given category object.
*
* @param WP_Term $category Category Object
*
* @return string
*/
private function wxr_cat_name( $category ): string {
if ( empty( $category->name ) ) {
return '';
}
return $this->indent( 3 ) . '' . $this->wxr_cdata( $category->name ) . '' . PHP_EOL;
}
/**
* Return a category_description XML tag from a given category object.
*
* @param WP_Term $category Category Object
*
* @return string
*/
private function wxr_category_description( $category ): string {
if ( empty( $category->description ) ) {
return '';
}
return $this->indent( 3 ) . '' . $this->wxr_cdata( $category->description ) . "\n";
}
/**
* Return a tag_name XML tag from a given tag object.
*
* @param WP_Term $tag Tag Object
*
* @return string
*/
private function wxr_tag_name( $tag ): string {
if ( empty( $tag->name ) ) {
return '';
}
return $this->indent( 3 ) . '' . $this->wxr_cdata( $tag->name ) . '' . PHP_EOL;
}
/**
* Return a tag_description XML tag from a given tag object.
*
* @param WP_Term $tag Tag Object
*
* @return string
*/
private function wxr_tag_description( $tag ): string {
if ( empty( $tag->description ) ) {
return '';
}
return $this->indent( 3 ) . '' . $this->wxr_cdata( $tag->description ) . '' . PHP_EOL;
}
/**
* Return a term_name XML tag from a given term object.
*
* @param WP_Term $term Term Object
*
* @return string
*/
private function wxr_term_name( $term ): string {
if ( empty( $term->name ) ) {
return '';
}
return $this->indent( 3 ) . '' . $this->wxr_cdata( $term->name ) . '' . PHP_EOL;
}
/**
* Return a term_description XML tag from a given term object.
*
* @param WP_Term $term Term Object
*
* @return string
*/
private function wxr_term_description( $term ): string {
if ( empty( $term->description ) ) {
return '';
}
return $this->indent( 3 ) . '' . $this->wxr_cdata( $term->description ) . '' . PHP_EOL;
}
/**
* Return term meta XML tags for a given term object.
*
* @param WP_Term $term Term object.
*
* @return string
*/
private function wxr_term_meta( $term ): string {
$result = '';
$termmeta = $this->wpdb->get_results( $this->wpdb->prepare( "SELECT * FROM {$this->wpdb->termmeta} WHERE term_id = %d", $term->term_id ) );// phpcs:ignore
foreach ( $termmeta as $meta ) {
/**
* Filters whether to selectively skip term meta used for WXR exports.
*
* Returning a truthy value from the filter will skip the current meta
* object from being exported.
*
* @param bool $skip Whether to skip the current piece of term meta. Default false.
* @param string $meta_key Current meta key.
* @param object $meta Current meta object.
*
* @since 4.6.0
*
*/
if ( ! apply_filters( 'wxr_export_skip_termmeta', false, $meta->meta_key, $meta ) ) {
$result .= sprintf( $this->indent( 3 ) . "\n\t\t\t%s\n\t\t\t%s\n\t\t\n", $this->wxr_cdata( $meta->meta_key ), $this->wxr_cdata( $meta->meta_value ) );
}
}
return $result;
}
/**
* Return list of authors with posts.
*
* @param int[] $post_ids Optional. Array of post IDs to filter the query by.
*
* @return string
*/
private function wxr_authors_list( array $post_ids = null ): string {
$result = '';
if ( ! empty( $post_ids ) ) {
$post_ids = array_map( 'absint', $post_ids );
$and = 'AND ID IN ( ' . implode( ', ', $post_ids ) . ')';
} else {
$and = '';
}
$authors = [];
$results = $this->wpdb->get_results( "SELECT DISTINCT post_author FROM {$this->wpdb->posts} WHERE post_status != 'auto-draft' $and" );// phpcs:ignore
foreach ( (array) $results as $r ) {
$authors[] = get_userdata( $r->post_author );
}
$authors = array_filter( $authors );
foreach ( $authors as $author ) {
$result .= $this->indent( 2 ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . (int) $author->ID . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $author->user_login ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $author->user_email ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $author->display_name ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $author->first_name ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $author->last_name ) . '' . PHP_EOL;
$result .= $this->indent( 2 ) . '' . PHP_EOL;
}
return $result;
}
/**
* Return list of categories.
*
* @param array $cats
*
* @return string
*/
private function wxr_categories_list( array $cats ): string {
$result = '';
foreach ( $cats as $c ) {
$result .= $this->indent( 2 ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . (int) $c->term_id . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $c->slug ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $c->parent ? $cats[ $c->parent ]->slug : '' ) . '' . PHP_EOL;
$result .= $this->wxr_cat_name( $c ) . $this->wxr_category_description( $c ) . $this->wxr_term_meta( $c );
$result .= $this->indent( 2 ) . '' . PHP_EOL;
}
return $result;
}
/**
* Return list of tags.
*
* @param array $tags
*
* @return string
*/
private function wxr_tags_list( array $tags ): string {
$result = '';
foreach ( $tags as $t ) {
$result .= $this->indent( 2 ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . (int) $t->term_id . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $t->slug ) . '' . PHP_EOL;
$result .= $this->wxr_tag_name( $t ) . $this->wxr_tag_description( $t ) . $this->wxr_term_meta( $t );
$result .= $this->indent( 2 ) . '' . PHP_EOL;
}
return $result;
}
public function get_parent_terms_slug( $terms, $term_id ) {
$key = array_search( $term_id, array_column( $terms, 'term_id' ));
if ( $key !== false ) {
return $terms[$key]->slug;
}
return null;
}
/**
* Return list of terms.
*
* @param array $terms
*
* @return string
*/
private function wxr_terms_list( array $terms ): string {
$result = '';
foreach ( $terms as $key => $t ) {
$result .= $this->indent( 2 ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $t->term_id ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $t->taxonomy ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $t->slug ) . '' . PHP_EOL;
if ( $t->parent ) {
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $this->get_parent_terms_slug( $terms, $t->parent ) ) . '' . PHP_EOL;
}
$result .= $this->wxr_term_name( $t ) . $this->wxr_term_description( $t ) . $this->wxr_term_meta( $t );
$result .= $this->indent( 2 ) . '' . PHP_EOL;
}
return $result;
}
/**
* Retrieve terms associated with the specified object IDs and sort them based on term meta.
*
* @param array $post_ids An array of object IDs.
* @return array An array of WP_Term objects sorted based on term meta.
*/
public function get_terms( array $post_ids ) {
// Get the object taxonomies
$taxonomies = get_object_taxonomies( $this->args['content'] );
if ( isset( $this->args['selected_docs'] ) && ! empty ( $this->args['selected_docs'] ) && $this->args['selected_docs'][0] == 'all' ) {
$terms = get_terms( [
'taxonomy' => $taxonomies,
'hide_empty' => false,
] );
} else if( $this->args['content'] == 'glossaries' ) {
$terms = get_terms([
'taxonomy' => 'glossaries',
'include' => $post_ids,
'hide_empty' => false,
]);
} else {
$terms = wp_get_object_terms( $post_ids, $taxonomies);
}
usort( $terms, array( $this, 'compare_terms_by_meta' ) );
return $terms;
}
/**
* Compare terms based on their associated term meta values.
*
* @param WP_Term $a The first term object.
* @param WP_Term $b The second term object.
* @return int Returns a negative value if $a is less than $b,
* a positive value if $a is greater than $b, or 0 if they are equal.
* Additionally, prioritize sorting terms by taxonomy order,
* with 'doc_category' terms appearing before other taxonomy terms.
*/
public function compare_terms_by_meta($a, $b) {
// Define the order of taxonomies
$taxonomy_order = array(
'doc_category' => 0,
'knowledge_base' => 1,
'doc_tag' => 2,
);
// Get the taxonomy order for terms $a and $b
$order_a = isset($taxonomy_order[$a->taxonomy]) ? $taxonomy_order[$a->taxonomy] : PHP_INT_MAX;
$order_b = isset($taxonomy_order[$b->taxonomy]) ? $taxonomy_order[$b->taxonomy] : PHP_INT_MAX;
// If the taxonomies have different order, sort by order
if ($order_a !== $order_b) {
return $order_a - $order_b;
}
// If the taxonomies have the same order, sort by meta value
$taxonomy_order_meta = array(
'doc_category' => 'doc_category_order',
'knowledge_base' => 'kb_order'
);
if (isset($taxonomy_order_meta[$a->taxonomy]) && isset($taxonomy_order_meta[$b->taxonomy])) {
$meta_a = intval(get_term_meta($a->term_id, $taxonomy_order_meta[$a->taxonomy], true));
$meta_b = intval(get_term_meta($b->term_id, $taxonomy_order_meta[$b->taxonomy], true));
return $meta_a - $meta_b;
}
return 0; // Default to no sorting if meta keys are not defined
}
/**
* Return list of posts, by requested `$post_ids`.
*
* @param array $post_ids
*
* @return string
*/
private function wxr_posts_list( array $post_ids ): string {
$result = '';
if ( $post_ids ) {
global $wp_query;
// Fake being in the loop.
$wp_query->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 (' . implode( ',', $next_posts ) . ')';
$posts = $this->wpdb->get_results( "SELECT * FROM {$this->wpdb->posts} $where" );// phpcs:ignore
// Begin Loop.
foreach ( $posts as $post ) {
setup_postdata( $post );
$title = apply_filters( 'the_title_rss', $post->post_title );
/**
* Filters the post content used for WXR exports.
*
* @param string $post_content Content of the current post.
*
* @since 2.5.0
*
*/
$content = $this->wxr_cdata( apply_filters( 'the_content_export', $post->post_content ) );
/**
* Filters the post excerpt used for WXR exports.
*
* @param string $post_excerpt Excerpt for the current post.
*
* @since 2.6.0
*
*/
$excerpt = $this->wxr_cdata( apply_filters( 'the_excerpt_export', $post->post_excerpt ) );
$result .= $this->indent( 2 ) . '- ' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $title . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . esc_url( get_permalink() ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . mysql2date( 'D, d M Y H:i:s +0000', get_post_time( 'Y-m-d H:i:s', true ), false ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( get_the_author_meta( 'login' ) ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( get_the_author_meta( 'login' ) ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $content . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $excerpt . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . (int) $post->ID . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->post_date ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->post_date_gmt ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->comment_status ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->ping_status ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->post_name ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->post_status ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->post_parent ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . (int) $post->menu_order . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->post_type ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $post->post_password ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . ( is_sticky( $post->ID ) ? 1 : 0 ) . '' . PHP_EOL;
if ( 'attachment' === $post->post_type ) {
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( wp_get_attachment_url( $post->ID ) ) . '' . PHP_EOL;
}
$result .= $this->wxr_post_taxonomy( $post );
$postmeta = $this->wpdb->get_results( $this->wpdb->prepare( "SELECT * FROM {$this->wpdb->postmeta} WHERE post_id = %d", $post->ID ) );// phpcs:ignore
foreach ( $postmeta as $meta ) {
/**
* Filters whether to selectively skip post meta used for WXR exports.
*
* Returning a truthy value from the filter will skip the current meta
* object from being exported.
*
* @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.
*
* @since 3.3.0
*
*/
if ( apply_filters( 'wxr_export_skip_postmeta', false, $meta->meta_key, $meta ) ) {
continue;
}
$result .= $this->indent( 3 ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $meta->meta_key ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $meta->meta_value ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . PHP_EOL;
}
$_comments = $this->wpdb->get_results( $this->wpdb->prepare( "SELECT * FROM {$this->wpdb->comments} WHERE comment_post_ID = %d AND comment_approved <> 'spam'", $post->ID ) );// phpcs:ignore
$comments = array_map( 'get_comment', $_comments );
foreach ( $comments as $c ) {
$result .= $this->indent( 3 ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . (int) $c->comment_ID . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_author ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_author_email ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_author_url ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_author_IP ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_date ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_date_gmt ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_content ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_approved ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_type ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . $this->wxr_cdata( $c->comment_parent ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . (int) $c->user_id . '' . PHP_EOL;
$c_meta = $this->wpdb->get_results( $this->wpdb->prepare( "SELECT * FROM {$this->wpdb->commentmeta} WHERE comment_id = %d", $c->comment_ID ) );// phpcs:ignore
foreach ( $c_meta as $meta ) {
/**
* Filters whether to selectively skip comment meta used for WXR exports.
*
* Returning a truthy value from the filter will skip the current meta
* object from being exported.
*
* @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.
*
* @since 4.0.0
*
*/
if ( apply_filters( 'wxr_export_skip_commentmeta', false, $meta->meta_key, $meta ) ) {
continue;
}
$result .= $this->indent( 4 ) . '' . PHP_EOL;
$result .= $this->indent( 5 ) . '' . $this->wxr_cdata( $meta->meta_key ) . '' . PHP_EOL;
$result .= $this->indent( 5 ) . '' . $this->wxr_cdata( $meta->meta_key ) . '' . PHP_EOL;
$result .= $this->indent( 4 ) . '' . PHP_EOL;
}
$result .= $this->indent( 3 ) . '' . PHP_EOL;
}
$result .= $this->indent( 2 ) . '
' . PHP_EOL;
}
}
}
return $result;
}
/**
* Return all navigation menu terms
*
* @return string
*/
private function wxr_nav_menu_terms(): string {
$args = [];
if( ! empty( $this->nav_menu_terms ) ) {
$args['include'] = $this->nav_menu_terms;
}
$nav_menus = wp_get_nav_menus( $args );
if ( empty( $nav_menus ) || ! is_array( $nav_menus ) ) {
return '';
}
$result = '';
foreach ( $nav_menus as $menu ) {
$this->terms[ $menu->term_id ] = $menu;
$result .= $this->indent( 2 ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . (int) $menu->term_id . '' . PHP_EOL;
$result .= $this->indent( 3 ) . 'nav_menu' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $menu->slug ) . '' . PHP_EOL;
$result .= $this->indent( 3 ) . '' . $this->wxr_cdata( $menu->name ) . '' . PHP_EOL;
$result .= $this->indent( 2 ) . '' . PHP_EOL;
}
return $result;
}
/**
* Return list of taxonomy terms, in XML tag format, associated with a post
*
* @param object $post
*
* @return string
*/
private function wxr_post_taxonomy( $post ): string {
$result = '';
$taxonomies = get_object_taxonomies( $post->post_type );
if ( empty( $taxonomies ) ) {
return $result;
}
$terms = wp_get_object_terms( $post->ID, $taxonomies );
foreach ( (array) $terms as $term ) {
$result .= $this->indent( 3 ) . "taxonomy}\" nicename=\"{$term->slug}\">" . $this->wxr_cdata( $term->name ) . '' . PHP_EOL;
}
return $result;
}
/**
* Get the XML export.
*
* @param array $post_ids
*
* @return string
*/
private function get_xml_export( array $post_ids ): string {
$charset = get_bloginfo( 'charset' );
$generator = get_the_generator( 'export' );
$wxr_version = self::WXR_VERSION;
$wxr_site_url = $this->wxr_site_url();
$rss_info_name = get_bloginfo_rss( 'name' );
$rss_info_url = get_bloginfo_rss( 'url' );
$rss_info_description = get_bloginfo_rss( 'description' );
$rss_info_language = get_bloginfo_rss( 'language' );
$pub_date = gmdate( 'D, d M Y H:i:s +0000' );
$dynamic = $this->wxr_authors_list( $post_ids );
ob_start();
/** This action is documented in wp-includes/feed-rss2.php */
do_action( 'rss2_head' );
$rss2_head = ob_get_clean();
$dynamic .= $rss2_head;
if ( 'all' === $this->args['content'] || 'nav_menu_item' === $this->args['content'] ) {
$dynamic .= $this->wxr_nav_menu_terms();
}
$dynamic .= $this->wxr_terms_list( $this->get_terms( $post_ids ) );
$dynamic .= $this->wxr_posts_list( $post_ids );
$result = <<
$generator
$rss_info_name
$rss_info_url
$rss_info_description
$pub_date
$rss_info_language
$wxr_version
$wxr_site_url
$rss_info_url
$dynamic
EOT;
return $result;
}
public function __construct( array $args = [] ) {
global $wpdb;
$this->args = wp_parse_args( $args, self::$default_args );
$this->wpdb = $wpdb;
}
}