Update README.md

This commit is contained in:
Thomas
2025-10-05 13:49:07 +02:00
committed by GitHub
parent 759910802c
commit 231de42412

125
README.md
View File

@@ -2,72 +2,87 @@
[📄 CHANGELOG.md](CHANGELOG.md) · [📄 INSTALL.md](INSTALL.md) · [📄 ROADMAP.md](ROADMAP.md) [📄 CHANGELOG.md](CHANGELOG.md) · [📄 INSTALL.md](INSTALL.md) · [📄 ROADMAP.md](ROADMAP.md)
# README — DA # Twitch PHP Bot 🇩🇰 / 🇬🇧
Dette projekt er et **PHP-baseret starterkit** til en **Moderator Platform** til Mix It Up Bot, som kører på **Windows** med lokale brugere (uden Twitch-login). Systemet giver **SU-Admin** og **Moderatorer** adgang til administration af kommandoer, filer, events m.m. direkte via en webgrænseflade. En letvægts **Twitch Chat Bot** skrevet i **PHP**, der kører direkte på en webserver som **XAMPP** eller **Apache**, uden Node.js eller eksterne services.
Webinterface til styring af kommandoer, timers, polls, giveaways, loyalty points og brugere.
## Funktioner
- Login-system (lokale brugere gemt i MySQL)
- Roller: SU-Admin, Moderator, Redaktør
- Dashboard med basisfunktioner
- Kommandooversigt (stub klar til at blive udvidet)
- Fil-editor (`storage/files/*.txt`) hvor Moderator og SU-Admin kan redigere
- Database-opsætning (`schema.sql` + `seed.sql`)
- Klar til integration med Mix It Up API via `app/MixItUpService.php`
## Installation (Windows + XAMPP)
1. Installer **XAMPP** (Apache, PHP 8.2+, MariaDB).
2. Opret database, kør `database/schema.sql` + `database/seed.sql`.
3. Placer mappen i `C:\xampp\htdocs\mod-platform`.
4. Ret `app/config.php` (DB login, base_url, MixItUp API).
5. Start Apache & MySQL i XAMPP.
6. Gå til `http://localhost/mod-platform/public/login.php`.
7. Log ind med: **admin / ChangeMe!2025** (skift straks kodeord!).
--- ---
# README — EN ## ✨ Features
This project is a **PHP-based starter kit** for a **Moderator Platform** for Mix It Up Bot, running on **Windows** with local users (no Twitch login). The system provides **SU-Admin** and **Moderators** access to manage commands, files, events, and more via a web interface. - Twitch IRC chat-bot (PHP socket)
- Dashboard med login og rettigheder
## Features - Kommandoer med placeholders (`@$user`, `@$target`, `{uptime}`, `!points`, …)
- Login system (local users stored in MySQL) - Live log (SSE + WebSocket fallback)
- Roles: SU-Admin, Moderator, Editor - Timers, Polls, Giveaways
- Dashboard with basic controls - Loyalty points + Bets, Slots, Raffle
- Commands overview (stub ready to be expanded) - Helix API-integration (subs, mods, VIPs, cheerers, uptime, osv.)
- File editor (`storage/files/*.txt`) where Moderator and SU-Admin can edit - Rettighedsstyring (Admin / Mod / User)
- Database setup (`schema.sql` + `seed.sql`) - SQLite database ingen ekstern DB
- Ready for Mix It Up API integration via `app/MixItUpService.php` - Dansk/Engelsk dokumentation
## Installation (Windows + XAMPP)
1. Install **XAMPP** (Apache, PHP 8.2+, MariaDB).
2. Create database, run `database/schema.sql` + `database/seed.sql`.
3. Place project folder in `C:\xampp\htdocs\mod-platform`.
4. Edit `app/config.php` (DB login, base_url, MixItUp API).
5. Start Apache & MySQL in XAMPP.
6. Open `http://localhost/mod-platform/public/login.php`.
7. Login with: **admin / ChangeMe!2025** (change password immediately!).
--- ---
# Beskrivelse — DA ## ⚙️ Krav / Requirements
Moderator Platform er udviklet for at give en samlet og brugervenlig webgrænseflade til styring af Mix It Up Bot. Den gør det muligt for moderatorer og admins at: - PHP **8.1+**
- Oprette og redigere kommandoer - Extensions: `pdo_sqlite`, `curl`, `mbstring`, `json`
- Administrere events og timere - Webserver (XAMPP, Apache, Nginx …)
- Se og ændre i tekstfiler (fx citater) - Twitch OAuth-token: [https://twitchapps.com/tmi/](https://twitchapps.com/tmi/)
- Udvides med moderation, statistik og logs - (Valgfrit) Node.js + `ws` for WebSocket-live-log
Målet er at skabe et fleksibelt og sikkert værktøj, som kan køre direkte på din Windows-server sammen med Mix It Up Bot.
--- ---
# Description — EN ## 🚀 Installation
Moderator Platform is built to provide a unified and user-friendly web interface for managing Mix It Up Bot. It allows moderators and admins to: Se [INSTALL.md](INSTALL.md) for komplette trin.
- Create and edit commands
- Manage events and timers
- View and edit text files (e.g., quotes)
- Extend with moderation, statistics, and logs
The goal is to deliver a flexible and secure tool that runs directly on your Windows server alongside Mix It Up Bot. ---
## 🔐 Login
Efter første installation:
- Brugernavn: `admin`
- Adgangskode: `lan2025`
(kan ændres under **Indstillinger**)
---
## 📁 Struktur
/bot
├── /data
│ ├── app.db
│ ├── bot.log
│ └── settings.json
├── /web
│ ├── index.php # Dashboard
│ ├── settings.php # Indstillinger + brugere
│ ├── commands.php # Kommandoer
│ ├── timers.php # Timers
│ ├── poll.php # Polls
│ ├── points.php # Loyalty Points
│ ├── db.php, guard.php, api.php …
├── bot.php # PHP-socket bot
├── ws_server.js # WebSocket server
├── .env # Twitch credentials
yaml
Kopier kode
---
## 📄 Filer
- [CHANGELOG.md](CHANGELOG.md) versionshistorik
- [ROADMAP.md](ROADMAP.md) planlagte funktioner
- [LICENSE](LICENSE) MIT-licens
---
## 🧡 Credits
Udviklet af **Thomas / DjGulvBasS**
Med hjælp fra **ChatGPT (OpenAI)**
MIT Licenseol that runs directly on your Windows server alongside Mix It Up Bot.