Valhalla for Vikinger

By valhallaplugins

0+ active installationsVersion 1.0.5

Community essentials for the Vikinger theme: reports and a moderation queue, member blocking, announcements and layout tweaks.

Description

Valhalla for Vikinger adds everyday community tools to sites built with the Vikinger BuddyPress + GamiPress theme, without editing a single theme file.

Valhalla is built for the Vikinger theme. Vikinger is a premium theme by Odin Design, sold separately through their OrokuBlocks store: get the Vikinger theme. Features that work on the theme itself, such as Layout Tweaks, need Vikinger as the active parent theme. Moderation and Member Blocking need BuddyPress, and their buttons attach to Vikinger’s activity, comment and profile layout. Announcements work with any theme.

Valhalla is an independent add-on. It is not affiliated with, endorsed by or sponsored by Odin Design. Vikinger is a trademark of its owner.

Requirements

  • Vikinger theme as the active parent theme (a child theme is fine), tested with 2.0 up to 2.0.2. The theme folder can be named vikinger or vikinger-premium. Sold separately by Odin Design; Valhalla does not include it.
  • WordPress 6.2 or newer.
  • PHP 8.2 or newer.
  • BuddyPress for moderation and member blocking.
  • Optional: GamiPress, bbPress (forum reports), VKReact BuddyPress (reaction controls) and Better Messages. Features that need them stay inactive without them.

Everything is designed to look and feel native: Valhalla reuses Vikinger’s own template parts, widget boxes, buttons, forms, hexagon/circle/square avatars, dropdowns and color variables, so it follows your color preset and dark mode automatically. Its features are added to Vikinger’s activity stream, comments and profile header through a lightweight front-end layer that survives the theme’s re-renders.

Valhalla is organized in four modules. Each one can be switched on or off from Valhalla → Dashboard, has its own settings page under Valhalla → Settings, and stays inactive (without errors) when a plugin it needs is missing. All features described here are free: nothing in this plugin needs a license, and there are no trial limits or external requests.

Looking for polls, hashtags or leaderboards? They are not part of this free plugin. They come with the separate, paid Valhalla Pro add-on (see Valhalla Pro below).

Moderation

  • Report buttons for activity posts, activity comments, members, groups, forum topics and replies and blog comments, with configurable reasons, optional details and rate limiting.
  • Moderation queue (Valhalla → Moderation, with a menu badge): view, dismiss or resolve reports, hide and unhide content manually, or delete it.
  • Moderation log of every moderator action.
  • Moderator notifications – moderators get a BuddyPress notification for each new report.
  • Moderator role support – anyone with the valhfovi_moderate capability (administrators and editors by default) can work in the queue without full admin rights.

Member Blocking

  • Block members from their profile header or any activity menu. Blocking works both ways: posts, comments and directory entries disappear, private messages, friend requests and @mentions are stopped, and a blocked member sees an “unavailable” notice on the blocker’s profile.
  • Privacy & Blocking page in the Account Hub listing blocked members with an unblock button.
  • Administrators and moderators can never be blocked.

Announcements

  • Announcement bars with message, color style, button, scheduling, audience targeting (everyone, members, guests, roles), dismissal memory, pinning and placement (top bar, floating card or lists only). Cache friendly.
  • [valhfovi_announcements] shortcode listing active announcements as Vikinger widget boxes.

Layout Tweaks & Menu Icons

  • Layout tweaks – hide page banners, the header search, the header rank bar / point balances or the avatar rank ring; compact activity stream; sticky sidebars; text size 100–125 %.
  • Theme defaults – default side-menu state, default grid type of member / group / post lists and the timestamp format of activities and comments (relative, absolute or hybrid).
  • Newsfeed controls – hide chosen activity types from the main newsfeed (for example “joined a group”, new friendships or changed profile photos) and keep group posts out of it. Member profiles, group pages and single posts still show everything, and nothing is deleted.
  • Share links on posts – “Share link” in the menu of every post that logged-out visitors can see opens a small window with Copy link and share links for X, Facebook, WhatsApp, Reddit, LinkedIn and e-mail. It is never offered for private posts, posts in private or hidden groups or forums, hidden or moderated posts, or a members-only community. On by default; pick the networks or switch it off in the settings.
  • Reaction controls – choose which reactions are available (enforced on the server) and optionally hide existing reactions of disabled types.
  • Menu icon picker – pick any Vikinger sprite icon for your menu items, plus a searchable Icons reference page.
  • Registration fix – Vikinger’s registration page lacks BuddyPress’s “I agree to the Privacy Policy” checkbox, so once your site has a published Privacy Policy page every sign-up fails without a message. Valhalla adds the checkbox and its error message (on by default, only when BuddyPress asks for it).
  • E-mail display name fix – when a member’s display name is an e-mail address, everyone could read it next to their posts, comments and member card. Valhalla shows the member’s nickname, first and last name or username there instead, and new accounts no longer get an e-mail address as display name (on by default). Usernames, @mention names and profile addresses are not changed.

