Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
09/24/2015 11:55:02 PM (10 years ago)
Author:
tw2113
Message:

Standardizing our @since tags for the Notifications component.

See #6576

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/bp-notifications/classes/class-bp-notifications-notification.php

    r9993 r10138  
    88 * @subpackage NotificationsClasses
    99 *
    10  * @since BuddyPress (1.9.0)
     10 * @since 1.9.0
    1111 */
    1212
    13 // Exit if accessed directly
     13// Exit if accessed directly.
    1414defined( 'ABSPATH' ) || exit;
    1515
     
    1919 * Use this class to create, access, edit, or delete BuddyPress Notifications.
    2020 *
    21  * @since BuddyPress (1.9.0)
     21 * @since 1.9.0
    2222 */
    2323class BP_Notifications_Notification {
     
    2626     * The notification ID.
    2727     *
    28      * @since BuddyPress (1.9.0)
     28     * @since 1.9.0
    2929     * @access public
    3030     * @var int
     
    3535     * The ID of the item associated with the notification.
    3636     *
    37      * @since BuddyPress (1.9.0)
     37     * @since 1.9.0
    3838     * @access public
    3939     * @var int
     
    4444     * The ID of the secondary item associated with the notification.
    4545     *
    46      * @since BuddyPress (1.9.0)
     46     * @since 1.9.0
    4747     * @access public
    4848     * @var int
     
    5353     * The ID of the user the notification is associated with.
    5454     *
    55      * @since BuddyPress (1.9.0)
     55     * @since 1.9.0
    5656     * @access public
    5757     * @var int
     
    6262     * The name of the component that the notification is for.
    6363     *
    64      * @since BuddyPress (1.9.0)
     64     * @since 1.9.0
    6565     * @access public
    6666     * @var string
     
    7171     * The component action which the notification is related to.
    7272     *
    73      * @since BuddyPress (1.9.0)
     73     * @since 1.9.0
    7474     * @access public
    7575     * @var string
     
    8080     * The date the notification was created.
    8181     *
    82      * @since BuddyPress (1.9.0)
     82     * @since 1.9.0
    8383     * @access public
    8484     * @var string
     
    8989     * Is the notification new, or has it already been read.
    9090     *
    91      * @since BuddyPress (1.9.0)
     91     * @since 1.9.0
    9292     * @access public
    9393     * @var bool
     
    100100     * Constructor method.
    101101     *
    102      * @since BuddyPress (1.9.0)
     102     * @since 1.9.0
    103103     *
    104104     * @param int $id Optional. Provide an ID to access an existing
     
    115115     * Update or insert notification details into the database.
    116116     *
    117      * @since BuddyPress (1.9.0)
     117     * @since 1.9.0
    118118     *
    119119     * @global wpdb $wpdb WordPress database object.
     
    143143         * Please use this hook to filter the properties above. Each part will be passed in.
    144144         *
    145          * @since BuddyPress (2.0.0)
     145         * @since 2.0.0
    146146         *
    147147         * @param BP_Notifications_Notification $value Current instance of the notification item being saved. Passed by reference.
     
    169169         * Fires after the current notification item gets saved.
    170170         *
    171          * @since BuddyPress (2.0.0)
     171         * @since 2.0.0
    172172         *
    173173         * @param BP_Notifications_Notification $value Current instance of the notification item being saved. Passed by reference.
     
    182182     * Fetch data for an existing notification from the database.
    183183     *
    184      * @since BuddyPress (1.9.0)
     184     * @since 1.9.0
    185185     *
    186186     * @global BuddyPress $bp The one true BuddyPress instance.
     
    212212     * Create a notification entry.
    213213     *
    214      * @since BuddyPress (1.9.0)
     214     * @since 1.9.0
    215215     *
    216216     * @param array $data {
     
    236236     * Update notifications.
    237237     *
    238      * @since BuddyPress (1.9.0)
     238     * @since 1.9.0
    239239     *
    240240     * @see wpdb::update() for further description of paramater formats.
     
    259259     * Delete notifications.
    260260     *
    261      * @since BuddyPress (1.9.0)
     261     * @since 1.9.0
    262262     *
    263263     * @see wpdb::update() for further description of paramater formats.
     
    281281     * clause.
    282282     *
    283      * @since BuddyPress (1.9.0)
     283     * @since 1.9.0
    284284     *
    285285     * @param array  $args           See {@link BP_Notifications_Notification::get()}
     
    382382         * Filters the MySQL WHERE conditions for the Notifications items get method.
    383383         *
    384          * @since BuddyPress (2.3.0)
     384         * @since 2.3.0
    385385         *
    386386         * @param array  $where_conditions Current conditions for MySQL WHERE statement.
     
    407407     * clause.
    408408     *
    409      * @since BuddyPress (1.9.0)
     409     * @since 1.9.0
    410410     *
    411411     * @param array $args See {@link BP_Notifications_Notification::get()}
     
    445445     * Used by BP_Notifications_Notification::get() to create its LIMIT clause.
    446446     *
    447      * @since BuddyPress (1.9.0)
     447     * @since 1.9.0
    448448     *
    449449     * @param array $args See {@link BP_Notifications_Notification::get()}
     
    503503     * which can easily be passed as arguments to the $wpdb methods.
    504504     *
    505      * @since BuddyPress (1.9.0)
     505     * @since 1.9.0
    506506     *
    507507     * @param array $args Associative array of filter arguments.
     
    567567     * Check that a specific notification is for a specific user.
    568568     *
    569      * @since BuddyPress (1.9.0)
     569     * @since 1.9.0
    570570     *
    571571     * @param int $user_id         ID of the user being checked.
     
    614614     * Get notifications, based on provided filter parameters.
    615615     *
    616      * @since BuddyPress (1.9.0)
     616     * @since 1.9.0
    617617     *
    618618     * @param array $args {
     
    703703     * Get a count of total notifications matching a set of arguments.
    704704     *
    705      * @since BuddyPress (1.9.0)
     705     * @since 1.9.0
    706706     *
    707707     * @see BP_Notifications_Notification::get() for a description of
     
    762762     * AND keyword from the 'where' clause).
    763763     *
    764      * @since BuddyPress (2.3.0)
     764     * @since 2.3.0
    765765     *
    766766     * @param  array $meta_query An array of meta_query filters. See the
     
    804804     * the leading AND keyword from the query).
    805805     *
    806      * @since BuddyPress (2.3.0)
     806     * @since 2.3.0
    807807     *
    808808     * @param array $date_query An array of date_query parameters. See the
     
    828828     * Update notifications.
    829829     *
    830      * @since BuddyPress (1.9.0)
     830     * @since 1.9.0
    831831     *
    832832     * @see BP_Notifications_Notification::get() for a description of
     
    849849         * Fires before the update of a notification item.
    850850         *
    851          * @since BuddyPress (2.3.0)
     851         * @since 2.3.0
    852852         *
    853853         * @param array $update_args See BP_Notifications_Notification::update().
     
    867867     * Delete notifications.
    868868     *
    869      * @since BuddyPress (1.9.0)
     869     * @since 1.9.0
    870870     *
    871871     * @see BP_Notifications_Notification::get() for a description of
     
    884884         * Fires before the deletion of a notification item.
    885885         *
    886          * @since BuddyPress (2.0.0)
     886         * @since 2.0.0
    887887         *
    888888         * @param array $args Associative array of columns/values, to determine
     
    900900     * Delete a single notification by ID.
    901901     *
    902      * @since BuddyPress (1.9.0)
     902     * @since 1.9.0
    903903     *
    904904     * @see BP_Notifications_Notification::delete() for explanation of
     
    918918     * Fetch all the notifications in the database for a specific user.
    919919     *
    920      * @since BuddyPress (1.9.0)
     920     * @since 1.9.0
    921921     *
    922922     * @param int    $user_id ID of the user whose notifications are being
     
    937937     * Fetch all the unread notifications in the database for a specific user.
    938938     *
    939      * @since BuddyPress (1.9.0)
     939     * @since 1.9.0
    940940     *
    941941     * @param int $user_id ID of the user whose notifications are being
     
    954954     * Fetch all the read notifications in the database for a specific user.
    955955     *
    956      * @since BuddyPress (1.9.0)
     956     * @since 1.9.0
    957957     *
    958958     * @param int $user_id ID of the user whose notifications are being
     
    971971     * Get unread notifications for a user, in a pagination-friendly format.
    972972     *
    973      * @since BuddyPress (1.9.0)
     973     * @since 1.9.0
    974974     *
    975975     * @param array $args {
     
    10171017     * Mark all user notifications as read.
    10181018     *
    1019      * @since BuddyPress (1.9.0)
     1019     * @since 1.9.0
    10201020     *
    10211021     * @param int    $user_id           The ID of the user who the notifications are for.
     
    10621062     * Mark all notifications from a user as read.
    10631063     *
    1064      * @since BuddyPress (1.9.0)
     1064     * @since 1.9.0
    10651065     *
    10661066     * @param int    $user_id           The ID of the user who the notifications are from.
     
    11031103     * secondary item id, and component name and action.
    11041104     *
    1105      * @since BuddyPress (1.9.0)
     1105     * @since 1.9.0
    11061106     *
    11071107     * @param int    $item_id           The ID of the item associated with the
Note: See TracChangeset for help on using the changeset viewer.