Sid Gifari File Manager

Sid Gifari File Manager

🏠 Root / home / genremedia08 / thepassage.overlookedtracks.com / wp-content9 / plugins / buddypress-docs / includes /

Editing: addon-folders.php

<?php

/**
 * Folder functionality.
 *
 * @since 1.9
 */
class BP_Docs_Folders {

/**
	 * Constructor.
	 *
	 * @since 1.9
	 */
	public function __construct() {
		$this->register_ajax_actions();

if ( ! bp_docs_enable_folders() ) {
			return;
		}

$this->register_post_type();
		$this->register_taxonomies();

// It is my hope and dream that this will one day be persistent.
		wp_cache_add_non_persistent_groups( array( 'bp_docs_folders' ) );

add_action( 'bp_docs_enqueue_scripts', array( $this, 'enqueue_assets' ) );

$this->setup_hooks();
	}

/**
	 * Register the Folder post type.
	 *
	 * This add-on is loaded after 'init', so we call it directly from the
	 * constructor.
	 *
	 * @since 1.9
	 */
	public function register_post_type() {
		$labels = array(
			'name' => __( 'BuddyPress Docs Folders', 'buddypress-docs' ),
			'singular_name' => __( 'BuddyPress Docs Folder', 'buddypress-docs' ),
			'menu_name' => __( 'Docs Folders', 'buddypress-docs' ),
			'name_admin_bar' => __( 'Docs Folder', 'buddypress-docs' ),
		);

register_post_type( 'bp_docs_folder', array(
			'labels' => $labels,
			'public' => false,
			'hierarchical' => true,
		) );
	}

/**
	 * Register the Folders taxonomies.
	 *
	 * - bp_docs_doc_in_folder contains relationships between Docs and
	 *   Folders
	 * - bp_docs_folder_in_user contains relationships between Folders
	 *   and Users
	 * - bp_docs_folder_in_group contains relationships between Folders
	 *   and Groups
	 *
	 * @since 1.9
	 */
	public function register_taxonomies() {
		register_taxonomy( 'bp_docs_doc_in_folder', bp_docs_get_post_type_name(), array(
			'public' => false,
		) );

register_taxonomy( 'bp_docs_folder_in_user', 'bp_docs_folder', array(
			'public' => false,
		) );

if ( bp_is_active( 'groups' ) ) {
			register_taxonomy( 'bp_docs_folder_in_group', 'bp_docs_folder', array(
				'public' => false,
			) );
		}
	}

/**
	 * Hook the Folders functionality into Docs.
	 *
	 * @since 1.9
	 */
	public function setup_hooks() {
		// Generate tax_query syntax for folder queries.
		add_filter( 'bp_docs_tax_query', 'bp_docs_folder_tax_query', 10, 2 );

// Filter capabilities for folders.
		add_filter( 'bp_docs_map_meta_caps', 'bp_docs_folders_map_meta_caps', 10, 4 );

// Validate folder selection when saving a Doc.
		add_filter( 'bp_docs_before_save_folder_selection', 'bp_docs_validate_group_folder_selection_on_doc_save', 10, 2 );

// Single Doc breadcrumbs.
		add_action( 'bp_docs_doc_breadcrumbs', 'bp_docs_folder_single_breadcrumb', 10, 2 );

// Show folder info on a single Doc.
		add_action( 'bp_docs_single_doc_meta', 'bp_docs_display_folder_meta' );

// Add Folders meta box to Edit screen.
		add_action( 'bp_docs_before_tags_meta_box', 'bp_docs_folders_meta_box' );

// Process new folder selections after save.
		add_action( 'bp_docs_after_save', 'bp_docs_save_folder_selection' );

// Screen controllers.
		add_action( 'bp_actions', 'bp_docs_process_folder_edit_cb' );
		add_action( 'bp_actions', 'bp_docs_process_folder_create_cb' );
		add_action( 'bp_actions', 'bp_docs_process_folder_delete_cb' );

// AJAX callbacks.
		add_action( 'wp_ajax_bp_docs_update_folders', 'bp_docs_update_folders_cb' );
		add_action( 'wp_ajax_bp_docs_update_parent_folders', 'bp_docs_update_parent_folders_cb' );
		add_action( 'wp_ajax_bp_docs_update_folder_type', 'bp_docs_update_folder_type_cb' );
		add_action( 'wp_ajax_bp_docs_update_folder_type_for_group', 'bp_docs_update_folder_type_for_group_cb' );
		add_action( 'wp_ajax_bp_docs_process_folder_drop', 'bp_docs_process_folder_drop_cb' );
		// AJAX template calls
		add_action( 'wp_ajax_bp_docs_get_folder_content', 'bp_docs_get_folder_content_cb' );
		add_action( 'wp_ajax_nopriv_bp_docs_get_folder_content', 'bp_docs_get_folder_content_cb' );

// Folders UI is limited to the Group context for now. Change at your own risk.
		if ( ! bp_docs_enable_folders_for_current_context() ) {
			return;
		}

// Directory breadcrumbs.
		add_filter( 'bp_docs_directory_breadcrumb', 'bp_docs_folders_directory_breadcrumb', 6 );

// Add folder info to directory filter message.
		add_filter( 'bp_docs_get_current_filters', 'bp_docs_folder_current_filters' );

// Ensure folder filters are maintained during directory filters.
		add_action( 'bp_docs_directory_filter_attachments_form', 'bp_docs_folders_directory_filter_form_argument' );
		add_action( 'bp_docs_directory_filter_search_form', 'bp_docs_folders_directory_filter_form_argument' );

// Add current folder info to info message.
		add_filter( 'bp_docs_info_header_message', 'bp_docs_folder_info_header_message', 10, 2 );

// Set up conditional filtering of tag links.
		add_action( 'bp_docs_directory_filter_taxonomy_before', 'bp_docs_folders_directory_filter_taxonomy_hooker' );
		add_action( 'bp_docs_directory_filter_taxonomy_after', 'bp_docs_folders_directory_filter_taxonomy_unhooker' );

// Modify Create links to be folder-sensitive.
		add_filter( 'bp_docs_get_create_link', 'bp_docs_folders_create_link' );

// Determine whether the directory view is filtered by a folder request.
		add_filter( 'bp_docs_is_directory_view_filtered', 'bp_docs_is_directory_view_filtered_by_folder', 10, 2 );

// Add draggable/droppable classes to the docs loop items.
		add_filter( 'bp_docs_doc_row_classes', 'bp_docs_item_add_draggable_class' );
	}

/**
	 * Enqueue CSS and JS assets.
	 *
	 * @since 1.9
	 */
	public function enqueue_assets() {
		wp_register_script( 'bp-docs-chosen', plugins_url() . '/buddypress-docs/lib/js/chosen/chosen.jquery.min.js', array( 'jquery' ) );

$js_requirements = array(
			'jquery',
			'bp-docs-chosen',
			'jquery-ui-droppable',
		);

wp_enqueue_script( 'bp-docs-folders', plugins_url() . '/buddypress-docs/includes/js/folders.js', $js_requirements );

wp_register_style( 'bp-docs-chosen', plugins_url() . '/buddypress-docs/lib/css/chosen/chosen.min.css' );
		if ( is_rtl() ) {
			wp_enqueue_style( 'bp-docs-folders', plugins_url() . '/buddypress-docs/includes/css-rtl/folders.css', array( 'bp-docs-chosen' ) );
		} else {
			wp_enqueue_style( 'bp-docs-folders', plugins_url() . '/buddypress-docs/includes/css/folders.css', array( 'bp-docs-chosen' ) );
		}

/**
		 * Filter whether Folders metabox should be force-shown.
		 *
		 * This will override any JS-based logic.
		 *
		 * @since 1.9.1
		 *
		 * @param bool $show
		 */
		$force_folders_metabox = apply_filters( 'bp_docs_folders_force_metabox', false );

wp_localize_script( 'bp-docs-folders', 'BP_Docs_Folders', array(
			'folders_tab_label' => _x( 'Folders', 'Doc edit tab name', 'buddypress-docs' ),
			'folders_tab_label_groups' => _x( 'Group Folders', 'Doc edit tab name', 'buddypress-docs' ),
			'force_metabox' => $force_folders_metabox,
		) );
	}

/**
	 * Register AJAX actions.
	 *
	 * Required by BuddyPress 12+, so that context information like "current group"
	 * is available during our AJAX callbacks.
	 *
	 * @since 2.2.3
	 *
	 * @return void
	 */
	public function register_ajax_actions() {
		if ( ! function_exists( 'bp_ajax_register_action' ) ) {
			return;
		}

$ajax_actions = array(
			'bp_docs_update_folders',
			'bp_docs_update_parent_folders',
			'bp_docs_update_folder_type',
			'bp_docs_update_folder_type_for_group',
			'bp_docs_process_folder_drop',
			'bp_docs_get_folder_content',
		);

foreach ( $ajax_actions as $action ) {
			bp_ajax_register_action( $action );
		}
	}
}

/** Utility functions ********************************************************/

/**
 * Is the folders function enabled?
 *
 * Use this toggle to disable folders.
 *
 * @since 1.9
 *
 * @return bool
 */
function bp_docs_enable_folders() {
	return apply_filters( 'bp_docs_enable_folders', true );
}

/**
 * Is the folders function enabled for the current context?
 *
 * Use this toggle to filter whether folders should be enabled in the current interface.
 *
 * @since 1.9
 *
 * @return bool
 */
function bp_docs_enable_folders_for_current_context() {
	// Enabled only in groups by default. Enable elsewhere only at your own risk.
	$enable = function_exists( 'bp_is_group' ) && bp_is_group();
	return apply_filters( 'bp_docs_enable_folders_for_current_context', (bool) $enable );
}

/**
 * Should folders be included in the view of the loop?
 * If a filter is selected, we don't show the folders, for instance.
 *
 * @since 1.9.0
 *
 * @return bool
 */
function bp_docs_include_folders_in_loop_view() {
	$enable = true;
	// If any non-folder filters are set, we don't include folders.
	if ( bp_docs_is_directory_view_filtered( array( 'folder' ) ) ) {
		$enable = false;
	}

return apply_filters( 'bp_docs_include_folders_in_loop_view', (bool) $enable );
}

/**
 * Concatenate a slug for bp_docs_doc_in_folder terms, based on folder ID.
 *
 * @param int $folder_id
 * @return string
 */
function bp_docs_get_folder_term_slug( $folder_id ) {
	return 'bp_docs_doc_in_folder_' . intval( $folder_id );
}

/**
 * Concatenate a slug for bp_docs_folder_in_group term, based on group ID.
 *
 * @param int $group_id
 * @return string
 */
function bp_docs_get_folder_in_group_term_slug( $group_id ) {
	return 'bp_docs_folder_in_group_' . intval( $group_id );
}

