You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -53,9 +49,10 @@ Modmail is similar to Reddit's Modmail both in functionality and purpose. It ser
53
49
This bot is free for everyone and always will be. If you like this project and would like to show your appreciation, you can support us on **[Patreon](https://www.patreon.com/kyber)**, cool benefits included!
54
50
55
51
## How does it work?
56
-
When a member sends a direct message to the bot, a channel or "thread" is created within an isolated category for that member. This channel is where messages will be relayed and where any available staff member can respond to that user.
57
52
58
-
All threads are logged and you can view previous threads through the corresponding generated log link. Here is an [**example**](https://logs.modmail.tk/example).
53
+
When a member sends a direct message to the bot, Modmail will create a channel or "thread" within an isolated category. All further DM messages will automatically relay to that channel, for any available staff can respond within the channel.
54
+
55
+
All threads are logged and you can view previous threads through their corresponding log link. Here is an [**example**](https://logs.modmail.tk/example).
59
56
60
57
## Features
61
58
@@ -65,46 +62,51 @@ All threads are logged and you can view previous threads through the correspondi
65
62
* Interface elements (color, responses, reactions, etc).
66
63
* Snippets and *command aliases*.
67
64
* Minimum duration for accounts to be created before allowed to contact Modmail (`account_age`).
68
-
* Minimum duration for member to be in the guild allowed to contact Modmail (`guild_age`).
65
+
* Minimum duration for members to be in the guild before allowed to contact Modmail (`guild_age`).
66
+
69
67
***Advanced Logging Functionality:**
70
-
* When you close a thread, a [log link](https://logs.modmail.tk/example)is generated and posted to your log channel.
68
+
* When you close a thread, Modmail will generate a [log link](https://logs.modmail.tk/example) and post it to your log channel.
71
69
* Native Discord dark-mode feel.
72
70
* Markdown/formatting support.
73
71
* Login via Discord to protect your logs ([premium Patreon feature](https://patreon.com/kyber)).
74
72
* See past logs of a user with `?logs`.
75
73
* Searchable by text queries using `?logs search`.
74
+
76
75
***Robust implementation:**
77
-
*Scheduled tasks in human time, e.g. `?close in 2 hours silently`.
78
-
* Editing and deleting messages are synced on all channels.
79
-
* Support for the full range of message content (multiple images, files).
76
+
*Schedule tasks in human time, e.g. `?close in 2 hours silently`.
77
+
* Editing and deleting messages are synced.
78
+
* Support for the diverse range of message contents (multiple images, files).
80
79
* Paginated commands interfaces via reactions.
81
-
80
+
82
81
This list is ever-growing thanks to active development and our exceptional contributors. See a full list of documented commands by using the `?help` command.
83
82
84
83
## Installation
85
84
86
-
<<<<<<< HEAD
85
+
Where is the Modmail bot invite link? Unfortunately, due to how this bot functions, it cannot be invited. This is to ensure the individuality to your server and grant you full control over your bot and data. Nonetheless, you can easily obtain a free copy of Modmail for your server by following one of the methods listed below (roughly takes 15 minutes of your time):
86
+
87
87
### Heroku
88
88
89
-
This bot can be hosted on Heroku.
89
+
This bot can be hosted on Heroku.
90
90
91
-
Installation via Heroku is possible with only your web browser.
92
-
The [**installation guide**](https://github.com/kyb3r/modmail/wiki/Installation) will guide you through the entire installation process. If you run into any problems, join the [development server](https://discord.gg/etJNHCQ) for help and support.
91
+
Installation via Heroku is possible with your web browser alone.
92
+
The [**installation guide**](https://github.com/kyb3r/modmail/wiki/Installation)(which includes a video tutorial!) will guide you through the entire installation process. If you run into any problems, join our [Modmail Discord Server](https://discord.gg/etJNHCQ) for help and support.
93
93
94
-
You can also set up auto-update. To do this:
94
+
To configure automatic updates:
95
+
- Login to [GitHub](https://github.com/) and verify your account.
95
96
-[Fork the repo](https://github.com/kyb3r/modmail/fork).
96
-
-[Install the Pull app for your fork](https://github.com/apps/pull).
97
-
- Then go to the Deploy tab in your Heroku account, select GitHub and connect your fork.
97
+
- Install the [Pull app](https://github.com/apps/pull) for your fork.
98
+
- Then go to the Deploy tab in your [Heroku account](https://dashboard.heroku.com/apps) of your bot app, select GitHub and connect your fork (usually by typing "Modmail").
98
99
- Turn on auto-deploy for the `master` branch.
99
100
100
101
### Hosting for patrons
101
102
102
-
If you don't want to go through the trouble of setting up your own bot, and want to support this project as well, we offer installation, hosting and maintenance for Modmail bots for [**Patrons**](https://patreon.com/kyber). Join the support server for more info!
103
+
If you don't want to go through the trouble of setting up your very own Modmail bot, and/or want to support this project, we offer the all inclusive installation, hosting and maintenance of your Modmail with [**Patron**](https://patreon.com/kyber). Join our [Modmail Discord Server](https://discord.gg/etJNHCQ) for more info!
103
104
104
105
### Locally
105
106
106
-
Installation locally for development reasons or otherwise is as follows, you will need [`python 3.7`](https://www.python.org/downloads/).
107
-
Follow the [**installation guide**](https://github.com/kyb3r/modmail/wiki/Installation) and disregard deploying Heroku apps. If you run into any problems, join the [development server](https://discord.gg/etJNHCQ) for help and support.
107
+
Local hosting of Modmail is also possible, first you will need [`python 3.7`](https://www.python.org/downloads/).
108
+
109
+
Follow the [**installation guide**](https://github.com/kyb3r/modmail/wiki/Installation) and disregard deploying the Heroku bot application. If you run into any problems, join our [Modmail Discord Server](https://discord.gg/etJNHCQ) for help and support.
108
110
109
111
Clone the repo:
110
112
@@ -119,9 +121,9 @@ Install dependencies:
119
121
$ pipenv install
120
122
```
121
123
122
-
Rename the `.env.example` to `.env` and fill out the fields. If `.env.example` is hidden, create a text file named `.env` and copy the contents of [`.env.example`](https://raw.githubusercontent.com/kyb3r/modmail/master/.env.example) then modify the values.
124
+
Rename the `.env.example` to `.env` and fill out the fields. If `.env.example` is nonexistent (hidden), create a text file named `.env` and copy the contents of [`.env.example`](https://raw.githubusercontent.com/kyb3r/modmail/master/.env.example) then modify the values.
123
125
124
-
Finally, run the bot.
126
+
Finally, start Modmail.
125
127
126
128
```console
127
129
$ pipenv run bot
@@ -135,14 +137,16 @@ Special thanks to our sponsors for supporting the project.
Become a sponsor on [Patreon](https://patreon.com/kyber).
139
141
140
142
## Plugins
141
143
142
-
Modmail supports the use of third-party plugins to extend or add functionality to the bot. This allows the introduction of niche features as well as anything else outside of the scope of the core functionality of Modmail. A list of third party plugins can be found using the `plugins registry` command. To develop your own, check out the [documentation](https://github.com/kyb3r/modmail/wiki/Plugins) for plugins.
144
+
Modmail supports the use of third-party plugins to extend or add functionalities to the bot. This allows niche features as well as anything else outside of the scope of the core functionality of Modmail. A list of third-party plugins can be found using the `plugins registry` command. To develop your own, check out the [plugins documentation](https://github.com/kyb3r/modmail/wiki/Plugins).
145
+
146
+
Plugins requests and support is available in our (Modmail Plugins Server)[https://discord.gg/4JE4XSW].
143
147
144
148
## Contributing
145
149
146
-
Contributions to Modmail are always welcome, whether it be improvements to the documentation or new functionality, please feel free to make the change. Check out our contribution [guidelines](https://github.com/kyb3r/modmail/blob/master/CONTRIBUTING.md) before you get started.
150
+
Contributions to Modmail are always welcome, whether it be improvements to the documentation or new functionality, please feel free to make the change. Check out our contribution [guidelines](https://github.com/kyb3r/modmail/blob/master/CONTRIBUTING.md) before you get started.
147
151
148
-
This bot is free for everyone and always will be. If you like this project and would like to show your appreciation, here's the link to our **[Patreon Page](https://www.patreon.com/kyber)**!
152
+
If you like this project and would like to show your appreciation, support us on **[Patreon](https://www.patreon.com/kyber)**!
0 commit comments