Vikinger - BuddyPress and GamiPress Social Community

Contents

1. I changed the name of a BuddyPress profile field or group and now its not displaying on the site

2. I'm having issues installing the theme / theme doesn't work

3. Can I customize all pages with Elementor?

4. Images/elements seem out of place/broken or theme functionality is not working as expected

5. Can users upload blog posts from the front end?

6. Where can users register?

7. Can i change GamiPress badges, quests, ranks names or create new ones?

8. Can I change the order of the members profile tabs?

9. How can i change the theme font?

10. How can I add new SVG icons?

11. Can I change the page that users are redirected to after they login?

12. Can I change the avatars from hexagons to circles/squares?

13. Why are all the quests images the same?

14. Can I hide the footer?

15. Can I remove the section headers?

16. Disable WooCommerce "Lost Password" page and use WordPress default

17. Where can I find the folders and illustrations mentioned in the documentation?

18. Can I change the default user avatars and covers?

19. Can I order/change the positions of the forums?

20. Where are all images and videos saved?

21. Having issues while Installing / Importing demo

22. I can't post a BuddyPress activity with images or video

23. Can I remove the WordPress bar at the top?

24. How do I create Groups?

25. BuddyPress is not sending emails with activation code to users after they register to the site

26. Can I remove the blog tab of the members profile?

27. Where are the color presets stored?

28. How can I customize the Login page?

29. Can I hide the side menu?

1. I changed the name of a BuddyPress profile field or group and now its not displaying on the site

The theme uses the BuddyPress xProfile groups and fields to allow site members to enter information about themselves, like bio, personal, interests, social links and account information.


To be able to show each xProfile field group and its respective fields in different settings pages and widgets in the members profiles, the theme has to query them by their name.

This creates problems if users need to edit group or field names for translations purposes, as the theme won't be able to find and display the group or field information if the name is not the one it is expecting.To solve this and allow users to translate them, we have included a new customizer section with this update ("Vikinger Settings" -> "xProfile Groups / Fields").

To understand how to edit the profile groups and fields for translation purposes, we need to detail how the theme uses the group names.

xProfile group names consist of a prefix part (i.e. "Profile") followed by an underscore (_) followed by the subgroup name ("Bio"): "Profile_Bio".

The prefix part (in this example "Profile") is used to identify on which settings page the group and all its fields will be displayed in, to allow members to edit their information:

The prefix part of the xProfile group names shouldn't be changed, otherwise the sub groups and fields won't display correctly in the settings pages.

The subgroup name part (in this example "Bio") is used to identify on which member profile page widget the subgroup fields are going to be displayed in (in this case, the "About Me" widget).

This subgroup in particular also has a special case with its "About" xprofile field, which is displayed differently from the other fields (text only at the top of the widget after the title).

With this update, users can now edit all subgroup names from the backend "Users" -> "Profile Fields" page to translate them and then enter that same name on the respective customizer "Vikinger Settings" -> "xProfile Groups / Fields" option.

This allows the theme to query the subgroup using the new name and display the information correctly on each widget.

As we mentioned before, the "Profile_Bio" "About" field is a special case and if changed, its new name has to be entered in the customizer.

Any other xProfile field names can be changed and will display correctly without the need to enter their new names in the customizer.

To summarize:

2. I'm having issues installing the theme / theme doesn't work

If you haven't done much yet, we recommend you to do a clean install to start again to make sure that the things you've done don't interfere with the setup.

For a successful install and setup process, please follow the instructions that are available in the theme documentation (https://odindesignthemes.com/vikinger-theme-docs/) inside "Getting Started" -> "How to Install" and "Theme Setup".

After completing the install and setup process and verifying that everything is working correctly, you can either use the "Demo Import" functionality to import demo content or create the content manually by following the documentation tutorials and videos.

3. Can I customize all pages with Elementor?

No, you can only use Elementor to edit pages created with Elementor (like the landing page) or create new pages. This is mainly due to, for example, plugins like BuddyPress, or GamiPress, don't allow for Elementor customization.

4. Images/elements seem out of place/broken or theme functionality is not working as expected

First, please ensure that you have completed all steps of the theme setup process as failing to complete a step can cause styling issues to appear on the site.

Sometimes, there can be third party plugins that are conflicting with the theme styling and functionality.

Deactivate any additional plugins you have installed (plugins that are not included in the theme setup or reported compatible with it) one by one to identify which plugin is causing the styling or functionality problems (You may need to clear your browser cache after deactivating certain plugins).

5. Can users upload blog posts from the front end?

Sorry, but it's not possible at the moment, the WordPress blog feature works from the backend and they have an already really powerful editor with lots of blocks and features (and constantly getting updates).

If you don't want to grant access to the complete backend features to someone, remember that you also have the option to give users the role of "Editor", "Author", or "Contributor" https://wordpress.org/support/article/roles-and-capabilities/ which allows them to write blog posts from the backend but "locks" some of the other features.

Please remember that we haven't tested any front end submission plugins with the theme (they aren't supported), so they may require additional coding in order to fully integrate them.

