Restructured plugin system and examples

plugins/README.md

@@ -0,0 +1,58 @@
+### Note
+Copy the example and rename it to your desired name. Plugins define a ui target slot with the 'ui_target' permissions data but don't have to if not directly interacted with.
+Plugins must have a run method defined; though, you do not need to necessarily do anything within it. The run method implies that the passed in event system or other data is ready for the plugin to use.
+
+
+### Manifest
+```
+class Manifest:
+    path: str        = os.path.dirname(os.path.realpath(__file__))
+    name: str        = "Example Plugin"
+    author: str      = "John Doe"
+    version: str     = "0.0.1"
+    support: str     = ""
+    permissions: {}  = {
+        'ui_target': "plugin_control_list",
+        'pass_fm_events': "true"
+
+    }
+```
+
+
+### Permissions
+```
+permissions: {}  = {
+    'ui_target': "plugin_control_list",
+    'ui_target_id': "<some other Gtk Glade ID>" # Only needed if using "other" in "ui_target". See below for predefined "ui_target" options...
+    'pass_fm_events': "true" # If empty or undefined will be ignored.
+}
+```
+
+UI Targets:
+<ul>
+<li>main_Window</li>
+<li>main_menu_bar</li>
+<li>path_menu_bar</li>
+<li>plugin_control_list</li>
+<li>window_(1-4)</li>
+<li>context_menu</li>
+<li>other</li>
+</ul>
+
+### Methods
+```
+# Must define and return a widget if "ui_target" is defined.
+def get_ui_element(self):
+    button = Gtk.Button(label=self.name)
+    button.connect("button-release-event", self._do_download)
+    return button
+
+# Must define in plugin if "pass_fm_events" is set to "true" string.
+def set_fm_event_system(self, fm_event_system):
+    self._fm_event_system = fm_event_system
+
+# Must define regardless if needed. Can just pass if plugin does stuff in its __init__
+def run(self):
+    self._module_event_observer()
+
+```