Dashboard & Tools

  • Module dashboard – search the modules (press /), filter them by category and switch them on or off instantly. Each card shows whether the module is running, what it needs and why it cannot start.
  • Getting started checklist with the first steps for a new site (choose modules, set report reasons, publish an announcement). Each administrator can mark steps done or hide the checklist.
  • Settings screens – a settings navigation with a filter, settings grouped in cards, a save bar that warns about unsaved changes, and Reset to defaults per module.
  • Export and import settings as a JSON file to copy your setup to another site. An import shows exactly what will change before anything is saved; secret values that add-ons keep, such as API keys, are never exported.
  • System information for support requests (versions, theme, required plugins, scheduled tasks) with a one-click copy button.

Built for developers too

  • Extensible module system (valhfovi_modules filter, valhfovi_module_can_boot / valhfovi_module_blocked_reason / valhfovi_module_held_ui filters), secure AJAX wrapper with nonces, capability checks and rate limiting, BuddyPress notification helpers, profile tab and Account Hub page helpers, template overrides from your child theme (valhalla/<module>/<template>.php).
  • A documented front-end JavaScript API (window.VALHFOVI) to add items to activity menus, comment actions, profile header buttons and group header buttons, plus modals, forms with validation, toasts and confirm dialogs that look native.
  • A small accessible UI kit for add-ons: loading states, skeleton placeholders, empty states, tooltips, dropdowns, character counters and screen-reader announcements. It follows the Vikinger color preset, dark mode and the reduced-motion setting.
  • Cross-module events such as valhfovi_report_created, valhfovi_report_resolved, valhfovi_user_blocked, valhfovi_reaction_added / valhfovi_reaction_removed (a member adds, changes or removes a reaction) and the valhfovi_can_interact filter; valhfovi_share_enabled decides per post whether share links are offered, and valhfovi_vikinger_theme_slugs adds more theme folder names.

Valhalla Pro

The optional, paid Valhalla Pro add-on from valhallawp.com adds more modules for growing communities: polls in the activity feed, clickable hashtags with hashtag pages and trending tags, GamiPress leaderboards and credit transfers, a chat sidebar with friends online, recent chats and quick replies, link preview cards, a GIF picker for posts and comments, Moderation Pro (auto-hide, word filter, suspensions and warnings, front-end moderator tools), privacy controls, follows, profile visitors and who’s online, members-only mode and registration protection, custom profile tabs and broadcasts. Everything listed above stays free.

Privacy

Valhalla for Vikinger does not send any data to external services, does not track you or your members and does not load scripts, styles or fonts from third-party servers. The data it stores (reports, blocks, logs, announcement dismissals and settings) stays in your WordPress database. Dismissed announcements are also remembered in the visitor’s browser (a cookie and local storage). Neither leaves your site. Share links are plain links to the networks: nothing is loaded from them, and nothing is sent to them unless a visitor clicks one.

Credits

The Valhalla admin screens use two fonts, both bundled in assets/fonts/ with their license files:

  • Russo One: Copyright (c) 2011-2012, Jovanny Lemonad, with Reserved Font Name “Russo”. Licensed under the SIL Open Font License 1.1 (OFL-russo-one.txt).
  • Inter: Copyright 2016 The Inter Project Authors. Licensed under the SIL Open Font License 1.1 (OFL-inter.txt).

They are only loaded on Valhalla’s own admin screens, never on your community’s front end.

The Valhalla logo and the artwork in assets/img/ (including assets/img/ui/) are © Valhalla and are distributed with the plugin under the same license as the plugin (GPLv2 or later).