/**
 * Concatenate a slug for bp_docs_folder_in_user term, based on user ID.
 *
 * @param int $user_id
 * @return string
 */
function bp_docs_get_folder_in_user_term_slug( $user_id ) {
	return 'bp_docs_folder_in_user_' . intval( $user_id );
}

/**
 * Get the bp_docs_doc_in_folder term for a given folder.
 *
 * @param int $folder_id
 * @return int|bool $term_id False on failure, term id on success.
 */
function bp_docs_get_folder_term( $folder_id ) {
	$folder = get_post( $folder_id );

if ( is_wp_error( $folder ) || empty( $folder ) || 'bp_docs_folder' !== $folder->post_type ) {
		return false;
	}

$term_slug = bp_docs_get_folder_term_slug( $folder_id );

$term_id = false;
	$term = get_term_by( 'slug', $term_slug , 'bp_docs_doc_in_folder' );

// Doesn't exist, so we must create
	if ( empty( $term ) || is_wp_error( $term ) ) {
		$new_term = wp_insert_term( $term_slug, 'bp_docs_doc_in_folder', array(
			'slug' => $term_slug,
		) );

if ( ! is_wp_error( $new_term ) ) {
			$term_id = intval( $new_term['term_id'] );
		}
	} else {
		$term_id = intval( $term->term_id );
	}

return $term_id;
}

/**
 * Get a term for a folder-in-x relationship.
 *
 * @param int $item_id
 * @param string $item_type 'user' or 'group'
 * @return int $term_id
 */
function bp_docs_get_folder_in_item_term( $item_id, $item_type ) {
	switch ( $item_type ) {
		case 'group' :
			if ( ! bp_is_active( 'groups' ) ) {
				return false;
			}

$group = groups_get_group( array(
				'group_id' => $item_id,
			) );

if ( empty( $group->id ) ) {
				return false;
			}

$term_slug = bp_docs_get_folder_in_group_term_slug( $group->id );
			$taxonomy = 'bp_docs_folder_in_group';

break;

case 'user' :
			$user = new WP_User( $item_id );

if ( empty( $user ) || is_wp_error( $user ) || empty( $user->ID ) ) {
				return false;
			}

$term_slug = bp_docs_get_folder_in_user_term_slug( $user->ID );
			$taxonomy = 'bp_docs_folder_in_user';

break;
	}

$term_id = false;
	$term = get_term_by( 'slug', $term_slug , $taxonomy );

// Doesn't exist, so we must create
	if ( empty( $term ) || is_wp_error( $term ) ) {
		$new_term = wp_insert_term( $term_slug, $taxonomy, array(
			'slug' => $term_slug,
		) );

if ( ! is_wp_error( $new_term ) ) {
			$term_id = intval( $new_term['term_id'] );
		}
	} else {
		$term_id = intval( $term->term_id );
	}

return $term_id;
}

/**
 * Get the ID of folder that a Doc is in.
 *
 * @since 1.9
 *
 * @param int $doc_id ID of the Doc.
 * @return int|bool ID of the folder if found, otherwise false.
 */
function bp_docs_get_doc_folder( $doc_id ) {
	$folder_id = false;

$maybe_folders = wp_get_object_terms( $doc_id, array(
		'bp_docs_doc_in_folder',
	) );

// Take the first one
	if ( ! empty( $maybe_folders ) && ! is_wp_error( $maybe_folders ) ) {
		$folder_id = intval( substr( $maybe_folders[0]->slug, 22 ) );
	}

return $folder_id;
}

/**
 * Get the ID of the group that a folder belongs to.
 *
 * @param int $folder_id ID of folder.
 * @return int|bool ID of group if found, otherwise false.
 */
function bp_docs_get_folder_group( $folder_id ) {
	$group_id = false;

if ( ! bp_is_active( 'groups' ) ) {
		return $group_id;
	}

$folder_group_terms = get_the_terms( $folder_id, 'bp_docs_folder_in_group' );
	if ( ! empty( $folder_group_terms ) ) {
		$group_id = intval( substr( $folder_group_terms[0]->slug, 24 ) );
	}

return $group_id;
}

/**
 * Get the ID of the user that a folder belongs to.
 *
 * @param int $folder_id ID of folder.
 * @return int|bool ID of user if found, otherwise false.
 */
function bp_docs_get_folder_user( $folder_id ) {
	$user_id = false;

$folder_user_terms = get_the_terms( $folder_id, 'bp_docs_folder_in_user' );
	if ( ! empty( $folder_user_terms ) ) {
		$user_id = intval( substr( $folder_user_terms[0]->slug, 23 ) );
	}

return $user_id;
}

/**
 * Get the ID of the folder from a term ID.
 *
 * @param int $folder_id ID of term.
 * @param string $taxonomy Taxonomy of the term.
 * @return int|bool ID of folder if found, otherwise false.
 */
function bp_docs_get_folder_id_from_term_id( $term_id, $taxonomy ) {
	$folder_id = false;

$folder_term = get_term_by( 'id', $term_id, $taxonomy );
	if ( ! empty( $folder_term->slug ) ) {
		$substr_length = strlen( $folder_term->taxonomy ) + 1;
		$folder_id = intval( substr( $folder_term->slug, $substr_length ) );
	}

return $folder_id;
}

/**
 * Get the ID of the folder from a taxonomy_term_id.
 *
 * @param int $folder_id Taxonomy term ID of term.
 * @return int|bool ID of folder if found, otherwise false.
 */
function bp_docs_get_folder_id_from_tax_term_id( $tt_id ) {
	$folder_id = false;

$folder_term = get_term_by( 'term_taxonomy_id', $tt_id );
	if ( ! empty( $folder_term->slug ) ) {
		$substr_length = strlen( $folder_term->taxonomy ) + 1;
		$folder_id = intval( substr( $folder_term->slug, $substr_length ) );
	}

return $folder_id;
}

/**
 * Add a Doc to a Folder.
 *
 * @since 1.9
 *
 * @param int $doc_id
 * @param int $folder_id
 * @param bool $append Whether to append to existing folders, or replace.
 *        Default: false (replace).
 * @return bool True on success, false on failure.
 */
function bp_docs_add_doc_to_folder( $doc_id, $folder_id, $append = false ) {
	$doc = get_post( $doc_id );

if ( is_wp_error( $doc ) || empty( $doc ) || bp_docs_get_post_type_name() !== $doc->post_type ) {
		return false;
	}

$folder = get_post( $folder_id );

if ( is_wp_error( $folder ) || empty( $folder ) || 'bp_docs_folder' !== $folder->post_type ) {
		return false;
	}

$term_id = bp_docs_get_folder_term( $folder_id );

// misc error
	if ( ! $term_id ) {
		return false;
	}

$existing_folders = wp_get_object_terms( $doc_id, 'bp_docs_doc_in_folder' );

// Return false if already in folder
	foreach ( $existing_folders as $existing_folder ) {
		if ( $term_id === $existing_folder->term_id ) {
			return false;
		}
	}

// Merge new folder into old ones
	if ( $append ) {
		$term_ids = ! empty( $existing_folders ) ? wp_parse_id_list( wp_list_pluck( $existing_folders, 'term_id' ) ) : array();
		$term_ids[] = $term_id;
	} else {
		$term_ids = array( $term_id );
	}

return (bool) wp_set_object_terms( $doc_id, $term_ids, 'bp_docs_doc_in_folder' );
}

/**
 * Remove a Doc from a Folder.
 *
 * @since 1.9
 *
 * @param int $doc_id
 * @param int $folder_id
 * @return bool True on success, false on failure.
 */
function bp_docs_remove_doc_from_folder( $doc_id, $folder_id ) {
	$doc = get_post( $doc_id );

if ( is_wp_error( $doc ) || empty( $doc ) || bp_docs_get_post_type_name() !== $doc->post_type ) {
		return false;
	}

$folder = get_post( $folder_id );

if ( is_wp_error( $folder ) || empty( $folder ) || 'bp_docs_folder' !== $folder->post_type ) {
		return false;
	}

$term_id = bp_docs_get_folder_term( $folder_id );

// misc error
	if ( ! $term_id ) {
		return false;
	}

$existing_folders = wp_get_object_terms( $doc_id, 'bp_docs_doc_in_folder' );

// Return false if not in folder
	$in_folder = false;
	foreach ( $existing_folders as $existing_folder ) {
		if ( $term_id === $existing_folder->term_id ) {
			$in_folder = true;
			break;
		}
	}

if ( ! $in_folder ) {
		return false;
	}

return (bool) wp_remove_object_terms( $doc_id, $term_id, 'bp_docs_doc_in_folder' );
}
/**
 * Create a Folder.
 *
 * @since 1.9
 *
 * @param array $args {
 *     Array of parameters.
 *     @type string $name Name of the folder, for display in the interface.
 *     @type int $user_id Optional. ID of the user that the folder is limited
 *           to.
 *     @type int $group_id Optional. ID of the group that the folder is
 *           limited to.
 * }
 * @return int|bool ID of the newly created folder on success, false on failure.
 */
function bp_docs_create_folder( $args ) {
	$r = wp_parse_args( $args, array(
		'folder_id' => null,
		'name' => '',
		'parent' => null,
		'group_id' => null,
		'user_id' => null,
	) );

if ( empty( $r['name'] ) ) {
		return false;
	}

// Validate group ID
	if ( ! empty( $r['group_id'] ) ) {
		if ( ! bp_is_active( 'groups' ) ) {
			return false;
		}

$r['group_id'] = intval( $r['group_id'] );

$group = groups_get_group( array(
			'group_id' => $r['group_id'],
		) );

if ( empty( $group->id ) ) {
			return false;
		}
	}

// Validate post parent
	if ( ! empty( $r['parent'] ) ) {
		$r['parent'] = intval( $r['parent'] );

$maybe_parent = get_post( $r['parent'] );
		if ( ! is_a( $maybe_parent, 'WP_Post' ) ) {
			return false;
		}
	}

$post_args = array(
		'post_type'   => 'bp_docs_folder',
		'post_title'  => $r['name'],
		'post_status' => 'publish',
		'post_parent' => $r['parent'],
	);

if ( ! empty( $r['folder_id'] ) ) {
		$post_args['ID'] = intval( $r['folder_id'] );
	}

$folder_id = wp_insert_post( $post_args );

// If a group ID was passed, associate with group
	if ( ! empty( $r['group_id'] ) ) {
		$group_term = bp_docs_get_folder_in_item_term( $r['group_id'], 'group' );
		wp_set_object_terms( $folder_id, $group_term, 'bp_docs_folder_in_group' );
	} else if ( ! empty( $r['user_id'] ) ) {
		$user_term = bp_docs_get_folder_in_item_term( $r['user_id'], 'user' );
		wp_set_object_terms( $folder_id, $user_term, 'bp_docs_folder_in_user' );
	}

if ( is_wp_error( $folder_id ) ) {
		return false;
	} else {
		return intval( $folder_id );
	}
}

