slack-smart-bot 1.10.0 → 1.12.0

data/lib/slack/smart-bot/commands/general_bot_commands.rb

@@ -27,6 +27,7 @@ def general_bot_commands(user, command, dest, files = [])
       # help:    you can use the option 'expanded' or the alias 'extended'
       # help:    `bot rules` will show only the specific rules for this channel.
       # help:    <https://github.com/MarioRuiz/slack-smart-bot#bot-help|more info>
+      # help: command_id: :bot_help
       # help:
 
 
@@ -39,6 +40,7 @@ def general_bot_commands(user, command, dest, files = [])
       # help:    After that if you want to avoid a single message to be treated by the smart bot, start the message by -
       # help:    Also apart of Hello you can use _Hallo, Hi, Hola, What's up, Hey, Hæ_
       # help:    <https://github.com/MarioRuiz/slack-smart-bot#how-to-access-the-smart-bot|more info>
+      # help: command_id: :hi_bot
       # help:
       when /\A\s*(Hello|Hallo|Hi|Hola|What's\sup|Hey|Hæ)\s+(#{@salutations.join("|")})\s*$/i
           hi_bot(user, dest, user.name, display_name)
@@ -50,6 +52,7 @@ def general_bot_commands(user, command, dest, files = [])
       # help:    Bot stops listening to you if you are on a Bot channel
       # help:    Also apart of Bye you can use _Bæ, Good Bye, Adiós, Ciao, Bless, Bless Bless, Adeu_
       # help:    <https://github.com/MarioRuiz/slack-smart-bot#how-to-access-the-smart-bot|more info>
+      # help: command_id: :bye_bot
       # help:
       when /\A\s*(Bye|Bæ|Good\s+Bye|Adiós|Ciao|Bless|Bless\sBless|Adeu)\s+(#{@salutations.join("|")})\s*$/i
           bye_bot(dest, user.name, display_name)
@@ -70,9 +73,10 @@ def general_bot_commands(user, command, dest, files = [])
         # help:     _add message `*Party* will start at *20:00* :tada:`_
         # help:     _add :heavy_exclamation_mark: message Pay attention all DB are on maintenance until 20:00 GMT_
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#announcements|more info>
+        # help: command_id: :add_announcement
         # help: 
       when /\A\s*(add|create)\s+(red\s+|green\s+|white\s+|yellow\s+)?(announcement|statement|declaration|message)\s+(.+)\s*\z/i,
-        /\A\s*(add|create)\s+(:\w+:)\s+(announcement|statement|declaration|message)\s+(.+)\s*\z/i
+        /\A\s*(add|create)\s+(:[\w\-]+:)\s+(announcement|statement|declaration|message)\s+(.+)\s*\z/i
         type = $2.to_s.downcase.strip
         type = 'white' if type == ''
         message = $4
@@ -89,6 +93,7 @@ def general_bot_commands(user, command, dest, files = [])
         # help:     _delete statement 77_
         # help:     _delete declaration 334_
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#announcements|more info>
+        # help: command_id: :delete_announcement
         # help: 
       when /\A\s*(delete|remove)\s+(announcement|statement|declaration|message)\s+(\d+)\s*\z/i
         message_id = $3
@@ -115,11 +120,12 @@ def general_bot_commands(user, command, dest, files = [])
         # help:     _see messages_
         # help:     _see :heavy_exclamation_mark: messages_
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#announcements|more info>
+        # help: command_id: :see_announcements
         # help: 
-      when /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:\w+:\s+)?(announcements|statements|declarations|messages)()\s*\z/i,
+      when /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:[\w\-]+:\s+)?(announcements|statements|declarations|messages)()\s*\z/i,
         /\A\s*see\s+(all\s+)?(announcements|statements|declarations|messages)()\s*\z/i,
-        /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:\w+:\s+)?(announcements|statements|declarations|messages)\s+#([\w\-]+)\s*\z/i,
-        /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:\w+:\s+)?(announcements|statements|declarations|messages)\s+<#(C\w+)\|.*>\s*\z/i
+        /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:[\w\-]+:\s+)?(announcements|statements|declarations|messages)\s+#([\w\-]+)\s*\z/i,
+        /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:[\w\-]+:\s+)?(announcements|statements|declarations|messages)\s+<#(\w+)\|.*>\s*\z/i
 
         type = $1.to_s.downcase.strip
         channel = $3.to_s
@@ -137,11 +143,12 @@ def general_bot_commands(user, command, dest, files = [])
         # help:     The Regexp will automatically add the parameters /im
         # help:     Only available on public channels.
         # help:  Examples:
-        # help:     _share messages /(last\s+|previous\s+)?sales\s+results\s+/ on #sales_
+        # help:     _share messages /(last\s+|previous\s+)sales\s+results\s+/ on #sales_
         # help:     _share messages "share post" on #announcements_
         # xhelp:     _share messages :tada: on #announcements_
         # xhelp:     _share messages :moneybag: from #sales_
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#share-messages|more info>
+        # help: command_id: :share_messages
         # help: 
       when /\A\s*share\s+messages\s+(\/.+\/|".+"|'.+')\s+on\s+<#\w+\|(.+)>\s*\z/i,
         /\A\s*share\s+messages\s+(\/.+\/|".+"|'.+')\s+on\s+<#(\w+)\|>\s*\z/,
@@ -158,6 +165,7 @@ def general_bot_commands(user, command, dest, files = [])
         # help: `see shares`
         # help:     It will display the active shares from this channel.
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#share-messages|more info>
+        # help: command_id: :see_shares
         # help: 
       when /\A\s*see\s+shares\s*\z/i
         see_shares()
@@ -168,6 +176,7 @@ def general_bot_commands(user, command, dest, files = [])
         # help:  Examples:
         # help:     _delete share 24_
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#share-messages|more info>
+        # help: command_id: :delete_share
         # help: 
       when /\A\s*(delete|remove)\s+share\s+(\d+)\s*\z/i
         share_id = $2
@@ -185,26 +194,34 @@ def general_bot_commands(user, command, dest, files = [])
         # help: `who is on EMOJI1 EMOJI99`
         # help: `who is not on vacation?`
         # help: `who is not on EMOJI`
+        # help: `who is available?`
         # help:     It will display the current statuses of the members of the channel where you are calling the command or on the channel you supply.
+        # help:     In case of `who is available?` will show members of the channel that are on line and not on a meeting or vacation or sick.
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#see-statuses|more info>
+        # help: command_id: :see_statuses
         # help: 
       when /\A\s*(see|get)\s+(statuses)()\s*\z/i,
