Skip to content

Commit 131df98

Browse files
committed
Update docs
1 parent 01be728 commit 131df98

19 files changed

+200
-799
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<strong><i>Raiden's personal fork of Python Discord Modmail bot.</i></strong><br><br>
44

55
<a href="#"><img src="https://img.shields.io/badge/Version-4.1.0-7d5edd?style=shield&logo=https://modmail-docs.netlify.app/favicon.png"></a>
6-
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.8_--_3.11-blue.svg?style=shield&logo=Python" alt="Made with Python 3.8"></a>
6+
<img src="https://img.shields.io/badge/3.8_--_3.11-red?logo=python&logoColor=white&label=Python&labelColor=%233772a2&color=%23ffdd54">
77
<a href="https://github.com/ambv/black"><img src="https://img.shields.io/badge/Code%20Style-Black-black?style=shield"></a>
88
<a href="https://github.com/modmail-dev/modmail/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-e74c3c.svg?style=shield" alt="MIT License"></a>
99
<a href="https://discord.gg/cnUpwrnpYb"><img src="https://img.shields.io/discord/616969119685935162.svg?label=Discord&logo=Discord&colorB=7289da&style=shield" alt="Support"></a>

docs/pages/_meta.json

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,20 @@
33
"getting-started": "Getting started",
44
"installation": "Installing Modmail",
55
"logviewer-installation": "Installing Logviewer",
6-
"configuration": "Configuring Modmail",
76
"updating": "Updating Modmail",
8-
"updating-logviewer": "Updating Logviewer",
9-
"setting-up-auto-restart": "Set up auto-restart",
7+
"configuring": {
8+
"title": "Configuring Modmail",
9+
"href": "https://docs.modmail.dev/usage-guide/configuration",
10+
"newWindow": true
11+
},
1012
"contact": {
1113
"title": "Discord ↗",
1214
"type": "page",
1315
"href": "https://dsc.gg/transience",
1416
"newWindow": true
15-
}
17+
},
18+
"frequently-asked-questions": "Common Questions",
19+
"plugins": "Plugin Documentation",
20+
"community-guides": "Community Guides"
1621
}
1722

docs/pages/community-guides.mdx

Lines changed: 2 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,21 +7,6 @@ import { Card, Cards } from 'nextra-theme-docs'
77
Community guides are not verified by the Modmail team, so use them at your own risks.
88
</Callout>
99

10-
### Hosting on [Replit](https://replit.com/)
11-
12-
Replit is an online code execution playground. You can host Modmail there for free using certain exploits.
13-
The legitimate method costs $7 USD per month. However, regardless if you pay or host for free,
14-
hosting on Replit are often unstable and thus not recommended. But for now, this is the one of the only options
15-
for those without a payment method for hosting or verification.
16-
<br/>
17-
<Card
18-
icon={
19-
<img src="https://replit.com/public/icons/favicon-prompt-192.png" alt="drawing" width="25"/>
20-
}
21-
title="Replit Hosting Guide by AnonDev"
22-
href="https://gist.github.com/anondev-sudo/24978429b85b44348bcff5c0885afe82"
23-
/>
24-
2510
### Hosting on [Northflank](https://northflank.com/)
2611

2712
Northflank is a Platform as a Service (PaaS) like Railway that offers abilities to run micro-services like bots,
@@ -51,5 +36,6 @@ They will not charge your card if you go over resource usage as you have limited
5136
ALwN4cq7wQvVMBxDHYaxCn0UduolhZ6Rwo/qb53/83/+AFhNZSejAD8zAAAAAElFTkSuQmCC" alt="drawing" width="25"/>
5237
}
5338
title="Northflank Guide by raidensakura"
54-
href="#"
39+
href="https://blog.project-mei.xyz/posts/2023-08-02-hosting-modmail-on-northflank.html"
40+
target="_blank"
5541
/>

docs/pages/configuration.mdx

Whitespace-only changes.

docs/pages/getting-started.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -39,11 +39,11 @@ The first step in setting up Modmail is to create a Discord bot.
3939
Head over to the Discord Developer Portal and create a new application.
4040