/**
 * Delete a folder.
 *
 * @since 1.9.0
 *
 * @param array $args {
 *     $type int $folder_id ID of the folder to be deleted.
 *     $type bool $delete_contents Delete folder contents (subfolders and docs)
 * }
 * @return bool
 */
function bp_docs_delete_folder( $args = array() ) {
	$r = wp_parse_args( $args, array(
		'folder_id'       => 0,
		'delete_contents' => false,
	) );

if ( empty( $r['folder_id'] ) ) {
		return false;
	}

if ( true === $r['delete_contents'] ) {
		bp_docs_delete_folder_contents( $r['folder_id'] );
	}

wp_trash_post( $r['folder_id'] );

return true;
}

/**
 * Delete folder contents.
 *
 * @since 1.9.0
 *
 * @param int $folder_id
 * @return bool
 */
function bp_docs_delete_folder_contents( $folder_id ) {

// Docs first
	$folder_term = bp_docs_get_folder_term( $folder_id );
	$folder_docs = get_posts( array(
		'post_type' => bp_docs_get_post_type_name(),
		'tax_query' => array(
			array(
				'taxonomy' => 'bp_docs_doc_in_folder',
				'field' => 'term_id',
				'terms' => $folder_term,
			),
		),
		'update_meta_cache' => false,
		'update_term_cache' => false,
	) );

$retval = true;

foreach ( $folder_docs as $fd ) {
		if ( ! wp_trash_post( $fd->ID ) ) {
			$retval = false;
		}
	}

// Subfolders
	$folder_subfolders = bp_docs_get_folders( array(
		'parent_id' => $folder_id,
	) );

// Recurse
	foreach ( $folder_subfolders as $fs ) {
		$deleted_fs = bp_docs_delete_folder( array(
			'folder_id' => $fs->ID,
			'delete_contents' => true,
		) );

if ( ! $deleted_fs ) {
			$retval = false;
		}
	}

return $retval;
}

/**
 * Get a list of folders.
 *
 * @since 1.9
 *
 * @param array $args {
 *     List of arguments.
 *     @type int $group_id Optional. ID of the group.
 *     @type int $user_id Optional. ID of the user.
 *     @type string $display Optional. Format of return value. 'tree' to
 *           display as hierarchical tree, 'flat' to return flat list. Default:
 *           'tree'.
 *     @type bool $force_all_folders Optional. Set to 'true' to include all
 *           folders, 'false' to exclude folders associated with users or
 *           groups (ie, include only "global" folders). Default: false.
 * }
 * @return array
 */
function bp_docs_get_folders( $args = array() ) {
	$group_id = null;
	if ( bp_is_active( 'groups' ) && bp_is_group() ) {
		$group_id = bp_get_current_group_id();
	}

$user_id = null;
	if ( bp_is_user() ) {
		$user_id = bp_displayed_user_id();
	}

$parent_id = 0;
	if ( isset( $_GET['folder'] ) ) {
		$parent_id = intval( $_GET['folder'] );
	}

// Don't try to do a tree display with a parent ID
	if ( ! is_null( $parent_id ) ) {
		$display = 'flat';
	} else {
		$display = 'tree';
	}

// Default order
	if ( isset( $_GET['order'] ) && 'desc' === strtolower( $_GET['order'] ) ) {
		$order = 'DESC';
	} else {
		$order = 'ASC';
	}

// Order by
	$orderby = 'title';
	if ( isset( $_GET['orderby'] ) && 'modified' === strtolower( $_GET['orderby'] ) ) {
		$orderby = 'modified';
	}

// Default search terms
	$search_terms = null;
	if ( ! empty( $_GET['s'] ) ) {
		$search_terms = urldecode( $_GET['s'] );
	}

$defaults = array(
		'group_id'          => $group_id,
		'user_id'           => $user_id,
		'display'           => $display,
		'force_all_folders' => false,
		'parent_id'         => $parent_id,
		'include'           => null,
		'search_terms'      => $search_terms,
	);

if ( function_exists( 'bp_parse_args' ) ) {
		$r = bp_parse_args( $args, $defaults, 'bp_docs_get_folders' );
	} else {
		$r = wp_parse_args( $args, $defaults );
	}

$last_changed = wp_cache_get( 'last_changed', 'bp_docs_folders' );
	if ( false === $last_changed ) {
		$last_changed = microtime();
		wp_cache_set( 'last_changed', $last_changed, 'bp_docs_folders' );
	}

ksort( $r );
	$cache_key = 'bp_docs_folders:' . md5( serialize( $r ) . $last_changed );
	$cached = wp_cache_get( $cache_key, 'bp_docs_folders' );
	if ( false !== $cached ) {
		return $cached;
	}

$post_args = array(
		'post_type' => 'bp_docs_folder',
		'orderby' => $orderby,
		'order' => $order,
		'posts_per_page' => '-1',
		'tax_query' => array(),
	);

// @todo support for multiple items
	if ( ! empty( $r['group_id'] ) ) {
		$post_args['tax_query'][] = array(
			'taxonomy' => 'bp_docs_folder_in_group',
			'terms' => array( bp_docs_get_folder_in_group_term_slug( $r['group_id'] ) ),
			'field' => 'slug',
		);
	} else if ( ! empty( $r['user_id'] ) ) {
		$post_args['tax_query'][] = array(
			'taxonomy' => 'bp_docs_folder_in_user',
			'terms' => array( bp_docs_get_folder_in_user_term_slug( $r['user_id'] ) ),
			'field' => 'slug',
		);

// Must exclude all user and group folders
	// @todo Find better way to do this
	} else if ( empty( $r['force_all_folders'] ) ) {
		$folder_taxonomies = array( 'bp_docs_folder_in_user' );
		if ( bp_is_active( 'groups' ) ) {
			$folder_taxonomies[] = 'bp_docs_folder_in_group';
		}
		$object_folders = get_terms(
			$folder_taxonomies,
			array(
				'hide_empty' => false,
				'fields' => 'ids',
			)
		);

if ( empty( $object_folders ) ) {
			$object_folders = array( 0 );
		}

if ( bp_is_active( 'groups' ) ) {
			$post_args['tax_query'][] = array(
				'taxonomy' => 'bp_docs_folder_in_group',
				'terms' => wp_parse_id_list( $object_folders ),
				'field' => 'term_id',
				'operator' => 'NOT IN',
			);
		}

$post_args['tax_query'][] = array(
			'taxonomy' => 'bp_docs_folder_in_user',
			'terms' => wp_parse_id_list( $object_folders ),
			'field' => 'term_id',
			'operator' => 'NOT IN',
		);
	}

if ( ! is_null( $r['parent_id'] ) ) {
		$post_args['post_parent__in'] = wp_parse_id_list( $r['parent_id'] );
	}

if ( ! is_null( $r['include'] ) ) {
		$post_args['post__in'] = wp_parse_id_list( $r['include'] );
	}

if ( ! is_null( $r['search_terms'] ) ) {
		$post_args['s'] = $r['search_terms'];
	}

$folders = get_posts( $post_args );

// Poor-man's walker
	if ( 'tree' === $r['display'] ) {
		$ref = $tree = array();

// Populate top-level items first
		foreach ( $folders as $folder_index => $folder ) {
			if ( empty( $folder->post_parent ) ) {
				$folder->children = array();

// Place in the top level of the tree
				$tree[ $folder->ID ] = $folder;

// Set the reference index
				$ref[ $folder->ID ] =& $tree[ $folder->ID ];

// Remove from original folder index
				unset( $folders[ $folder_index ] );
			}
		}

while ( ! empty( $folders ) ) {
			foreach ( $folders as $folder_index => $folder ) {
				// Nested
				if ( ! empty( $folder->post_parent ) && isset( $ref[ $folder->post_parent ] ) ) {
					$folder->children = array();

// Place in the tree
					$children = $ref[ $folder->post_parent ]->children;
					$children[ $folder->ID ] = $folder;
					$ref[ $folder->post_parent ]->children = $children;

// Set the reference index
					$ref[ $folder->ID ] =& $ref[ $folder->post_parent ]->children[ $folder->ID ];

// Remove from original folders array
					unset( $folders[ $folder_index ] );
				}
			}
		}

$folders = $tree;
	}

wp_cache_set( $cache_key, $folders, 'bp_docs_folders' );

return $folders;
}

/**
 * Filter the BP_Docs_Query tax_query to account for the folder_id param.
 *
 * @since 1.9
 *
 * @param array $tax_query Tax query to be passed to WP_Query.
 * @param BP_Docs_Query $bp_docs_query
 * @return array
 */
function bp_docs_folder_tax_query( $tax_query, $bp_docs_query ) {
	// Folder 0 means: find Docs not in a folder
	if ( 0 === $bp_docs_query->query_args['folder_id'] && ! bp_docs_is_directory_view_filtered() ) {
		// Get all folders
		// @todo Is there a better way? Not in WP_Query I don't think
		$folder_terms = get_terms( 'bp_docs_doc_in_folder', array(
			'fields' => 'ids',
		) );

$tax_query[] = array(
			'taxonomy' => 'bp_docs_doc_in_folder',
			'field'    => 'term_id',
			'terms'    => $folder_terms,
			'operator' => 'NOT IN',
		);

// Find Docs in the following folders
	} else if ( ! empty( $bp_docs_query->query_args['folder_id'] ) ) {
		$folder_ids = wp_parse_id_list( $bp_docs_query->query_args['folder_id'] );

$folder_terms = array();
		foreach ( $folder_ids as $folder_id ) {
			$folder_terms[] = bp_docs_get_folder_term( $folder_id );
		}

$tax_query[] = array(
			'taxonomy' => 'bp_docs_doc_in_folder',
			'field'    => 'term_id',
			'terms'    => $folder_terms,
		);
	}

return $tax_query;
}

/**
 * Folder-specific meta cap mapping.
 *
 * @since 1.9.0
 */