-        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+is\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??()\s*\z/i,
-        /\A\s*(who\s+is\s+on|who\s+is\s+not\s+on)\s+(vacation|holiday)\s*\??()\s*\z/i,
+        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??()\s*\z/i,
+        /\A\s*(who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(vacation|holiday)\s*\??()\s*\z/i,
+        /\A\s*(who\s+is|who\s+are)\s+(available|active)\s*\??()\s*\z/i,
         /\A\s*(see|get)\s+(statuses)\s+#([\w\-]+)\s*\z/i,
-        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+is\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??\s+#([\w\-]+)\s*\z/i,
-        /\A\s*(who\s+is\s+on|who\s+is\s+not\s+on)\s+(vacation|holiday)\s*\??\s+#([\w\-]+)\s*\z/i,
-        /\A\s*(see|get)\s+(statuses)\s+<#(C\w+)\|.+>\s*\z/i,
-        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+is\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??\s+<#(C\w+)\|.+>\s*\z/i,
-        /\A\s*(who\s+is\s+on|who\s+is\s+not\s+on)\s+(vacation|holiday)\s*\??\s+<#(C\w+)\|.+>\s*\z/i
+        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??\s+#([\w\-]+)\s*\z/i,
+        /\A\s*(who\s+is|who\s+are)\s+(available|active)\s*\??\s+#([\w\-]+)\s*\z/i,
+        /\A\s*(who\s+is|who\s+are)\s+(available|active)\s*\??\s+<#(\w+)\|.*>\s*\z/i,
+        /\A\s*(who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(vacation|holiday)\s*\??\s+#([\w\-]+)\s*\z/i,
+        /\A\s*(see|get)\s+(statuses)\s+<#(\w+)\|.*>\s*\z/i,
+        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+is\s+not\s+on|who\s+are\s+on|who\s+are\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??\s+<#(\w+)\|.*>\s*\z/i,
+        /\A\s*(who\s+is\s+on|who\s+is\s+not\s+on|who\s+are\s+on|who\s+are\s+not\s+on)\s+(vacation|holiday)\s*\??\s+<#(\w+)\|.*>\s*\z/i
 
-        not_on = $1.match?(/who\s+is\s+not\s+on/i)
+        not_on = $1.match?(/who\s+(is|are)\s+not\s+on/i)
         type = $2.downcase
         channel = $3.to_s
         if type == 'statuses'
           types = []
         elsif type =='vacation' or type == 'holiday'
           types = [':palm_tree:']
+        elsif type == 'available' or type == 'active'
+          types = ['available']
         else
           type.gsub!(' ', '')
           type.gsub!('::',': :')
@@ -222,11 +239,423 @@ def general_bot_commands(user, command, dest, files = [])
         # help:     aliases for favorite: favourite, most used, fav
         # helpmaster:    You need to set stats to true to generate the stats when running the bot instance and get this info.
         # help:    <https://github.com/MarioRuiz/slack-smart-bot#see-favorite-commands|more info>
+        # help: command_id: :see_favorite_commands
         # help: 
       when /\A\s*(see\s+)?(my\s+)?(fav|favorite|favourite|most\s+used)\s+commands\s*\z/i
         only_mine = $2.to_s!=''
         see_favorite_commands(user, only_mine)
 
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `add admin @user`
+        # helpadmin:     It will add @user as an admin of the channel.
+        # helpadmin:     Only creator of the channel, admins and master admins can use this command.
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # helpadmin: command_id: :add_admin
+        # helpadmin: 
+      when /\A\s*add\s+admin\s+<@(\w+)>\s*\z/i
+        admin_user = $1
+        add_admin(user, admin_user)
+
+        # help: ----------------------------------------------
+        # help: `see admins`
+        # help: `show admins`
+        # help: `who are admins?`
+        # help:     It will show who are the admins of the channel.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # help: command_id: :see_admins
+        # help: 
+      when /\A\s*(see|show)\s+admins\s*\z/i, /\A\s*who\s+are\s+(the\s+)?admins\??\s*\z/i
+        see_admins()
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `remove admin @user`
+        # helpadmin:     It will remove the admin privileges for @user on the channel.
+        # helpadmin:     Only creator of the channel, admins and master admins can use this command.
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # helpadmin: command_id: :remove_admin
+        # helpadmin: 
+      when /\A\s*(remove|delete)\s+admin\s+<@(\w+)>\s*\z/i
+        admin_user = $2
+        remove_admin(user, admin_user)
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `see command ids`
+        # helpadmin:     It will display all available command ids.
+        # helpadmin:     The command id can be used on `bot stats command COMMAND_ID`, `allow access COMMAND_ID` and `deny access COMMAND_ID`
+        # helpadmin:     Only creator of the channel, admins and master admins can use this command.
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # helpadmin: command_id: :see_command_ids
+        # helpadmin: 
+      when /\A\s*(see|display|get)\s+command(\s+|_)ids?\s*\z/i
+        see_command_ids()
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `allow access COMMAND_ID`
+        # helpadmin: `allow access COMMAND_ID @user1 @user99`
+        # helpadmin:     It will allow the specified command to be used on the channel.
+        # helpadmin:     If @user specified, only those users will have access to the command.
+        # helpadmin:     Only admins of the channel can use this command
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#control-who-has-access-to-a-command|more info>
+        # helpadmin: command_id: :allow_access
+        # helpadmin: 
+      when /\A\s*(allow|give)\s+access\s+(\w+)\s+(.+)\s*\z/i, /\A\s*(allow|give)\s+access\s+(\w+)()\s*\z/i
+        command_id = $2.downcase
+        opt = $3.to_s.split(' ')
+        allow_access(user, command_id, opt)
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `deny access COMMAND_ID`
+        # helpadmin:     It won't allow the specified command to be used on the channel.
+        # helpadmin:     Only admins of the channel can use this command
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#control-who-has-access-to-a-command|more info>
+        # helpadmin: command_id: :deny_access
+        # helpadmin: 
+      when /\A\s*deny\s+access(\s+rights)?\s+(\w+)\s*\z/i
+        command_id = $2.downcase
+        deny_access(user, command_id)
+
+
+        # help: ----------------------------------------------
+        # help: `see access COMMAND_ID`
+        # help:     It will show the access rights for the specified command.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#control-who-has-access-to-a-command|more info>
+        # help: command_id: :see_access
+        # help: 
+      when /\A\s*(see|show)\s+access(\s+rights)?\s+(.+)\s*\z/i
+        command_id = $3.downcase
+        see_access(command_id)
+
+        # help: ----------------------------------------------
+        # help: `poster MESSAGE`
+        # help: `poster :EMOTICON_TEXT: MESSAGE`
+        # help: `poster :EMOTICON_TEXT: :EMOTICON_BACKGROUND: MESSAGE`
+        # help: `poster MINUTESm MESSAGE`
+        # help:     It will create a poster with the message supplied. By default will be autodeleted 1 minute later.
+        # help:     If you want the poster to be permanent then use the command `pposter`
+        # help:     If minutes supplied then it will be deleted after the minutes specified. Maximum value 60.
+        # help:     To see the messages on a mobile phone put the phone on landscape mode
+        # help:     Max 15 characters. If the message is longer than that won't be treat it.
+        # help:     Only letters from a to z, 0 to 9 and the chars: ? ! - + =
+        # help:     To be displayed correctly use words with no more than 6 characters
+        # help:     Examples:
+        # help:            _poster nice work!_
+        # help:            _poster :heart: nice work!_
+        # help:            _poster :mac-spinning-wheel: :look: love!_
+        # help:            _poster 25m :heart: woah!_
+        # help: command_id: :poster
+        # help: 
+      when /\A()poster\s+(\d+m\s+)?(:[^:]+:)\s+(:[^:]+:)(.+)\s*\z/i, /\A()poster\s+(\d+m\s+)?(:.+:)\s+()(.+)\s*\z/i, /\A()poster\s+(\d+m\s+)?()()(.+)\s*\z/i,
+        /\A(p)poster\s+()(:[^:]+:)\s+(:[^:]+:)(.+)\s*\z/i, /\A(p)poster\s+()(:.+:)\s+()(.+)\s*\z/i, /\A(p)poster\s+()()()(.+)\s*\z/i
+        permanent = $1.to_s != ''
+        minutes = $2.to_s
+        emoticon_text = $3
+        emoticon_bg = $4
+        text = $5
+        minutes = minutes.scan(/(\d+)/).join
+        
+        if minutes == ''
+          minutes = 1
+        elsif minutes.to_i > 60
+          minutes = 60
+        end
+        
+        save_stats :poster
+        if text.to_s.gsub(/\s+/, '').length > 15
+          respond "Too long. Max 15 chars", :on_thread
+        else
+          poster(permanent, emoticon_text, emoticon_bg, text, minutes)
+        end
+
+        # help: ----------------------------------------------
+        # help: `add team TEAM_NAME members #TEAM_CHANNEL CHANNEL_TYPE #CHANNEL1 #CHANNEL99 : INFO`
+        # help: `add team TEAM_NAME MEMBER_TYPE @USER1 @USER99 CHANNEL_TYPE #CHANNEL1 #CHANNEL99 : INFO`
+        # help: `add team TEAM_NAME MEMBER_TYPE1 @USER1 @USER99 MEMBER_TYPE99 @USER1 @USER99 CHANNEL_TYPE1 #CHANNEL1 #CHANNEL99 CHANNEL_TYPE99 #CHANNEL1 #CHANNEL99 : INFO`
+        # help:     It will add a team with the info supplied.
+        # help:     TEAM_NAME, TYPE: one word, a-z, A-Z, 0-9, - and _
+        # help:     In case it is supplied a channel with type 'members' the members of that channel would be considered members of the team. The SmartBot needs to be a member of the channel.
+        # help:  Examples:
+        # help:     _add team sales members #sales support #sales-support public #sales-ff : Contact us if you need anything related to Sales. You can also send us an email at sales@ffxaja.com_
+        # help:     _add team Sales manager @ann qa @peter @berglind dev @john @sam @marta members #sales support #sales-support public #sales-ff : Contact us if you need anything related to Sales. You can also send us an email at sales@ffxaja.com_
+        # help:     _add team devweb qa @jim dev @johnja @cooke @luisa members #devweb support #devweb-support : We take care of the website_
+        # help:     _add team sandex manager @sarah members #sandex : We take care of the sand_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :add_team
+        # help: 
+      when /\A\s*add\s+team\s+([\w\-]+)\s+([^:]+)\s*:\s+(.+)\s*\z/im, /\A\s*add\s+([\w\-]+)\s+team\s+([^:]+)\s*:\s+(.+)\s*\z/im
+        name = $1.downcase
+        options = $2
+        info = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/^[^:]+:\s*(.+)\s*$/im).join
+        add_team(user, name, options, info)
+
+        # help: ----------------------------------------------
+        # help: `add TYPE to TEAM_NAME team : MESSAGE`
+        # help: `add private TYPE to TEAM_NAME team : MESSAGE`
+        # help: `add personal TYPE to TEAM_NAME team : MESSAGE`
+        # help: `add TYPE to TEAM_NAME team TOPIC : MESSAGE`
+        # help: `add private TYPE to TEAM_NAME team TOPIC : MESSAGE`
+        # help: `add personal TYPE to TEAM_NAME team TOPIC : MESSAGE`
+        # help:     It will add a memo to the team. The memos will be displayed with the team info.
+        # help:     Only team members can add a memo.
+        # help:     TYPE: memo, note, issue, task, feature, bug, jira, github
+        # help:     TOPIC: one word, a-z, A-Z, 0-9, - and _
+        # help:     If private then the memo will be only displayed to team members on a DM or the members channel.
+        # help:     If personal then the memo will be only displayed to the creator on a DM.
+        # help:     In case jira type supplied:
+        # help:       The message should be an JQL URL, JQL string or an issue URL.
+        # help:       To be able to use it you need to specify on the SmartBot settings the credentials.
+        # help:       In case no TOPIC is supplied then it will create automatically the topics from the labels specified on every JIRA issue
+        # help:     In case github type supplied:
+        # help:       The message should be a github URL. You can filter by state (open/closed/all) and labels
+        # help:       To be able to use it you need to specify on the SmartBot settings the github token.
+        # help:       In case no TOPIC is supplied then it will create automatically the topics from the labels specified on every Github issue
+        # help:  Examples:
+        # help:     _add memo to sales team : Add tests for Michigan feature_
+        # help:     _add private note to sales team : Bills will need to be deployed before Friday_
+        # help:     _add memo to dev team web : Check last version_
+        # help:     _add private bug to dev team SRE : Logs should not be accessible from outside VPN_
+        # help:     _add memo sales team : Add tests for Michigan feature_
+        # help:     _add memo team sales: Add tests for Michigan feature_
+        # help:     _add personal memo team sales: Check my vacations_
+        # help:     _add jira to sales team : labels = SalesT AND status != Done_
+        # help:     _add github to sales team : PeterBale/SalesBoom/issues?state=open&labels=bug_
+        # help:     _add github to sales team dev: PeterBale/DevProject/issues/71_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :add_memo_team
+        # help: 
+      when /\A\s*add\s+(private\s+|personal\s+)?(memo|note|issue|task|feature|bug|jira|github)\s+(to\s+)?team\s+([\w\-]+)\s*([^:]+)?\s*:\s+(.+)\s*\z/im,
+           /\A\s*add\s+(private\s+|personal\s+)?(memo|note|issue|task|feature|bug|jira|github)\s+(to\s+)?([\w\-]+)\s+team\s*([^:]+)?\s*:\s+(.+)\s*\z/im 
+        privacy = $1.to_s.strip.downcase
+        type = $2.downcase
+        team_name = $4.downcase
+        topic = $5.to_s.strip
+        message = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/^[^:]+:\s*(.+)\s*$/im).join
+        add_memo_team(user, privacy, team_name, topic, type, message)
+
+        # help: ----------------------------------------------
+        # help: `delete memo ID from TEAM_NAME team`
+        # help:     It will delete the supplied memo ID on the team specified.
+        # help:     aliases for memo: note, issue, task, feature, bug, jira, github
+        # help:     You have to be a member of the team, the creator or a Master admin to be able to delete a memo.
+        # help:  Examples:
+        # help:     _delete memo 32 from sales team_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :delete_memo_team
+        # help: 
+      when /\A\s*(delete|remove)\s+(memo|note|issue|task|feature|bug|jira|github)\s+(\d+)\s+(from|on)\s+team\s+([\w\-]+)\s*\z/i, 
+        /\A\s*(delete|remove)\s+(memo|note|issue|task|feature|bug|jira|github)\s+(\d+)\s+(from|on)\s+([\w\-]+)\s+team\s*\z/i
+        memo_id = $3
+        team_name = $5.downcase
+        delete_memo_team(user, team_name, memo_id)
+
+        # help: ----------------------------------------------
+        # help: `set memo ID on TEAM_NAME team STATUS`
+        # help: `set STATUS on memo ID TEAM_NAME team`
+        # help:     It will assign to the ID specified the emoticon status indicated.
+        # help:     aliases for memo: note, issue, task, feature, bug
+        # help:     This command will be only for memo, note, issue, task, feature, bug. Not for jira or github.
+        # help:     You have to be a member of the team, the creator or a Master admin to be able to set a status.
+        # help:  Examples:
+        # help:     _set memo 32 on sales team :runner:_
+        # help:     _set bug 7 on team sales :heavy_check_mark:_
+        # help:     _set :runner: on memo 6 sales team_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :set_memo_status
+        # help: 
+      when /\A\s*(set)\s+(memo|note|issue|task|feature|bug)\s+(\d+)\s+on\s+team\s+([\w\-]+)\s+(:[\w\-]+:)\s*\z/i, 
+        /\A\s*(set)\s+(memo|note|issue|task|feature|bug)\s+(\d+)\s+on\s+([\w\-]+)\s+team\s+(:[\w\-]+:)\s*\z/i
+        memo_id = $3
+        team_name = $4.downcase
+        status = $5
+        set_memo_status(user, team_name, memo_id, status)
+
+      when /\A\s*(set)\s+(:[\w\-]+:)\s+on\s+(memo|note|issue|task|feature|bug)\s+(\d+)\s+team\s+([\w\-]+)\s*\z/i,
+        /\A\s*(set)\s+(:[\w\-]+:)\s+on\s+(memo|note|issue|task|feature|bug)\s+(\d+)\s+([\w\-]+)\s+team\s*\z/i 
+        memo_id = $4
+        team_name = $5.downcase
+        status = $2
+        set_memo_status(user, team_name, memo_id, status)
+
+        # help: ----------------------------------------------
+        # help: `see teams`
+        # help: `see team TEAM_NAME`
+        # help: `team TEAM_NAME`
+        # help: `TEAM_NAME team`
+        # help: `which team @USER`
+        # help: `which team #CHANNEL`
+        # help: `which team TEXT_TO_SEARCH_ON_INFO`
+        # help: `which team does @USER belongs to?`
+        # help:     It will display all teams or the team specified.
+        # help:     In case a specific team it will show also the availability of the members.
+        # help:  Examples:
+        # help:     _see teams_
+        # help:     _see team Sales_
+        # help:     _Dev team_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :see_teams
+        # help: 
+      when /\A\s*see\s+teams?\s*([\w\-]+)?\s*\z/i, /\A\s*team\s+([\w\-]+)\s*\z/i, /\A\s*([\w\-]+)\s+team\s*\z/i, /\A\s*see\s+all\s+teams\s*()\z/i
+        name = $1.to_s.downcase
+        see_teams(user, name)
+      when /\A\s*(which|search)\s+teams?\s+(is\s+)?(.+)\??\s*\z/i, /\A\s*which\s+team\s+does\s+()()(.+)\s+belongs\s+to\??\s*\z/i
+        search = $3.to_s.downcase
+        see_teams(user, '', search)
+
+        # help: ----------------------------------------------
+        # help: `update team TEAM_NAME NEW_TEAM_NAME`
+        # help: `update team TEAM_NAME : NEW_INFO`
+        # help: `update team TEAM_NAME add MEMBER_TYPE @USER`
+        # help: `update team TEAM_NAME add CHANNEL_TYPE #CHANNEL`
+        # help: `update team TEAM_NAME delete MEMBER_TYPE @USER`
+        # help: `update team TEAM_NAME delete CHANNEL_TYPE #CHANNEL`
+        # help: `update team TEAM_NAME delete @USER`
+        # help: `update team TEAM_NAME delete #CHANNEL`
+        # help:     It will update a team with the info supplied.
+        # help:     You have to be a member of the team, the creator or a Master admin to be able to update a team.
+        # help:  Examples:
+        # help:     _update team sales salesff_
+        # help:     _update team salesff : Support for customers_        
+        # help:     _update sales team delete @sarah @peter_
+        # help:     _update team sales delete public #sales_
+        # help:     _update team sales delete #sales_support_
+        # help:     _update sales team add public #salesff_
+        # help:     _update sales team add qa @john @ben @ana_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :update_team
+        # help: 
+      when /\A\s*update\s+team\s+([\w\-]+)\s+([\w\-]+)\s*\z/i, /\A\s*update\s+([\w\-]+)\s+team\s+([\w\-]+)\s*\z/i
+        name = $1.downcase
+        new_name = $2.downcase
+        update_team(user, name, new_name: new_name)
+      when /\A\s*update\s+team\s+([\w\-]+)\s*:\s+(.+)\s*\z/im, /\A\s*update\s+([\w\-]+)\s+team\s*:\s+(.+)\s*\z/im
+        name = $1.downcase
+        new_info = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/^[^:]+:\s*(.+)\s*$/im).join
+        update_team(user, name, new_info: new_info)
+      when /\A\s*update\s+team\s+([\w\-]+)\s+(delete|remove)\s+(.+)\s*\z/i, /\A\s*update\s+([\w\-]+)\s+team\s+(delete|remove)\s+(.+)\s*\z/i
+        name = $1.downcase
+        delete_opts = $3
+        update_team(user, name, delete_opts: delete_opts)
+      when /\A\s*update\s+team\s+([\w\-]+)\s+add\s+(.+)\s*\z/i, /\A\s*update\s+([\w\-]+)\s+team\s+add\s+(.+)\s*\z/i
+        name = $1.downcase
+        add_opts = $2
+        update_team(user, name, add_opts: add_opts)
+
+        # help: ----------------------------------------------
+        # help: `ping team TEAM_NAME MEMBER_TYPE MESSAGE`
+        # help: `contact team TEAM_NAME MEMBER_TYPE MESSAGE`
+        # help:     ping: It will send the MESSAGE naming all available members of the MEMBER_TYPE supplied.
+        # help:     contact: It will send the MESSAGE naming all members of the MEMBER_TYPE supplied.
+        # help:     In case MEMBER_TYPE is 'all' it will name 10 random members of the team
+        # help:  Examples:
+        # help:     _ping team sales development How is the status on the last feature_
+        # help:     _contact team sales qa Please finish testing of dev02 feature before noon_
+        # help:     _contact team qa all Check the test failures please_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :ping_team
+        # help: command_id: :contact_team
+        # help: 
+      when /\A\s*(contact|ping)\s+team\s+([\w\-]+)\s+([\w\-]+)\s+(.+)\s*\z/im, /\A\s*(contact|ping)\s+([\w\-]+)\s+team\s+([\w\-]+)\s+(.+)\s*\z/im
+        type = $1.downcase.to_sym
+        name = $2.downcase
+        member_type = $3.downcase
+        message = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/\A\s*[^\s]+\s*\w+\s+team\s+[\w\-]+\s+[\w\-]+\s+(.+)\s*\z/im).join
+        if message == ''
+          message = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/\A\s*[^\s]+\s*\w+\s+[\w\-]+\s+team\s+[\w\-]+\s+(.+)\s*\z/im).join
+        end
+        ping_team(user, type, name, member_type, message)
+
+        # help: ----------------------------------------------
+        # help: `delete team TEAM_NAME`
+        # help:     It will delete the supplied team.
+        # help:     You have to be a member of the team, the creator or a Master admin to be able to delete a team.
+        # help:  Examples:
+        # help:     _delete team sales_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :delete_team
+        # help: 
+      when /\A\s*(delete|remove)\s+team\s+([\w\-]+)\s*\z/i, /\A\s*(delete|remove)\s+([\w\-]+)\s+team\s*\z/i
+        name = $2.downcase
+        delete_team(user, name)
+
+
+        # help: ----------------------------------------------
+        # help: `add vacation from YYYY/MM/DD to YYYY/MM/DD`
+        # help: `add vacation YYYY/MM/DD`
+        # help: `add sick from YYYY/MM/DD to YYYY/MM/DD`
+        # help: `add sick YYYY/MM/DD`
+        # help: `add sick child YYYY/MM/DD`
+        # help:     It will add the supplied period to your plan.
+        # help:     Instead of YYYY/MM/DD you can use 'today' or 'tomorrow' or 'next week'
+        # help:     To see your plan call `see my time off`
+        # help:     If you want to see the vacation plan for the team `see team NAME`
+        # help:     Also you can see the vacation plan for the team for a specific period: `vacations team NAME YYYY/MM/DD`
+        # help:     The SmartBot will automatically set the users status to :palm_tree:, :baby: or :face_with_thermometer: and the expiration date.
+        # help:  Examples:
+        # help:     _add vacation from 2022/10/01 to 2022/10/22_
+        # help:     _add sick 2022/08/22_
+        # help:     _add vacation tomorrow_
+        # help:     _add sick baby today_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#time-off-management|more info>
+        # help: command_id: :add_vacation
+        # help: 
+      when /\A\s*add\s+(sick|vacation|sick\s+baby|sick\s+child)\s+from\s+(\d\d\d\d\/\d\d\/\d\d)\s+to\s+(\d\d\d\d\/\d\d\/\d\d)\s*\z/i,
+        /\A\s*add\s+(sick|vacation|sick\s+baby|sick\s+child)\s+from\s+(\d\d\d\d-\d\d-\d\d)\s+to\s+(\d\d\d\d-\d\d-\d\d)\s*\z/i,
+        /\A\s*add\s+(sick|vacation|sick\s+baby|sick\s+child)\s+(\d\d\d\d-\d\d-\d\d)()\s*\z/i,
+        /\A\s*add\s+(sick|vacation|sick\s+baby|sick\s+child)\s+(\d\d\d\d\/\d\d\/\d\d)()\s*\z/i,
+        /\A\s*add\s+(sick|vacation|sick\s+baby|sick\s+child)\s+(today|tomorrow|next\sweek)()\s*\z/i
+        type = $1
+        from = $2.downcase
+        to = $3
+        add_vacation(user, type, from, to)
+
+        # help: ----------------------------------------------
+        # help: `remove vacation ID`
+        # help: `remove vacation period ID`
+        # help: `remove sick period ID`
+        # help: `remove time off period ID`
+        # help: `delete vacation ID`
+        # help:     It will remove the specified period from your vacations/sick periods.
+        # help:  Examples:
+        # help:     _remove vacation 20_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#time-off-management|more info>
+        # help: command_id: :remove_vacation
+        # help: 
+      when /\A\s*(delete|remove)\s+(vacation|sick|time\s+off)(\s+period)?\s+(\d+)\s*\z/i
+        vacation_id = $4
+        remove_vacation(user, vacation_id)
+
+        # help: ----------------------------------------------
+        # help: `see my vacations`
+        # help: `see my time off`
+        # help: `see vacations @USER`
+        # help:     It will display current and past time off.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#time-off-management|more info>
+        # help: command_id: :see_vacations
+        # help: 
+      when /\A\s*see\s+my\s+vacations\s*()\z/i,
+        /\A\s*see\s+my\s+time\s+off\s*()\z/i,
+        /\A\s*see\s+time\s+off\s+<@(\w+)>\s*\z/i,
+        /\A\s*see\s+vacations\s+<@(\w+)>\s*\z/i
+        from_user = $1
+        see_vacations(user, from_user: from_user)
+
+        # help: ----------------------------------------------
+        # help: `vacations team NAME`
+        # help: `time off team NAME`
+        # help: `vacations team NAME YYYY/MM/DD`
+        # help: `time off team NAME YYYY/MM/DD`
+        # help:     It will display the time off plan for the team specified.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#time-off-management|more info>
+        # help: command_id: :see_vacations_team
+        # help: 
+      when /\A\s*(see\s+)?(vacations|time\s+off)\s+team\s+([\w\-]+)\s*(\d\d\d\d\/\d\d\/\d\d)?\s*\z/i,
+        /\A\s*(see\s+)?(vacations|time\s+off)\s+([\w\-]+)\s+team\s*(\d\d\d\d\/\d\d\/\d\d)?\s*\z/i,
+        /\A\s*(see\s+)?(vacations|time\s+off)\s+team\s+([\w\-]+)\s*(\d\d\d\d-\d\d-\d\d)?\s*\z/i,
+        /\A\s*(see\s+)?(vacations|time\s+off)\s+([\w\-]+)\s+team\s*(\d\d\d\d-\d\d-\d\d)?\s*\z/i        
+        team_name = $3.downcase
+        date = $4.to_s
+        date = Date.today.strftime("%Y/%m/%d") if date.empty?
+        see_vacations_team(user, team_name, date)
+        
     else
       return false
     end

