Skip to main content

How to Install

scriptstribe_f05eaf0bb9aa66e1fe04c17e4ca5a5b9.png

The Achievements and Rewards Module is an exciting addition to your Sngine-powered community, designed to incentivize engagement and recognize user contributions. This module allows you to set up customizable badges and rewards that users can earn as they participate in your community, adding a gamification layer that encourages continued activity and loyalty.

Key Installation Steps:

  1. Administrative Access:
    Ensure you are logged in as an administrator. Only users with administrative privileges can install or update system modules.

  2. Environment Setup:
    The module integrates seamlessly with Sngine by using the platform's bootloader. This ensures that all system configurations, including the database connection, are loaded before the installation process begins.

  3. Database Schema Creation and Update:
    The installation script creates the required database tables—typically badges and users_badges—if they don't already exist. If these tables are already in place, the script can update them to match the latest schema requirements. It also populates these tables with sample data, ensuring you have a working baseline to test and further customize the module.

  4. Error Handling and Confirmation:
    The installation script includes mechanisms to handle common issues, such as duplicate entries or foreign key conflicts. Upon successful installation, you'll receive a clear confirmation message; if any errors occur, detailed error messages will be displayed for troubleshooting.

  5. Customization and Integration:
    After installation, you can further customize the badges, rewards, and their associated criteria according to your community's needs. This module integrates naturally into the Sngine framework, making it straightforward to extend or modify functionalities as your platform grows.

By following these steps, you can quickly set up the Achievements and Rewards Module and start rewarding your community members for their engagement. Whether you’re looking to boost user interaction or celebrate milestones, this module offers a robust solution tailored for Sngine communities. So let's get started.

Step 1: Upload Files and install database tables

Download your zip folder and upload it to your root directory and visit yousite.com/install-badge.php

Click on Install/Update Module once you finish the install, delete or rename install-badge.php

badgefiles.PNG

Step 2: Edit Files 

Open .htaccess file a and add 

# Achivements and Rewards Module for Sngine
RewriteRule ^leaderboard/?$ modules/badges/index.php [L,QSA]
RewriteRule ^rewards/?$ modules/badges/rewards.php [L,QSA]
RewriteRule ^mybadges/?$ modules/badges/mybadges.php [L,QSA]
RewriteRule ^gifts/?$ modules/badges/gifts.php [L,QSA]
RewriteRule ^addgifts/?$ modules/badges/addgifts.php [L,QSA]

# Achivements and Rewards Module for Sngine ADMIN
RewriteRule ^leaderboard/admin/?$ modules/badges/admin.php [L,QSA]

Now open 

content/themes/youTheme/templates/profile.tpl and add this code whereever you want to display the badges block inthe user profile, I have it above basic info

{include file="badges/user_badges.tpl" user_id=$profile_user.user_id}

profileblock.jpg

Open content/themes/youTheme/templates/user_menu.tpl  and look for 

{if $user->_is_admin}

and before that add 

 <a class="dropdown-item" href="{$system['system_url']}/leaderboard">
      {include file='__svg_icons.tpl' icon="trophy" class="mr10" width="20px" height="20px"}
      {__("Leaderboard")}
    </a>
	 <a class="dropdown-item" href="{$system['system_url']}/mybadges">
      {include file='__svg_icons.tpl' icon="trophy" class="mr10" width="20px" height="20px"}
      {__("My Badges")}
    </a>

Look for 

{if $user->_is_admin}

and after that add 

    <div class="dropdown-divider"></div>
	 <a class="dropdown-item" href="{$system['system_url']}/leaderboard/admin">
      {include file='__svg_icons.tpl' icon="badge" class="mr10" width="20px" height="20px"}
      {__("Badges Admin")}
    </a>

Step 3: Change default settings

I left some default settings go give you an idea of what to do, this addon is very simple, you will understand when you play with the admin area. 

Visit yoursite.com/leaderboard/admin to change this settings

PS: I created my own admin area to avoid touching the core files much.

when adding images url upload you images or new badges to /content/uploads/badges folder

it's 3:57 AM and i am creating this so if I forgot anything, talk to me in the chat at https://scriptstribe.com

In the next few days I will be working on  make this look nice on elengine and Xngine theme and once I am done I will update the download file, in the mean while, if you want to do it yourself or wait is up to you. Remember! custom themes is not part of the job but I am willing to do this to help.  

You are done, now go play around

Thank you for your order

emot.png


Back to top