function bp_docs_folders_map_meta_caps( $caps, $cap, $user_id, $args ) {
	switch ( $cap ) {
		case 'bp_docs_manage_folders' :
			$caps = array( 'do_not_allow' );

if ( user_can( $user_id, 'bp_moderate' ) ) {
				$caps = array( 'exist' );

// Group
			} else if ( function_exists( 'bp_is_group' ) && bp_is_group() ) {
				$group_id = bp_get_current_group_id();
				if ( groups_is_user_admin( $user_id, $group_id ) || groups_is_user_mod( $user_id, $group_id ) ) {
					$caps = array( 'exist' );
				}
			// User
			} else if ( bp_is_user() ) {
				if ( bp_displayed_user_id() == $user_id ) {
					$caps = array( 'exist' );
				}
			// Global - bp_moderate only for now
			} else if ( bp_docs_is_global_directory() ) {

}

break;

case 'bp_docs_manage_folder' :
			$caps = array( 'do_not_allow' );

$folder_id = 0;
			if ( isset( $args[0] ) ) {
				$folder_id = intval( $args[0] );
			}

if ( ! $folder_id ) {
				return $caps;
			}

$group_id  = bp_docs_get_folder_group( $folder_id );
			$f_user_id = bp_docs_get_folder_user( $folder_id );

if ( user_can( $user_id, 'bp_moderate' ) ) {
				$caps = array( 'exist' );
			} else if ( $group_id && groups_is_user_admin( $user_id, $group_id ) ) {
				$caps = array( 'exist' );
			} else if ( $f_user_id && $f_user_id == $user_id ) {
				$caps = array( 'exist' );
			} else if ( user_can( $user_id, 'bp_moderate' ) ) {
				$caps = array( 'exist' );
			}

break;

// Temp
		case 'bp_docs_create_global_folder' :
		case 'bp_docs_create_personal_folder' :
			if ( is_user_logged_in() ) {
				$caps = array( 'exist' );
			} else {
				$caps = array();
			}
			break;

case 'bp_docs_change_folder_type' :
			$caps = array( 'bp_moderate' );
			break;

case 'bp_docs_add_items_to_folders_in_context' :
			$caps = array( 'do_not_allow' );

if ( user_can( $user_id, 'bp_moderate' ) ) {
				$caps = array( 'exist' );

// Group
			} else if ( function_exists( 'bp_is_group' ) && bp_is_group() ) {
				if ( groups_is_user_member( $user_id, bp_get_current_group_id() ) ) {
					$caps = array( 'exist' );
				}
			// User
			} else if ( bp_is_user() ) {
				if ( bp_displayed_user_id() == $user_id ) {
					$caps = array( 'exist' );
				}
			// Global
			} else if ( bp_docs_is_global_directory() ) {
				if ( is_user_logged_in() ) {
					$caps = array( 'exist' );
				}
			}
			break;
	}

return $caps;
}

/** "Action" functions *******************************************************/

/**
 * Save folder selections on Doc save.
 *
 * @since 1.9
 *
 * @param int $doc_id
 * @return bool True on success, false on failure.
 */
function bp_docs_save_folder_selection( $doc_id ) {
	$retval = false;

if ( empty( $_POST['existing-or-new-folder'] ) ) {
		return;
	}

$check = apply_filters( 'bp_docs_before_save_folder_selection', true, $doc_id );

if ( ! $check ) {
		return $retval;
	}

switch ( $_POST['existing-or-new-folder'] ) {
		case 'existing' :
			if ( isset( $_POST['bp-docs-folder'] ) ) {
				$folder_id = intval( $_POST['bp-docs-folder'] );

if ( 0 === $folder_id ) {
					$existing_folder_id = bp_docs_get_doc_folder( $doc_id );
					$retval = bp_docs_remove_doc_from_folder( $doc_id, $existing_folder_id );
				} else {
					$retval = bp_docs_add_doc_to_folder( $doc_id, $folder_id );
				}
			}

break;

case 'new' :
			$folder_name = trim( stripslashes( $_POST['new-folder'] ) );

if ( empty( $folder_name ) ) {
				bp_core_add_message( __( 'You must provide a folder name.', 'buddypress-docs' ), 'error' );
			} else {
				$folder_args = array(
					'name' => $folder_name,
				);

// Parent
				$folder_args['parent'] = ! empty( $_POST['new-folder-parent'] ) ? intval( $_POST['new-folder-parent'] ) : null;

// Type
				$folder_type = stripslashes( $_POST['new-folder-type'] );

if ( 'global' === $folder_type ) {
					// Nothing to do
				} else if ( 'me' === $folder_type ) {
					$folder_args['user_id'] = bp_loggedin_user_id();
				} else if ( is_numeric( $folder_type ) ) {
					// This is a group
					$folder_args['group_id'] = intval( $folder_type );
				}

// Create the folder
				$folder_id = bp_docs_create_folder( $folder_args );

// Add the doc to the folder
				$retval = bp_docs_add_doc_to_folder( $doc_id, $folder_id );
			}

break;
	}

return $retval;
}

/**
 * Validate group-folder selection when saving a Doc.
 *
 * @since 1.9.0
 */
function bp_docs_validate_group_folder_selection_on_doc_save( $check, $doc_id ) {
	if ( ! bp_is_active( 'groups' ) ) {
		return $check;
	}

// If creating a new folder, make sure the type and associated group
	// are not a mismatch
	$folder_type     = stripslashes( $_POST['new-folder-type'] );
	$new_or_existing = stripslashes( $_POST['existing-or-new-folder'] );
	if ( 'new' === $new_or_existing && is_numeric( $folder_type ) ) {
		// Associated group ID has been saved by this point
		$group_id = bp_docs_get_associated_group_id( $doc_id );
		if ( $group_id && intval( $group_id ) !== intval( $folder_type ) ) {
			$check = false;
		}
	}

return $check;
}

/**
 * Process folder edits.
 */
function bp_docs_process_folder_edit_cb() {
	if ( ! bp_docs_is_docs_component() && ! bp_is_current_action( bp_docs_get_docs_slug() ) ) {
		return;
	}

if ( ! bp_docs_is_folder_manage_view() ) {
		return;
	}

if ( empty( $_POST['folder-id'] ) ) {
		return;
	}

$folder_id = intval( $_POST['folder-id'] );

$nonce = isset( $_POST['bp-docs-edit-folder-nonce-' . $folder_id] ) ? stripslashes( $_POST['bp-docs-edit-folder-nonce-' . $folder_id] ) : '';

$redirect_url = bp_get_requested_url();

if ( ! wp_verify_nonce( $nonce, 'bp-docs-edit-folder-' . $folder_id ) ) {
		bp_core_add_message( __( 'There was a problem editing that folder. Please try again.', 'buddypress-docs' ), 'error' );
		bp_core_redirect( $redirect_url );
		die();
	}

$parent = isset( $_POST['folder-parent-' . $folder_id] ) ? intval( $_POST['folder-parent-' . $folder_id] ) : '';

$edit_args = array(
		'folder_id' => $folder_id,
		'name'      => stripslashes( $_POST['folder-name-' . $folder_id] ),
	);

if ( ! empty( $parent ) ) {
		$edit_args['parent'] = $parent;

// Force the document to the type of the parent
		$edit_args['group_id'] = bp_docs_get_folder_group( $parent );
		$edit_args['user_id']  = bp_docs_get_folder_user( $parent );

}

// @todo permissions checks!!
	$success = bp_docs_create_folder( $edit_args );

if ( ! empty( $success ) && ! is_wp_error( $success ) ) {
		bp_core_add_message( __( 'Folder successfully updated.', 'buddypress-docs' ), 'success' );
	} else {
		bp_core_add_message( __( 'There was a problem editing that folder. Please try again.', 'buddypress-docs' ), 'error' );
	}

bp_core_redirect( $redirect_url );
	die();
}

/**
 * Process folder creation from manage-folders.
 */
function bp_docs_process_folder_create_cb() {
	if ( ! bp_docs_is_docs_component() && ! bp_is_current_action( bp_docs_get_docs_slug() ) ) {
		return;
	}

if ( ! bp_docs_is_folder_manage_view() ) {
		return;
	}

if ( empty( $_POST['bp-docs-create-folder-submit'] ) ) {
		return;
	}

$nonce = isset( $_POST['bp-docs-create-folder-nonce'] ) ? stripslashes( $_POST['bp-docs-create-folder-nonce'] ) : '';

$redirect_url = bp_get_requested_url();

if ( ! wp_verify_nonce( $nonce, 'bp-docs-create-folder' ) ) {
		bp_core_add_message( __( 'There was a problem editing that folder. Please try again.', 'buddypress-docs' ), 'error' );
		bp_core_redirect( $redirect_url );
		die();
	}

$folder_args = array(
		'name' => stripslashes( $_POST['new-folder'] ),
	);

$parent = isset( $_POST['new-folder-parent'] ) ? intval( $_POST['new-folder-parent'] ) : null;

if ( ! empty( $parent ) ) {
		$folder_args['parent'] = $parent;
	}

// If there's a parent, the parent's folder type takes precedence
	if ( ! empty( $parent ) ) {
		$folder_args['group_id'] = bp_docs_get_folder_group( $parent );
		$folder_args['user_id']  = bp_docs_get_folder_user( $parent );

// Otherwise, trust the values passed
	} else {
		// Type
		$folder_type = stripslashes( $_POST['new-folder-type'] );

if ( 'global' === $folder_type ) {
			// Nothing to do
		} else if ( 'me' === $folder_type ) {
			$folder_args['user_id'] = bp_loggedin_user_id();
		} else if ( is_numeric( $folder_type ) ) {
			// This is a group
			$folder_args['group_id'] = intval( $folder_type );
		}
	}

// Create the folder
	// @todo permissions checks
	$success = bp_docs_create_folder( $folder_args );

if ( ! empty( $success ) && ! is_wp_error( $success ) ) {
		bp_core_add_message( __( 'Folder successfully created.', 'buddypress-docs' ), 'success' );
	} else {
		bp_core_add_message( __( 'There was a problem creating the folder. Please try again.', 'buddypress-docs' ), 'error' );
	}

bp_core_redirect( $redirect_url );
	die();
}

/**
 * Catch a request to delete a folder.
 *
 * @since 1.9.0
 */
function bp_docs_process_folder_delete_cb() {
	if ( ! bp_docs_is_folder_manage_view() ) {
		return;
	}

$folder_id = 0;
	if ( isset( $_GET['delete-folder'] ) ) {
		$folder_id = intval( $_GET['delete-folder'] );
	}

if ( ! $folder_id ) {
		return;
	}

$nonce = '';
	if ( isset( $_POST['_wpnonce'] ) ) {
		$nonce = stripslashes( $_POST['_wpnonce'] );
	}

if ( ! wp_verify_nonce( $nonce, 'bp-docs-delete-folder-' . $folder_id ) ) {
		return;
	}

if ( ! current_user_can( 'bp_docs_manage_folder', $folder_id ) ) {
		return;
	}

if ( empty( $_POST['delete-confirm'] ) || '1' !== $_POST['delete-confirm'] ) {
		return;
	}

$deleted = bp_docs_delete_folder( array(
		'folder_id'       => $folder_id,
		'delete_contents' => true,
	) );

if ( $deleted ) {
		bp_core_add_message( __( 'Folder deleted.', 'buddypress-docs' ) );
	} else {
		bp_core_add_message( __( 'Could not delete folder.', 'buddypress-docs' ) );
	}

bp_core_redirect( remove_query_arg( 'delete-folder', bp_get_requested_url() ) );
	die();
}

