Reign widgets, shortcodes and widget areas
Every widget, shortcode and widget area Reign adds: what each shows, its settings and defaults, the plugin it needs, and where each widget area appears.
Reign adds eight widgets, seven shortcodes and a set of widget areas to your site. Widgets and widget areas live under Appearance > Widgets. Shortcodes are short tags you type into any page, post or text block.
Some items only exist when a plugin is active. The tables below name the plugin for each one. If a widget is missing from the list, activate the plugin it needs.
Widgets
Go to Appearance > Widgets, open a widget area, select the + button, and search for the widget name (for example “Reign - Groups”). Set the fields below and select Update.
Reign - News Widget
Needs: no plugin.
Shows your latest blog posts as a small list with a thumbnail, the post title and the date. The list is cached for 10 minutes.
| Field | Default | What it does |
|---|---|---|
| Title | Latest Posts | Heading above the list. |
| Number of posts to show | 5 | How many posts appear. |
| Select post category | none (all categories) | Hold Ctrl or Cmd to pick one or more categories. Leave empty to show every category. |
Reign - Site Wide Activity
Needs: BuddyPress with the Activity component on.
Shows a live feed of community activity with a View All button that opens your activity page.
| Field | Default | What it does |
|---|---|---|
| Title | Site Wide Activities | Heading above the feed. |
| Number of items Per Page | 25 | Items shown per page of the feed. |
| Max items to show | 200 | Upper limit on items. |
| Limit to Logged In user’s activity | No | When Yes, the widget shows only to logged-in members and lists their activity. |
| List My Activity Only | No | When Yes, lists only the activity of your site’s first administrator. |
| Show Avatar | Yes | Shows each member’s picture. |
| Show Feed Link | Yes | Adds an [RSS] link next to the title. |
| Show Activity Content | No | Shows the text of each update, not just the action line. |
| Limit activity content to | 0 | Cuts each update to this many words. Zero means no limit. |
| Show Activity Filters | Yes | Shows filter links above the feed. |
| Include only following Filters | none ticked (all) | Tick activity types to show only those. |
| Exclude following Components activity | none ticked | Tick activity types to hide them. |
Reign - Product Categories
Needs: WooCommerce.
Shows your product categories as image tiles. Empty categories and “Uncategorized” are left out.
| Field | Default | What it does |
|---|---|---|
| Title | Product Categories | Heading above the tiles. |
| Number of categories per row | 3 | Tiles per row. |
| Number of categories | 6 | Total tiles. |
| Show parent categories only | Off | Hides subcategories. |
| Show product counts | On | Shows “Items” under the name. |
| Enable slider | Off | Turns the row into a slider. |
| Layout | Layout - 1 | Picks the tile design, Layout - 1 to Layout - 6 (see below). |
| Selected Categories: (comma-separated IDs) | empty (all) | Type category IDs such as 12,15,20 to show only those. |
What each layout shows:
- Layout - 1: category image as background, name, product count and a Shop Now button.
- Layout - 2: category image as background, name and product count. No button.
- Layout - 3 and Layout - 4: image, Shop Now button, name and count, without a background image. The two differ in styling.
- Layout - 5: image, name, count, then the Shop Now button.
- Layout - 6: count, image, name, then the Shop Now button.
Reign - Login
Needs: BuddyPress. This is the “BP Login” widget.
Shows a login form. A logged-in visitor does not need it, so place it in a sidebar for visitors.
| Field | Default | What it does |
|---|---|---|
| Title | Login | Heading above the form. |
| Login Redirect | Current page | Where members land after logging in: Current page, Profile page, Activity page or Custom page. |
| Login Custom URL | empty | The address used when Login Redirect is Custom page. |
| Login description | empty | Text under the form. When empty, Reign shows “Don’t have an account? Register Now! it’s simple and you’ll enjoy all the benefits!” with a link to your registration page. |
Reign - Groups
Needs: BuddyPress with the User Groups component on.
Shows a grid of groups with the group picture, name, member count, last active time, a short description and the group admins.
| Field | Default | What it does |
|---|---|---|
| Title | Groups | Heading above the grid. |
| Max groups to show | 4 | How many groups appear. |
| No Of Columns | 2 | Columns on large screens. |
| Default groups to show | Active | Newest, Active, Popular or Alphabetical. |
| Display View All Button | Show | Show or Hide the View All button to the groups page. |
Reign - Groups Carousel
Needs: BuddyPress with the User Groups component on.
Shows groups as a slider of cards, each with a cover image, group picture and name. The title links to your groups page.
| Field | Default | What it does |
|---|---|---|
| Title | Groups Carousel | Heading above the slider. |
| Max groups to show | 4 | How many groups appear. |
| Default groups to show | Active | Newest, Active, Popular or Alphabetical. |
Reign - Members Carousel
Needs: BuddyPress.
Shows members as a slider of cards with a cover image, picture, online status and name.
| Field | Default | What it does |
|---|---|---|
| Title | Members | Heading above the slider. |
| Max members to show | 5 | How many members appear. |
| Default members to show | Active | Newest, Active or Popular. |
| Display Member Name | Show | Show or Hide each member’s name. |
Reign - Profile Completion
Needs: BuddyPress.
Shows a progress bar of how complete the logged-in member’s profile is. It shows only to logged-in members, and not while they view someone else’s profile.
| Field | Default | What it does |
|---|---|---|
| Title | Complete Your Profile | Heading above the bar. |
| Profile field sets | none ticked (all) | Tick the profile field groups that count toward progress. |
| Profile photos | none ticked (all available) | Tick Profile Photo and Cover Photo to count them. A photo type is listed only when members can upload it. |
| Hide widget once progress hits 100% | Off | Removes the widget when a member’s profile is complete. |
If you tick nothing, Reign counts every profile field group and every photo type that members can upload.
Shortcodes
Type a shortcode into a Shortcode block, or into any text area. Wrap values in quotes. Leave out an attribute to use its default.
For attributes marked “on or off” below, any text counts as on. To turn one
off, set it to 0, for example show_count="0".
bp_group_carousel
Needs: BuddyPress with the User Groups component on.
A slider of group cards with cover image, picture and name.
| Attribute | Default | Values |
|---|---|---|
| max_groups | 10 | A number. |
| group_sort | active | newest, active, popular or alphabetical. |
[bp_group_carousel max_groups="8" group_sort="popular"]bp_member_carousel
Needs: BuddyPress.
A slider of member cards with cover image, picture, online status and name.
| Attribute | Default | Values |
|---|---|---|
| max_members | 5 | A number. |
| member_sort | active | newest, active or popular. |
| member_name | show | show or hide. |
[bp_member_carousel max_members="10" member_sort="newest" member_name="hide"]reign_bp_user_menu
Needs: no plugin for the tag itself. It is built for community sites.
Shows a member’s avatar button when logged in. When logged out it shows a login icon, and a register icon if your site allows registration. It has no attributes.
[reign_bp_user_menu]reign_display_posts
Needs: no plugin.
Lists posts in the same card style as your blog archive. Pagination links appear under the list.
| Attribute | Default | Values |
|---|---|---|
| category | empty (all) | Category IDs, comma separated, such as 3,7. |
| posts_view | your blog list layout from the Customizer | default-view, wb-grid-view (Grid View) or masonry-view (Masonry View). |
| posts_per_page | the number in Settings > Reading | A number. |
| column_count | your Blogs Per Row setting (3) | A number of columns for grid and masonry. |
[reign_display_posts category="3,7" posts_view="wb-grid-view" posts_per_page="6" column_count="3"]reign_woo_product_layout
Needs: WooCommerce.
Shows products using one of Reign’s product card layouts.
| Attribute | Default | Values |
|---|---|---|
| layout | default | default, one, two, three or four. |
| limit | 8 | Number of products. |
| columns | 4 | Products per row. |
| category | empty (all) | A product category slug, such as shoes. |
[reign_woo_product_layout layout="two" limit="8" columns="4" category="shoes"]rg_woo_product_categories
Needs: WooCommerce.
Shows product category tiles, the same as the Reign - Product Categories
widget. The title attribute is accepted but the shortcode does not print it.
| Attribute | Default | Values |
|---|---|---|
| per_row | 3 | Tiles per row. |
| count | 6 | Total tiles. |
| show_parent_categories_only | off | on or off. |
| show_count | on | on or off. |
| enable_slider | off | on or off. |
| layout | layout-type-1 | layout-type-1 to layout-type-6. |
| selected_categories | empty (all) | Category IDs, comma separated. |
[rg_woo_product_categories per_row="4" count="8" layout="layout-type-5" show_count="0"]rg_woo_product_category_with_subcategory
Needs: WooCommerce.
Shows top-level product categories, each with a list of its subcategory links.
Categories without subcategories are skipped. The title attribute is
accepted but not printed, and layout only changes the tile styling class.
| Attribute | Default | Values |
|---|---|---|
| per_row | 3 | Tiles per row. |
| count | 6 | Total top-level categories. |
| subcat_count | 4 | Subcategory links shown per category. |
| enable_slider | off | on or off. |
| layout | layout-type-1 | layout-type-1 to layout-type-6. |
| selected_categories | empty (all) | Category IDs, comma separated. |
[rg_woo_product_category_with_subcategory count="6" subcat_count="5" per_row="3"]Widget areas
Widget areas are the places on your site where widgets can go. Find them in Appearance > Widgets. A widget area shows on your site only when it contains at least one widget.
Always available
| Widget area | Where it appears |
|---|---|
| Right Sidebar | The right column on any page whose layout has a right sidebar. This is the default sidebar for every content type. |
| Left Sidebar | The left column on any page whose layout has a left sidebar. |
| Footer Widget Area | The widget row in your site footer. |
You can choose a different widget area for a page, post type or search results. See Choose page layouts and sidebars.
WooCommerce
These exist when WooCommerce is active.
| Widget area | Where it appears |
|---|---|
| WooCommerce Right Sidebar | Right column on shop, product, cart, checkout and product category pages, unless you picked another sidebar. |
| WooCommerce Left Sidebar | Left column on those pages. |
| Off Canvas Sidebar | The filter panel that opens from the shop’s filter button. It exists only when Display Filter Button is on in the Customizer’s WooCommerce shop section. |
BuddyPress
These exist when BuddyPress is active and Youzify is not.
| Widget area | Where it appears |
|---|---|
| Groups Index | Sidebar on the groups directory. |
| Member Index | Sidebar on the members directory. |
| Activity Index | Sidebar on the activity directory. It is also used for the documents and media pages and the registration page when they show a sidebar. |
| Group Single | Sidebar inside a single group. |
| Member Profile | Sidebar on a member’s profile. |
Each directory sidebar shows only when its Customizer sidebar layout for that directory includes a right sidebar.
Shops and stores
| Widget area | Exists when | Where it appears |
|---|---|---|
| Single Store Sidebar | WC Vendors is active | Vendor store pages. |
| Download Archive Sidebar | Easy Digital Downloads is active | Download archive, download category and download tag pages. |
| Single Download Sidebar | Easy Digital Downloads is active | A single download page. |
| Product Left Sidebar | FluentCart is active | Left column on FluentCart pages. |
| Product Right Sidebar | FluentCart is active | Right column on FluentCart pages. |
Learning
These two exist when LearnDash is active and the LearnMate LearnDash add-on is not. Their names use your LearnDash labels. With the default labels they read LD Single Course Sidebar and LD Single Group Sidebar.
| Widget area | Where it appears |
|---|---|
| LD Single Course Sidebar | A single LearnDash course page. |
| LD Single Group Sidebar | A single LearnDash group page. |
Header
| Widget area | Exists when | Where it appears |
|---|---|---|
| Header Widget Area | PeepSo is active | The logged-in member area of the header and the mobile header. Reign adds the PeepSo user bar widget here for notification icons. |
Widget areas not listed here come from other plugins or add-ons, not from the Reign theme.
Page template: PeepSo Layout
When you edit a page, open Page settings and choose Template. One of the choices is PeepSo Layout. It shows the page content inside Reign’s standard content area and handles the PeepSo header position for PeepSo profile and group pages.
Reign’s PeepSo setup assigns this template to the PeepSo profile and groups pages. If PeepSo is not active, Reign hides PeepSo Layout from the template list, because the template shows no page content without PeepSo.