{"id":23406264,"url":"https://github.com/zozs/a-wild-button-appears","last_synced_at":"2025-04-11T21:51:15.133Z","repository":{"id":38655868,"uuid":"132178702","full_name":"zozs/a-wild-button-appears","owner":"zozs","description":"\"A wild BUTTON appears\" is a completely useless Slack bot which randomly posts a wild BUTTON. Who will click it first?!","archived":false,"fork":false,"pushed_at":"2024-01-25T13:45:51.000Z","size":2303,"stargazers_count":12,"open_issues_count":4,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-02T06:15:55.134Z","etag":null,"topics":["bot","slack","wildbutton"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zozs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-04T19:04:27.000Z","updated_at":"2024-02-13T14:38:52.000Z","dependencies_parsed_at":"2023-11-12T16:24:35.438Z","dependency_job_id":"346651de-0ec0-49eb-b62d-7d949ac95390","html_url":"https://github.com/zozs/a-wild-button-appears","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zozs%2Fa-wild-button-appears","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zozs%2Fa-wild-button-appears/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zozs%2Fa-wild-button-appears/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zozs%2Fa-wild-button-appears/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zozs","download_url":"https://codeload.github.com/zozs/a-wild-button-appears/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248487733,"owners_count":21112188,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","slack","wildbutton"],"created_at":"2024-12-22T13:33:09.294Z","updated_at":"2025-04-11T21:51:15.087Z","avatar_url":"https://github.com/zozs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A wild BUTTON appears\n\n**A completely useless bot for Slack**\n\n_A wild BUTTON appears_ is a completely useless bot for Slack.\nDuring work days, at a random time between 09:00-16:00, the bot will post a message with a button to Slack channel of choice.\nThe first user to click the button wins, and can enjoy the glory during the rest of the day.\n\n## Screenshots\n\n![Before clicking](/../screenshots/before.png?raw=true \"Before clicking\")\n\n![After clicking](/../screenshots/after.png?raw=true \"After clicking\")\n\n## Usage\n\nInstall the bot, and then proceed by waiting for a wild BUTTON to appear.\n\n## Installation, configuration, and running\n\n### Installation\n\n#### Install with a cloud-hosted instance\n\n\u003ca href=\"https://slack.com/oauth/v2/authorize?client_id=398308658001.1314237615088\u0026scope=commands,channels:read,chat:write,groups:read,im:write,channels:join,chat:write.public\u0026user_scope=\"\u003e\u003cimg alt=\"Add to Slack\" height=\"40\" width=\"139\" src=\"https://platform.slack-edge.com/img/add_to_slack.png\" srcSet=\"https://platform.slack-edge.com/img/add_to_slack.png 1x, https://platform.slack-edge.com/img/add_to_slack@2x.png 2x\" /\u003e\u003c/a\u003e\n\nAfter installation, you will receive a message by DM in your Slack client. You can then go to the Home tab of wildbutton, where you can configure settings. You need to at least select the proper channel to post buttons to :slightly_smiling_face:\n\nThe cloud-hosted service is free to use, and kindly sponsored by [Debricked](https://debricked.com/).\n\n#### Deploy own instance\n\nConfigure new Slack app with following properties:\n\n* Fill in app name, description, icon, and colour.\n* Configure interactive components with the URL ending in `/interactive`\n* Configure slash commands with the URL ending in `/commands`\n* Configure event subscriptions with URL ending in `/events`. Subscribe to bot scope `app_uninstall` and `app_home_opened`.\n* Configure bot user/app home. Set Home Tab to active.\n* Configure permissions:\n  * Add the redirect url to the URL ending in `/auth`.\n  * Add Bot Token Scopes: `commands`, `channels:read`, `chat:write`, `groups:read`, `im:write`, `channels:join`, `chat:write.public`.\n\n### Configuration\n\nA wild BUTTON appears needs some environmental variables configured. You can either supply them as regular\nenvironmental variables in your shell, or put them in a `.env` file in the same folder as\n`wildbutton.js`.\n\n * `MONGO_URL`: A connection string to connect to MongoDB. Example: `mongodb+srv://user:pass@some-atlas-example.mongodb.net/test?retryWrites=true\u0026w=majority`\n * `MONGO_DATABASE_NAME`: Name of database in Mongo to store the instance data.\n * `SLACK_SIGNING_SECRET`: Signing secret to verify that the requests comes from Slack\n * `SLACK_CLIENT_ID`: Client ID for Slack app.\n * `SLACK_CLIENT_SECRET`: Client secret for Slack app.\n * `SLACK_REDIRECT_URI`: Publicly available url where Slack should redirect to after adding app (the endpoint ending in `/auth`)\n * `PORT`: Port for HTTP server to listen on.\n * `SENTRY_DSN`: Optional DSN if you want to submit errors to Sentry. Truly optional, if not set, log only to stderr/stdout.\n * `SENTRY_ENVIRONMENT`: Optional. The environment sent to sentry. Useful if you have e.g. both staging and production.\n\n### Running\n\nLaunch the `handler-standalone.js` file with Node.\n\n## License\n\nA wild BUTTON appears is licensed under GNU AGPL v3 or later, see the `LICENSE` file for the full license.\n\n```\na-wild-button-appears - a slack bot for posting random buttons\nCopyright (c) 2018, 2019, 2020, 2021, 2022, 2023, 2024, Linus Karlsson\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU Affero General Public License as\npublished by the Free Software Foundation, either version 3 of the\nLicense, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU Affero General Public License for more details.\n\nYou should have received a copy of the GNU Affero General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzozs%2Fa-wild-button-appears","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzozs%2Fa-wild-button-appears","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzozs%2Fa-wild-button-appears/lists"}