/** AJAX Handlers ************************************************************/

/**
 * Update folders based on group selections.
 *
 * @since 1.9
 */
function bp_docs_update_folders_cb() {
	if ( ! isset( $_POST['doc_id'] ) || ! isset( $_POST['group_id'] ) ) {
		die( '-1' );
	}

$doc_id = intval( $_POST['doc_id'] );
	$group_id = intval( $_POST['group_id'] );

bp_docs_folder_selector( array(
		'group_id' => $group_id,
		'doc_id' => $doc_id,
	) );

die();

}

/**
 * Update parent folder selector based on folder type.
 *
 * @since 1.9
 */
function bp_docs_update_parent_folders_cb() {
	if ( ! isset( $_POST['folder_type'] ) ) {
		die( '-1' );
	}

$folder_type = stripslashes( $_POST['folder_type'] );

$selector_args = array(
		'id'    => 'new-folder-parent',
		'name'  => 'new-folder-parent',
		'class' => 'folder-parent',
	);

if ( 'global' === $folder_type ) {
		// Nothing to do
	} else if ( 'me' === $folder_type ) {
		$selector_args['user_id'] = bp_loggedin_user_id();
	} else if ( is_numeric( $folder_type ) ) {
		// This is a group
		$selector_args['group_id'] = intval( $folder_type );
	}

bp_docs_folder_selector( $selector_args );

die();

}

/**
 * Update folder type selector based on value of parent selector.
 */
function bp_docs_update_folder_type_cb() {
	if ( ! isset( $_POST['parent_id'] ) ) {
		die( '-1' );
	}

$parent_id = intval( $_POST['parent_id'] );

$type_selector_name = '';
	if ( isset( $_POST['type_selector_name'] ) ) {
		$type_selector_name = stripslashes( $_POST['type_selector_name'] );
	}

// A $parent_id of 0 means to fetch all fields available to user
	if ( 0 === $parent_id ) {
		$folder_type = null;

// See if a group_id was passed explicitly
		$group_id = 0;
		if ( isset( $_POST['group_id'] ) ) {
			$group_id = intval( $_POST['group_id'] );

// Or if this is a group, get the group_id from the current group
		} else {
			if ( bp_is_active( 'groups' ) && bp_is_group() ) {
				$group_id = bp_get_current_group_id();
			}
		}

if ( ! empty( $group_id ) ) {
			$folder_type = $group_id;
		}

$user_id = bp_loggedin_user_id();
	} else {
		$parent_post = get_post( $parent_id );

if ( ! is_a( $parent_post, 'WP_Post' ) || 'bp_docs_folder' !== $parent_post->post_type ) {
			die( '-1' );
		}

// Child folders must inherit the folder type of the parent
		$folder_type = '';
		$group_id = bp_docs_get_folder_group( $parent_id );
		if ( ! empty( $group_id ) ) {
			$folder_type = $group_id;
		}

$user_id = bp_docs_get_folder_user( $parent_id );;
		if ( bp_loggedin_user_id() == $user_id ) {
			$folder_type = 'me';
		}
	}

$folder_type_args = array(
		'selected' => $folder_type,
	);

if ( ! empty( $type_selector_name ) ) {
		$folder_type_args['id'] = $type_selector_name;
		$folder_type_args['name'] = $type_selector_name;
	}

bp_docs_folder_type_selector( $folder_type_args );

die();
}

/**
 * Update available folder types when the group is changed.
 *
 * @since 1.9.0
 */
function bp_docs_update_folder_type_for_group_cb() {
	if ( ! isset( $_POST['group_id'] ) ) {
		die( '-1' );
	}

$group_id = intval( $_POST['group_id'] );

bp_docs_folder_type_selector( array(
		'selected' => $group_id,
		'group_id' => $group_id,
		'include_all_groups' => false,
	) );

die();
}

/**
 * Process folder drops.
 *
 * @since 1.9
 */
function bp_docs_process_folder_drop_cb() {
	if ( empty( $_POST['doc_id'] ) ) {
		wp_send_json_error( '-1' );
	}

$doc_id = intval( $_POST['doc_id'] );

$nonce = isset( $_POST['nonce'] ) ? stripslashes( $_POST['nonce'] ) : '';

if ( ! wp_verify_nonce( $nonce, 'bp-docs-folder-drop-' . $doc_id ) ) {
		wp_send_json_error( '-2' );
	}

// @todo This needs testing with group admins, etc
	if ( ! current_user_can( 'bp_docs_manage', bp_loggedin_user_id(), $doc_id ) ) {
		wp_send_json_error( '-3' );
	}

// Folder ID must be set, but may be zero.
	if ( ! isset( $_POST['folder_id'] ) ) {
		wp_send_json_error( '-4' );
	}

$folder_id = intval( $_POST['folder_id'] );

if ( 0 === $folder_id ) {
		$existing_folder_id = bp_docs_get_doc_folder( $doc_id );
		$success = bp_docs_remove_doc_from_folder( $doc_id, $existing_folder_id );
	} else {
		$success = bp_docs_add_doc_to_folder( $doc_id, $folder_id );
	}

if ( $success ) {
		wp_send_json_success( '1' );
	} else {
		wp_send_json_error( '-1' );
	}
}

/**
 * Handle AJAX requests for the contents of folders.
 *
 * @since 1.9
 */
function bp_docs_get_folder_content_cb() {
	bp_docs_locate_template( 'docs-folder-loop.php', true, true );
	exit;
}

/** Template functions *******************************************************/

/**
 * Get the current folder ID out of the URL.
 *
 * @since 1.9.0
 *
 * @return null|int Folder ID if it is found, otherwise null.
 */
function bp_docs_get_current_folder_id() {
	$folder_id = null;
	if ( isset( $_GET['folder'] ) ) {
		$folder_id = intval( $_GET['folder'] );
	}
	return $folder_id;
}

/**
 * Is this 'tree' view?
 *
 * @since 1.9
 *
 * @return bool
 */
function bp_docs_is_folder_tree_view() {
	if ( isset( $_GET['view'] ) && 'tree' === $_GET['view'] ) {
		return true;
	} else {
		return false;
	}
}

/**
 * Is this 'manage' view?
 *
 * @since 1.9
 *
 * @return bool
 */
function bp_docs_is_folder_manage_view() {
	if ( isset( $_GET['view'] ) && 'manage' === $_GET['view'] ) {
		return true;
	} else {
		return false;
	}
}

/**
 * Fetch <select> box for folder selection.
 *
 * @since 1.9
 *
 * @param array $args {
 *     Array of optional arguments.
 *     @type int $group_id Include folders of a given group.
 *     @type int $user_id Include folders of a given user.
 *     @type int $selected ID of the selected folder.
 * }
 * @return string
 */
function bp_docs_folder_selector( $args = array() ) {
	$defaults = array(
		'name'         => 'bp-docs-folder',
		'id'           => 'bp-docs-folder',
		'class'        => '',
		'group_id'     => null,
		'user_id'      => null,
		'selected'     => null,
		'doc_id'       => null,
		'force_global' => false,
		'echo'         => true,
	);

if ( function_exists( 'bp_parse_args' ) ) {
		$r = bp_parse_args( $args, $defaults, 'bp_docs_folder_selector' );
	} else {
		$r = wp_parse_args( $args, $defaults );
	}

// If no manual 'selected' value is passed, try to infer it from the
	// current context
	if ( is_null( $r['selected'] ) ) {
		if ( ! is_null( $r['doc_id'] ) ) {
			$doc_id = intval( $r['doc_id'] );
		} else {
			$maybe_doc = get_queried_object();
			if ( isset( $maybe_doc->post_type ) && bp_docs_get_post_type_name() === $maybe_doc->post_type ) {
				$doc_id = $maybe_doc->ID;
			}
		}

if ( ! empty( $doc_id ) ) {
			$maybe_folders = wp_get_object_terms( $doc_id, array(
				'bp_docs_doc_in_folder',
			) );

// Take the first one
			if ( ! empty( $maybe_folders ) ) {
				$r['selected'] = substr( $maybe_folders[0]->slug, 22 );
			}
		}
	}

$types = array();

// Include Global folders either when force_global is true or there
	// are no others to show
	if ( $r['force_global'] || ( empty( $r['group_id'] ) && empty( $r['user_id'] ) ) ) {
		$types['global'] = array(
			'label' => __( 'Global', 'buddypress-docs' ),
			'folders' => bp_docs_get_folders( array(
				'display'   => 'flat',
				'group_id'  => null,
				'user_id'   => null,
				'parent_id' => null,
			) ),
		);
	}

if ( ! empty( $r['group_id'] ) ) {
		$group = groups_get_group( array(
			'group_id' => $r['group_id'],
		) );

if ( ! empty( $group->name ) ) {
			$types['group'] = array(
				'label' => $group->name,
				'folders' => bp_docs_get_folders( array(
					'display'   => 'flat',
					'group_id'  => $r['group_id'],
					'parent_id' => null,
				) ),
			);
		}
	}

if ( ! empty( $r['user_id'] ) ) {
		$user = new WP_User( $r['user_id'] );

if ( ! empty( $user->ID ) ) {
			$label = $r['user_id'] === bp_loggedin_user_id() ? __( 'My Folders', 'buddypress-docs' ) : bp_core_get_user_displayname( $r['user_id'] );
			$types['user'] = array(
				'label' => $label,
				'folders' => bp_docs_get_folders( array(
					'display'   => 'flat',
					'user_id'   => $r['user_id'],
					'parent_id' => null,
				) ),
			);
		}
	}

$walker = new BP_Docs_Folder_Dropdown_Walker();

// Global only
	if ( 1 === count( $types ) && isset( $types['global'] ) ) {
		$options = $walker->walk( $types['global']['folders'], 10, array( 'selected' => $r['selected'] ) );

// If there is more than one folder type (global + user or group),
	// organize into <optgroup>
	} else {
		$options = '';
		foreach ( $types as $type ) {
			if ( empty( $type['folders'] ) ) {
				continue;
			}

$options .= sprintf( '<optgroup label="%s">', esc_attr( $type['label'] ) );
			$options .= $walker->walk( $type['folders'], 10, array( 'selected' => $r['selected'] ) );
			$options .= '</optgroup>';
		}
	}

$options = '<option value="">' . __( ' - None - ', 'buddypress-docs' ) . '</option>' . $options;
	$retval = sprintf( '<select name="%s" id="%s" class="chosen-select %s">', esc_attr( $r['name'] ), esc_attr( $r['id'] ), esc_attr( $r['class'] ) ) . $options . '</select>';

if ( false === $r['echo'] ) {
		return $retval;
	} else {
		// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		echo $retval;
	}
}

