diff --git a/config_text.md b/config_text.md index ac6f994..62ecea4 100644 --- a/config_text.md +++ b/config_text.md @@ -28,6 +28,65 @@ tv,kitchen=kodi://myuser:mypass@kitchen.hostame tv,basement=kodi://myuser:mypass@basement.hostame ``` +### Tag Grouping +New in v1.6.0 is Tag Grouping! This allows you to assign a group to previous tags defined. +```bash +# Group Example #1 + +# Define your URLs as per normal +user1=mailto://credentials +user2=mailto://credentials + +# Then define a group +friends = user1, user2 +``` +With respect to `Group Example #1` above, you could now send a notification to the tag `friends` and that would in turn trigger a notification to all of the URLs that were included indirectly to that tag. In this case, `user1` and `user2` would be notified. + +Another great thing about groups is you can assign groups to groups to recursively include everything they're apart of: +```bash +# Group Example #2 + +# Define your URLs as per normal +user1=mailto://credentials +user2=mailto://credentials +user3=mailto://credentials +user4=mailto://credentials +boss=mailto://credentials + +# Then define a group +finance = user1, user2 +devteam = user3, user4 + +# Here we create another group and assign it groups +# We also can mix and max tags in line with group assignments too +# like so: +company = finance, devteam, boss + +``` +With respect to `Group Example #2` above, you could now send a notification to the tag `company` and that would in turn trigger a notification to everyone because they're all associated with the group tag. + +You can also assign tags to multiple groups: +```bash +# Group Example #3 + +# Define your URLs as per normal +user1=mailto://credentials +user2=mailto://credentials +user3=mailto://credentials +user4=mailto://credentials + +# Multiple Group Assignments; reuse of a tag causes existing assignment +# to stack on the previous value. +TeamA, Friends = user1, user3 +TeamB, Friends = user2, user4 + +``` +With respect to `Group Example #3` above, we have 3 group tags created (TeamA, TeamB, and Friends). TeamA includes user1 and user3, and Team B contains user2 and user4. The Friends tag actually includes user1, user2, user3, and user4 (all entries stacked). + +**Some Notes:** +- There is no requirement to define the group before or after the URLs that are defined. +- Tags associated with a group that are not used are just ignored. +- Reuse of the same group assignment stacks it's values (it does not replace them) ## Expanding Configuration Sources The TEXT based configuration also supports the keyword `include` which allows you to pull more configuration down from other locations. For example: ```apache