Installation

  1. Make sure Vikinger (sold separately) is your active parent theme (a child theme is fine), that your server runs PHP 8.2 or newer and that BuddyPress is active (moderation and blocking need it). bbPress, VKReact BuddyPress and Better Messages are optional: the features that need them simply stay inactive without them.
  2. Install the plugin from Plugins → Add New, or upload the valhalla-for-vikinger folder to /wp-content/plugins/.
  3. Activate the plugin. Database tables are created automatically.
  4. Open Valhalla → Dashboard, review the modules (all are enabled by default and start when their requirements are met) and adjust each module under Valhalla → Settings. The Getting started checklist on the dashboard walks you through the first steps.
  5. Optional: give trusted members the valhfovi_moderate capability (administrators and editors have it already) so they can work in the moderation queue.

FAQ

Does Valhalla modify the Vikinger theme?

No. Everything is done through WordPress, BuddyPress and Vikinger hooks and a small front-end layer. You can update the theme as usual.

Will it work with another theme?

Only in part. Valhalla is built for the Vikinger theme (by Odin Design, sold separately through their OrokuBlocks store: get the Vikinger theme). Features that work on the theme itself, such as Layout Tweaks, need Vikinger as the active parent theme. Moderation and Member Blocking need BuddyPress, and their buttons attach to Vikinger’s activity, comment and profile layout. Announcements work with any theme.

Where are polls, hashtags and leaderboards?

In Valhalla Pro, the separate paid add-on. Polls, hashtags with trending tags, GamiPress leaderboards and the chat sidebar are Pro modules. Everything this plugin’s Description lists as its own features is free.

Which PHP version do I need?

PHP 8.2 or newer. On an older PHP version the plugin does not load and shows a notice to administrators instead, so your site keeps working.

Which plugins are required?

BuddyPress, for moderation and member blocking. bbPress (forum reports), VKReact BuddyPress (reaction controls) and Better Messages are optional.

Does the free version need a license or contact any server?

No. The plugin is fully functional on its own and makes no external requests. Nothing in it needs a license. If you add the separate Valhalla Pro add-on, the dashboard also shows that add-on’s license status.

Where do I get help?

In this plugin’s support forum on WordPress.org. The Support links on the Valhalla screens and on the Plugins screen open it. With Valhalla Pro active they open Valhalla support instead, and once a Pro license key is saved, your support tickets in your store account.

Does it support dark mode and color presets?

Yes. All styles use the Vikinger color variables, so every preset and the light/dark switch are followed automatically.

My own icon image stays blank

Single-colour icon images are drawn with a CSS mask, and browsers only load a mask image from another domain when that domain allows cross-origin requests (CORS). If your media is served from a CDN or offloaded storage (for example Amazon S3 / CloudFront) without an Access-Control-Allow-Origin header, either tick Keep original colours for that image or enable CORS for your site on the media domain. The image picker shows a note when an image comes from another domain.

Can moderators work without being administrators?

Yes. Users with the valhfovi_moderate capability see the Valhalla menu with only the moderation tools.

How do I override a template?

Copy the file from wp-content/plugins/valhalla-for-vikinger/modules/<module>/templates/ to wp-content/themes/<your-child-theme>/valhalla/<module>/ and edit it there.

Can I copy my settings to another site?

Yes. Open Valhalla → Tools, download the export file and import it on the other site from the same screen. You see every change before it is saved. Secret values that add-ons keep, such as API keys, are not part of the file.

Is my data removed when I delete the plugin?

Only if you enable Delete data on uninstall under Valhalla → Settings → General. Then all Valhalla tables, settings, transients, scheduled tasks, notifications, user meta, activity meta and post meta (such as menu item icons) are removed when the plugin is deleted, including the data of Valhalla Pro modules. On a multisite network each site follows its own setting; user meta, BuddyPress activity meta and notifications, which all sites share, are only removed when no site keeps its data.

New members cannot register since I published a Privacy Policy page

BuddyPress then requires every new member to tick “I have read and agree to this site’s Privacy Policy”, but Vikinger’s registration page does not show that checkbox or its error, so the form just comes back. Keep Valhalla → Settings → Layout Tweaks & Menu Icons → Registration privacy-policy checkbox fix switched on (the default): the checkbox and the error message appear above the “Complete Sign Up” button.

Does Valhalla slow my site down?

Modules only load what they need, results are cached per request or in transients, and scheduled clean-ups run through two shared cron events (hourly and daily).

Screenshots

Changelog

