Sid Gifari File Manager

Sid Gifari File Manager

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

Editing: class-wp-widget-recent-docs.php

<?php
/**
 * BuddyPress Docs Recent Docs Widget
 * Based on WP's "Recent Posts" widget.
 *
 * @package BuddyPressDocs
 * @since 1.9.0
 */

// Exit if accessed directly
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Register the recent docs widget.
 *
 * @since 1.9.0
 */
function bp_docs_register_recent_docs_widget() {
	register_widget( 'BP_Docs_Widget_Recent_Docs' );
}
add_action( 'widgets_init', 'bp_docs_register_recent_docs_widget' );

/**
 * Core class used to implement a Recent Docs widget.
 *
 * @since 1.9.0
 *
 * @see WP_Widget
 */
class BP_Docs_Widget_Recent_Docs extends WP_Widget {

/**
	 * Sets up a new Recent Docs widget instance.
	 *
	 * @since 1.9.0
	 * @access public
	 */
	public function __construct() {
		$widget_ops = array(
			// Use the class `widget_recent_entries` to inherit WP Recent Posts widget styling.
			'classname' => 'widget_recent_entries widget_recent_bp_docs',
			'description' => __( 'Displays the most recent BuddyPress Docs that the visitor can read.' ) );
		parent::__construct( 'widget_recent_bp_docs', _x( '(BuddyPress Docs) Recent Docs', 'widget name', 'buddypress-docs' ), $widget_ops);
		$this->alt_option_name = 'widget_recent_bp_docs';
	}

/**
	 * Outputs the content for the current Recent Docs widget instance.
	 *
	 * @since 1.9.0
	 * @access public
	 *
	 * @param array $args     Display arguments including 'before_title', 'after_title',
	 *                        'before_widget', and 'after_widget'.
	 * @param array $instance Settings for the current Recent Docs widget instance.
	 */
	public function widget( $args, $instance ) {
		$bp = buddypress();

// Store the existing doc_query, so ours is made from scratch.
		$temp_doc_query = isset( $bp->bp_docs->doc_query ) ? $bp->bp_docs->doc_query : null;
		$bp->bp_docs->doc_query = null;

if ( ! isset( $args['widget_id'] ) ) {
			$args['widget_id'] = $this->id;
		}

$title = ( ! empty( $instance['title'] ) ) ? $instance['title'] : __( 'Recent BuddyPress Docs', 'buddypress-docs' );

/* This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
		$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );

$number = ( ! empty( $instance['number'] ) ) ? absint( $instance['number'] ) : 5;
		if ( ! $number ) {
			$number = 5;
		}
		$show_date = isset( $instance['show_date'] ) ? $instance['show_date'] : false;

$doc_args = array(
			'posts_per_page' => $number,
			'post_status'    => array( 'publish' ),
			'group_id'       => null,
			'folder_id'      => null,
		);

/**
		 * Limit to docs associated with the current context
		 * if the widget has been set to be context aware
		 * and we're in a group or viewing a user's profile.
		 */
		if ( isset( $instance['context_aware'] ) && $instance['context_aware'] ) {
			if ( bp_is_user() ) {
				$doc_args['author_id'] = bp_displayed_user_id();
			}

if ( bp_is_group() ) {
				$doc_args['group_id'] = bp_get_current_group_id();
			}
		}

/**
		 * Filters the args passed to `bp_docs_has_docs()` in the Recent Docs widget.
		 *
		 * @since 2.1.0
		 *
		 * @param array {
		 *     @type int    $posts_per_page
		 *     @type string $post_status
		 *     @type int    $group_id
		 *     @type int    $folder_id
		 * }
		 */
		$doc_args = apply_filters( 'bp_docs_widget_query_args', $doc_args );

if ( bp_docs_has_docs( $doc_args ) ) :
			// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
			echo $args['before_widget'];
			if ( $title ) {
				// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
				echo $args['before_title'] . esc_html( $title ) . $args['after_title'];
			} ?>
			<ul>
			<?php while ( bp_docs_has_docs() ) : bp_docs_the_doc(); ?>
				<li>
					<a href="<?php the_permalink(); ?>"><?php get_the_title() ? the_title() : the_ID(); ?></a>
				<?php if ( $show_date ) : ?>
					<span class="post-date"><?php echo get_the_date(); ?></span>
				<?php endif; ?>
				</li>
			<?php endwhile; ?>
		</ul>

<?php
		// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		echo $args['after_widget'];

endif;

wp_reset_postdata();

// Restore the main doc_query; obliterate our secondary loop arguments.
		$bp->bp_docs->doc_query = $temp_doc_query;
	}

/**
	 * Handles updating the settings for the current Recent Docs widget instance.
	 *
	 * @since 1.9.0
	 * @access public
	 *
	 * @param array $new_instance New settings for this instance as input by the user via
	 *                            WP_Widget::form().
	 * @param array $old_instance Old settings for this instance.
	 * @return array Updated settings to save.
	 */
	public function update( $new_instance, $old_instance ) {
		$instance              = $old_instance;
		$instance['title']     = sanitize_text_field( $new_instance['title'] );
		$instance['number']    = (int) $new_instance['number'];
		$instance['show_date'] = isset( $new_instance['show_date'] );
		$instance['context_aware'] = isset( $new_instance['context_aware'] );
		return $instance;
	}

/**
	 * Outputs the settings form for the Recent Docs widget.
	 *
	 * @since 1.9.0
	 * @access public
	 *
	 * @param array $instance Current settings.
	 */
	public function form( $instance ) {
		$title     = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : '';
		$number    = isset( $instance['number'] ) ? absint( $instance['number'] ) : 5;
		$show_date = isset( $instance['show_date'] ) ? (bool) $instance['show_date'] : false;
		$context_aware = isset( $instance['context_aware'] ) ? (bool) $instance['context_aware'] : false;
		?>
		<p><label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php esc_html_e( 'Title:', 'buddypress-docs' ); ?></label>
		<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" /></p>

<p><label for="<?php echo esc_attr( $this->get_field_id( 'number' ) ); ?>"><?php esc_html_e( 'Number of docs to show:', 'buddypress-docs' ); ?></label>
		<input class="tiny-text" id="<?php echo esc_attr( $this->get_field_id( 'number' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'number' ) ); ?>" type="number" step="1" min="1" value="<?php echo esc_attr( $number ); ?>" size="3" /></p>

<p><input class="checkbox" type="checkbox"<?php checked( $show_date ); ?> id="<?php echo esc_attr( $this->get_field_id( 'show_date' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'show_date' ) ); ?>" />
		<label for="<?php echo esc_attr( $this->get_field_id( 'show_date' ) ); ?>"><?php esc_html_e( 'Display post date?', 'buddypress-docs' ); ?></label></p>

<p><input class="checkbox" type="checkbox"<?php checked( $context_aware ); ?> id="<?php echo esc_attr( $this->get_field_id( 'context_aware' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'context_aware' ) ); ?>" />
		<label for="<?php echo esc_attr( $this->get_field_id( 'context_aware' ) ); ?>"><?php esc_html_e( 'When used within a group or on a user&rsquo;s profile, limit docs to the current group or displayed user&rsquo;s docs.', 'buddypress-docs' ); ?></label></p>

<?php
	}
}