6. Where can users register?

The theme uses the WordPress or BuddyPress (if the plugin is installed and active) default register pages.

Please, make sure that the WordPress option for anyone to register is enabled. 

You can find it inside Settings -> General -> "Membership: Anyone can Register".

7. Can i change GamiPress badges, quests, ranks names or create new ones?

1) Renaming existing achievement and rank types:

You can change / translate the names throughout the site but it's very important that you don't change the information (name, slug, etc) that is assigned to them in the GamiPress -> "Achievement Types" and "Rank Types" backend pages as this information is used to display them on several pages and widgets throughout the site.

Changing this information will cause several theme widgets and pages to not display information about the corresponding badges, quests or ranks.

If you want to rename the URL of the pages, you have to rename the slug of the respective WordPress Page that is used to display them (if you are using the theme demo import, the pages will be named "Badges", "Quests" and "Ranks" and have the "Badges Page", "Quests Page" and "Ranks Page" Template assigned to them).

All other mentions of the Badges, Quests and Ranks in the theme can be renamed by translating the theme.

2) Creating new achievement and rank types: 

You can create new achievement and rank types but the theme won't recognize them so they won't be displayed or used anywhere on the site.


Check the documentation "GamiPress" section for more information on how this works and for video tutorials on how to create each achievement type, rank type and point type.



8. Can I change the order of the members profile tabs?

Yes, just go to "Customizer" -> "Vikinger Settings" -> "Members" and change the numbers to order them in the way you want.

9. How can i change the theme font?

You can change the theme font (Google Fonts) by using the Customizer options:

You can get your Google Fonts API Key here

After entering your API Key in the Customizer "Google Fonts - API KEY" field, click on "Publish", close and open the customizer again in order for the fonts to load in the "Primary" and "Secondary" fields.

10. How can I add new SVG icons?

1) To add new icons you need to create:

a) A new script file that includes the SVG code and include it in your theme "functions.php" (we recommend using the child theme as to not lose changes after a theme update).

You can use the theme script as an example, you will find it in the "vikinger/js/source/utils/svg-loader.js" file. You can copy it and replace the svgData constant value with the SVG icons you want to include.

Your SVG icons need to follow the same naming structure as existing ones, i.e:

<!-- SVG CUSTOM -->
<svg style="display: none;">
  <symbol id="svg-custom" viewBox="0 0 yourviewboxvalue yourviewboxvalue" preserveAspectRatio="xMinYMin meet">
    // your svg content
  </symbol>
</svg>
<!-- /SVG CUSTOM -->    

b) Create styles for your icons and add them to the style.css or add a new stylesheet and include it in the "functions.php" file, they must also follow the naming structure:

.icon-custom {
  // your icon styles
}    

c) You can then use the part after the icon-* name to use that icon in the theme. In this case, you can use "custom" to assign this icon to a menu item.

The "vikinger/style.css" file contains all theme styles that are not related to third-party plugins, you will find the .icon-* CSS declarations in that file.

11. Can I change the page that users are redirected to after they login?

Yes! You have that option inside the customizer.

Just go to Vikinger Settings -> Login - Register -> Login - Redirect Page.

12. Can I change the avatars from hexagons to circles/squares?

Yes! You can change the shape of the avatars, just go to "Customizer" -> "Vikinger Settings" -> "Avatar" and choose the one you like the most.

13. Why are all the quests images the same?

What you’re seeing isn’t and issue! They are shown like that because the quests aren’t unlocked yet (the icon means locked or “open” quest)! 

Once users earn them, they will be shown the colored token, this way people are encouraged to finish the quests to “unlock” the tokens!. What you see in the live preview is an example of some of the tokens locked, and others unlocked.

14. Can I hide the footer?

Yes! You have that option inside the customizer.

Just go to Vikinger Settings -> Footer.

15. Can I remove the section headers?

Yes! You can do it inside the WordPress Customizer.

Just go to Vikinger "Settings" -> "Page Headers", and choose "Hide"