data/lib/slack/smart-bot/commands/on_bot/add_shortcut.rb

@@ -19,6 +19,7 @@ class SlackSmartBot
   # help:        _shortcut Spanish Account_
   # help:        _Spanish Account_
   # help:    <https://github.com/MarioRuiz/slack-smart-bot#shortcuts|more info>
+  # help: command_id: :add_shortcut
   # help:
   def add_shortcut(dest, user, typem, for_all, shortcut_name, command, command_to_run, global)
     save_stats(__method__)
@@ -63,7 +64,7 @@ class SlackSmartBot
               end
             }
           end
-          if !config.admins.include?(from) and @shortcuts[:all].include?(shortcut_name) and !@shortcuts[from].include?(shortcut_name)
+          if !is_admin?(from) and @shortcuts[:all].include?(shortcut_name) and !@shortcuts[from].include?(shortcut_name)
             respond "Only the creator of the shortcut can modify it", dest
           elsif found_other
             respond "You cannot create a shortcut for all with the same name than other user is using", dest

data/lib/slack/smart-bot/commands/on_bot/admin/add_routine.rb

@@ -35,11 +35,12 @@ class SlackSmartBot
   # helpadmin:      _add routine example on Tuesdays at 09:00 #SREChannel !run db cleanup_
   # helpadmin:      _add routine example on weekdays at 22:00 suggest command_
   # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#routines|more info>
