Country Flag Badge

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

Slug: country-flag-badge Version: 1.0.0 Author: Arman Sen

Introduction

Display user country flags as badges on avatars and usernames using profile country ISO codes

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

Features (As Per Plugin Functions)

1. What this plugin does: Display user country flags as badges on avatars and usernames using profile country ISO codes
2. Can show country flag badges from user profile country.
3. Supports display near avatars/usernames.
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. Creates required setup data during install.
8. Contains core business logic for plugin features.
9. Runs cleanup when you uninstall the plugin.
10. Can update page output before user sees it.

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/country-flag-badge.
3. Open /admincp/plugins, find Country Flag Badge, 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 Country Flag Badge if active.
3. Click Uninstall.
4. This plugin has uninstall.php, so cleanup can run when you click Uninstall.
5. Delete folder content/plugins/country-flag-badge 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.