/**
 * Get a Type selector dropdown.
 *
 * @since 1.9
 */
function bp_docs_folder_type_selector( $args = array() ) {
	$r = wp_parse_args( $args, array(
		'selected' => 'global',
		'echo' => true,
		'include_all_groups' => true,
		'id' => 'new-folder-type',
		'name' => 'new-folder-type',
	) );

// todo: user/me

if ( $r['include_all_groups'] || is_numeric( $r['selected'] ) ) {
		if ( $r['include_all_groups'] ) {
			$group_id = null;
		} else {
			$group_id = $r['selected'];
		}

$group_selector = bp_docs_associated_group_dropdown( array(
			'options_only' => true,
			'selected'     => $r['selected'],
			'echo'         => false,
			'null_option'  => false,
			'include'      => $group_id,
		) );
	}

$type_selector  = '<select name="' . esc_attr( $r['name'] ) . '" id="' . esc_attr( $r['id'] ) . '" class="folder-type">';
	$type_selector .=   '<option ' . selected( $r['selected'], 'global', false ) . ' value="global">' . __( 'Global', 'buddypress-docs' ) . '</option>';
	$type_selector .=   '<option ' . selected( $r['selected'], 'me', false ) . ' value="me">' . __( 'Personal', 'buddypress-docs' ) . '</option>';

if ( isset( $group_selector ) ) {
		$type_selector .=   '<optgroup label="' . __( 'Group-specific', 'buddypress-docs' ) . '">';
		$type_selector .=     $group_selector;
		$type_selector .=   '</optgroup>';
	}

$type_selector .= '</select>';

$type_selector = apply_filters( 'bp_docs_folder_type_selector', $type_selector, $r );

if ( false === $r['echo'] ) {
		return $type_selector;
	} else {
		// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		echo $type_selector;
	}
}

/**
 * Add breadcrumbs to Doc titles.
 *
 * @since 1.9.0
 *
 * @param array $crumbs
 * @return array
 */
function bp_docs_folder_single_breadcrumb( $crumbs, $doc ) {
	$folder_crumbs = bp_docs_get_folder_breadcrumbs( $doc );
	return array_merge( $folder_crumbs, $crumbs );
}

/**
 * Add folder information to directory breadcrumbs.
 *
 * @since 1.9.0
 */
function bp_docs_folders_directory_breadcrumb( $crumbs ) {
	$folder_crumbs = bp_docs_get_folder_breadcrumbs();
	return array_merge( $crumbs, $folder_crumbs );
}

/**
 * Generate folder breadcrumbs for the current item.
 *
 * @since 1.9.0
 */
function bp_docs_get_folder_breadcrumbs( $doc = null ) {
	$folder_id = 0;

if ( is_a( $doc, 'WP_Post' ) ) {
		$folder_id = bp_docs_get_doc_folder( $doc->ID );
	} else if ( bp_docs_is_existing_doc() ) {
		$folder_id = bp_docs_get_doc_folder( get_queried_object_id() );
	} else if ( isset( $_GET['folder'] ) ) {
		$folder_id = intval( $_GET['folder'] );
	}

$folder_id = intval( $folder_id );

$descendants    = array();
	$this_folder_id = $folder_id;

// Recurse up the tree
	while ( 0 !== $this_folder_id ) {
		$folder = get_post( $this_folder_id );
		$descendants[] = array(
			'id'     => $folder->ID,
			'parent' => $folder->post_parent,
			'name'   => $folder->post_title,
		);

$this_folder_id = intval( $folder->post_parent );
	}

// Sort from top to bottom
	$descendants = array_reverse( $descendants );

$breadcrumb_items = array();
	foreach ( $descendants as $d ) {
		$breadcrumb_items[] = sprintf(
			'<span class="bp-docs-folder-breadcrumb" id="bp-docs-folder-breadcrumb-%s">%s<a href="%s">%s</a></span>',
			$d['id'],
			bp_docs_get_genericon( 'category', $d['id'] ),
			esc_url( bp_docs_get_folder_url( $d['id'] ) ),
			esc_html( $d['name'] )
		);
	}

return $breadcrumb_items;
}

/**
 * Create the markup for creating a new folder.
 *
 * Used on Doc Edit/Create as well as the Folders management page.
 *
 * @since 1.9
 */
function bp_docs_create_new_folder_markup( $args = array() ) {
	$default_group_id = null;
	if ( bp_is_active( 'groups' ) && bp_is_group() ) {
		$default_group_id = bp_get_current_group_id();
	}

$r = wp_parse_args( $args, array(
		'selected' => $default_group_id,
		'group_id' => $default_group_id,
		'folder_type_name' => 'new-folder-type',
		'folder_type_id' => 'new-folder-type',
		'folder_type_include_all_groups' => false,
	) );

<?php $folder_type_class = current_user_can( 'bp_docs_change_folder_type' ) ? 'can-change' : 'cannot-change' ?>

<div class="folder-type-selector-div <?php echo esc_url( $folder_type_class ); ?>">
		<label for="new-folder-type"><?php _e( 'Folder type', 'buddypress-docs' ) ?></label>
		<?php bp_docs_folder_type_selector( array(
			'selected' => $r['selected'],
			'id' => $r['folder_type_id'],
			'name' => $r['folder_type_name'],
			'include_all_groups' => $r['folder_type_include_all_groups'],
		) ) ?>
	</div>

<div style="clear:both"></div>
	<label for="new-folder-parent"><?php _e( 'Parent (optional)', 'buddypress-docs' ) ?></label>
	<?php bp_docs_folder_selector( array(
		'name'     => 'new-folder-parent',
		'id'       => 'new-folder-parent',
		'class'    => 'folder-parent',
		'selected' => isset( $_GET['folder'] ) ? intval( $_GET['folder'] ) : false,
		'group_id' => $r['group_id'],
	) ) ?>

<div style="clear:both"></div>
	<?php
}

/**
 * Add the meta box to the edit page.
 *
 * @since 1.9
 */
function bp_docs_folders_meta_box() {

$doc_id = get_the_ID();
	$associated_group_id = bp_is_active( 'groups' ) ? bp_docs_get_associated_group_id( $doc_id ) : 0;

if ( ! $associated_group_id && isset( $_GET['group'] ) ) {
		$group_id = BP_Groups_Group::get_id_from_slug( urldecode( $_GET['group'] ) );
		if ( current_user_can( 'bp_docs_associate_with_group', $group_id ) ) {
			$associated_group_id = $group_id;
		}
	}

// On the Create screen, respect the 'folder' $_GET param
	if ( bp_docs_is_doc_create() ) {
		$folder_id = bp_docs_get_current_folder_id();
	} else {
		$folder_id = bp_docs_get_doc_folder( $doc_id );
	}

<td>
							<div class="existing-or-new-selector">
								<input type="radio" name="existing-or-new-folder" id="use-existing-folder" value="existing" checked="checked" />
								<label for="use-existing-folder" class="radio-label"><?php _e( 'Use an existing folder', 'buddypress-docs' ) ?></label><br />
								<div class="selector-content">
									<?php bp_docs_folder_selector( array(
										'name'     => 'bp-docs-folder',
										'id'       => 'bp-docs-folder',
										'group_id' => $associated_group_id,
										'selected' => $folder_id,
									) ) ?>
								</div>
							</div>

<?php bp_docs_create_new_folder_markup( array(
										'group_id' => $associated_group_id,
										'selected' => $associated_group_id,
									) ) ?>
								</div>
							</div>
						</td>
					</tr>
				</table>
			</div>
		</div>
	</div>

<?php
}

/**
 * Show Folder info on a single Doc.
 *
 * @since 1.9
 */
