Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
09/27/2015 05:25:02 AM (9 years ago)
Author:
tw2113
Message:

Standardizing our @since tags for the Groups Component.

See #6576.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/bp-groups/classes/class-bp-group-extension.php

    r10021 r10148  
    77 */
    88
    9 // Exit if accessed directly
     9// Exit if accessed directly.
    1010defined( 'ABSPATH' ) || exit;
    1111
     
    8686 * @package BuddyPress
    8787 * @subpackage Groups
    88  * @since BuddyPress (1.1.0)
     88 * @since 1.1.0
    8989 */
    9090class BP_Group_Extension {
     
    9595     * Information about this extension's screens.
    9696     *
    97      * @since BuddyPress (1.8.0)
     97     * @since 1.8.0
    9898     * @access public
    9999     * @var array
     
    104104     * The name of the extending class.
    105105     *
    106      * @since BuddyPress (1.8.0)
     106     * @since 1.8.0
    107107     * @access public
    108108     * @var string
     
    113113     * A ReflectionClass object of the current extension.
    114114     *
    115      * @since BuddyPress (1.8.0)
     115     * @since 1.8.0
    116116     * @access public
    117117     * @var ReflectionClass
     
    122122     * Parsed configuration parameters for the extension.
    123123     *
    124      * @since BuddyPress (1.8.0)
     124     * @since 1.8.0
    125125     * @access public
    126126     * @var array
     
    131131     * Raw config params, as passed by the extending class.
    132132     *
    133      * @since BuddyPress (2.1.0)
     133     * @since 2.1.0
    134134     * @access public
    135135     * @var array
     
    140140     * The ID of the current group.
    141141     *
    142      * @since BuddyPress (1.8.0)
     142     * @since 1.8.0
    143143     * @access public
    144144     * @var int
     
    189189     * Whether the current user should see the navigation item.
    190190     *
    191      * @since BuddyPress (2.1.0)
     191     * @since 2.1.0
    192192     * @access public
    193193     * @var bool
     
    198198     * Whether the current user can visit the tab.
    199199     *
    200      * @since BuddyPress (2.1.0)
     200     * @since 2.1.0
    201201     * @access public
    202202     * @var bool
     
    237237     * Has the extension been initialized?
    238238     *
    239      * @since BuddyPress (1.8.0)
     239     * @since 1.8.0
    240240     * @access protected
    241241     * @var bool
     
    246246     * Extension properties as set by legacy extensions.
    247247     *
    248      * @since BuddyPress (1.8.0)
     248     * @since 1.8.0
    249249     * @access protected
    250250     * @var array
     
    258258     * then converted to match the new format for params.
    259259     *
    260      * @since BuddyPress (1.8.0)
     260     * @since 1.8.0
    261261     * @access protected
    262262     * @var array
     
    267267     * Redirect location as defined by post-edit save callback.
    268268     *
    269      * @since BuddyPress (2.1.0)
     269     * @since 2.1.0
    270270     * @access protected
    271271     * @var string
     
    276276     * Miscellaneous data as set by the __set() magic method.
    277277     *
    278      * @since BuddyPress (1.8.0)
     278     * @since 1.8.0
    279279     * @access protected
    280280     * @var array
     
    334334     *   }
    335335     *
    336      * @since BuddyPress (1.8.0)
    337      * @since BuddyPress (2.1.0) Added 'access' and 'show_tab' arguments to `$args`.
     336     * @since 1.8.0
     337     * @since 2.1.0 Added 'access' and 'show_tab' arguments to `$args`.
    338338     *
    339339     * @param array $args {
     
    416416     * bp_register_group_extension().
    417417     *
    418      * @since BuddyPress (1.1.0)
     418     * @since 1.1.0
    419419     */
    420420    public function _register() {
     
    463463     * whether your extension overrides certain callback methods.
    464464     *
    465      * @since BuddyPress (1.8.0)
     465     * @since 1.8.0
    466466     */
    467467    protected function setup_class_info() {
     
    483483     *   - group admin
    484484     *
    485      * @since BuddyPress (1.8.0)
     485     * @since 1.8.0
    486486     *
    487487     * @return int
     
    516516     * Gather configuration data about your screens.
    517517     *
    518      * @since BuddyPress (1.8.0)
     518     * @since 1.8.0
    519519     *
    520520     * @return array
     
    551551     * Set up screens array based on params.
    552552     *
    553      * @since BuddyPress (1.8.0)
     553     * @since 1.8.0
    554554     */
    555555    protected function setup_screens() {
     
    570570     * Set up access-related settings for this extension.
    571571     *
    572      * @since BuddyPress (2.1.0)
     572     * @since 2.1.0
    573573     */
    574574    protected function setup_access_settings() {
     
    714714     * Hook this extension's group tab into BuddyPress, if necessary.
    715715     *
    716      * @since BuddyPress (1.8.0)
     716     * @since 1.8.0
    717717     */
    718718    protected function setup_display_hooks() {
     
    784784         * Filters the template to load for the main display method.
    785785         *
    786          * @since BuddyPress (1.0.0)
     786         * @since 1.0.0
    787787         *
    788788         * @param string $template_file Path to the template to load.
     
    797797     * display() callback.
    798798     *
    799      * @since BuddyPress (2.1.1)
     799     * @since 2.1.1
    800800     */
    801801    public function call_display() {
     
    809809     * Access to the tab is controlled by the user_can_visit() check.
    810810     *
    811      * @since BuddyPress (2.1.0)
     811     * @since 2.1.0
    812812     *
    813813     * @param bool $user_can_see_nav_item
     
    826826     * Determine whether the current user has access to visit this tab.
    827827     *
    828      * @since BuddyPress (2.1.0)
     828     * @since 2.1.0
    829829     *
    830830     * @param bool $user_can_visit
     
    847847     * modified before the redirect takes place.
    848848     *
    849      * @since BuddyPress (2.1.0)
     849     * @since 2.1.0
    850850     *
    851851     * @param bool  $user_can_visit
     
    876876     * Hook this extension's Create step into BuddyPress, if necessary.
    877877     *
    878      * @since BuddyPress (1.8.0)
     878     * @since 1.8.0
    879879     */
    880880    protected function setup_create_hooks() {
     
    904904     * Call the create_screen() method, if we're on the right page.
    905905     *
    906      * @since BuddyPress (1.8.0)
     906     * @since 1.8.0
    907907     */
    908908    public function maybe_create_screen() {
     
    922922     * Call the create_screen_save() method, if we're on the right page.
    923923     *
    924      * @since BuddyPress (1.8.0)
     924     * @since 1.8.0
    925925     */
    926926    public function maybe_create_screen_save() {
     
    938938     * Hook this extension's Edit panel into BuddyPress, if necessary.
    939939     *
    940      * @since BuddyPress (1.8.0)
     940     * @since 1.8.0
    941941     */
    942942    protected function setup_edit_hooks() {
     
    10121012     * do not auto-add our own button.
    10131013     *
    1014      * @since BuddyPress (1.8.0)
     1014     * @since 1.8.0
    10151015     */
    10161016    public function call_edit_screen() {
     
    10281028     * Check the nonce, and call the edit_screen_save() method.
    10291029     *
    1030      * @since BuddyPress (1.8.0)
     1030     * @since 1.8.0
    10311031     */
    10321032    public function call_edit_screen_save() {
     
    10611061             * Only runs if a redirect has not already occurred.
    10621062             *
    1063              * @since BuddyPress (2.1.0)
     1063             * @since 2.1.0
    10641064             *
    10651065             * @param string $value URL to redirect to.
     
    10811081     * Hooked to 'bp_screens'.
    10821082     *
    1083      * @since BuddyPress (1.8.0)
     1083     * @since 1.8.0
    10841084     * @access public So that do_action() has access. Do not call directly.
    10851085     *
     
    11001100     * if one is not found.
    11011101     *
    1102      * @since BuddyPress (1.8.0)
     1102     * @since 1.8.0
    11031103     *
    11041104     * @param string $screen The screen markup, captured in the output
     
    11231123     * Does the given markup have a submit button?
    11241124     *
    1125      * @since BuddyPress (1.8.0)
     1125     * @since 1.8.0
    11261126     *
    11271127     * @param string $screen The markup to check.
     
    11381138     * Detect redirects hardcoded into edit_screen_save() callbacks.
    11391139     *
    1140      * @since BuddyPress (2.1.0)
     1140     * @since 2.1.0
    11411141     *
    11421142     * @param string $redirect
     
    11571157     * Hook this extension's Admin metabox into BuddyPress, if necessary.
    11581158     *
    1159      * @since BuddyPress (1.8.0)
     1159     * @since 1.8.0
    11601160     */
    11611161    protected function setup_admin_hooks() {
     
    11771177     * Call the admin_screen() method, and add a nonce field.
    11781178     *
    1179      * @since BuddyPress (1.8.0)
     1179     * @since 1.8.0
    11801180     */
    11811181    public function call_admin_screen() {
     
    11871187     * Check the nonce, and call the admin_screen_save() method.
    11881188     *
    1189      * @since BuddyPress (1.8.0)
     1189     * @since 1.8.0
    11901190     */
    11911191    public function call_admin_screen_save() {
     
    11971197     * Create the Dashboard meta box for this extension.
    11981198     *
    1199      * @since BuddyPress (1.7.0)
     1199     * @since 1.7.0
    12001200     */
    12011201    public function _meta_box_display_callback() {
     
    12251225     * must avoid name clashes.
    12261226     *
    1227      * @since BuddyPress (1.8.0)
     1227     * @since 1.8.0
    12281228     *
    12291229     * @param string $context Screen context. 'create', 'edit', or 'admin'.
     
    12361236     * Check the nonce on a submitted settings form.
    12371237     *
    1238      * @since BuddyPress (1.8.0)
     1238     * @since 1.8.0
    12391239     *
    12401240     * @param string $context Screen context. 'create', 'edit', or 'admin'.
     
    12511251     * must also exist and be callable.
    12521252     *
    1253      * @since BuddyPress (1.8.0)
     1253     * @since 1.8.0
    12541254     *
    12551255     * @param string $context Screen context. 'create', 'edit', or 'admin'.
     
    12991299     * determine whether your extension has provided a given callback.
    13001300     *
    1301      * @since BuddyPress (1.8.0)
     1301     * @since 1.8.0
    13021302     *
    13031303     * @param string $context Screen context. 'create', 'edit', or 'admin'.
     
    13501350     * https://core.trac.wordpress.org/ticket/19888
    13511351     *
    1352      * @since BuddyPress (1.8.0)
     1352     * @since 1.8.0
    13531353     *
    13541354     * @param array $a First set of arguments.
     
    13951395     * self::setup_legacy_properties().
    13961396     *
    1397      * @since BuddyPress (1.8.0)
     1397     * @since 1.8.0
    13981398     *
    13991399     * @param string $key Property name.
     
    14201420     * $this->data array.
    14211421     *
    1422      * @since BuddyPress (1.8.0)
     1422     * @since 1.8.0
    14231423     *
    14241424     * @param string $key Property name.
     
    14441444     * $this->enable_create_step.
    14451445     *
    1446      * @since BuddyPress (1.8.0)
     1446     * @since 1.8.0
    14471447     *
    14481448     * @param string $key Property name.
     
    15091509     * object properties for configuration. Some have been moved.
    15101510     *
    1511      * @since BuddyPress (1.8.0)
     1511     * @since 1.8.0
    15121512     *
    15131513     * @return array List of legacy property keys.
     
    15451545     * parse them into the new init() array.
    15461546     *
    1547      * @since BuddyPress (1.8.0)
     1547     * @since 1.8.0
    15481548     */
    15491549    protected function parse_legacy_properties() {
     
    16261626     * their old locations.
    16271627     *
    1628      * @since BuddyPress (1.8.0)
     1628     * @since 1.8.0
    16291629     *
    16301630     * @see BP_Group_Extension::__get()
Note: See TracChangeset for help on using the changeset viewer.