Smart Badge System

Plugin documentation for installation, usage, uninstallation, and troubleshooting.

Slug: smart-badges Version: 1.0.0 Author: Arman Sen

Introduction

Automatic multi-condition user badges with admin management, event triggers, and cron backup.

This plugin is managed through /admincp/plugins and works without core-file edits.

Features (As Per Plugin Functions)

1. What this plugin does: Automatic multi-condition user badges with admin management, event triggers, and cron backup.
2. Can auto-assign badges based on user actions/events.
3. Supports multi-condition badge rules and automated updates.
4. Has an admin settings panel for plugin controls.
5. Handles background actions without full page reload.
6. Connects plugin behavior to system events.
7. Loads plugin startup logic automatically.
8. Creates required setup data during install.
9. Runs cleanup when you uninstall the plugin.
10. Can update page output before user sees it.
11. Runs on user registration.
12. Runs when a new post is created.
13. Runs when a new comment is created.
14. Runs after successful AJAX actions.
15. Runs at request end for final updates/cleanup.

How to Install

1. Make sure plugin system loader is active (/plugins-check.php should show auto_prepend_loaded: true).
2. Confirm plugin path exists: content/plugins/smart-badges.
3. Open /admincp/plugins, find Smart Badge System, then click Install.
4. Click Enable to start using the plugin.
5. This plugin has install.php, so setup tasks run when you click Install.

How to Use

• Enable the plugin first, then test its workflow in the related area of your site.
• Use plugin settings in AdminCP when available to adjust behavior.
• Check frontend and AJAX flows for expected behavior after each change.
• Keep plugin files consistent with the same version shown in plugin.json.

How to Uninstall

1. Go to /admincp/plugins.
2. Disable Smart Badge System if active.
3. Click Uninstall.
4. This plugin has uninstall.php, so cleanup can run when you click Uninstall.
5. Delete folder content/plugins/smart-badges only after uninstall completes (if full removal is needed).

FAQs

Q: Plugin is installed but nothing changes. Why?

A: Usually it is not enabled, or plugin loader is not active. Check /admincp/plugins and /plugins-check.php.

Q: Where do I configure this plugin?

A: This plugin has a settings/admin screen available from its plugin card in AdminCP.

Q: Will core updates delete this plugin?

A: No. Plugin files in content/plugins are designed to be update-safe from core upgrades.

Q: Will uninstall remove all plugin data?

A: It depends on cleanup logic in uninstall.php. Review plugin behavior before removal if you need to preserve data.