Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
06/30/2015 06:22:31 AM (9 years ago)
Author:
tw2113
Message:

Further docs cleanup for BP Groups component.

See #6401.

File:
1 edited

Legend:

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

    r9907 r9982  
    11<?php
    22/**
    3  * BuddyPress Groups Classes
     3 * BuddyPress Groups Classes.
    44 *
    55 * @package BuddyPress
     
    291291
    292292    /**
    293      * The content of the group tab
     293     * The content of the group tab.
    294294     *
    295295     * @param int|null $group_id
     
    319319
    320320    /**
    321      * Initialize the extension, using your config settings
     321     * Initialize the extension, using your config settings.
    322322     *
    323323     * Your plugin should call this method at the very end of its
     
    339339     * @param array $args {
    340340     *     Array of initialization arguments.
    341      *     @type string $slug Unique, URL-safe identifier for your
    342      *           extension.
    343      *     @type string $name Translatable name for your extension. Used to
    344      *           populate navigation items.
    345      *     @type string $visibility Optional. Set to 'public' for your
    346      *           extension (the main tab as well as the widget) to be
    347      *           available to anyone who can access the group; set to
    348      *           'private' otherwise. Default: 'public'.
    349      *     @type int $nav_item_position Optional. Location of the nav item
    350      *           in the tab list. Default: 81.
    351      *     @type bool $enable_nav_item Optional. Whether the extension's
    352      *           tab should be accessible to anyone who can view the group.
    353      *           Default: true.
    354      *     @type string $nav_item_name Optional. The translatable text you
    355      *           want to appear in the nav tab. Default: the value of $name.
    356      *     @type string $display_hook Optional. The WordPress action that
    357      *           the widget_display() method is hooked to.
    358      *           Default: 'groups_custom_group_boxes'.
    359      *     @type string $template_file Optional. Theme-relative path to the
    360      *           template file BP should use to load the content of your
    361      *           main extension tab. Default: 'groups/single/plugins.php'.
    362      *     @type array $screens A multi-dimensional array of configuration
    363      *           information for the extension screens. See docblock of
    364      *           {@link BP_Group_Extension} for more details.
    365      *     @type string|array $access Which users can visit the plugin's tab.
    366      *           Possible values: 'anyone', 'loggedin', 'member',
    367      *           'mod', 'admin' or 'noone'. ('member', 'mod', 'admin'
    368      *           refer to user's role in group.) Note that 'mod' targets only
    369      *           group moderators. If you want to allow access to group
    370      *           moderators and admins, specify `array( 'mod', 'admin' )`.
    371      *           Defaults to 'anyone' for public groups and 'member' for
    372      *           private groups.
    373      *     @type string|array $show_tab Which users can see the plugin's
    374      *           navigation tab.
    375      *           Possible values: 'anyone', 'loggedin', 'member',
    376      *           'mod', 'admin' or 'noone'. ('member', 'mod', 'admin'
    377      *           refer to user's role in group.) Note that 'mod' targets only
    378      *           group moderators. If you want to show the tab to group
    379      *           moderators and admins, specify `array( 'mod', 'admin' )`.
    380      *           Defaults to 'anyone' for public groups and 'member' for
    381      *           private groups.
     341     *     @type string       $slug            Unique, URL-safe identifier for your
     342     *                                         extension.
     343     *     @type string       $name            Translatable name for your extension. Used to
     344     *                                         populate navigation items.
     345     *     @type string       $visibility      Optional. Set to 'public' for your
     346     *                                         extension (the main tab as well as the widget) to be
     347     *                                         available to anyone who can access the group; set to
     348     *                                         'private' otherwise. Default: 'public'.
     349     *     @type int          $nav_item_       Position Optional. Location of the nav item
     350     *                                         in the tab list. Default: 81.
     351     *     @type bool         $enable_nav_item Optional. Whether the extension's tab should be
     352     *                                         accessible to anyone who can view the group.
     353     *                                         Default: true.
     354     *     @type string       $nav_item_name   Optional. The translatable text you want to appear
     355     *                                         in the nav tab. Default: the value of $name.
     356     *     @type string       $display_hook    Optional. The WordPress action that
     357     *                                         the widget_display() method is hooked to.
     358     *                                         Default: 'groups_custom_group_boxes'.
     359     *     @type string       $template_file   Optional. Theme-relative path to the template file
     360     *                                         BP should use to load the content of your main
     361     *                                         extension tab. Default: 'groups/single/plugins.php'.
     362     *     @type array        $screens         A multi-dimensional array of configuration
     363     *                                         information for the extension screens. See docblock of
     364     *                                         {@link BP_Group_Extension} for more details.
     365     *     @type string|array $access          Which users can visit the plugin's tab.
     366     *                                         Possible values: 'anyone', 'loggedin', 'member',
     367     *                                         'mod', 'admin' or 'noone'. ('member', 'mod', 'admin'
     368     *                                         refer to user's role in group.) Note that 'mod' targets only
     369     *                                         group moderators. If you want to allow access to group
     370     *                                         moderators and admins, specify `array( 'mod', 'admin' )`.
     371     *                                         Defaults to 'anyone' for public groups and 'member' for
     372     *                                         private groups.
     373     *     @type string|array $show_tab        Which users can see the plugin's navigation tab.
     374     *                                         Possible values: 'anyone', 'loggedin', 'member',
     375     *                                         'mod', 'admin' or 'noone'. ('member', 'mod', 'admin'
     376     *                                         refer to user's role in group.) Note that 'mod' targets only
     377     *                                         group moderators. If you want to show the tab to group
     378     *                                         moderators and admins, specify `array( 'mod', 'admin' )`.
     379     *                                         Defaults to 'anyone' for public groups and 'member' for
     380     *                                         private groups.
    382381     * }
    383382     */
     
    679678     *
    680679     * @param string $access_condition 'anyone', 'loggedin', 'member',
    681      *        'mod', 'admin' or 'noone'.
     680     *                                 'mod', 'admin' or 'noone'.
    682681     * @return bool
    683682     */
     
    768767
    769768    /**
    770      * Hook the main display method, and loads the template file
     769     * Hook the main display method, and loads the template file.
    771770     */
    772771    public function _display_hook() {
     
    803802     * @since BuddyPress (2.1.0)
    804803     *
     804     * @param bool $user_can_see_nav_item
     805     *
    805806     * @return bool
    806807     */
     
    818819     * @since BuddyPress (2.1.0)
    819820     *
     821     * @param bool $user_can_visit
     822     *
    820823     * @return bool
    821824     */
     
    837840     * @since BuddyPress (2.1.0)
    838841     *
    839      * @param bool $user_can_visit
     842     * @param bool  $user_can_visit
    840843     * @param array $no_access_args
     844     *
    841845     * @return bool
    842846     */
     
    11131117     *
    11141118     * @param string $screen The markup to check.
     1119     *
    11151120     * @return bool True if a Submit button is found, otherwise false.
    11161121     */
     
    11711176
    11721177    /**
    1173      * Check the nonce, and call the admin_screen_save() method
     1178     * Check the nonce, and call the admin_screen_save() method.
    11741179     *
    11751180     * @since BuddyPress (1.8.0)
     
    12401245     *
    12411246     * @param string $context Screen context. 'create', 'edit', or 'admin'.
     1247     *
    12421248     * @return bool True if the screen is enabled, otherwise false.
    12431249     */
     
    12871293     *
    12881294     * @param string $context Screen context. 'create', 'edit', or 'admin'.
    1289      * @param string $type Screen type. 'screen' or 'screen_save'. Default:
    1290      *        'screen'.
     1295     * @param string $type    Screen type. 'screen' or 'screen_save'. Default:
     1296     *                        'screen'.
     1297     *
    12911298     * @return callable A callable function handle.
    12921299     */
     
    13381345     * @param array $a First set of arguments.
    13391346     * @param array $b Second set of arguments.
     1347     *
    13401348     * @return array Parsed arguments.
    13411349     */
     
    13811389     *
    13821390     * @param string $key Property name.
     1391     *
    13831392     * @return mixed The value if found, otherwise null.
    13841393     */
     
    14051414     *
    14061415     * @param string $key Property name.
     1416     *
    14071417     * @return bool True if the value is set, otherwise false.
    14081418     */
Note: See TracChangeset for help on using the changeset viewer.