User_Controll plugin

🛡️ User_Controll Plugin for AVideo

The User_Controll plugin empowers administrators to secure and manage their AVideo platform by providing tools to:

• Log login activity
• Ban users and IP addresses
• Interrupt active live streams
• ✅ Define upload limits per user group (configurable but not enforced by default)

⚠️ Live stream control requires the NGINX RTMP control module to be installed and enabled on your server.

---

🔐 Features

Feature	Description
IP & Login Tracking	Automatically logs all login attempts with associated IP addresses
Ban Users or IPs	Instantly block site access and streaming for specific users or IPs
Stop Active Live Streams	Immediately disconnects any live broadcast from a banned user
Upload Limit Per User Group	(New) Lets you define how many videos each user in a group may upload hourly

---

🚫 How to Ban a User or IP

1. Go to Admin Panel → Users.
2. Find the user you want to block.
3. Click the "Ban" button in that user’s row.
4. You will see a list of all IPs that the user has logged in with.
5. Select one or more IPs and click "Add".

✅ Once banned, the user cannot access the platform using those IPs. If currently broadcasting, their live stream will be forcibly stopped.

---

📈 Login and IP Tracking

• Navigate to Plugins → User_Controll.
• A history table is displayed showing login attempts, usernames, and IPs.
• This is useful for auditing and identifying suspicious access patterns.

---

📤 Limiting Uploads Per Hour (Per User Group)

What It Does

This feature lets you configure a maximum number of uploads per user in a specific user group, within a 1-hour window.

⚠️ The plugin stores these limits, but does not enforce them on its own. You must integrate the validation manually into your upload workflow if enforcement is required.

---

How to Configure

1. Go to Plugins → User_Controll
2. Open the “Max Uploads Per Hour” tab
3. Click “Create”
4. Fill out the following:
   • User Group – select one (e.g., Default, Premium, Subscriber)
   • Max Uploads – select:
     • From 1 to 9 (in steps of 1)
     • From 10 to 90 (in steps of 10)
5. Click Save

Once saved, the rule will be applied to all users in the selected group.

---

Example

Group	Limit	Result
Default	5 uploads/hour	Each user in the Default group can upload 5 videos per hour.
Premium	20 uploads/hour	Premium users can upload up to 20 videos every 60 minutes.

---

⚠️ Enforcement Disclaimer

The upload limit rule is saved and can be viewed in the admin interface, but this plugin does not enforce it automatically during uploads.

You must manually integrate the logic in your upload controller (e.g., during video::save) to check:

• Current time
• User’s group
• Number of videos uploaded in the last hour
• Apply restriction accordingly

Let me know if you'd like help implementing this enforcement check.

---

🧹 Managing Rules and Bans

Action	Location
Remove IP Ban	User_Controll → IP List → Remove
Delete Upload Limit	User_Controll → Max Uploads Per Hour → 🗑️

---

📌 Summary

Area	Description
Plugin Location	Admin Panel → Plugins → User_Controll
Required Role	Admin
Requires NGINX Control	Only for stopping live streams
Upload Limit Scope	Per user group (not per individual user)
Enforcement	Manual integration required for upload limiting