Extension:DynamicSidebar

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
DynamicSidebar
Release status: stable
Extension DynamicSidebar example.png
Implementation Skin, MyWiki
Description Provides dynamic sidebars based on user pages, groups, and categories.
Author(s) Ryan Lane (Ryan lanetalk)
Latest version 1.1 (2017-07-17)
MediaWiki 1.25+
License GNU General Public License 2.0 or later
Download
Parameters
  • $wgDynamicSidebarUseUserpages
  • $wgDynamicSidebarUseGroups
  • $wgDynamicSidebarUseCategories
Hooks used
Debug
SkinBuildSidebar
User
Translate the DynamicSidebar extension if it is available at translatewiki.net
Check usage and version matrix.
Issues Open tasks · Report a bug

The DynamicSidebar extends the capabilities of the sidebar for logged in users. If allowed, users can add their own custom sidebars via "User:<username>/Sidebar". Administrators can add sidebars for groups, and userpage categories via "MediaWiki:Sidebar/Group:<group>", and "MediaWiki:Sidebar/Category:<category>".

Installation[edit]

  • Download and place the file(s) in a directory called DynamicSidebar in your extensions/ folder.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension() If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'DynamicSidebar' );, you need to use:

require_once "$IP/extensions/DynamicSidebar/DynamicSidebar.php";

Configuration[edit]

The following options are available:

// Enable debugging
$wgDebugLogGroups['dynamic-sidebar'] = '/tmp/sidebar-debug.txt';

// Allow users to create their own custom sidebars under User:<username>/Sidebar
// Default: true
$wgDynamicSidebarUseUserpages = true;

// Allow group sidebars under MediaWiki:Sidebar/Group:<group>
// Default: true
$wgDynamicSidebarUseGroups = true;

// Allow category based sidebars under MediaWiki:Sidebar/Category:<category>
// Default: true
$wgDynamicSidebarUseCategories = true;

Usage[edit]

Custom user sidebars[edit]

$wgDynamicSidebarUseUserpages must be enabled, then an administrator must add the following in "MediaWiki:Sidebar":

* USER-SIDEBAR

This string will be replaced with the user's sidebar.

Users should add their sidebar to "User:<username>/Sidebar".

Group sidebars[edit]

$wgDynamicSidebarUseGroups must be enabled, then an administrator must add the following in "MediaWiki:Sidebar":

* GROUP-SIDEBAR

This string will be replaced with the user's group sidebars.

Administrators must add a sidebar for each group at "MediaWiki:Sidebar/Group:<group>". If a user is in multiple groups, sidebars will be shown for each group.

Category sidebars[edit]

$wgDynamicSidebarUseCategories must be enabled, then an administrator must add the following in "MediaWiki:Sidebar":

* CATEGORY-SIDEBAR

This string will be replaced with the sidebars of the categories on the user's userpage.

Administrators must add a sidebar for each category at "MediaWiki:Sidebar/Category:<category>". If a user's userpage has multiple categories, sidebars will be shown for each category. Users can add sidebars by adding a category to their userpage.


Possible issues[edit]

If the Dynamic sidebar don't appear or the menu is not collapsible then you need install the CollapsibleVector (link below):

Extension:CollapsibleVector

See Also[edit]