+  # helpadmin: command_id: :add_routine
   # helpadmin:
   def add_routine(dest, from, user, name, type, number_time, period, command_to_run, files, silent, channel, routine_type)
     save_stats(__method__)
     if files.nil? or files.size == 0 or (files.size > 0 and config.masters.include?(from))
-      if config.admins.include?(from)
+      if is_admin?
         if @routines.key?(@channel_id) && @routines[@channel_id].key?(name)
           respond "I'm sorry but there is already a routine with that name.\nCall `see routines` to see added routines", dest
         else

data/lib/slack/smart-bot/commands/on_bot/admin/extend_rules.rb

@@ -5,13 +5,14 @@ class SlackSmartBot
   # helpadmin: `use rules on CHANNEL_NAME`
   # helpadmin:    It will allow to use the specific rules from this channel on the CHANNEL_NAME
   # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#extending-rules-to-other-channels|more info>
+  # helpadmin: command_id: :extend_rules
   # helpadmin:
   def extend_rules(dest, user, from, channel, typem)
     save_stats(__method__)
     unless typem == :on_extended
       if config.on_master_bot
         respond "You cannot use the rules from Master Channel on any other channel.", dest
-      elsif !config.admins.include?(from) #not admin
+      elsif !is_admin? #not admin
         respond "Only admins can extend the rules. Admins on this channel: #{config.admins}", dest
       else
         #todo: add pagination for case more than 1000 channels on the workspace

