Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
10/22/2015 06:02:55 AM (9 years ago)
Author:
tw2113
Message:

More docs cleanup for Notifications component.

See #6404.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/bp-notifications/bp-notifications-template.php

    r10248 r10303  
    266266    public function __construct( $args = array() ) {
    267267
    268         // Parse arguments
     268        // Parse arguments.
    269269        $r = wp_parse_args( $args, array(
    270270            'id'                => false,
     
    286286        ) );
    287287
    288         // Overrides
    289 
    290         // Sort order direction
     288        // Sort order direction.
    291289        $orders = array( 'ASC', 'DESC' );
    292290        if ( ! empty( $_GET['sort_order'] ) && in_array( $_GET['sort_order'], $orders ) ) {
     
    296294        }
    297295
    298         // Setup variables
     296        // Setup variables.
    299297        $this->pag_arg      = sanitize_key( $r['page_arg'] );
    300298        $this->pag_page     = bp_sanitize_pagination_arg( $this->pag_arg, $r['page']     );
     
    322320        );
    323321
    324         // Setup the notifications to loop through
     322        // Setup the notifications to loop through.
    325323        $this->notifications            = BP_Notifications_Notification::get( $this->query_vars );
    326324        $this->total_notification_count = BP_Notifications_Notification::get_total_count( $this->query_vars );
     
    457455        $this->notification = $this->next_notification();
    458456
    459         // loop has just started
     457        // Loop has just started.
    460458        if ( 0 === $this->current_notification ) {
    461459
     
    492490 *                            Default: 'npage'.
    493491 * }
    494  *
    495492 * @return bool
    496493 */
    497494function bp_has_notifications( $args = '' ) {
    498495
    499     // Get the default is_new argument
     496    // Get the default is_new argument.
    500497    if ( bp_is_current_action( 'unread' ) ) {
    501498        $is_new = 1;
     
    503500        $is_new = 0;
    504501
    505     // not on a notifications page? default to fetch new notifications
     502    // Not on a notifications page? default to fetch new notifications.
    506503    } else {
    507504        $is_new = 1;
    508505    }
    509506
    510     // Get the user ID
     507    // Get the user ID.
    511508    if ( bp_displayed_user_id() ) {
    512509        $user_id = bp_displayed_user_id();
     
    515512    }
    516513
    517     // Parse the args
     514    // Parse the args.
    518515    $r = bp_parse_args( $args, array(
    519516        'id'                => false,
     
    531528        'per_page'          => 25,
    532529
    533         // these are additional arguments that are not available in
    534         // BP_Notifications_Notification::get()
     530        // These are additional arguments that are not available in
     531        // BP_Notifications_Notification::get().
    535532        'max'               => false,
    536533        'page_arg'          => 'npage',
    537534    ), 'has_notifications' );
    538535
    539     // Get the notifications
     536    // Get the notifications.
    540537    $query_loop = new BP_Notifications_Template( $r );
    541538
    542     // Setup the global query loop
     539    // Setup the global query loop.
    543540    buddypress()->notifications->query_loop = $query_loop;
    544541
     
    757754    function bp_get_the_notification_time_since() {
    758755
    759         // Get the notified date
     756        // Get the notified date.
    760757        $date_notified = bp_get_the_notification_date_notified();
    761758
    762         // Notified date has legitimate data
     759        // Notified date has legitimate data.
    763760        if ( '0000-00-00 00:00:00' !== $date_notified ) {
    764761            $retval = bp_core_time_since( $date_notified );
    765762
    766         // Notified date is empty, so return a fun string
     763        // Notified date is empty, so return a fun string.
    767764        } else {
    768765            $retval = __( 'Date not found', 'buddypress' );
     
    799796        $notification = $bp->notifications->query_loop->notification;
    800797
    801         // Callback function exists
     798        // Callback function exists.
    802799        if ( isset( $bp->{ $notification->component_name }->notification_callback ) && is_callable( $bp->{ $notification->component_name }->notification_callback ) ) {
    803800            $description = call_user_func( $bp->{ $notification->component_name }->notification_callback, $notification->component_action, $notification->item_id, $notification->secondary_item_id, 1 );
     
    807804            $description = call_user_func( $bp->{ $notification->component_name }->format_notification_function, $notification->component_action, $notification->item_id, $notification->secondary_item_id, 1 );
    808805
    809         // Allow non BuddyPress components to hook in
     806        // Allow non BuddyPress components to hook in.
    810807        } else {
    811808
     
    843840    function bp_get_the_notification_mark_read_link() {
    844841
    845         // Start the output buffer
     842        // Start the output buffer.
    846843        ob_start(); ?>
    847844
     
    874871    /**
    875872     * Return the URL used for marking a single notification as read.
    876      *
     873     *
    877874     * @since 2.1.0
    878875     */
    879876    function bp_get_the_notification_mark_read_url() {
    880877
    881         // Get the notification ID
     878        // Get the notification ID.
    882879        $id   = bp_get_the_notification_id();
    883880
    884         // Get the args to add to the URL
     881        // Get the args to add to the URL.
    885882        $args = array(
    886883            'action'          => 'read',
     
    888885        );
    889886
    890         // Add the args to the URL
     887        // Add the args to the URL.
    891888        $url = add_query_arg( $args, bp_get_notifications_unread_permalink() );
    892889
    893         // Add the nonce
     890        // Add the nonce.
    894891        $url = wp_nonce_url( $url, 'bp_notification_mark_read_' . $id );
    895892
     
    921918    function bp_get_the_notification_mark_unread_link() {
    922919
    923         // Start the output buffer
     920        // Start the output buffer.
    924921        ob_start(); ?>
    925922
     
    952949    /**
    953950     * Return the URL used for marking a single notification as unread.
    954      *
     951     *
    955952     * @since 2.1.0
    956953     */
    957954    function bp_get_the_notification_mark_unread_url() {
    958955
    959         // Get the notification ID
     956        // Get the notification ID.
    960957        $id   = bp_get_the_notification_id();
    961958
    962         // Get the args to add to the URL
     959        // Get the args to add to the URL.
    963960        $args = array(
    964961            'action'          => 'unread',
     
    966963        );
    967964
    968         // Add the args to the URL
     965        // Add the args to the URL.
    969966        $url = add_query_arg( $args, bp_get_notifications_read_permalink() );
    970967
    971         // Add the nonce
     968        // Add the nonce.
    972969        $url = wp_nonce_url( $url, 'bp_notification_mark_unread_' . $id );
    973970
     
    10321029    function bp_get_the_notification_delete_link() {
    10331030
    1034         // Start the output buffer
     1031        // Start the output buffer.
    10351032        ob_start(); ?>
    10361033
     
    10711068    function bp_get_the_notification_delete_url() {
    10721069
    1073         // URL to add nonce to
     1070        // URL to add nonce to.
    10741071        if ( bp_is_current_action( 'unread' ) ) {
    10751072            $link = bp_get_notifications_unread_permalink();
     
    10781075        }
    10791076
    1080         // Get the ID
     1077        // Get the ID.
    10811078        $id = bp_get_the_notification_id();
    10821079
    1083         // Get the args to add to the URL
     1080        // Get the args to add to the URL.
    10841081        $args = array(
    10851082            'action'          => 'delete',
     
    10871084        );
    10881085
    1089         // Add the args
     1086        // Add the args.
    10901087        $url = add_query_arg( $args, $link );
    10911088
    1092         // Add the nonce
     1089        // Add the nonce.
    10931090        $url = wp_nonce_url( $url, 'bp_notification_delete_' . $id );
    10941091
     
    11061103 * Output the action links for the current notification.
    11071104 *
     1105 * @since 1.9.0
     1106 *
    11081107 * @param array|string $args Array of arguments.
    1109  * @since 1.9.0
    11101108 */
    11111109function bp_the_notification_action_links( $args = '' ) {
     
    11231121     *     @type array  $links  Array of links to implode by 'sep'.
    11241122     * }
    1125      *
    11261123     * @return string HTML links for actions to take on single notifications.
    11271124     */
    11281125    function bp_get_the_notification_action_links( $args = '' ) {
    11291126
    1130         // Parse
     1127        // Parse.
    11311128        $r = wp_parse_args( $args, array(
    11321129            'before' => '',
     
    11391136        ) );
    11401137
    1141         // Build the links
     1138        // Build the links.
    11421139        $retval = $r['before'] . implode( $r['links'], $r['sep'] ) . $r['after'];
    11431140
     
    12261223function bp_notifications_sort_order_form() {
    12271224
    1228     // Setup local variables
     1225    // Setup local variables.
    12291226    $orders   = array( 'DESC', 'ASC' );
    12301227    $selected = 'DESC';
    12311228
    1232     // Check for a custom sort_order
     1229    // Check for a custom sort_order.
    12331230    if ( !empty( $_REQUEST['sort_order'] ) ) {
    12341231        if ( in_array( $_REQUEST['sort_order'], $orders ) ) {
Note: See TracChangeset for help on using the changeset viewer.