+
−Introduction
+
−============
+
−
+
−This module allows to load/unload external components after they have
+
−been added/removed to a configuration file. It is necessary to explicitly
+
−initiate a reload on Prosody either via prosodyctl reload or config:reload().
+
−
+
−Example 1:
+
−--------
+
−If Prosody has started with this configuration file:
+
−
+
−``` {.lua}
+
−VirtualHost "example.com"
+
−    authentication = "internal_plain"
+
−
+
−Component "a.example.com"
+
−    component_secret = "a"
+
−
+
−Component "b.example.com"
+
−    component_secret = "b"
+
−```
+
−
+
−And the file has changed manually or dynamically to:
+
−
+
−``` {.lua}
+
−VirtualHost "example.com"
+
−    authentication = "internal_plain"
+
−
+
−Component "a.example.com"
+
−    component_secret = "a"
+
−
+
−Component "c.example.com"
+
−    component_secret = "c"
+
−```
+
−
+
−Then, the following actions will occur if this module is loaded:
+
−
+
−1. The component c.example.com will be loaded and start bouncing for
+
−authentication.
+
−2. The component b.example.com will be unloaded and deactivated. The
+
−connection with it will not be closed, but no further actions will be
+
−executed on Prosody.
+
−
+
−Example 2:
+
−--------
+
−
+
−If Prosody has started with this configuration file:
+
−
+
−``` {.lua}
+
−VirtualHost "example.com"
+
−    authentication = "internal_plain"
+
−
+
−Component "a.example.com"
+
−    component_secret = "a"
+
−```
+
−
+
−And the file has changed manually or dynamically to:
+
−
+
−``` {.lua}
+
−VirtualHost "example.com"
+
−    authentication = "internal_plain"
+
−
+
−Component "a.example.com"
+
−    component_secret = "a"
+
−
+
−VirtualHost "newexample.com"
+
−        authentication = "internal_plain"
+
−
+
−Component "a.newexample.com"
+
−    component_secret = "a"
+
−```
+
−
+
−Then, the following actions will occur if this module is loaded:
+
−
+
−1. The component a.newexample.com will be loaded and start bouncing for
+
−authentication. Note that its respective VirtualHost is not loaded. Bad
+
−things may happen.
+
−
+
−Usage
+
−=====
+
−
+
−Copy the module folder into your Prosody modules directory. Place the
+
−module between your enabled modules either into the global or a vhost
+
−section.
+
−
+
−No configuration directives are needed
+
−
+
−Info
+
−====
+
−
+
−-   0.9, works