|
1 | | -# Discord Sollicitatie Bot |
| 1 | +# Discord Application Bot |
2 | 2 |
|
3 | | -Deze Discord bot maakt het mogelijk om sollicitaties voor verschillende functies binnen je Discord server te beheren via een eenvoudig formulier systeem. Sollicitaties worden ingediend via pop-up formulieren direct in Discord en de resultaten worden naar een aangewezen kanaal gestuurd. |
| 3 | +This Discord bot enables you to manage applications for various positions within your Discord server through a simple form system. Applications are submitted via pop-up forms directly in Discord, and the results are sent to a designated channel. |
4 | 4 |
|
5 | | -## Installatie |
| 5 | +## Installation |
6 | 6 |
|
7 | | -Volg deze stappen om de bot te installeren en op te zetten: |
| 7 | +Follow these steps to install and set up the bot: |
8 | 8 |
|
9 | | -1. **Vereisten:** |
10 | | - * Python 3.8 of hoger is vereist. Je kunt Python downloaden van [python.org](https://www.python.org/). |
11 | | - * Zorg ervoor dat je `pip` hebt geïnstalleerd (meestal meegeleverd met Python). |
| 9 | +1. **Prerequisites:** |
| 10 | + * Python 3.8 or higher is required. You can download Python from [python.org](https://www.python.org/). |
| 11 | + * Ensure you have `pip` installed (usually included with Python). |
12 | 12 |
|
13 | | -2. **Installeer de `discord.py` library:** |
14 | | - Open je terminal of command prompt en voer het volgende commando uit: |
| 13 | +2. **Install the `discord.py` library:** |
| 14 | + Open your terminal or command prompt and run the following command: |
15 | 15 | ```bash |
16 | 16 | pip install discord.py |
17 | 17 | ``` |
18 | 18 |
|
19 | | -3. **Maak een Discord Bot Applicatie:** |
20 | | - * Ga naar de [Discord Developer Portal](https://discord.com/developers/applications). |
21 | | - * Klik op "Create New Application". |
22 | | - * Geef je applicatie een naam (bijvoorbeeld "Sollicitatie Bot") en klik op "Create". |
23 | | - * Ga naar het "Bot" tabblad in het menu aan de linkerkant. |
24 | | - * Klik op "Add Bot". |
25 | | - * Bevestig door op "Yes, do it!" te klikken. |
26 | | - |
27 | | -4. **Verkrijg je Bot Token:** |
28 | | - * Op de "Bot" pagina, klik op "Reset Token". |
29 | | - * **Let op:** Dit token is geheim. Deel het met niemand! Kopieer het token en bewaar het veilig. |
30 | | - |
31 | | -5. **Verkrijg Kanaal en Rol ID's:** |
32 | | - * **Zet Developer Mode aan in Discord:** Ga naar Discord Instellingen (tandwiel naast je gebruikersnaam) > Geavanceerd > Developer Mode (inschakelen). |
33 | | - * **Kopieer de Kanaal ID voor sollicitaties:** Ga naar het Discord kanaal waar je de ingediende sollicitaties wilt ontvangen. Rechtermuisklik op het kanaal en kies "ID kopiëren". |
34 | | - * **Kopieer de Notificatie Rol ID:** Ga naar de server instellingen > Rollen. Rechtermuisklik op de rol die je wilt taggen wanneer er een nieuwe sollicitatie is. Kies "ID kopiëren". |
35 | | -
|
36 | | -6. **Configureer de Bot Code:** |
37 | | - * Open het `sollicitatie_bot.py` bestand met een teksteditor. |
38 | | - * **Vervang de placeholders:** |
39 | | - * `BOT_TOKEN = 'VUL_IN'` - Vervang dit met het **Bot Token** dat je in stap 4 hebt gekopieerd. |
40 | | - * `NOTIFICATIE_ROL_ID = VUL_IN` - Vervang dit met de **Notificatie Rol ID** die je in stap 5 hebt gekopieerd. |
41 | | - * `KANAL_ID_VOOR_SOLLICITATIES = VUL_IN` - Vervang dit met de **Kanaal ID voor sollicitaties** die je in stap 5 hebt gekopieerd. |
42 | | -
|
43 | | -7. **Start de Bot:** |
44 | | - * Open je terminal of command prompt. |
45 | | - * Navigeer naar de map waar je `sollicitatie_bot.py` hebt opgeslagen. |
46 | | - * Voer het volgende commando uit om de bot te starten: |
| 19 | +3. **Create a Discord Bot Application:** |
| 20 | + * Go to the [Discord Developer Portal](https://discord.com/developers/applications). |
| 21 | + * Click on "Create New Application". |
| 22 | + * Give your application a name (e.g., "Application Bot") and click "Create". |
| 23 | + * Go to the "Bot" tab in the menu on the left. |
| 24 | + * Click on "Add Bot". |
| 25 | + * Confirm by clicking "Yes, do it!". |
| 26 | + |
| 27 | +4. **Obtain your Bot Token:** |
| 28 | + * On the "Bot" page, click on "Reset Token". |
| 29 | + * **Important:** This token is secret. Do not share it with anyone! Copy the token and store it safely. |
| 30 | + |
| 31 | +5. **Obtain Channel and Role IDs:** |
| 32 | + * **Enable Developer Mode in Discord:** Go to Discord Settings (gear icon next to your username) > Advanced > Developer Mode (toggle on). |
| 33 | + * **Copy the Channel ID for applications:** Go to the Discord channel where you want to receive submitted applications. Right-click on the channel and choose "Copy ID". |
| 34 | + * **Copy the Notification Role ID:** Go to Server Settings > Roles. Right-click on the role you want to tag when a new application is submitted. Choose "Copy ID". |
| 35 | + |
| 36 | +6. **Configure the Bot Code:** |
| 37 | + * Open the `sollicitatie_bot.py` file with a text editor. |
| 38 | + * **Replace the placeholders:** |
| 39 | + * `BOT_TOKEN = 'FILL_IN'` - Replace this with the **Bot Token** you copied in step 4. |
| 40 | + * `NOTIFICATIE_ROL_ID = FILL_IN` - Replace this with the **Notification Role ID** you copied in step 5. |
| 41 | + * `KANAL_ID_VOOR_SOLLICITATIES = FILL_IN` - Replace this with the **Channel ID for applications** you copied in step 5. |
| 42 | + |
| 43 | +7. **Start the Bot:** |
| 44 | + * Open your terminal or command prompt. |
| 45 | + * Navigate to the folder where you saved `sollicitatie_bot.py`. |
| 46 | + * Run the following command to start the bot: |
47 | 47 | ```bash |
48 | 48 | python sollicitatie_bot.py |
49 | 49 | ``` |
50 | | - * Je zou een bericht in de terminal moeten zien dat de bot is ingelogd. |
| 50 | + * You should see a message in the terminal indicating that the bot has logged in. |
51 | 51 |
|
52 | | -8. **Nodig de Bot uit naar je Server:** |
53 | | - * Ga terug naar de [Discord Developer Portal](https://discord.com/developers/applications) en selecteer je bot applicatie. |
54 | | - * Ga naar "OAuth2" > "URL Generator". |
55 | | - * Vink in "Scopes" de opties `bot` en `applications.commands` aan. |
56 | | - * Selecteer in "Bot Permissions" de permissies die je bot nodig heeft (minimaal "View Channels", "Send Messages", "Read Message History", "Use Application Commands"). |
57 | | - * Kopieer de gegenereerde URL. |
58 | | - * Open de URL in je browser en selecteer de server waar je de bot wilt toevoegen. Klik op "Authorize". |
| 52 | +8. **Invite the Bot to your Server:** |
| 53 | + * Go back to the [Discord Developer Portal](https://discord.com/developers/applications) and select your bot application. |
| 54 | + * Go to "OAuth2" > "URL Generator". |
| 55 | + * In "Scopes", check the options `bot` and `applications.commands`. |
| 56 | + * In "Bot Permissions", select the permissions your bot needs (at least "View Channels", "Send Messages", "Read Message History", "Use Application Commands"). |
| 57 | + * Copy the generated URL. |
| 58 | + * Open the URL in your browser and select the server where you want to add the bot. Click "Authorize". |
59 | 59 |
|
60 | | -## Commando's |
| 60 | +## Commands |
61 | 61 |
|
62 | | -Zodra de bot is toegevoegd aan je server, kun je de volgende commando's gebruiken door `/` te typen in een tekstkanaal: |
| 62 | +Once the bot is added to your server, you can use the following commands by typing `/` in a text channel: |
63 | 63 |
|
64 | | -* **`/solliciteren`**: Start de sollicitatie procedure. |
65 | | - * **Gebruik:** Typ `/solliciteren` in een kanaal en druk op Enter. De bot zal een menu weergeven waarin je een functie kunt selecteren waarvoor je wilt solliciteren. Na het selecteren van een functie, opent er een pop-up formulier waar je de sollicitatie vragen kunt beantwoorden. |
66 | | -* **`/functies`**: Bekijk de beschikbare functies om voor te solliciteren. |
67 | | - * **Gebruik:** Typ `/functies` in een kanaal en druk op Enter. De bot zal een lijst van de huidige beschikbare functies weergeven, alleen zichtbaar voor jou. |
68 | | -* **`/bothelp`**: Krijg hulp en informatie over de bot commando's. |
69 | | - * **Gebruik:** Typ `/bothelp` in een kanaal en druk op Enter. De bot zal een help bericht weergeven met informatie over alle beschikbare commando's, alleen zichtbaar voor jou. |
| 64 | +* **`/solliciteren`**: Start the application procedure. |
| 65 | + * **Usage:** Type `/solliciteren` in a channel and press Enter. The bot will display a menu where you can select a position you want to apply for. After selecting a position, a pop-up form will open where you can answer the application questions. |
| 66 | +* **`/functies`**: View the available positions to apply for. |
| 67 | + * **Usage:** Type `/functies` in a channel and press Enter. The bot will display a list of currently available positions, visible only to you. |
| 68 | +* **`/bothelp`**: Get help and information about the bot commands. |
| 69 | + * **Usage:** Type `/bothelp` in a channel and press Enter. The bot will display a help message with information about all available commands, visible only to you. |
70 | 70 |
|
71 | | -## Aanpassen van Functies en Vragen |
| 71 | +## Customizing Positions and Questions |
72 | 72 |
|
73 | | -Je kunt de bot eenvoudig aanpassen door de lijsten `FUNCTIES` en de dictionary `FORMULIER_VRAGEN` in het `sollicitatie_bot.py` bestand te bewerken: |
| 73 | +You can easily customize the bot by editing the `FUNCTIES` lists and the `FORMULIER_VRAGEN` dictionary in the `sollicitatie_bot.py` file: |
74 | 74 |
|
75 | | -* **`FUNCTIES`**: Verander de lijst van functienamen om de beschikbare functies voor sollicitaties aan te passen. |
76 | | -* **`FORMULIER_VRAGEN`**: Pas de vragen per functie aan. Voeg meer vragen toe, verwijder vragen, of verander de tekst van de vragen. Zorg ervoor dat de functienamen in `FORMULIER_VRAGEN` overeenkomen met die in de `FUNCTIES` lijst. Je kunt ook Unicode iconen toevoegen aan de vragen om ze visueel aantrekkelijker te maken. |
| 75 | +* **`FUNCTIES`**: Change the list of position names to customize the available positions for applications. |
| 76 | +* **`FORMULIER_VRAGEN`**: Customize the questions per position. Add more questions, remove questions, or change the text of the questions. Ensure that the position names in `FORMULIER_VRAGEN` match those in the `FUNCTIES` list. You can also add Unicode icons to the questions to make them visually appealing. |
77 | 77 |
|
78 | | -**Let op:** Na het wijzigen van de code, moet je de bot stoppen en opnieuw starten om de veranderingen door te voeren. |
| 78 | +**Note:** After modifying the code, you must stop and restart the bot for the changes to take effect. |
79 | 79 |
|
80 | | -## Probleemoplossing |
| 80 | +## Troubleshooting |
81 | 81 |
|
82 | | -* **Bot commando's verschijnen niet:** Zorg ervoor dat de bot de permissie "Applicatiecommando's" heeft in je server rollen instellingen. Nodig de bot ook opnieuw uit met de `applications.commands` scope (zie installatie stap 8). |
83 | | -* **Foutmelding "Er is een probleem met het indienen van je sollicitatie...":** Controleer **nauwkeurig** of de `NOTIFICATIE_ROL_ID` en `KANAL_ID_VOOR_SOLLICITATIES` correct zijn ingesteld in de code en dat de bot permissies heeft om berichten te sturen naar het sollicitatiekanaal. Bekijk de console output van de bot voor meer gedetailleerde foutmeldingen. |
| 82 | +* **Bot commands do not appear:** Ensure that the bot has the "Use Application Commands" permission in your server role settings. Also, re-invite the bot with the `applications.commands` scope (see installation step 8). |
| 83 | +* **Error message "There is a problem submitting your application...":** Double-check **carefully** whether the `NOTIFICATIE_ROL_ID` and `KANAL_ID_VOOR_SOLLICITATIES` are set correctly in the code and that the bot has permissions to send messages to the application channel. Check the console output of the bot for more detailed error messages. |
84 | 84 |
|
85 | | -Voor vragen of hulp, bekijk de GitHub repository: [https://github.com/CustomCodex](https://github.com/CustomCodex) |
| 85 | +For questions or assistance, visit the GitHub repository: [https://github.com/CustomCodex](https://github.com/CustomCodex) |
86 | 86 |
|
87 | 87 | --- |
88 | | -_Deze sollicitatie bot is ontwikkeld door Bjorn L (CustomCodex) op Github._ |
| 88 | +_This application bot is developed by Bjorn L (CustomCodex) on Github._ |
0 commit comments