1.0.5

  • New: newsfeed controls in Layout Tweaks. Hide chosen activity types from the main newsfeed, such as “joined a group”, new friendships or changed profile photos, and keep group posts out of it. Profiles, group pages and single posts still show everything.
  • New: share links on posts. “Share link” in a post’s menu opens Copy link and links to X, Facebook, WhatsApp, Reddit, LinkedIn and e-mail. Only for posts that logged-out visitors can see. On by default: pick the networks or switch it off in Layout Tweaks.
  • New: a privacy fix for display names that are e-mail addresses. Such a name now shows as the member’s nickname, name or username, also in the browser tab title of their author page, and new accounts no longer get one. On by default. Usernames and profile addresses stay as they are.
  • Improved: tested with Vikinger 2.0.2.
  • Improved: sharper artwork on Valhalla’s screens. Icons stay crisp on high-resolution screens and line up with their headings, the page background is now a vector drawing that stays sharp at every screen size, high-resolution screens included, and the other backgrounds are no longer stretched on wide screens.
  • Improved: the Valhalla item in the WordPress admin menu now shows the Valhalla crest, and takes the colours of your admin colour scheme like the other menu icons.
  • Improved: when you close a window opened from a post’s menu, such as Report or Share link, the keyboard focus goes back to that post or its menu button, so keyboard users keep their place.
  • Improved: faster member lists when blocking or privacy rules are in use, for example in the Account Hub and in Valhalla Pro’s lists.
  • Improved: add-ons such as Valhalla Pro now hear when members add, change or remove a reaction, so reaction rewards work with this plugin.
  • Changed: Support links now open this plugin’s support forum on WordPress.org. With Valhalla Pro active, they open Valhalla support instead.
  • Fixed: Valhalla now recognises Vikinger in a theme folder named vikinger-premium, and child themes of it. Before, Layout Tweaks and the other theme features stayed off there.
  • Fixed: icon names on the Icons page no longer break in the middle of a word.
  • Fixed: “What’s new” and “Changelog” now show this plugin’s own changes.
  • Fixed: after a Vikinger update, the icon previews on Valhalla’s screens show the new theme icons straight away.
  • Fixed: X icons are now black, X’s own colour, instead of Twitter’s old light blue: on profiles, groups, the footer and in the Share link window.

1.0.4

  • Changed: the Custom CSS box is gone from Layout Tweaks. CSS you saved there moves to Appearance > Customize > Additional CSS by itself, so your site keeps its look.
  • Changed: Valhalla stores its data under new internal names. The move runs by itself the first time the site loads after this update and only goes one way, so back up first if you may want to return to 1.0.3.
  • Changed: custom code and child themes that call Valhalla functions or hooks starting with vhl_ need updating to valhfovi_. The announcements shortcode is now [valhfovi_announcements]. Pages, posts and widgets are updated for you; change it by hand in page builders.
  • Changed: “Upgrade to Pro” now opens in the same tab, and the Pro card you can hide is the only Pro area on the dashboard.
  • Changed: importing settings from a file now needs a .json file, as made by Export.
  • Improved: stricter checks on everything that saves data or prints it, across the whole plugin.
  • Fixed: the Filter button on the Moderation screen now only filters. It no longer runs a bulk action you had picked.

1.0.3

  • New: use your own images as icons for menu items and for the header icons (cart, friend requests, messages, notifications, light/dark switch and settings).
  • New: a brand-new look for every Valhalla screen, with the new Valhalla logo.
  • Improved: on phones, Settings opens straight on the module you are editing.
  • Improved: Valhalla screens are easier to use with a keyboard or a screen reader.
  • Fixed: the bbPress “Report” link now sits in line with Edit and Reply.
  • Fixed: menu icons no longer show on the wrong item when two menus link to the same page.
  • Fixed: announcement bar text is easy to read in every colour.
  • Fixed: a Valhalla Pro screen opened without an active license shows a clear message with a link to the license page, instead of a “not allowed” error.

1.0.2

  • New: Valhalla now sits right under Dashboard in the admin menu.
  • New: quick links to Settings, Docs and Support on the Plugins screen and on every Valhalla screen.
  • New: without Valhalla Pro, the Valhalla menu has an “Upgrade to Pro” link, and you can hide the Pro card on the dashboard.
  • Improved: a fresh look for every Valhalla screen, which now works better on phones, on tablets and in right-to-left languages.
  • Changed: needs WordPress 6.2 or newer.

1.0.1

  • Improved: if you use Valhalla Pro, its modules clearly show when they need a license, and your settings are always kept. Everything in this free plugin stays free.
  • Fixed: the Docs button now opens the documentation.
  • Fixed: wide tables no longer stretch the screen on phones.

1.0.0

  • First release.