function bp_docs_display_folder_meta() {
	$doc_id    = get_the_ID();
	$folder_id = bp_docs_get_doc_folder( $doc_id );

if ( ! $folder_id ) {
		return;
	}

$folder = get_post( $folder_id );

if ( ! is_a( $folder, 'WP_Post' ) || 'bp_docs_folder' !== $folder->post_type ) {
		return;
	}

echo sprintf(
		'<p class="folder-meta" data-folder-id="%d">%s<a href="%s">%s</a>',
		esc_attr( $folder_id ),
		bp_docs_get_genericon( 'category', $folder_id ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		esc_url( bp_docs_get_folder_url( $folder_id ) ),
		esc_attr( $folder->post_title )
	);
}

/**
 * Get the URL for a folder view.
 *
 * Filtered so that it can be sent to the group directory or whatever.
 *
 * @param int $folder_id ID of the folder.
 * @return string URL of the directory.
 */
function bp_docs_get_folder_url( $folder_id ) {
	$group_id = bp_docs_get_folder_group( $folder_id );
	$user_id  = bp_docs_get_folder_user( $folder_id );

if ( $group_id ) {
		$base_url = bp_docs_get_directory_url( 'group', $group_id );
	} else if ( $user_id ) {
		$base_url = bp_docs_get_directory_url( 'user', $user_id );
	} else {
		$base_url = bp_docs_get_directory_url( 'global' );
	}

$folder_id = intval( $folder_id );

if ( $folder_id ) {
		$url = add_query_arg( 'folder', $folder_id, $base_url );
	} else {
		$url = $base_url;
	}

return apply_filters( 'bp_docs_get_folder_url', $url, $folder_id );
}

/**
 * Get the URL for a parent folder view.
 *
 * @param int $folder_id ID of the folder whose parent URL is being fetched.
 * @return string URL
 */
function bp_docs_get_parent_folder_url( $folder_id = null ) {
	if ( is_null( $folder_id ) && isset( $_GET['folder'] ) ) {
		$folder_id = intval( $_GET['folder'] );
	}

$parent_url = '';

$folder = get_post( $folder_id );

if ( ! empty( $folder->post_parent ) ) {
		$parent_url = bp_docs_get_folder_url( $folder->post_parent );
	} else {
		// Folderless directory link for this specific item
		$group_id = bp_docs_get_folder_group( $folder_id );
		$user_id  = bp_docs_get_folder_user( $folder_id );

if ( $group_id ) {
			$parent_url = bp_docs_get_directory_url( 'group', $group_id );
		} else if ( $user_id ) {
			$parent_url = bp_docs_get_directory_url( 'user', $user_id );
		} else {
			$parent_url = bp_docs_get_directory_url( 'global' );
		}
	}

return $parent_url;
}

/**
 * Echo the manage folders URL.
 *
 * Sensitive to the current context.
 *
 * @since 1.9.0
 */
function bp_docs_manage_folders_url() {
	echo esc_url( bp_docs_get_manage_folders_url() );
}
	/**
	 * Generate a manage-folders URL relative to the current context.
	 *
	 * @since 1.9.0
	 *
	 * @return string
	 */
	function bp_docs_get_manage_folders_url() {
		$base = bp_get_requested_url();
		return add_query_arg( 'view', 'manage', $base );
	}

/**
 * Add folder-related filters to the list of current directory filters.
 *
 * @since 1.9
 *
 * @param array $filters
 * @return array
 */
function bp_docs_folder_current_filters( $filters ) {
	if ( ! empty( $_GET['folder'] ) ) {
		$folder_ids = wp_parse_id_list( $_GET['folder'] );
		$filters['folders'] = $folder_ids;
	}

return $filters;
}

/**
 * Add folder filter info to the directory header message.
 *
 * @since 1.9
 *
 * @param array $message
 * @param array $filters
 * @return array
 */
function bp_docs_folder_info_header_message( $message, $filters ) {
	if ( ! empty( $filters['folders'] ) ) {
		$folders = get_posts( array(
			'post_type' => 'bp_docs_folder',
			'post__in'  => $filters['folders'],
		) );

$folder_links = array();

foreach ( $folders as $f ) {
			$folder_links[] = sprintf(
				'<a href="%s">%s</a>',
				esc_url( bp_docs_get_folder_url( $f->ID ) ),
				esc_html( $f->post_title )
			);
		}

$message[] = sprintf(
			_n( 'You are viewing docs in the following folder: %s', 'You are viewing docs in the following folders: %s', count( $folders ), 'buddypress-docs' ),
			implode( ', ', $folder_links )
		);
	}

return $message;
}

/**
 * Add a hidden 'folder' param to directory filter forms.
 *
 * This is a dumb trick to ensure that the folder filter is maintained when
 * adding an attachment filter to the directory.
 *
 * @since 1.9.0
 */
function bp_docs_folders_directory_filter_form_argument() {
	if ( ! empty( $_GET['folder'] ) ) {
		printf(
			'<input type="hidden" name="folder" value="%s" />',
			intval( $_GET['folder'] )
		);
	}
}

/**
 * Add the 'folder' param to Doc tag URLs when in a directory.
 *
 * @since 1.9.0
 */
function bp_docs_folders_directory_tag_link_argument( $link ) {
	if ( ! empty( $_GET['folder'] ) ) {
		$link = add_query_arg( 'folder', intval( $_GET['folder'] ), $link );
	}

return $link;
}

/**
 * Callback for hooking bp_docs_folders_directory_tag_link_argument().
 *
 * Oh boy.
 *
 * @since 1.9.0
 */
function bp_docs_folders_directory_filter_taxonomy_hooker() {
	add_filter( 'bp_docs_get_tag_link_url', 'bp_docs_folders_directory_tag_link_argument' );
}

/**
 * Callback for hooking bp_docs_folders_directory_tag_link_argument().
 *
 * Oh boy x2.
 *
 * @since 1.9.0
 */
function bp_docs_folders_directory_filter_taxonomy_unhooker() {
	remove_filter( 'bp_docs_get_tag_link_url', 'bp_docs_folders_directory_tag_link_argument' );
}

/**
 * Make the Create Doc link sensitive to the current folder.
 *
 * @since 1.9.0
 *
 * @param string $link
 * @return string
 */
function bp_docs_folders_create_link( $link ) {
	$folder_id = bp_docs_get_current_folder_id();

if ( $folder_id ) {
		$link = add_query_arg( 'folder', $folder_id, $link );
	}

return $link;
}

/**
 * Determine whether the directory view is filtered by a folder request.
 *
 * @since 1.9.0
 *
 * @param bool  $is_filtered Is the current directory view filtered?
 * @param array $exclude Array of filter types to ignore.
 *
 * @return bool $is_filtered
 */
function bp_docs_is_directory_view_filtered_by_folder( $is_filtered, $exclude ) {
	// If this filter is excluded, stop now.
	if ( in_array( 'folder', $exclude ) ) {
		return $is_filtered;
	}

if ( ! empty( $_GET['folder'] ) ) {
		$is_filtered = true;
	}
    return $is_filtered;
}

/**
 * Add the draggable item class to docs in the directory view.
 *
 * @since 2.1.0
 *
 * @param array $classes Array of classes to apply to the doc item.
 *
 * @return array $classes
 */
function bp_docs_item_add_draggable_class( $classes ) {
	if ( current_user_can( 'bp_docs_edit', get_the_ID() ) && current_user_can( 'bp_docs_add_items_to_folders_in_context' ) ) {
		$classes[] = 'doc-in-folder';
	}
	return $classes;
}

/**
 * Create dropdown <option> values for BP Docs Folders.
 *
 * @since 1.9
 * @uses Walker
 */
class BP_Docs_Folder_Dropdown_Walker extends Walker {
	/**
	 * @see Walker::$tree_type
	 * @since 1.9
	 * @var string
	 */
	var $tree_type = 'bp_docs_folder';

/**
	 * @see Walker::$db_fields
	 * @since 1.9
	 * @var array
	 */
	var $db_fields = array( 'parent' => 'post_parent', 'id' => 'ID' );

$output .= "\t<option class=\"level-$depth\" value=\"$page->ID\"";
		if ( $page->ID == $args['selected'] )
			$output .= ' selected="selected"';
		$output .= '>';

$title = $page->post_title . '&nbsp;';
		if ( '' === $title ) {
			$title = sprintf( __( '#%d (no title)', 'buddypress-docs' ), $page->ID );
		}

$output .= $pad . esc_html( $title );
		$output .= "</option>\n";
	}
}

/**
 * Get a folder tree for the Manage screen.
 *
 * @since 1.9
 * @uses Walker
 */
class BP_Docs_Folder_Manage_Walker extends Walker {
	/**
	 * @see Walker::$tree_type
	 * @since 1.9
	 * @var string
	 */
	var $tree_type = 'bp_docs_folder';

/**
	 * @see Walker::$db_fields
	 * @since 1.9
	 * @var array
	 */
	var $db_fields = array( 'parent' => 'post_parent', 'id' => 'ID' );

public function start_lvl( &$output, $depth = 0, $args = array() ) {
		$indent = str_repeat( "\t", $depth );
		$output .= "\n$indent<ul class='children'>\n";
	}

public function end_lvl( &$output, $depth = 0, $args = array() ) {
		$indent = str_repeat("\t", $depth);
		$output .= "$indent</ul>\n";
	}

/**
	 * @see Walker::start_el()
	 * @since 1.9
	 *
	 * @param string $output Passed by reference. Used to append additional content.
	 * @param object $page Page data object.
	 * @param int $depth Depth of page. Used for padding.
	 * @param int $current_page Page ID.
	 * @param array $args
	 */
	public function start_el( &$output, $page, $depth = 0, $args = array(), $current_page = 0 ) {
		$group_id = bp_docs_get_folder_group( $page->ID );
		$user_id  = bp_docs_get_folder_user( $page->ID );

$parent_selector = bp_docs_folder_selector( array(
			'name'     => 'folder-parent-' . $page->ID,
			'id'       => 'folder-parent-' . $page->ID,
			'class'    => 'folder-parent',
			'selected' => $page->post_parent,
			'group_id' => $group_id,
			'echo'     => false,
		) );

$type_selector_markup = '';
		if ( empty( $page->post_parent ) ) {
			$selected = null;
			if ( ! empty( $group_id ) ) {
				$selected = $group_id;
			} else if ( ! empty( $user_id ) ) {
				$selected = 'me';
			} else {
				$selected = 'global';
			}

$type_selector = bp_docs_folder_type_selector( array(
				'echo' => false,
				'selected' => $selected,
				'name' => 'folder-type-' . $page->ID,
				'id' => 'folder-type-' . $page->ID,
			) );

$type_selector_markup = sprintf(
				'<label for="folder-type-%d">%s</label> %s
				<div style="clear:both;"></div>',
				intval( $page->ID ), // for="folder-type-%d"
				__( 'Type', 'buddypress-docs' ), // type label text
				$type_selector // type dropdown
			);
		}

$delete_link_markup = '';
		if ( current_user_can( 'bp_docs_manage_folder', $page->ID ) ) {
			$delete_link_markup = sprintf(
				'<a class="folder-delete" href="%s">%s</a>',
				add_query_arg( 'delete-folder', $page->ID, bp_get_requested_url() ), // No nonce because actual deletion is done on the subsequent page
				__( 'Delete', 'buddypress-docs' )
			);
		}

$output .= sprintf(
			'
<li class="folder folder-edit-closed" data-folder-id="%d">
	<div class="folder-info">
		<h4>%s<span class="folder-toggle-edit"> <a href="#">%s</a></span><span class="folder-toggle-close"> <a href="#">%s</a></span></h4>
		<div class="folder-details">
			<form method="post" action="">
				<label for="folder-name-%d">%s</label> <input id="folder-name-%d" name="folder-name-%d" value="%s" />
				<div style="clear:both;"></div>
				<label for="folder-parent-%d">%s</label> %s
				<div style="clear:both;"></div>
				%s
				<input type="hidden" class="folder-id" name="folder-id" value="%d" />
				%s
				<input type="submit" value="%s" class="primary-button" /> %s
			</form>
		</div>
	</div>',
			intval( $page->ID ), // data-folder-id
			esc_html( $page->post_title ), // h4
			__( 'Edit', 'buddypress-docs' ), // folder-edit-toggle text
			__( 'Close', 'buddypress-docs' ), // folder-edit-close text
			intval( $page->ID ), // for="folder-name-%d"
			__( 'Name', 'buddypress-docs' ), // label text
			intval( $page->ID ), // id="folder-name-%d"
			intval( $page->ID ), // name="folder-name-%d"
			esc_attr( $page->post_title ), // input value
			intval( $page->ID ), // for="folder-parent-%d"
			__( 'Parent', 'buddypress-docs' ), // label text
			$parent_selector, // parent dropdown
			$type_selector_markup,
			intval( $page->ID ), // hidden input value
			wp_nonce_field( 'bp-docs-edit-folder-' . $page->ID, 'bp-docs-edit-folder-nonce-' . $page->ID, false, false ), // nonce
			__( 'Save Changes', 'buddypress-docs' ), // save button text
			$delete_link_markup
		);
	}

public function end_el( &$output, $page, $depth = 0, $args = array(), $current_page = 0 ) {
		$output .= '</li>';
	}
}

/**
 * Get a folder tree.
 *
 * @since 1.9
 * @uses Walker
 */
