🐞 BugTrack Sngine Add-On Installation Guide

Jane Marcia

Admin

Joined: 2025-05-17 02:14:16

2025-05-21 22:57:04

Make sure that when you add to the htaccess you add little more to the star of it. Not at the end. This fixed the issue for many users.

Ai Generator Generator

Member

Joined: 2025-05-24 18:58:15

2025-05-28 18:48:47

Let your users report bugs and get rewarded with points! Here's how to install the BugTrack add-on for Sngine:

1. 📁 Upload the Addon Files

Place the files exactly like this:

/modules/
  └── bugtrack/
      ├── bugtrack.php
      ├── view.php
      ├── admin.php
      ├── installer.php
      ├── init.php
      ├── bugtrack_hooks.php

/content/themes/default/templates/bugtrack/
  ├── index.tpl
  ├── view.tpl
  ├── admin.tpl
  ├── sidebar.tpl
  ├── leaderboard.tpl
  ├── installer.tpl

2. ⚙️ Update Your `.htaccess` File

Add these lines to your root .htaccess file to enable clean URLs:

# Bugtrack URLs
RewriteRule ^bugtrack/view/([0-9]+)$ modules/bugtrack/view.php?id=$1 [L,QSA]
RewriteRule ^bugtrack/?$ modules/bugtrack/bugtrack.php [L,QSA]
RewriteRule ^bugtrack/admin?$ modules/bugtrack/admin.php [L,QSA]
RewriteRule ^bugtrack/installer?$ modules/bugtrack/installer.php [L,QSA]

3. 🛠️ Run the Installer

Go to:

https://yoursite.com/bugtrack

Click the Install Bug Tracker Table button. This will:

Install the bug_reports table
Install the bugtrack_settings table
Insert demo bug reports

4. 🔧 Admin Configuration

Visit the admin panel at:

https://yoursite.com/bugtrack/admin

From there, you can:

Update bug statuses (open, in-progress, fixed)
Write admin notes on bug reports
Set how many points users get per report

5. 👤 Add Link to User Menu

Edit this file:

content/themes/default/templates/_usermenu.tpl

Add this snippet:

<a class="dropdown-item" href="{$system['system_url']}/bugtrack">
  {include file='__svg_icons.tpl' icon="media" class="main-icon mr10" width="20px" height="20px"}
  {__("Report a Bug")}
</a>

🎉 Done!

You're all set! Users can now report bugs, view their status, and earn points for helping improve your platform.

Admin has full control, and everything is nicely integrated into Sngine without touching core files.