Post Categories

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

Slug: post-categories Version: 1.0.0 Author: Arman Sen

Introduction

Post categories with user preferences, personalized feed filtering, and category pages

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

Features (As Per Plugin Functions)

1. What this plugin does: Post categories with user preferences, personalized feed filtering, and category pages
2. Adds categories for posts and category-based discovery.
3. Supports category preference-based feed filtering.
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. Runs cleanup when you uninstall the plugin.
9. Can update page output before user sees it.
10. Runs when a new post is created.

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/post-categories.
3. Open /admincp/plugins, find Post Categories, 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 Post Categories if active.
3. Click Uninstall.
4. This plugin has uninstall.php, so cleanup can run when you click Uninstall.
5. Delete folder content/plugins/post-categories 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.