class BP_Docs_Folder_Walker extends Walker {
	/**
	 * @see Walker::$tree_type
	 * @since 1.9
	 * @var string
	 */
	var $tree_type = 'bp_docs_folder';

/**
	 * @see Walker::$db_fields
	 * @since 1.9
	 * @var array
	 */
	var $db_fields = array( 'parent' => 'post_parent', 'id' => 'ID' );

public function start_lvl( &$output, $depth = 0, $args = array() ) {
		$indent = str_repeat( "\t", $depth );
		$output .= "\n$indent<ul class='children'>\n";
	}

public function end_lvl( &$output, $depth = 0, $args = array() ) {
		$indent = str_repeat("\t", $depth);
		$output .= "$indent</ul>\n";
	}

/**
	 * @see Walker::start_el()
	 * @since 1.9
	 *
	 * @param string $output Passed by reference. Used to append additional content.
	 * @param object $page Page data object.
	 * @param int $depth Depth of page. Used for padding.
	 * @param int $current_page Page ID.
	 * @param array $args
	 */
	public function start_el( &$output, $page, $depth = 0, $args = array(), $current_page = 0 ) {
		$output .= sprintf(
			'<li class="folder folder-closed" data-folder-id="%d">%s<span class="folder-name">%s</span>',
			esc_attr( $page->ID ),
			bp_docs_get_genericon( 'category', $page->ID ),
			esc_html( $page->post_title )
		);
	}

public function end_el( &$output, $page, $depth = 0, $args = array(), $current_page = 0 ) {
		// Get the docs belonging to this folder
		$folder_term = bp_docs_get_folder_term( $page->ID );

$folder_docs = get_posts( array(
			'post_type' => bp_docs_get_post_type_name(),
			'tax_query' => array(
				array(
					'taxonomy' => 'bp_docs_doc_in_folder',
					'field' => 'term_id',
					'terms' => $folder_term,
				),
			),
		) );

$empty_class = empty( $folder_docs ) ? 'empty' : '';
		$output .= sprintf( '<ul class="docs-in-folder %s" id="docs-in-folder-%d">', $empty_class, $page->ID );

$output .= '<li class="folder-empty">' . __( 'This folder contains no Docs.', 'buddypress-docs' ) . '</li>';
		foreach ( $folder_docs as $folder_doc ) {
			$output .= sprintf(
				'<li class="doc-in-folder" id="doc-in-folder-%d" data-doc-id="%d">%s<a href="%s">%s</a>%s</li>',
				$folder_doc->ID,
				$folder_doc->ID,
				bp_docs_get_genericon( 'document', $folder_doc->ID ),
				get_permalink( $folder_doc ),
				esc_html( $folder_doc->post_title ),
				wp_nonce_field( 'bp-docs-folder-drop-' . $folder_doc->ID, 'bp-docs-folder-drop-nonce-' . $folder_doc->ID, false, false )
			);
		}

$output .= '</ul>';
		$output .= '</li>';
	}
}

/**
 * Reset the 'last_changed' cache incrementor when posts are updated.
 *
 * Big hammer, small nail.
 *
 * @since 1.9.0
 */
function bp_docs_folders_invalidate_last_changed_incrementor() {
	wp_cache_delete( 'last_changed', 'bp_docs_folders' );
}
add_action( 'save_post_bp_doc', 'bp_docs_folders_invalidate_last_changed_incrementor' );
add_action( 'trashed_post', 'bp_docs_folders_invalidate_last_changed_incrementor' );
add_action( 'set_object_terms', 'bp_docs_folders_invalidate_last_changed_incrementor' );

/**
 * Find most recently updated content date for a folder.
 *
 * @since 2.2.0
 * @param $folder_id
 * @return false|string false if not found, MySQL date string of recently updated content.
 */
function bp_docs_folders_calculate_modified_date( $folder_id = 0 ) {
	$retval = false;
	if ( ! $folder_id ) {
		return $retval;
	}

$subfolder_ids   = bp_folders_get_descendant_folder_ids( $folder_id );
	$subfolder_ids[] = $folder_id;
	$terms           = array();
	foreach ( $subfolder_ids as $subfolder_id ) {
		$terms[] = bp_docs_get_folder_term( $subfolder_id );
	}
	// Need to remove doc access protection, else different users will get different answers.
	remove_action( 'pre_get_posts', 'bp_docs_general_access_protection', 28 );
	$last_mod = new WP_Query(
		array(
			'post_type'      => bp_docs_get_post_type_name(),
			'orderby'        => 'modified',
			'posts_per_page' => '1',
			'tax_query'      => array(
				array(
					'taxonomy' => 'bp_docs_doc_in_folder',
					'field'    => 'term_id',
					'terms'    => $terms,
				),
			)
		)
	);
	add_action( 'pre_get_posts', 'bp_docs_general_access_protection', 28 );

if ( ! empty( $last_mod->post->post_modified ) ) {
		$retval = $last_mod->post->post_modified;
	}

return $retval;
}

/**
 * Get all of the descendant folders of a specified folder.
 *
 * @since 2.2.0
 * @param $folder_id int Folder ID to find descendants of.
 * @return array Array of folder IDs.
 */
function bp_folders_get_descendant_folder_ids( $folder_id = 0 ) {
	$folder_ids = array();
	if ( ! $folder_id ) {
		return $folder_ids;
	}

$args = array(
		'post_parent__in' => array( $folder_id ),
		'post_type'       => 'bp_docs_folder',
		'fields'          => 'ids',
	);
	$subfolder_ids = get_posts( $args );

while ( $subfolder_ids ) {
		$folder_ids = array_merge( $folder_ids, $subfolder_ids );

// Next level
		$args['post_parent__in'] = $subfolder_ids;
		$subfolder_ids           = get_posts( $args );
	}

return $folder_ids;
}

/**
 * Set the modified date for a specified folder.
 * This function will work through all ancestor folders to
 * recalculate the modified date for each.
 *
 * @since 2.2.0
 * @param $folder_id int Folder ID to update.
 * @return array Array of folder IDs.
 */
function bp_docs_folders_update_folder_modified_date( $folder_id = 0 ) {

if ( $folder_id ) {
		$last_mod_date = bp_docs_folders_calculate_modified_date( $folder_id );
		if ( $last_mod_date ) {
			wp_update_post(
				array(
					'ID'            => $folder_id,
					'modified_date' => $last_mod_date,
				)
			);
		}
		$parent_folder = wp_get_post_parent_id( $folder_id );
		while ( $parent_folder ) {
			$last_mod_date = bp_docs_folders_calculate_modified_date( $parent_folder );
			if ( $last_mod_date ) {
				wp_update_post(
					array(
						'ID'            => $parent_folder,
						'modified_date' => $last_mod_date,
					)
				);
			}

$parent_folder = wp_get_post_parent_id( $parent_folder );
		}
	}
}

/**
 * Update folder modified dates when a doc is saved via WP Admin.
 *
 * @since 2.2.0
 * @param $doc_id int Doc ID updated.
 */
function bp_docs_folders_update_folder_modified_date_from_wpadmin( $doc_id ) {

if ( is_admin() && ! wp_doing_ajax() ) {
		$folder_id = bp_docs_get_doc_folder( $doc_id );
		bp_docs_folders_update_folder_modified_date( $folder_id );
	}
}
add_action( 'save_post_bp_doc', 'bp_docs_folders_update_folder_modified_date_from_wpadmin' );

/**
 * Update folder modified dates when a doc is saved via BP Docs frontend.
 * The folder term isn't yet applied at 'save_post_bp_doc' with front-end saves,
 * so we use a different action hook.
 *
 * @since 2.2.0
 * @param $doc_id int Doc ID updated.
 */
function bp_docs_folders_update_folder_modified_date_from_front( $doc_id ) {

$folder_id = bp_docs_get_doc_folder( $doc_id );
	bp_docs_folders_update_folder_modified_date( $folder_id );
}
add_action( 'bp_docs_after_save', 'bp_docs_folders_update_folder_modified_date_from_front', 32 );

/**
 * Update folder modified dates when a doc is trashed.
 *
 * @since 2.2.0
 * @param $doc_id int Doc ID updated.
 */
function bp_docs_folders_update_folder_modified_date_on_trash( $doc_id ) {

$folder_id = bp_docs_get_doc_folder( $doc_id );
	bp_docs_folders_update_folder_modified_date( $folder_id );
}
add_action( 'trashed_post', 'bp_docs_folders_update_folder_modified_date_on_trash' );

/**
 * Update folder modified dates when a doc is trashed by BP Docs action.
 *
 * @since 2.2.0
 * @param $doc_id int Doc ID updated.
 */
function bp_docs_folders_update_folder_modified_date_on_doc_deleted( $delete_args ) {

if ( ! empty( $delete_args['ID'] ) ) {
		bp_docs_folders_update_folder_modified_date_on_trash( $delete_args['ID'] );
	}
}
add_action( 'bp_docs_doc_deleted', 'bp_docs_folders_update_folder_modified_date_on_doc_deleted' );

/**
 * Update folder modified dates when set_object_terms is run on a doc.
 * Runs when a doc is moved between folders, but not when just moved out to "no folder."
 *
 * @since 2.2.0
 * @param int    $object_id  Object ID.
 * @param array  $terms      An array of object terms.
 * @param array  $tt_ids     An array of term taxonomy IDs.
 * @param string $taxonomy   Taxonomy slug.
 * @param bool   $append     Whether to append new terms to the old terms.
 * @param array  $old_tt_ids Old array of term taxonomy IDs.
 */
function bp_docs_folders_update_folder_modified_date_on_term_update( $object_id, $terms, $tt_ids, $taxonomy, $append, $old_tt_ids ) {

if ( 'bp_docs_doc_in_folder' !== $taxonomy ) {
		return;
	}

if ( $changed_folder_term_ids = array_merge( $old_tt_ids, $tt_ids ) ) {
		foreach ( $changed_folder_term_ids as $tt_id ) {
			$folder_id = bp_docs_get_folder_id_from_tax_term_id( $tt_id );
			bp_docs_folders_update_folder_modified_date( $folder_id );
		}
	}
}
add_action( 'set_object_terms', 'bp_docs_folders_update_folder_modified_date_on_term_update', 10, 6 );

/**
 * Update folder modified dates when a doc is removed from a folder.
 * Runs when a doc is removed from a folder.
 *
 * @since 2.2.0
 * @param int    $object_id Object ID.
 * @param array  $tt_ids    An array of term taxonomy IDs.
 * @param string $taxonomy  Taxonomy slug.
 */
function bp_docs_folders_update_folder_modified_date_on_deleted_term_relationships( $object_id, $tt_ids, $taxonomy ) {

if ( 'bp_docs_doc_in_folder' !== $taxonomy ) {
		return;
	}

foreach ( $tt_ids as $tt_id ) {
		$folder_id = bp_docs_get_folder_id_from_tax_term_id( $tt_id );
		bp_docs_folders_update_folder_modified_date( $folder_id );
	}
}
add_action( 'deleted_term_relationships', 'bp_docs_folders_update_folder_modified_date_on_deleted_term_relationships', 10, 3 );