Valhalla for Vikinger

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 or newer. 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.

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).
• 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).

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 and the valhfovi_can_interact filter.

Valhalla Pro

The optional Valhalla Pro add-on adds more modules for growing communities: polls in the activity feed, clickable hashtags with hashtag pages and trending tags, 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, GamiPress leaderboards and credit transfers, 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.

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).