docs: write an awesome README

This commit is contained in:
Isaac 2023-02-18 02:32:09 +00:00
parent 68765e530b
commit 4049202ab2
No known key found for this signature in database
GPG Key ID: 0DE40AE37BBA5C33

198
README.md
View File

@ -1,48 +1,176 @@
[![Translation status](https://hosted.weblate.org/widgets/discord-tickets/-/open-graph.png)](https://hosted.weblate.org/engage/discord-tickets/) > **Warning**
>
https://www.prisma.io/docs/reference/database-reference/supported-databases > This is the development branch, it may be unstable and may not work as expected.
>
![](https://static.eartharoid.me/k/22/08/02185801.png) - for user/create, slash/force-close, slash/claim, slash/release, and slash/move > *dev notes:*
> - https://static.eartharoid.me/k/22/08/02185801.png - for user/create, slash/force-close, slash/claim, slash/release, and slash/move
menu question max length cannot be higher than question options > - menu question max length cannot be higher than question options
> - ports <1024 require root
ports <1024 require root > - TODO: update notifications
> - TODO: user:create, force-close
- TODO: update notifications > - **likely to be rate limited by discord**:
>
> [![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/eB6TkX?referralCode=Z3aYd2)
creation requires an interaction:
- [x] /new -> category? -> topic or questions -> create <div align="center">
- [ ] user:create(self) -> category? -> topic or questions -> create
- [ ] user:create(staff) -> category? -> DM (channel fallback) button -> topic or questions -> create ![bots](https://img.shields.io/badge/dynamic/json?color=5865F2&label=bots&query=clients.total&url=https%3A%2F%2Fstats.discordtickets.app%2Fapi%2Fv3%2Fcurrent&logo=discord&logoColor=white&style=flat-square)
- [x] message:create(self) -> category? -> topic or questions -> create ![tickets](https://img.shields.io/badge/dynamic/json?color=5865F2&label=tickets&query=tickets&url=https%3A%2F%2Fstats.discordtickets.app%2Fapi%2Fv3%2Fcurrent&logo=discord&logoColor=white&style=flat-square)
- [ ] ~~message:create(staff) -> category? -> DM (channel fallback) button -> topic or questions -> create~~ [![GitHub stars](https://img.shields.io/github/stars/discord-tickets/bot?style=flat-square)](https://github.com/discord-tickets/bot/stargazers)
- [x] DM -> guild? -> category? -> topic or questions -> create [![Codacy](https://img.shields.io/codacy/grade/b974eb5f984c40868e07d82c968bd02d?logo=codacy&amp;style=flat-square)](https://www.codacy.com/gh/discord-tickets/bot/dashboard)
- [x] panel(interaction) -> topic or questions -> create [![All Contributors](https://img.shields.io/github/all-contributors/discord-tickets/bot?color=ee8449&style=flat-square)](https://github.com/discord-tickets/bot/blob/main/CONTRIBUTORS.md)
- [ ] ~~panel(message) -> DM (channel fallback) button -> topic or questions -> create~~ [![Discord](https://img.shields.io/discord/451745464480432129?label=discord&amp;color=7289DA&amp;style=flat-square)](https://lnk.earth/discord)
<br>
![Discord Tickets](https://static.eartharoid.me/discord-tickets/logo/wordmark/gradient-by-eartharoid.png)
**A free alternative to the premium and white-label plans of other ticket management bots.**
<br>
<a
href="https://www.producthunt.com/posts/discord-tickets?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-discord&#0045;tickets"
target="_blank">
<img
src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=321112&theme=light"
alt="Discord&#0032;Tickets - A&#0032;free&#0032;ticketing&#0032;solution | Product Hunt"
style="width: 250px; height: 54px;"
width="250"
height="54"
/>
</a>
<br>
---
[![PebbleHost](https://img.eartharoid.me/insecure/rs:auto:180/plain/s3://eartharoid/sharex/21/10/pebblehost.webp)](https://pebble.host/discordtickets)
<br>
**[Partnered with PebbleHost](https://pebble.host/discordtickets)**
<sub>for affordable bot hosting</sub>
---
<br>
</div>
## 📖 Contents
- [📖 Contents](#-contents)
- [✨ Features](#-features)
- [Want to learn more?](#want-to-learn-more)
- [⚡ Getting started](#-getting-started)
- [🤑 Sponsors](#-sponsors)
- [🎖️ Contributors](#-contributors)
- [🧰 Contributing](#-contributing)
- [🌎 Translating](#-translating)
- [😕 Support](#-support)
- [⭐ Star History](#-star-history)
- [🥱 License](#-license)
## ✨ Features
- 📖 [**Documentation**](https://discordtickets.app/getting-started/) - comprehensive documentation and guides to help you get started
- ⚙️ **Simple settings** - configure your bot with the included and easy-to-use dashboard
- 🎨 **Highly customisable** - tweak features, colours, messages, and more to your liking
- 🛸 **Modern features** - including slash commands, buttons, select menus, and modals
- 🤖 **Automation** - ease your staff team's workload with configurable automation
- 🏷️ [**Tags**](https://v4--discordtickets.netlify.app/features/#tags) - resolve members' problems without escalating to tickets
- 🎫 **Tickets** - close inactive tickets automatically
- ❓ **Context** - ask for a topic or up to 5 custom questions before creating a ticket, and see references to a message or previous ticket at a glance
- 🗃️ **Organisation** - claim, release, move and transfer tickets between members and categories
- 🌎 [**Internationalisation**](#-translating) - available in more than 10 languages
- ⏱️ **Statistics** - analyse your staff members' performance
- 🪓 **Battle-tested** - trusted by thousands of servers, with over [half a million tickets](https://stats.discordtickets.app/) created since 2019
- 🐳 [**Docker**](https://discordtickets.app/self-hosting/installation/docker/) - reliable and quick deployment with Docker
[*...and more!*](https://discordtickets.app/features/)
### Want to learn more?
**Visit [the website](https://discordtickets.app/) for more features, details, and screenshots**,
or skip to the [full feature tour](https://discordtickets.app/features/).
## ⚡ Getting started
> *🙏 Please read the [documentation](https://discordtickets.app/self-hosting/installation/) before you start.*
There are 3 ways to get started with Discord Tickets:
- ☁️ [Add the public bot](https://discordtickets.app/public/) - instant setup, but branded *(great for testing)*
- 😴 [Get a managed bot](https://discordtickets.app/managed/) - your own bot, hosted by me *(easy and cheap)*
- 🧑‍💻 [Install your own bot](https://discordtickets.app/self-hosting/) - host it yourself *(⚠️ experience recommended)*
**[Read the documentation](https://discordtickets.app/getting-started/)** for more information.
> **Warning**
> This button is here because it looks nice, but I will cry if you click it before reading the [documentation](https://discordtickets.app/getting-started/). :)
[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/eB6TkX?referralCode=Z3aYd2)
<!-- [![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/discord-tickets/bot) -->
## 🤑 Sponsors
Discord Tickets is made possible by its sponsors:
![Sponsors](https://cdn.jsdelivr.net/gh/eartharoid/sponsors/sponsorkit/sponsors.svg)
Please consider sponsoring the project if it adds value to your business/community.
**[Sponsor on GitHub](https://github.com/discord-tickets/bot/?sponsor=1)**, or
[![Donate at ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/eartharoid)
> **Note** > **Note**
> >
> test > Your logo will only appear here if you sponsor through GitHub Sponsors.
> [Create an organisation](https://github.com/account/organizations/new?plan=free) if you want to use your business/community logo.
> **Warning** ## 🎖️ Contributors
<!-- [![Contributors](https://contrib.rocks/image?repo=discord-tickets/bot)](https://github.com/discord-tickets/bot/graphs/contributors) -->
Discord Tickets is made possible by all of the people listed in [CONTRIBUTORS.md](https://github.com/discord-tickets/bot/blob/main/CONTRIBUTORS.md).
### 🧰 Contributing
If you want to help translate, suggest a feature, submit a bug report,
or contribute in any other way, please read the [contributing guidelines](https://github.com/discord-tickets/.github/blob/main//CONTRIBUTING.md).
> **Note**
> >
> test > You can add yourself to the list of contributors [here](https://github.com/discord-tickets/bot/issues/new/choose).
<!-- <picture> ### 🌎 Translating
<source media="(prefers-color-scheme: dark)" srcset="...>
<source media="(prefers-color-scheme: light)" srcset="...">
<img alt="..." src="...">
</picture> -->
## Contributing [![Translation status](https://hosted.weblate.org/widgets/discord-tickets/-/open-graph.png)](https://hosted.weblate.org/engage/discord-tickets/)
https://commitlint.js.org/#/ ## 😕 Support
huksy? [![Discord](https://discordapp.com/api/guilds/451745464480432129/widget.png?style=banner4)](https://lnk.earth/discord)
eslint
secret scan
## Contributors ## ⭐ Star History
[![Contributors](https://contrib.rocks/image?repo=discord-tickets/bot)](https://github.com/discord-tickets/bot/graphs/contributors) <details>
<summary>Show graph</summary>
[![Star History Chart](https://api.star-history.com/svg?repos=discord-tickets/bot&type=Date)](https://star-history.com/#discord-tickets/bot&Date)
</details>
## 🥱 License
Discord Tickets by eartharoid™ is licensed under the [GPLv3 license](https://github.com/discord-tickets/bot/blob/main/LICENSE).
This is not an official Discord product. It is not affiliated with nor endorsed by Discord Inc.
© 2023 Isaac Saunders