4141
Once you've created a new application, head over to the Bot tab and create a new bot.
42-
<Image src="/create-bot.png" alt="Hello" width={500} height={500} />
42+
<Image src="/create-bot.png" alt="Hello" width={850} height={500} />
4343
<sub>Navigate to the Bot tab on the sidebar. On this page, you can also edit the About Me section of your bot.</sub>
4444

4545
Click Add bot to create the bot. After adding a bot, reset the token and copy and store the newly generated token in your Text editor for later use.
46-
<Image src="/reset-token.png" alt="Hello" width={500} height={500} />
46+
<Image src="/reset-token.png" alt="Hello" width={850} height={500} />
4747
<Callout emoji="⚠️" type="warning">
4848
Make sure to keep this token private! Anyone who has this token can control your bot and potentially cause malicious damage.
4949
</Callout>
@@ -66,7 +66,7 @@ We recommend keeping this toggled off to save computational resources.
6666

6767
Navigate back to the General Information tab and copy the application ID.
6868
Click Copy to copy the application ID. This is also known as your "Bot ID".
69-
<Image src="/bot-id.png" alt="Hello" width={500} height={500} />
69+
<Image src="/bot-id.png" alt="Hello" width={850} height={500} />
7070

7171
Using the following URL as template, replace `YOUR-ID-HERE` with the ID you just copied. Do not change anything else! Open a new browser tab and go to that URL.
7272
```
@@ -75,7 +75,7 @@ https://discord.com/oauth2/authorize?scope=bot&permissions=416075476184&client_i
7575

7676
Discord should prompt you to choose a server to invite your bot, followed by a list of permissions. Scroll to the bottom and click Authorize.
7777
Choose your server to invite, then click Continue.
78-
<Image src="/invite-bot.png" alt="Hello" width={500} height={500} />
78+
<Image src="/invite-bot.png" alt="Hello" width={850} height={500} />
7979

8080
Scroll to the bottom and click Authorize. Don't un-check any permissions. Only Administrator is optional.
8181
<Callout emoji="ℹ️" type="info">
@@ -108,29 +108,29 @@ asking you to "tell us a few things about yourself and your project". You can an
108108
In the next step for "deploy a cloud database", choose the **Shared** option. Choose the region that's closest to where you're hosting your bot.
109109
Make sure the **Cluster Tier** is set to **M0 Sandbox** and the price shows as **FREE**.
110110

111-
<Image src="/mongo-shared.png" alt="Hello" width={500} height={500} />
111+
<Image src="/mongo-shared.png" alt="Hello" width={850} height={500} />
112112
<sub>Choose the free **Shared** option and click **Create**.</sub>
113113

114114
On the following **Security Quickstart** page, do the following:
115115

116116
1. Authentication method: _Username and Password_
117117
```Username: `modmail`
118118
Password: Click **Autogenerate Secure Password** - don't type your own password!```
119-
<Image src="/mongo-password.png" alt="Hello" width={500} height={500} />
119+
<Image src="/mongo-password.png" alt="Hello" width={850} height={500} />
120120
2. Copy and **save the password** into your text editor, you will need this for later.
121121
From now on, we will be referring to these credentials as the _database username_ and _database password_.
122122
3. Click **Create User**.
123123
4. Scroll down, we will be connecting from: _My Local Environment_
124124
5. Set IP address as **`0.0.0.0/0`** and anything for the description.
125-
<Image src="/mongo-ip.png" alt="Hello" width={500} height={500} />
125+
<Image src="/mongo-ip.png" alt="Hello" width={850} height={500} />
126126
**You must** set the IP address exactly to this, unless you know what you're doing.
127127
**Do not** set it to anything else or click add my current IP address. This allows Modmail to connect to your database.
128128
6. Click **Add Entry**.
129129

130130
Next, we will need to generate a MongoDB connection string. Simply click `Connect` on the main dashboard,
131131
choose `Connect your application`, then copy the connection string (the default driver is fine) and paste it into your Notepad.
132132

133-
<Image src="/mongo-connect.png" alt="Hello" width={500} height={500} />
133+
<Image src="/mongo-connect.png" alt="Hello" width={850} height={500} />
134134

135135
If you followed all the steps so far, your Notepad should contain three lines:
136136
the bot token, the database password, and the MongoDB connection string. For example:

docs/pages/index.mdx

Lines changed: 47 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@ import Image from 'next/image'
22

33
# Introduction
44

5+
This is the documentation for a fork of [modmail-dev/Modmail](https://github.com/modmail-dev/Modmail), a Discord Modmail bot written in Python.
6+
57
Modmail is a self-hosted Python Discord bot for your server.
68
It serves as a shared inbox for server staff to communicate with their users in a seamless way.
79
Users create a ticket by direct-messaging the bot on Discord, and it will create a ticket channel
@@ -10,11 +12,11 @@ in your chosen server relaying the messages between you and the server staff sea
1012
It comes with many advanced features and customizable configurations to help you handle tickets smoothly,
1113
such as custom snippets, command aliases, adding multiple users and so on.
1214

13-
<Image src="/header-pic.png" alt="Hello" width={500} height={500} />
15+
<br /><Image src="/header-pic.png" alt="Hello" width={500} height={500} />
1416

15-
With the built-in Logviewer plugin, you can also view previous tickets created on your browser.
17+
With the Logviewer plugin, you can also view previous tickets created on your browser:
1618

17-
<Image src="/logviewer.png" alt="Hello" width={500} height={500} />
19+
<br /><Image src="/logviewer.png" alt="Hello" width={500} height={500} />
1820

1921
## Features
2022

@@ -46,10 +48,47 @@ With the built-in Logviewer plugin, you can also view previous tickets created o
4648

4749
This list is ever-growing thanks to active development by our exceptional contributors. See a full list of available commands by using the `?help` command.
4850

49-
## Contributing to Modmail
51+
## Contributing to this fork
52+
53+
import { useData } from 'nextra/data'
5054

51-
* Be a stargazer by giving the repository a ⭐
52-
* Fork the repository and Submit a Pull Request containing your features 🔧
53-
* Help us find the bugs and submit a GitHub Issue 🐛
55+
export const getStaticProps = ({ params }) => {
56+
return fetch(`https://api.github.com/repos/raidensakura/modmail`)
57+
.then(res => res.json())
58+
.then(repo => ({
59+
props: {
60+
ssg: {
61+
stars: repo.stargazers_count,
62+
forks: repo.forks_count,
63+
issues: repo.open_issues_count
64+
}
65+
},
66+
revalidate: 60
67+
}))
68+
}
69+
70+
export const Stars = () => {
71+
const { stars } = useData()
72+
return <strong>{stars}</strong>
73+
}
74+
75+
export const Forks = () => {
76+
const { forks } = useData()
77+
return <strong>{forks}</strong>
78+
}
5479

55-
You can also support the original project on their [GitHub repository](https://github.com/modmail-dev/modmail).
80+
export const Issues = () => {
81+
const { issues } = useData()
82+
return <strong>{issues}</strong>
83+
}
84+
85+
Support the project on our [GitHub repository](https://github.com/raidensakura/modmail).
86+
87+
[<img src="https://img.shields.io/badge/ko--fi.com%2Fraidensakura-d11df9?logo=kofi&logoColor=white&label=Support%20me&color=%23ff5b62"/>](https://ko-fi.com/raidensakura)
88+
89+
* [Be a stargazer](https://github.com/raidensakura/modmail/stargazers) by giving the repository a ⭐
90+
<br /><sub>This fork has <Stars /> stargazers on GitHub!</sub>
91+
* [Fork the repository](https://github.com/raidensakura/modmail/forks) and [Submit a Pull Request](https://github.com/raidensakura/modmail/pulls) containing your features 🔧
92+
<br /><sub>Forking fork! This fork also has <Forks /> other fork(s) on GitHub!</sub>
93+
* Help us find issues with the bot and [submit a GitHub Issue](https://github.com/raidensakura/modmail/issues) 🐛
94+
<br /><sub>This fork currently has <Issues /> open issues on GitHub!</sub>

docs/pages/installation.mdx

Lines changed: 0 additions & 11 deletions
This file was deleted.

docs/pages/installation/almalinux.mdx

Lines changed: 0 additions & 97 deletions
This file was deleted.

0 commit comments

Comments
 (0)