WIP new plugin loader, plugin guide

dev

@@ -208,7 +208,6 @@ bootstrap_plugins() {
     else
         echo "Skipping plugin bootstrap because plugins directory doesn't exist."
     fi
-    exit 1
 }
 
 # Clear existing dev project

dev-docs/index.md

@@ -10,3 +10,10 @@ This directory contains reference documents for Misago developers.
 Misago's notifications feature is implemented in the `misago.notifications` package.
 
 - [Notifications reference](./notifications.md)
+
+
+## Plugins
+
+Misago implements a plugin system that extends [Django's existing application mechanism](https://docs.djangoproject.com/en/4.2/ref/applications/), allowing developers to customize and extend standard features.
+
+- [Plugin guide](./plugins/index.md)

dev-docs/plugins/index.md

@@ -0,0 +1 @@
+# Plugin guide

devproject/settings.py

@@ -13,7 +13,7 @@
 
 import os
 
-from misago import load_plugin_list_if_exists
+from misago import plugin_loader
 from misago.settings import *
 
 
@@ -160,7 +160,7 @@
 
 PLUGINS_LIST_PATH = os.path.join(os.path.dirname(BASE_DIR), "plugins.txt")
 
-INSTALLED_PLUGINS = load_plugin_list_if_exists(PLUGINS_LIST_PATH) or []
+INSTALLED_PLUGINS = plugin_loader.get_plugins_apps()
 
 # Combine Misago's default installed apps with plugins
 INSTALLED_APPS = [

misago/__init__.py

@@ -1,4 +1,4 @@
-from .plugins.pluginlist import load_plugin_list_if_exists
+from .plugins.loader import plugin_loader
 
 
 __version__ = "0.39.0"

misago/plugins/loader.py

@@ -0,0 +1,26 @@
+import os
+
+
+PLUGINS_DIR = os.environ.get("MISAGO_PLUGINS") or None
+
+
+class PluginLoader:
+    def __init__(self):
+        pass
+
+    def load_plugins(self):
+        pass
+
+    def get_plugins_manifests(self):
+        pass
+
+    def get_plugins_apps(self):
+        pass
+
+
+plugin_loader = PluginLoader()
+
+if PLUGINS_DIR:
+    plugins_dir = os.path(PLUGINS_DIR)
+    if plugins_dir.isdir():
+        plugin_loader.load_plugins(plugins_dir)