Add optional argument to "feed" command for specifying template (#1097)

* Allow specifying a template as an optional argument to the "feed" command

Signed-off-by: Molly Miller <[email protected]>

* Document template argument in the "feed" command.

Signed-off-by: Molly Miller <[email protected]>

---------

Signed-off-by: Molly Miller <[email protected]>
Co-authored-by: Molly Miller <[email protected]>

Author: sysvinit

changelog.d/1097.feature.md

@@ -0,0 +1 @@
+Add an optional template argument to the `feed` command, to allow specifying a template for feed entries when using the command interface.

docs/setup/feeds.md

@@ -60,3 +60,5 @@ may include any of the following tokens:
 | $SUMMARY   | The summary of the entry.                                  |
 
 If not specified, the default template is `New post in $FEEDNAME: $LINK`.
+
+The template can also be given as an argument when adding the feed to a room, e.g. `!hookshot feed <URL> <LABEL> <TEMPLATE>`. If the template contains spaces, it can be quoted using double quotes.

src/Connections/SetupConnection.ts

@@ -624,11 +624,16 @@ export class SetupConnection extends CommandConnection {
   @botCommand("feed", {
     help: "Bridge an RSS/Atom feed to the room.",
     requiredArgs: ["url"],
-    optionalArgs: ["label"],
+    optionalArgs: ["label", "template"],
     includeUserId: true,
     category: FeedConnection.ServiceCategory,
   })
-  public async onFeed(userId: string, url: string, label?: string) {
+  public async onFeed(
+    userId: string,
+    url: string,
+    label?: string,
+    template?: string,
+  ) {
     if (!this.config.feeds?.enabled) {
       throw new CommandError(
         "not-configured",
@@ -660,7 +665,7 @@ export class SetupConnection extends CommandConnection {
     const { connection } = await FeedConnection.provisionConnection(
       this.roomId,
       userId,
-      { url, label },
+      { url, label, template },
       this.provisionOpts,
     );
     this.pushConnections(connection);