data/lib/slack/smart-bot/commands/on_bot/admin/pause_bot.rb

@@ -6,10 +6,11 @@ class SlackSmartBot
   # helpadmin:    the bot will pause so it will listen only to admin commands
   # helpadmin:    You can use this command only if you are an admin user
   # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+  # helpadmin: command_id: :pause_bot
   # helpadmin:
   def pause_bot(dest, from)
     save_stats(__method__)
-    if config.admins.include?(from) #admin user
+    if is_admin?
       respond "This bot is paused from now on. You can start it again: start this bot", dest
       respond "zZzzzzZzzzzZZZZZZzzzzzzzz", dest
       @status = :paused

data/lib/slack/smart-bot/commands/on_bot/admin/pause_routine.rb

@@ -7,10 +7,11 @@ class SlackSmartBot
   # helpadmin:    Examples:
   # helpadmin:      _pause routine example_
   # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#routines|more info>
+  # helpadmin: command_id: :pause_routine
   # helpadmin:
   def pause_routine(dest, from, name)
     save_stats(__method__)
-    if config.admins.include?(from) #admin user
+    if is_admin?
       if !config.on_master_bot and dest[0] == "D"
         respond "It's only possible to pause routines from MASTER channel from a direct message with the bot.", dest
       elsif @routines.key?(@channel_id) and @routines[@channel_id].key?(name)

data/lib/slack/smart-bot/commands/on_bot/admin/remove_routine.rb

@@ -10,10 +10,11 @@ class SlackSmartBot
   # helpadmin:    Examples:
   # helpadmin:      _kill routine example_
   # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#routines|more info>
+  # helpadmin: command_id: :remove_routine
   # helpadmin:
   def remove_routine(dest, from, name)
     save_stats(__method__)
-    if config.admins.include?(from) #admin user
+    if is_admin?
       if @routines.key?(@channel_id) and @routines[@channel_id].key?(name)
         @routines[@channel_id][name][:thread].exit
         @routines[@channel_id].delete(name)