Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
09/13/2015 02:02:56 AM (10 years ago)
Author:
tw2113
Message:

Standardizing our @since tags for the Core component.

See #6576.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/bp-core/bp-core-component.php

    r10052 r10108  
    2323 * @subpackage Component
    2424 *
    25  * @since BuddyPress (1.5.0)
     25 * @since 1.5.0
    2626 */
    2727class BP_Component {
     
    9696     * Placeholder text for component directory search box.
    9797     *
    98      * @since BuddyPress (1.5.0)
     98     * @since 1.5.0
    9999     * @var string $search_string
    100100     */
     
    104104     * Root slug for the component.
    105105     *
    106      * @since BuddyPress (1.5.0)
     106     * @since 1.5.0
    107107     * @var string $root_slug
    108108     */
     
    112112     * Metadata tables for the component (if applicable).
    113113     *
    114      * @since BuddyPress (2.0.0)
     114     * @since 2.0.0
    115115     *
    116116     * @var array
     
    121121     * Global tables for the component (if applicable).
    122122     *
    123      * @since BuddyPress (2.0.0)
     123     * @since 2.0.0
    124124     *
    125125     * @var array
     
    132132     * Component loader.
    133133     *
    134      * @since BuddyPress (1.5.0)
    135      * @since BuddyPress (1.9.0) Added $params as a parameter.
    136      * @since BuddyPress (2.3.0) Added $params['features'] as a configurable value.
     134     * @since 1.5.0
     135     * @since 1.9.0 Added $params as a parameter.
     136     * @since 2.3.0 Added $params['features'] as a configurable value.
    137137     *
    138138     * @param string $id   Unique ID. Letters, numbers, and underscores only.
     
    185185     * Set up component global variables.
    186186     *
    187      * @since BuddyPress (1.5)
     187     * @since 1.5.0
    188188     *
    189189     * @uses apply_filters() Calls 'bp_{@link bp_Component::name}_id'.
     
    228228         * Filters the slug to be used for the permalink URI chunk after root.
    229229         *
    230          * @since BuddyPress (1.5.0)
     230         * @since 1.5.0
    231231         *
    232232         * @param string $value Slug to use in permalink URI chunk.
     
    237237         * Filters the slug used for root directory.
    238238         *
    239          * @since BuddyPress (1.5.0)
     239         * @since 1.5.0
    240240         *
    241241         * @param string $value Root directory slug.
     
    246246         * Filters the component's top-level directory if available.
    247247         *
    248          * @since BuddyPress (1.5.0)
     248         * @since 1.5.0
    249249         *
    250250         * @param bool $value Whether or not there is a top-level directory.
     
    255255         * Filters the component's directory title.
    256256         *
    257          * @since BuddyPress (2.0.0)
     257         * @since 2.0.0
    258258         *
    259259         * @param string $value Title to use for the directory.
     
    264264         * Filters the placeholder text for search inputs for component.
    265265         *
    266          * @since BuddyPress (1.5.0)
     266         * @since 1.5.0
    267267         *
    268268         * @param string $value Name to use in search input placeholders.
     
    273273         * Filters the callable function that formats the component's notifications.
    274274         *
    275          * @since BuddyPress (1.5.0)
     275         * @since 1.5.0
    276276         *
    277277         * @param string $value Function callback.
     
    299299         * This is a dynamic hook that is based on the component string ID.
    300300         *
    301          * @since BuddyPress (1.5.0)
     301         * @since 1.5.0
    302302         */
    303303        do_action( 'bp_' . $this->id . '_setup_globals' );
     
    327327     *   - ./bp-my_component/bp-my_component-actions.php
    328328     *
    329      * @since BuddyPress (1.5.0)
     329     * @since 1.5.0
    330330     *
    331331     * @uses do_action() Calls 'bp_{@link bp_Component::name}includes'.
     
    370370         * This is a dynamic hook that is based on the component string ID.
    371371         *
    372          * @since BuddyPress (1.5.0)
     372         * @since 1.5.0
    373373         */
    374374        do_action( 'bp_' . $this->id . '_includes' );
     
    378378     * Set up the actions.
    379379     *
    380      * @since BuddyPress (1.5.0)
     380     * @since 1.5.0
    381381     *
    382382     * @uses add_action() To add various actions.
     
    436436         * This is a dynamic hook that is based on the component string ID.
    437437         *
    438          * @since BuddyPress (1.5.0)
     438         * @since 1.5.0
    439439         */
    440440        do_action( 'bp_' . $this->id . '_setup_actions' );
     
    444444     * Set up the canonical URL stack for this component.
    445445     *
    446      * @since BuddyPress (2.1.0)
     446     * @since 2.1.0
    447447     */
    448448    public function setup_canonical_stack() {}
     
    481481         * This is a dynamic hook that is based on the component string ID.
    482482         *
    483          * @since BuddyPress (1.5.0)
     483         * @since 1.5.0
    484484         */
    485485        do_action( 'bp_' . $this->id . '_setup_nav' );
     
    515515         * This is a dynamic hook that is based on the component string ID.
    516516         *
    517          * @since BuddyPress (1.9.0)
     517         * @since 1.9.0
    518518         *
    519519         * @param array $wp_admin_nav Array of navigation items to add.
     
    541541         * This is a dynamic hook that is based on the component string ID.
    542542         *
    543          * @since BuddyPress (1.5.0)
     543         * @since 1.5.0
    544544         */
    545545        do_action( 'bp_' . $this->id . '_setup_admin_bar' );
     
    549549     * Set up the component title.
    550550     *
    551      * @since BuddyPress (1.5.0)
     551     * @since 1.5.0
    552552     *
    553553     * @uses do_action() Calls 'bp_{@link bp_Component::name}_setup_title'.
     
    560560         * This is a dynamic hook that is based on the component string ID.
    561561         *
    562          * @since BuddyPress (1.5.0)
     562         * @since 1.5.0
    563563         */
    564564        do_action(  'bp_' . $this->id . '_setup_title' );
     
    568568     * Setup component-specific cache groups.
    569569     *
    570      * @since BuddyPress (2.2.0)
     570     * @since 2.2.0
    571571     *
    572572     * @uses do_action() Calls 'bp_setup_{@link bp_Component::name}_cache_groups'.
     
    579579         * This is a dynamic hook that is based on the component string ID.
    580580         *
    581          * @since BuddyPress (2.2.0)
     581         * @since 2.2.0
    582582         */
    583583        do_action( 'bp_' . $this->id . '_setup_cache_groups' );
     
    587587     * Register global tables for the component, so that it may use WordPress's database API.
    588588     *
    589      * @since BuddyPress (2.0.0)
     589     * @since 2.0.0
    590590     *
    591591     * @param array $tables Table names to register.
     
    600600         * *all* tables, use the 'bp_core_get_table_prefix' filter instead.
    601601         *
    602          * @since BuddyPress (1.6.0)
     602         * @since 1.6.0
    603603         */
    604604        $tables = apply_filters( 'bp_' . $this->id . '_global_tables', $tables );
     
    619619         * This is a dynamic hook that is based on the component string ID.
    620620         *
    621          * @since BuddyPress (2.0.0)
     621         * @since 2.0.0
    622622         */
    623623        do_action( 'bp_' . $this->id . '_register_global_tables' );
     
    630630     * compatibility with the WordPress metadata API.
    631631     *
    632      * @since BuddyPress (2.0.0)
     632     * @since 2.0.0
    633633     *
    634634     * @param array $tables Table names to register.
     
    644644         * *all* tables, use the 'bp_core_get_table_prefix' filter instead.
    645645         *
    646          * @since BuddyPress (2.0.0)
     646         * @since 2.0.0
    647647         */
    648648        $tables = apply_filters( 'bp_' . $this->id . '_meta_tables', $tables );
     
    666666         * This is a dynamic hook that is based on the component string ID.
    667667         *
    668          * @since BuddyPress (2.0.0)
     668         * @since 2.0.0
    669669         */
    670670        do_action( 'bp_' . $this->id . '_register_meta_tables' );
     
    674674     * Set up the component post types.
    675675     *
    676      * @since BuddyPress (1.5.0)
     676     * @since 1.5.0
    677677     *
    678678     * @uses do_action() Calls 'bp_{@link bp_Component::name}_register_post_types'.
     
    685685         * This is a dynamic hook that is based on the component string ID.
    686686         *
    687          * @since BuddyPress (1.5.0)
     687         * @since 1.5.0
    688688         */
    689689        do_action( 'bp_' . $this->id . '_register_post_types' );
     
    693693     * Register component-specific taxonomies.
    694694     *
    695      * @since BuddyPress (1.5.0)
     695     * @since 1.5.0
    696696     *
    697697     * @uses do_action() Calls 'bp_{@link bp_Component::name}_register_taxonomies'.
     
    704704         * This is a dynamic hook that is based on the component string ID.
    705705         *
    706          * @since BuddyPress (1.5.0)
     706         * @since 1.5.0
    707707         */
    708708        do_action( 'bp_' . $this->id . '_register_taxonomies' );
     
    712712     * Add any additional rewrite tags.
    713713     *
    714      * @since BuddyPress (1.5.0)
     714     * @since 1.5.0
    715715     *
    716716     * @uses do_action() Calls 'bp_{@link bp_Component::name}_add_rewrite_tags'.
     
    723723         * This is a dynamic hook that is based on the component string ID.
    724724         *
    725          * @since BuddyPress (1.5.0)
     725         * @since 1.5.0
    726726         */
    727727        do_action( 'bp_' . $this->id . '_add_rewrite_tags' );
     
    731731     * Add any additional rewrite rules.
    732732     *
    733      * @since BuddyPress (1.9.0)
     733     * @since 1.9.0
    734734     *
    735735     * @uses do_action() Calls 'bp_{@link bp_Component::name}_add_rewrite_rules'.
     
    742742         * This is a dynamic hook that is based on the component string ID.
    743743         *
    744          * @since BuddyPress (1.9.0)
     744         * @since 1.9.0
    745745         */
    746746        do_action( 'bp_' . $this->id . '_add_rewrite_rules' );
     
    750750     * Add any permalink structures.
    751751     *
    752      * @since BuddyPress (1.9)
     752     * @since 1.9.0
    753753     *
    754754     * @uses do_action() Calls 'bp_{@link bp_Component::name}_add_permastruct'.
     
    761761         * This is a dynamic hook that is based on the component string ID.
    762762         *
    763          * @since BuddyPress (1.9.0)
     763         * @since 1.9.0
    764764         */
    765765        do_action( 'bp_' . $this->id . '_add_permastructs' );
     
    769769     * Allow components to parse the main query.
    770770     *
    771      * @since BuddyPress (1.9)
     771     * @since 1.9.0
    772772     *
    773773     * @uses do_action() Calls 'bp_{@link bp_Component::name}_parse_query'.
     
    782782         * This is a dynamic hook that is based on the component string ID.
    783783         *
    784          * @since BuddyPress (1.9.0)
     784         * @since 1.9.0
    785785         *
    786786         * @param object $query Main WP_Query object. Passed by reference.
     
    792792     * Generate any additional rewrite rules.
    793793     *
    794      * @since BuddyPress (1.5)
     794     * @since 1.5.0
    795795     *
    796796     * @uses do_action() Calls 'bp_{@link bp_Component::name}_generate_rewrite_rules'.
     
    803803         * This is a dynamic hook that is based on the component string ID.
    804804         *
    805          * @since BuddyPress (1.5.0)
     805         * @since 1.5.0
    806806         */
    807807        do_action( 'bp_' . $this->id . '_generate_rewrite_rules' );
Note: See TracChangeset for help on using the changeset viewer.