[![ReadMeSupportPalestine](https://raw.githubusercontent.com/Safouene1/support-palestine-banner/master/banner-project.svg)](https://s.id/standwithpalestine)

# PHPNuxBill Advanced Mode - Enhanced Mikrotik Billing System

![PHPNuxBill](install/img/logo.png)

## 🚀 Advanced Mode Edition

**This is the advanced version of PHPNuxBill** - a highly optimized and refined Mikrotik billing solution featuring:

- ✅ **Significantly Reduced Errors** - Enhanced error handling and bug fixes
- ⚡ **Superior Performance** - Optimized code execution and database queries
- 🔒 **Enhanced Security** - Improved security measures and vulnerability patches
- 🎨 **Better User Experience** - Streamlined interface and improved workflows
- 📈 **Increased Stability** - More robust and reliable operation
- 🔧 **Advanced Features** - Additional capabilities beyond the standard version

---

## ✨ Core Features

### Billing & Voucher Management
- **Advanced Voucher Generator** with customizable templates and print layouts
- Self-registration system with validation controls
- User balance management with automatic tracking
- Auto-renewal packages using customer balance
- Invoice generation and management

### Router Integration
- Multi-router Mikrotik support with load balancing
- Hotspot & PPPoE authentication
- [Freeradius integration](https://github.com/hotspotbilling/phpnuxbill/wiki/FreeRadius) with database support
- Real-time connection monitoring

### Communication & Notifications
- WhatsApp notifications for customers
- Telegram alerts for administrators
- SMS validation for secure login
- Email notification system
- Customizable message templates

### Advanced Features
- Multi-language support for global deployment
- Payment gateway integration (extensible)
- Plugin architecture for easy customization
- API access for third-party integrations
- Comprehensive reporting and analytics
- Responsive dashboard design

See [How it Works / Cara Kerja](https://github.com/hotspotbilling/phpnuxbill/wiki/How-It-Works---Cara-kerja)

---

## 🔌 Extensions & Integrations

### Payment Gateways
Extensive payment gateway support for global and local payment methods.
- [Available Payment Gateways](https://github.com/orgs/hotspotbilling/repositories?q=payment+gateway)

### Plugins
Extend functionality with community-developed plugins.
- [Available Plugins](https://github.com/orgs/hotspotbilling/repositories?q=plugin)

**Easy Installation**: Download and install payment gateways and plugins directly from the built-in Plugin Manager.

---

## 💻 System Requirements

### Server Requirements
PHPNuxBill Advanced Mode is designed to run on most modern web servers with proper PHP and MySQL configuration.

### Minimum Specifications
- **Operating System**: Linux (recommended) or Windows Server
- **PHP Version**: 8.2 or higher (required)
- **Database**: MySQL 4.1.x or higher / MariaDB 10.x+
- **PHP Extensions**:
  - PDO & MySQLi (both required)
  - GD2 Image Library
  - CURL
  - ZIP
  - Mbstring
  - OpenSSL
  - JSON

### Recommended Environment
- **OS**: Ubuntu Server 20.04+ / Debian 11+ / CentOS 8+
- **Web Server**: Apache 2.4+ or Nginx 1.18+
- **PHP**: 8.2 or 8.3
- **Database**: MySQL 8.0+ or MariaDB 10.6+
- **Memory**: 512MB RAM minimum, 1GB+ recommended

### Additional Notes
- Can be deployed on Raspberry Pi devices
- Linux is strongly recommended over Windows for easier cron job configuration and better performance
- SSL certificate recommended for production environments

---

## 📦 Installation

For detailed installation instructions, please visit:
[Installation Guide](https://github.com/hotspotbilling/phpnuxbill/wiki)

**Quick Start:**
1. Upload files to your web server
2. Create a MySQL database
3. Navigate to `/install` in your browser
4. Follow the installation wizard
5. Configure your Mikrotik routers

---

## 🛠️ Configuration

### Freeradius Setup
Full support for [Freeradius with Database](https://github.com/hotspotbilling/phpnuxbill/wiki/FreeRadius) integration for advanced authentication scenarios.

### Cron Jobs
Configure automated tasks for:
- Package expiration checks
- Auto-renewal processing
- Reminder notifications
- System maintenance

---

## 📝 Changelog & Updates

Stay updated with the latest improvements and features:
- [CHANGELOG.md](CHANGELOG.md) - Version history and updates
- [IMPROVEMENTS_ROADMAP.md](IMPROVEMENTS_ROADMAP.md) - Future enhancements

---

## 💬 Community & Support

### Free Community Support
Get help from the community and share your experience:
- [GitHub Discussions](https://github.com/hotspotbilling/phpnuxbill/discussions) - Ask questions and share ideas
- [Telegram Group](https://t.me/phpmixbill) - Join our active community

### Professional Technical Support
This software is **Free and Open Source** under GNU GPL v2 license.

**Please Note:**
- The software comes without warranty
- Community support is available for free in discussion forums
- Professional technical support is available: **Starting from Rp 500.000 or $50 USD**

For paid technical support, contact: [Telegram @ibnux](https://t.me/ibnux)

---

## 📄 License

**GNU General Public License version 2 or later**

See [LICENSE](LICENSE) file for full license text.

This is free software: you are free to change and redistribute it under the terms of the GNU GPL v2.

---

## 💝 Support Development

### Donate to ibnux
Support continued development and improvements:

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/ibnux)

**Bank Transfer (Indonesia):**
- **BCA**: 5410454825
- **Mandiri**: 163-000-1855-793
- **a.n**: Ibnu Maksum

---

## 🏆 Sponsors

Special thanks to our sponsors who support this project:
- [mixradius.com](https://mixradius.com/) - Paid Services Billing Radius
- [mlink.id](https://mlink.id) - Network Solutions
- [sonyinside](https://github.com/sonyinside) - Development Contributor

**Interested in becoming a sponsor?** Contact us for sponsorship opportunities.

---

## 🙏 Contributors

We appreciate all the amazing people contributing to make PHPNuxBill better:

<a href="https://github.com/hotspotbilling/phpnuxbill/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=hotspotbilling/phpnuxbill" />
</a>

**Want to contribute?** Check our [contribution guidelines](https://github.com/hotspotbilling/phpnuxbill/discussions) and submit your pull requests!

---

## 🌟 Why Choose Advanced Mode?

This enhanced version provides:
- **Fewer bugs and errors** for smoother operation
- **Better code quality** with improved structure and documentation
- **Enhanced features** that go beyond the standard release
- **Performance optimizations** for faster response times
- **Regular improvements** based on community feedback
- **Production-ready** with extensive testing

Perfect for ISPs, hotspot providers, and network administrators seeking a reliable, feature-rich billing solution.

---

*Built with ❤️ for the network administration community*