16. Disable WooCommerce "Lost Password" page and use WordPress default

To remove the page that WooCommerce adds for "Lost Password", you need to remove the respective endpoint setting found in the WooCommerce backend options:

WooCommerce > Settings > Advanced > Account endpoints, delete lost-password from the Lost Password option input and save changes.

17. Where can I find the folders and illustrations mentioned in the documentation?

Please be sure that when you go to your downloads page, you not only download the installable WordPress file, but also the main files.

Many things, like the demo imports and illustration files are inside that main zip file so be sure to download it and check it out.

18. Can I change the default user avatars and covers?

Yes! You have that option inside the customizer.

Just go to Vikinger Settings -> Members and Vikinger Settings -> Groups.

19. Can I order/change the positions of the forums?

Yes, the forum positions are managed from the backend. You have to number them in the order that you want them to be shown (1, 2, 3…), check this screen:

20. Where are all images and videos saved?

Videos (and images) uploaded by users are saved in your WordPress install "uploads" directory (wp-content/uploads/vikinger).

21. Having issues while Installing / Importing demo

If you haven’t done much yet, we recommend you to do a clean install to start again to make sure that the things you’ve done don’t interfere with the setup (be sure to install the latest version of the theme!)

After that you first have to install and setup the theme you can do it following the docs: https://odindesignthemes.com/vikinger-theme-docs/ inside “Getting Started” – “How to Install” “Theme Setup” (this is an important step as you need to correctly customize the BuddyPress setting to make sure everything works OK). After that, check this video https://www.youtube.com/watch?v=SXEgduXEupk to import the demo content

Doing this things in order is very important for the process as failing to correctly setup BuddyPress may lead to errors or styling issues. If you install the latest version, you can see all steps in the “Getting Started” tab where you can find this and more helpful guides.

Also, we really recommend you checking the docs https://odindesignthemes.com/vikinger-theme-docs/ where you can find all the info about customization (we recommend the section – Theme Customization – Customizer Overview to see what you can do with the customizer) and the video guides https://www.youtube.com/playlist?list=PLdR1KxGpPfLWZ1Yq0_mNlYCtj8TLfX9CK

22. I can't post a BuddyPress activity with images or video

Please check your WordPress site health page (WordPress backend panel -> Tools -> Site Health), the most common cause of being unable to make an activity post with media (images or video) is due to having an outdated MariaDB database.

If you have an outdated MariaDB version installed, please update it to the latest version, and then uninstall and reinstall the "Vikinger Media" plugin, if the plugin is installed successfully, the "yourprefix_vkmedia_media" table will be created and available in your WordPress database.

23. Can I remove the WordPress bar at the top?

Users can individually remove the toolbar by going to the WordPress admin, Users -> Profile and unchecking the Toolbar option.

BuddyPress adds the toolbar for logged out users too, you can change this by going to Settings -> BuddyPress -> Options tab.

24. How do I create Groups?

Groups must be created from the frontend.

We created a system so users can easily create and manage groups. Just go to your front-end settings menu (the cog wheel icon at the top right) and click on "Manage Groups".

There you'll be able to create them, change settings, promote users and more!.

25. BuddyPress is not sending emails with activation code to users after they register to the site

Please check that your WordPress email configuration is correctly setup and if emails are being sent for other actions.

If you are using an email plugin (i.e.: https://wordpress.org/plugins/wp-mail-smtp/), please check if this works for you: https://wordpress.org/support/topic/activation-emails-from-forums-not-sent/.

Otherwise, please contact the BuddyPress support team (https://buddypress.org/support/) as they will be able to assist you further with this: https://buddypress.org/support/search/activation+email/

26. Can I remove the blog tab of the members profile?

Yes, just go to "Customizer" -> "Vikinger Settings" -> "Members" and you can disable it.

27. Where are the color presets stored?

Color presets are stored as options in your WordPress install database (“yourprefix_options” table), you can find each preset name in the “vikinger/includes/customizer/vikinger-customizer-utils.php” file, “vikinger_customizer_color_preset_setting_name_get” function on line 1152.

28. How can I customize the Login page?

The theme uses the default WordPress login and forgot password pages, we include several options in the "Customizer" like text and background customization.

For further customization, please check the WordPress docs on how to edit these pages:

https://codex.wordpress.org/Customizing_the_Login_Form

https://codex.wordpress.org/Customizing_the_Login_Form#Styling_Your_Login

29. Can I hide the side menu?

Yes! You have that option inside the customizer.

Just go to Vikinger Settings -> Side Menu.