+
+{% endblock %}
+```
+
+**`templates/myFirstPlugin/settings.html`:**
+
+```html
+{% extends "baseTemplate/index.html" %}
+{% load static %}
+{% load i18n %}
+
+{% block title %}
+ My First Plugin Settings - {% trans "CyberPanel" %}
+{% endblock %}
+
+{% block content %}
+
+
+
+
+{% trans "My First Plugin" %}
+Version {{ version }}
+
+
+{% endblock %}
+```
+
+### Step 3: Test Your Plugin Locally
+
+Before installing, verify your plugin structure:
+
+```bash
+# Check file structure
+cd /home/cyberpanel/plugins/myFirstPlugin
+tree -L 3
+
+# Verify Python syntax
+python3 -m py_compile views.py urls.py
+
+# Check XML validity
+xmllint --noout meta.xml
+```
+
+### Step 4: Install Your Plugin
+
+1. **Via CyberPanel UI:**
+ - Navigate to **Plugins** → **Installed Plugins**
+ - Your plugin should appear in the list
+ - Click **Install** button
+ - Wait for installation to complete
+
+2. **Verify Installation:**
+ ```bash
+ # Check if plugin was copied
+ ls -la /usr/local/CyberCP/myFirstPlugin/
+
+ # Check if added to INSTALLED_APPS
+ grep -i "myFirstPlugin" /usr/local/CyberCP/CyberCP/settings.py
+
+ # Check if URLs were added
+ grep -i "myFirstPlugin" /usr/local/CyberCP/CyberCP/urls.py
+ ```
+
+3. **Access Your Plugin:**
+ - Navigate to `/plugins/myFirstPlugin/` in CyberPanel
+ - Or click **Manage** button in Installed Plugins list
+
+---
+
+## Plugin Structure & Files
+
+### Complete Directory Structure
+
+```
+pluginName/
+├── __init__.py # Python package marker (required)
+├── apps.py # Django app configuration (optional)
+├── models.py # Database models (optional)
+├── views.py # View functions (required)
+├── urls.py # URL routing (required)
+├── forms.py # Django forms (optional)
+├── admin.py # Django admin integration (optional)
+├── utils.py # Utility functions (optional)
+├── signals.py # Django signals (optional)
+├── tests.py # Unit tests (optional)
+├── meta.xml # Plugin metadata (REQUIRED)
+├── README.md # Plugin documentation (recommended)
+├── requirements.txt # Python dependencies (optional)
+├── pre_install # Pre-installation script (optional)
+├── post_install # Post-installation script (optional)
+├── pre_remove # Pre-removal script (optional)
+├── templates/ # HTML templates
+│ └── pluginName/
+│ ├── main.html
+│ ├── settings.html
+│ └── other_templates.html
+├── static/ # Static files (CSS, JS, images)
+│ └── pluginName/
+│ ├── css/
+│ │ └── style.css
+│ ├── js/
+│ │ └── script.js
+│ └── images/
+│ └── logo.png
+└── migrations/ # Database migrations
+ └── __init__.py
+```
+
+### File Descriptions
+
+#### Required Files
+
+1. **`__init__.py`**
+ - Makes directory a Python package
+ - Can be empty or contain initialization code
+
+2. **`meta.xml`**
+ - Plugin metadata for CyberPanel
+ - Must be valid XML
+ - Required fields: name, description, version
+
+3. **`urls.py`**
+ - URL routing configuration
+ - Must define `app_name` for namespace
+ - Maps URLs to view functions
+
+4. **`views.py`**
+ - Contains view functions
+ - Must have at least one view
+ - Should use `@cyberpanel_login_required` decorator
+
+#### Optional Files
+
+1. **`apps.py`**
+ - Django app configuration
+ - Useful for signals and app initialization
+
+2. **`models.py`**
+ - Database models
+ - Use Django ORM for data persistence
+
+3. **`forms.py`**
+ - Django forms for user input
+ - Provides validation and CSRF protection
+
+4. **`utils.py`**
+ - Helper functions
+ - Business logic
+ - API integrations
+
+5. **`admin.py`**
+ - Django admin interface
+ - For managing plugin data
+
+6. **`signals.py`**
+ - Django signals
+ - For event handling
+
+7. **`tests.py`**
+ - Unit tests
+ - Integration tests
+
+---
+
+## Core Components
+
+### 1. Authentication & Security
+
+#### Using the Login Decorator
+
+**Always use `cyberpanel_login_required` for all views:**
+
+```python
+from functools import wraps
+
+def cyberpanel_login_required(view_func):
+ """Custom decorator for CyberPanel session authentication"""
+ @wraps(view_func)
+ def _wrapped_view(request, *args, **kwargs):
+ try:
+ userID = request.session['userID']
+ return view_func(request, *args, **kwargs)
+ except KeyError:
+ from loginSystem.views import loadLoginPage
+ return redirect(loadLoginPage)
+ return _wrapped_view
+
+@cyberpanel_login_required
+def my_view(request):
+ # Your view code here
+ pass
+```
+
+#### CSRF Protection
+
+Django's CSRF protection is enabled by default. For forms:
+
+```html
+{% csrf_token %}
+```
+
+For AJAX requests:
+
+```javascript
+// Get CSRF token
+function getCookie(name) {
+ let cookieValue = null;
+ if (document.cookie && document.cookie !== '') {
+ const cookies = document.cookie.split(';');
+ for (let i = 0; i < cookies.length; i++) {
+ const cookie = cookies[i].trim();
+ if (cookie.substring(0, name.length + 1) === (name + '=')) {
+ cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
+ break;
+ }
+ }
+ }
+ return cookieValue;
+}
+
+const csrftoken = getCookie('csrftoken');
+
+// Use in AJAX
+fetch('/plugins/myPlugin/api/', {
+ method: 'POST',
+ headers: {
+ 'X-CSRFToken': csrftoken,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify(data)
+});
+```
+
+### 2. URL Routing
+
+#### Basic URL Patterns
+
+```python
+# urls.py
+from django.urls import path, re_path
+from . import views
+
+app_name = 'myPlugin'
+
+urlpatterns = [
+ # Simple path
+ path('', views.main_view, name='main'),
+
+ # Path with parameter
+ path('item/
+
+
+
+ {% trans "Plugin Settings" %}
+
+
+ {% trans "Settings page for My First Plugin" %}
+ +
+
+
+{% load i18n %}
+{% trans "Welcome" %}
+{% trans "Hello, world!" %}
+ + +{% url 'myPlugin:main' %} + + +{{ variable }} +{{ object.attribute }} +{{ object.method }} + + +{{ text|upper }} +{{ text|truncatewords:10 }} +{{ date|date:"Y-m-d" }} + + +{% if condition %} + +{% elif other_condition %} + +{% else %} + +{% endif %} + + +{% for item in items %} +{{ item }}
+{% empty %} +No items
+{% endfor %} +``` + +### 5. Static Files + +#### Organizing Static Files + +``` +static/ +└── pluginName/ + ├── css/ + │ └── style.css + ├── js/ + │ └── script.js + └── images/ + └── logo.png +``` + +#### Using Static Files in Templates + +```html +{% load static %} + + + + + + + + +
+```
+
+#### Collecting Static Files
+
+After installation, static files are automatically collected. To manually collect:
+
+```bash
+cd /usr/local/CyberCP
+python3 manage.py collectstatic --noinput
+```
+
+### 6. Database Models
+
+#### Creating Models
+
+```python
+# models.py
+from django.db import models
+
+class MyModel(models.Model):
+ name = models.CharField(max_length=255)
+ description = models.TextField(blank=True)
+ created_at = models.DateTimeField(auto_now_add=True)
+ updated_at = models.DateTimeField(auto_now=True)
+ is_active = models.BooleanField(default=True)
+
+ class Meta:
+ db_table = 'my_plugin_mymodel'
+ ordering = ['-created_at']
+ verbose_name = 'My Model'
+ verbose_name_plural = 'My Models'
+
+ def __str__(self):
+ return self.name
+```
+
+#### Using Models in Views
+
+```python
+from .models import MyModel
+
+@cyberpanel_login_required
+def list_items(request):
+ items = MyModel.objects.filter(is_active=True)
+ context = {'items': items}
+ return render(request, 'myPlugin/list.html', context)
+
+@cyberpanel_login_required
+def create_item(request):
+ if request.method == 'POST':
+ name = request.POST.get('name')
+ description = request.POST.get('description')
+ item = MyModel.objects.create(
+ name=name,
+ description=description
+ )
+ return redirect('myPlugin:list')
+ return render(request, 'myPlugin/create.html')
+```
+
+#### Database Migrations
+
+```bash
+# Create migrations
+cd /usr/local/CyberCP
+python3 manage.py makemigrations pluginName
+
+# Apply migrations
+python3 manage.py migrate pluginName
+
+# Show migration status
+python3 manage.py showmigrations pluginName
+```
+
+---
+
+## Advanced Features
+
+### 1. Forms & Validation
+
+#### Creating Forms
+
+```python
+# forms.py
+from django import forms
+
+class MyForm(forms.Form):
+ name = forms.CharField(
+ max_length=255,
+ required=True,
+ widget=forms.TextInput(attrs={'class': 'form-control'})
+ )
+ email = forms.EmailField(
+ required=True,
+ widget=forms.EmailInput(attrs={'class': 'form-control'})
+ )
+ description = forms.CharField(
+ required=False,
+ widget=forms.Textarea(attrs={'class': 'form-control', 'rows': 5})
+ )
+```
+
+#### Using Forms in Views
+
+```python
+from .forms import MyForm
+
+@cyberpanel_login_required
+def my_form_view(request):
+ if request.method == 'POST':
+ form = MyForm(request.POST)
+ if form.is_valid():
+ # Process valid form data
+ name = form.cleaned_data['name']
+ email = form.cleaned_data['email']
+ # Save or process data
+ return JsonResponse({'success': True})
+ else:
+ # Return form errors
+ return JsonResponse({'success': False, 'errors': form.errors})
+ else:
+ form = MyForm()
+
+ context = {'form': form}
+ return render(request, 'myPlugin/form.html', context)
+```
+
+#### Rendering Forms in Templates
+
+```html
+
+```
+
+### 2. AJAX & API Endpoints
+
+#### Creating API Endpoints
+
+```python
+from django.http import JsonResponse
+from django.views.decorators.csrf import csrf_exempt
+from django.views.decorators.http import require_http_methods
+import json
+
+@cyberpanel_login_required
+@csrf_exempt # Only if not using CSRF token in AJAX
+@require_http_methods(["POST"])
+def api_endpoint(request):
+ try:
+ data = json.loads(request.body)
+ # Process data
+ result = {
+ 'success': True,
+ 'message': 'Operation completed',
+ 'data': data
+ }
+ return JsonResponse(result)
+ except Exception as e:
+ return JsonResponse({
+ 'success': False,
+ 'error': str(e)
+ }, status=400)
+```
+
+#### JavaScript AJAX Example
+
+```javascript
+function sendAjaxRequest(data) {
+ // Get CSRF token
+ const csrftoken = getCookie('csrftoken');
+
+ fetch('/plugins/myPlugin/api/', {
+ method: 'POST',
+ headers: {
+ 'X-CSRFToken': csrftoken,
+ 'Content-Type': 'application/json',
+ },
+ body: JSON.stringify(data)
+ })
+ .then(response => response.json())
+ .then(data => {
+ if (data.success) {
+ console.log('Success:', data.message);
+ } else {
+ console.error('Error:', data.error);
+ }
+ })
+ .catch(error => {
+ console.error('Request failed:', error);
+ });
+}
+```
+
+### 3. File Uploads
+
+#### Handling File Uploads
+
+```python
+from django.core.files.storage import default_storage
+from django.core.files.base import ContentFile
+
+@cyberpanel_login_required
+def upload_file(request):
+ if request.method == 'POST' and request.FILES.get('file'):
+ uploaded_file = request.FILES['file']
+
+ # Validate file
+ if uploaded_file.size > 10 * 1024 * 1024: # 10MB limit
+ return JsonResponse({'success': False, 'error': 'File too large'})
+
+ # Save file
+ file_path = f'myPlugin/uploads/{uploaded_file.name}'
+ path = default_storage.save(file_path, ContentFile(uploaded_file.read()))
+
+ return JsonResponse({
+ 'success': True,
+ 'file_path': path
+ })
+
+ return JsonResponse({'success': False, 'error': 'No file provided'})
+```
+
+### 4. Logging
+
+#### Using CyberPanel's Logging System
+
+```python
+from plogical.CyberCPLogFileWriter import CyberCPLogFileWriter as logging
+
+# Write to log file
+logging.writeToFile("Plugin message: Something happened")
+
+# Write error
+logging.writeToFile(f"Error: {str(exception)}", 1) # 1 = error level
+
+# Write with plugin name
+logging.writeToFile(f"[MyPlugin] Action completed successfully")
+```
+
+### 5. Background Tasks
+
+#### Using Subprocess for Long-Running Tasks
+
+```python
+import subprocess
+import threading
+
+def run_background_task(command):
+ """Run a command in the background"""
+ def task():
+ try:
+ result = subprocess.run(
+ command,
+ shell=True,
+ capture_output=True,
+ text=True
+ )
+ logging.writeToFile(f"Task completed: {result.stdout}")
+ except Exception as e:
+ logging.writeToFile(f"Task error: {str(e)}", 1)
+
+ thread = threading.Thread(target=task)
+ thread.daemon = True
+ thread.start()
+ return thread
+```
+
+---
+
+## Best Practices
+
+### 1. Code Organization
+
+- **Keep files under 500 lines**: Split large files into modules
+- **Use descriptive names**: Functions, variables, and classes should be self-documenting
+- **Follow PEP 8**: Python style guide
+- **Add comments**: Explain complex logic
+- **Modular structure**: Separate concerns (views, models, utils)
+
+### 2. Error Handling
+
+```python
+from django.http import JsonResponse
+from plogical.CyberCPLogFileWriter import CyberCPLogFileWriter as logging
+
+@cyberpanel_login_required
+def my_view(request):
+ try:
+ # Your code here
+ result = perform_operation()
+ return JsonResponse({'success': True, 'data': result})
+ except ValueError as e:
+ logging.writeToFile(f"Validation error: {str(e)}", 1)
+ return JsonResponse({'success': False, 'error': str(e)}, status=400)
+ except Exception as e:
+ logging.writeToFile(f"Unexpected error: {str(e)}", 1)
+ return JsonResponse({'success': False, 'error': 'An error occurred'}, status=500)
+```
+
+### 3. Security Best Practices
+
+- **Always validate input**: Never trust user input
+- **Use parameterized queries**: When using raw SQL
+- **Sanitize output**: Escape HTML in templates
+- **Check permissions**: Verify user has access
+- **Use HTTPS**: For sensitive operations
+- **Rate limiting**: Prevent abuse
+- **CSRF protection**: Always include CSRF tokens
+
+### 4. Performance Optimization
+
+- **Database queries**: Use `select_related()` and `prefetch_related()`
+- **Caching**: Cache expensive operations
+- **Lazy loading**: Load data only when needed
+- **Pagination**: For large datasets
+- **Static files**: Minify CSS/JS in production
+
+### 5. Testing
+
+```python
+# tests.py
+from django.test import TestCase, Client
+from django.urls import reverse
+
+class MyPluginTests(TestCase):
+ def setUp(self):
+ self.client = Client()
+ # Set up test data
+
+ def test_main_view(self):
+ # Test main view
+ response = self.client.get(reverse('myPlugin:main'))
+ self.assertEqual(response.status_code, 200)
+
+ def test_api_endpoint(self):
+ # Test API endpoint
+ response = self.client.post(
+ reverse('myPlugin:api'),
+ data={'key': 'value'},
+ content_type='application/json'
+ )
+ self.assertEqual(response.status_code, 200)
+```
+
+---
+
+## Security Guidelines
+
+### 1. Input Validation
+
+```python
+import re
+from django.core.exceptions import ValidationError
+
+def validate_input(data):
+ """Validate and sanitize user input"""
+ if not data:
+ raise ValidationError("Input cannot be empty")
+
+ # Remove dangerous characters
+ data = re.sub(r'[<>"\']', '', data)
+
+ # Check length
+ if len(data) > 1000:
+ raise ValidationError("Input too long")
+
+ return data.strip()
+```
+
+### 2. SQL Injection Prevention
+
+**Always use Django ORM (recommended):**
+
+```python
+# ✅ GOOD - Using ORM
+items = MyModel.objects.filter(name=user_input)
+
+# ❌ BAD - Raw SQL with string formatting
+items = MyModel.objects.raw(f"SELECT * FROM table WHERE name = '{user_input}'")
+```
+
+**If using raw SQL, use parameterized queries:**
+
+```python
+from django.db import connection
+
+cursor = connection.cursor()
+cursor.execute("SELECT * FROM table WHERE name = %s", [user_input])
+```
+
+### 3. XSS Prevention
+
+**Django templates auto-escape by default:**
+
+```html
+
+{{ user_input }}
+
+
+{{ user_input|safe }}
+```
+
+**Only use `|safe` if you're certain the content is safe:**
+
+```python
+from django.utils.html import escape
+
+# Escape in Python
+safe_html = escape(user_input)
+```
+
+### 4. File Upload Security
+
+```python
+import os
+from django.core.exceptions import ValidationError
+
+ALLOWED_EXTENSIONS = ['.jpg', '.png', '.pdf']
+MAX_FILE_SIZE = 10 * 1024 * 1024 # 10MB
+
+def validate_uploaded_file(file):
+ """Validate uploaded file"""
+ # Check extension
+ ext = os.path.splitext(file.name)[1].lower()
+ if ext not in ALLOWED_EXTENSIONS:
+ raise ValidationError(f"File type {ext} not allowed")
+
+ # Check size
+ if file.size > MAX_FILE_SIZE:
+ raise ValidationError("File too large")
+
+ # Check content type
+ if file.content_type not in ['image/jpeg', 'image/png', 'application/pdf']:
+ raise ValidationError("Invalid file type")
+
+ return True
+```
+
+---
+
+## Testing & Debugging
+
+### 1. Debugging Tools
+
+#### Enable Django Debug Mode (Development Only)
+
+```python
+# In your view
+import logging
+logger = logging.getLogger(__name__)
+
+def my_view(request):
+ logger.debug("Debug message")
+ logger.info("Info message")
+ logger.warning("Warning message")
+ logger.error("Error message")
+```
+
+#### Check Logs
+
+```bash
+# CyberPanel logs
+tail -f /usr/local/lscp/logs/error.log
+
+# Django logs (if configured)
+tail -f /var/log/cyberpanel/error.log
+
+# Plugin-specific logs
+tail -f /home/cyberpanel/plugin_logs/myPlugin.log
+```
+
+### 2. Common Issues & Solutions
+
+#### Template Not Found
+
+**Problem:** `TemplateDoesNotExist` error
+
+**Solutions:**
+- Check template path: `templates/pluginName/template.html`
+- Verify template name in `render()` call
+- Ensure template extends `baseTemplate/index.html`
+- Run `python3 manage.py collectstatic`
+
+#### URL Not Found
+
+**Problem:** 404 error when accessing plugin URL
+
+**Solutions:**
+- Verify URL pattern in `urls.py`
+- Check `app_name` is set correctly
+- Ensure plugin is in `INSTALLED_APPS`
+- Restart CyberPanel: `systemctl restart lscpd`
+
+#### Import Errors
+
+**Problem:** `ImportError` or `ModuleNotFoundError`
+
+**Solutions:**
+- Check Python syntax: `python3 -m py_compile views.py`
+- Verify `__init__.py` exists
+- Check import paths
+- Ensure plugin is installed correctly
+
+#### Static Files Not Loading
+
+**Problem:** CSS/JS/images not appearing
+
+**Solutions:**
+- Run `python3 manage.py collectstatic --noinput`
+- Check static file paths in templates
+- Verify files exist in `static/pluginName/`
+- Clear browser cache
+
+---
+
+## Packaging & Distribution
+
+### 1. Creating Plugin Package
+
+```bash
+# Navigate to plugin directory
+cd /home/cyberpanel/plugins/myPlugin
+
+# Create ZIP file
+zip -r myPlugin-v1.0.0.zip . \
+ -x "*.pyc" \
+ -x "__pycache__/*" \
+ -x "*.log" \
+ -x ".git/*" \
+ -x ".DS_Store"
+```
+
+### 2. Plugin Distribution Checklist
+
+- [ ] Plugin tested and working
+- [ ] All required files included
+- [ ] `meta.xml` is valid and complete
+- [ ] README.md with installation instructions
+- [ ] No sensitive data (passwords, API keys)
+- [ ] Proper file permissions
+- [ ] Version number updated
+- [ ] Documentation complete
+
+### 3. Version Management
+
+**Semantic Versioning:**
+
+- **MAJOR.MINOR.PATCH** (e.g., 1.2.3)
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+**Update version in:**
+- `meta.xml`
+- `views.py` (if version displayed)
+- `README.md`
+- Git tags (if using version control)
+
+---
+
+## Troubleshooting
+
+### Installation Issues
+
+**Plugin not appearing in list:**
+- Check `meta.xml` format and validity
+- Verify plugin directory exists in `/home/cyberpanel/plugins/`
+- Check file permissions
+- Review CyberPanel logs
+
+**Installation fails:**
+- Check Python syntax errors
+- Verify all required files exist
+- Check file permissions
+- Review installation logs
+- Ensure sufficient disk space
+
+### Runtime Issues
+
+**Plugin page not loading:**
+- Verify URL routing
+- Check authentication decorator
+- Review template paths
+- Check for JavaScript errors
+- Verify plugin is enabled
+
+**Database errors:**
+- Run migrations: `python3 manage.py migrate pluginName`
+- Check database permissions
+- Verify model definitions
+- Review migration files
+
+**Static files missing:**
+- Run `python3 manage.py collectstatic`
+- Check static file paths
+- Verify file permissions
+- Clear browser cache
+
+---
+
+## Examples & References
+
+### Reference Plugins
+
+1. **examplePlugin**: Basic plugin structure
+ - Location: `/usr/local/CyberCP/examplePlugin/`
+ - URL: `/plugins/examplePlugin/`
+
+2. **testPlugin**: Comprehensive example
+ - Location: `/usr/local/CyberCP/testPlugin/`
+ - URL: `/plugins/testPlugin/`
+ - **Author:** usmannasir
+
+3. **discordWebhooks**: Discord webhook integration plugin
+ - Location: `/usr/local/CyberCP/discordWebhooks/` (if installed)
+ - URL: `/plugins/discordWebhooks/`
+ - **Author:** Master3395
+
+### Useful Resources
+
+- **CyberPanel Documentation**: https://cyberpanel.net/KnowledgeBase/
+- **Django Documentation**: https://docs.djangoproject.com/
+- **Python Documentation**: https://docs.python.org/
+- **CyberPanel GitHub**: https://github.com/usmannasir/cyberpanel
+- **Plugin Repository**: https://github.com/master3395/cyberpanel-plugins
+
+### Code Examples Repository
+
+Check the `examplePlugin` and `testPlugin` directories in CyberPanel for complete working examples.
+
+---
+
+## Conclusion
+
+This guide provides comprehensive information for developing CyberPanel plugins. Start with a simple plugin and gradually add more features as you become familiar with the system.
+
+### Quick Start Checklist
+
+1. ✅ Create plugin directory structure
+2. ✅ Create `meta.xml` with required fields
+3. ✅ Create `urls.py` with URL patterns
+4. ✅ Create `views.py` with view functions
+5. ✅ Create templates extending `baseTemplate/index.html`
+6. ✅ Test plugin locally
+7. ✅ Install via CyberPanel UI
+8. ✅ Verify plugin works correctly
+
+### Getting Help
+
+- Review existing plugins for examples
+- Check CyberPanel community forum
+- Review Django documentation
+- Examine CyberPanel source code
+- Create GitHub issues for bugs
+
+---
+
+**Happy Plugin Development!**
+
+**Author:** master3395
+**Last Updated:** 2026-01-04
+**Version:** 2.0.0
diff --git a/emailMarketing/meta.xml b/emailMarketing/meta.xml
index c2abe51a7..2c5d8e719 100644
--- a/emailMarketing/meta.xml
+++ b/emailMarketing/meta.xml
@@ -3,5 +3,5 @@
+
+
+ {% trans "Back to Installed Plugins" %}
+
+
+
+
+
+{% endblock %}
diff --git a/pluginHolder/templates/pluginHolder/plugins.html b/pluginHolder/templates/pluginHolder/plugins.html
index ddf278e3f..19942fc17 100644
--- a/pluginHolder/templates/pluginHolder/plugins.html
+++ b/pluginHolder/templates/pluginHolder/plugins.html
@@ -125,7 +125,7 @@
display: flex;
align-items: center;
gap: 15px;
- margin-bottom: 20px;
+ margin-bottom: 15px;
}
.plugin-icon {
@@ -143,6 +143,7 @@
.plugin-info {
flex: 1;
+ min-width: 0;
}
.plugin-name {
@@ -150,6 +151,14 @@
font-weight: 700;
color: var(--text-primary, #2f3640);
margin-bottom: 5px;
+ word-wrap: break-word;
+ }
+
+ .plugin-meta {
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ flex-wrap: wrap;
}
.plugin-type {
@@ -158,43 +167,119 @@
background: var(--purple-light, #e8e6ff);
color: #5856d6;
border-radius: 6px;
- font-size: 12px;
+ font-size: 11px;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.5px;
}
- .plugin-description {
- font-size: 14px;
- color: var(--text-secondary, #64748b);
- line-height: 1.6;
- margin-bottom: 15px;
- }
-
- .plugin-footer {
- display: flex;
- justify-content: space-between;
- align-items: center;
- padding-top: 15px;
- border-top: 1px solid var(--border-primary, #e8e9ff);
- }
-
- .plugin-version {
- font-size: 13px;
- color: var(--text-muted, #94a3b8);
- display: flex;
- align-items: center;
- gap: 5px;
- }
-
.plugin-version-number {
background: var(--bg-secondary, #f8f9ff);
padding: 3px 8px;
border-radius: 4px;
font-weight: 600;
+ font-size: 11px;
color: var(--text-secondary, #64748b);
}
+ .plugin-description {
+ font-size: 13px;
+ color: var(--text-secondary, #64748b);
+ line-height: 1.6;
+ margin-bottom: 15px;
+ min-height: 40px;
+ }
+
+ .plugin-status-section {
+ padding: 12px;
+ background: var(--bg-secondary, #f8f9ff);
+ border-radius: 8px;
+ margin-bottom: 15px;
+ }
+
+ .plugin-status-row {
+ display: flex;
+ justify-content: space-between;
+ align-items: center;
+ margin-bottom: 8px;
+ font-size: 12px;
+ }
+
+ .plugin-status-row:last-child {
+ margin-bottom: 0;
+ }
+
+ .plugin-status-row .label {
+ color: var(--text-secondary, #64748b);
+ font-weight: 600;
+ }
+
+ .status-installed-small {
+ display: inline-block;
+ padding: 3px 8px;
+ background: #d4edda;
+ color: #155724;
+ border-radius: 4px;
+ font-size: 11px;
+ font-weight: 600;
+ }
+
+ .status-not-installed-small {
+ display: inline-block;
+ padding: 3px 8px;
+ background: #f8f9fa;
+ color: #6c757d;
+ border-radius: 4px;
+ font-size: 11px;
+ font-weight: 600;
+ }
+
+ .active-status {
+ font-size: 14px;
+ display: inline-flex;
+ align-items: center;
+ gap: 4px;
+ }
+
+ .active-status.active-yes {
+ color: #28a745;
+ }
+
+ .active-status.active-no {
+ color: #dc3545;
+ }
+
+ .active-status.active-na {
+ color: #6c757d;
+ font-size: 12px;
+ }
+
+ .plugin-footer {
+ display: flex;
+ flex-direction: column;
+ gap: 12px;
+ padding-top: 15px;
+ border-top: 1px solid var(--border-primary, #e8e9ff);
+ }
+
+ .plugin-links {
+ display: flex;
+ justify-content: center;
+ gap: 8px;
+ flex-wrap: wrap;
+ }
+
+ .btn-small {
+ padding: 6px 12px;
+ font-size: 12px;
+ }
+
+ .btn-link-small {
+ padding: 4px 10px;
+ font-size: 11px;
+ white-space: nowrap;
+ }
+
/* Table View (Alternative) */
.plugins-table {
width: 100%;
@@ -295,6 +380,21 @@
border-color: #5856d6;
}
+ /* Style links that use view-btn class */
+ a.view-btn {
+ color: var(--text-secondary, #64748b);
+ text-decoration: none;
+ display: inline-flex;
+ align-items: center;
+ gap: 8px;
+ }
+
+ a.view-btn:hover {
+ background: var(--bg-hover, #f8f9ff);
+ color: #5856d6;
+ border-color: #5856d6;
+ }
+
/* Alert Messages */
.alert {
padding: 15px 20px;
@@ -321,6 +421,339 @@
color: var(--alert-danger-icon, #ef4444);
}
+ /* Plugin Store Styles */
+ .store-notice {
+ background: #fff3cd;
+ border: 1px solid #ffc107;
+ border-radius: 8px;
+ padding: 20px;
+ margin-bottom: 25px;
+ position: relative;
+ }
+
+ .notice-header {
+ display: flex;
+ justify-content: space-between;
+ align-items: center;
+ margin-bottom: 10px;
+ font-weight: 700;
+ color: #856404;
+ }
+
+ .notice-close {
+ background: none;
+ border: none;
+ font-size: 18px;
+ color: #856404;
+ cursor: pointer;
+ padding: 5px;
+ border-radius: 4px;
+ transition: background 0.2s;
+ }
+
+ .notice-close:hover {
+ background: rgba(0,0,0,0.1);
+ }
+
+ .notice-content p {
+ margin: 10px 0;
+ color: #856404;
+ font-size: 14px;
+ line-height: 1.6;
+ }
+
+ .warning-text {
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ color: #ff6b00 !important;
+ font-weight: 600;
+ margin-top: 15px !important;
+ }
+
+ .warning-text i {
+ font-size: 18px;
+ }
+
+ .store-loading {
+ text-align: center;
+ padding: 60px 20px;
+ }
+
+ .loading-spinner {
+ width: 40px;
+ height: 40px;
+ border: 4px solid #f3f3f3;
+ border-top: 4px solid #5856d6;
+ border-radius: 50%;
+ animation: spin 1s linear infinite;
+ margin: 0 auto 20px;
+ }
+
+ @keyframes spin {
+ 0% { transform: rotate(0deg); }
+ 100% { transform: rotate(360deg); }
+ }
+
+ .alphabet-filter {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 8px;
+ margin-bottom: 20px;
+ padding: 15px;
+ background: var(--bg-secondary, #f8f9ff);
+ border-radius: 8px;
+ }
+
+ .alpha-btn {
+ padding: 6px 12px;
+ border: 1px solid var(--border-primary, #e8e9ff);
+ background: var(--bg-primary, white);
+ border-radius: 6px;
+ font-size: 13px;
+ font-weight: 600;
+ cursor: pointer;
+ transition: all 0.2s;
+ color: var(--text-secondary, #64748b);
+ min-width: 36px;
+ text-align: center;
+ }
+
+ .alpha-btn:hover {
+ background: var(--bg-hover, #f0f1ff);
+ border-color: #5856d6;
+ color: #5856d6;
+ }
+
+ .alpha-btn.active {
+ background: #5856d6;
+ color: white;
+ border-color: #5856d6;
+ }
+
+ .store-table-wrapper {
+ overflow-x: auto;
+ background: var(--bg-primary, white);
+ border-radius: 8px;
+ border: 1px solid var(--border-primary, #e8e9ff);
+ }
+
+ .store-table {
+ width: 100%;
+ border-collapse: collapse;
+ }
+
+ .store-table th {
+ background: #2f3640;
+ color: white;
+ padding: 15px;
+ text-align: left;
+ font-size: 13px;
+ font-weight: 600;
+ text-transform: uppercase;
+ letter-spacing: 0.5px;
+ border-bottom: 2px solid #1a1d2e;
+ }
+
+ .store-table td {
+ padding: 18px 15px;
+ border-bottom: 1px solid var(--border-primary, #e8e9ff);
+ font-size: 14px;
+ color: var(--text-primary, #2f3640);
+ }
+
+ .store-table tr:hover {
+ background: var(--bg-hover, #f8f9ff);
+ }
+
+ .store-table tr:last-child td {
+ border-bottom: none;
+ }
+
+ .status-action {
+ display: flex;
+ align-items: center;
+ gap: 10px;
+ }
+
+ .status-installed {
+ display: inline-block;
+ padding: 6px 12px;
+ background: #d4edda;
+ color: #155724;
+ border-radius: 6px;
+ font-size: 13px;
+ font-weight: 600;
+ }
+
+ .btn-install {
+ padding: 8px 16px;
+ background: #5856d6;
+ color: white;
+ border: none;
+ border-radius: 6px;
+ font-size: 13px;
+ font-weight: 600;
+ cursor: pointer;
+ transition: all 0.2s;
+ display: inline-flex;
+ align-items: center;
+ gap: 6px;
+ }
+
+ .btn-install:hover:not(:disabled) {
+ background: #4a48c4;
+ transform: translateY(-1px);
+ box-shadow: 0 4px 8px rgba(88,86,214,0.3);
+ }
+
+ .btn-install:disabled {
+ opacity: 0.6;
+ cursor: not-allowed;
+ }
+
+ .btn-link {
+ padding: 6px 12px;
+ background: var(--bg-secondary, #f8f9ff);
+ color: var(--text-secondary, #64748b);
+ text-decoration: none;
+ border-radius: 6px;
+ font-size: 13px;
+ transition: all 0.2s;
+ display: inline-flex;
+ align-items: center;
+ gap: 6px;
+ }
+
+ .btn-link:hover {
+ background: var(--bg-hover, #f0f1ff);
+ color: #5856d6;
+ }
+
+ /* Status and Action Columns */
+ .status-installed {
+ display: inline-block;
+ padding: 4px 10px;
+ background: #d4edda;
+ color: #155724;
+ border-radius: 4px;
+ font-size: 12px;
+ font-weight: 600;
+ }
+
+ .status-not-installed {
+ display: inline-block;
+ padding: 4px 10px;
+ background: #f8f9fa;
+ color: #6c757d;
+ border-radius: 4px;
+ font-size: 12px;
+ font-weight: 600;
+ }
+
+ .btn-action {
+ padding: 6px 12px;
+ border: none;
+ border-radius: 6px;
+ font-size: 12px;
+ font-weight: 600;
+ cursor: pointer;
+ transition: all 0.2s;
+ display: inline-flex;
+ align-items: center;
+ gap: 6px;
+ }
+
+ .btn-install {
+ background: #5856d6;
+ color: white;
+ }
+
+ .btn-install:hover:not(:disabled) {
+ background: #4a48c4;
+ transform: translateY(-1px);
+ box-shadow: 0 4px 8px rgba(88,86,214,0.3);
+ }
+
+ .btn-uninstall {
+ background: #dc3545;
+ color: white;
+ }
+
+ .btn-uninstall:hover:not(:disabled) {
+ background: #c82333;
+ transform: translateY(-1px);
+ box-shadow: 0 4px 8px rgba(220,53,69,0.3);
+ }
+
+ .btn-activate {
+ background: #28a745;
+ color: white;
+ }
+
+ .btn-activate:hover:not(:disabled) {
+ background: #218838;
+ transform: translateY(-1px);
+ box-shadow: 0 4px 8px rgba(40,167,69,0.3);
+ }
+
+ .btn-deactivate {
+ background: #ffc107;
+ color: #212529;
+ }
+
+ .btn-deactivate:hover:not(:disabled) {
+ background: #e0a800;
+ transform: translateY(-1px);
+ box-shadow: 0 4px 8px rgba(255,193,7,0.3);
+ }
+
+ .btn-settings {
+ background: #5856d6;
+ color: white;
+ }
+
+ .btn-settings:hover {
+ background: #4a48c4;
+ transform: translateY(-1px);
+ box-shadow: 0 4px 8px rgba(88,86,214,0.3);
+ }
+
+ .btn-action:disabled {
+ opacity: 0.6;
+ cursor: not-allowed;
+ }
+
+ .plugin-actions {
+ display: flex;
+ gap: 8px;
+ flex-wrap: wrap;
+ justify-content: center;
+ }
+
+ /* Active Column */
+ .active-column {
+ text-align: center;
+ }
+
+ .active-status {
+ font-size: 18px;
+ display: inline-block;
+ }
+
+ .active-status.active-yes {
+ color: #28a745;
+ }
+
+ .active-status.active-no {
+ color: #dc3545;
+ }
+
+ .active-status.active-na {
+ color: #6c757d;
+ font-size: 14px;
+ }
+
/* Responsive */
@media (max-width: 768px) {
.plugins-wrapper {
@@ -346,7 +779,17 @@
}
.view-toggle {
- display: none;
+ flex-wrap: wrap;
+ }
+
+ .alphabet-filter {
+ padding: 10px;
+ }
+
+ .alpha-btn {
+ padding: 5px 10px;
+ font-size: 12px;
+ min-width: 32px;
}
}
@@ -384,6 +827,14 @@
{% trans "Table View" %}
+
+
+
+ {% trans "Plugin Development Guide" %}
+
@@ -406,7 +857,10 @@
+
+
+
+
+
+
+
+
+ {% trans "Plugin Development Guide" %}
+
+ {% trans "Comprehensive guide to creating plugins for CyberPanel. Learn how to build, package, and distribute your own plugins." %}
+
+
+
+
+
+ {% trans "Table of Contents" %}
+-
+
- {% trans "Introduction" %} +
- {% trans "Prerequisites" %} +
- {% trans "Plugin Architecture Overview" %} +
- {% trans "Creating Your First Plugin" %} +
- {% trans "Plugin Structure & Files" %} +
- {% trans "Version Numbering (Semantic Versioning)" %} +
- {% trans "Core Components" %} +
- {% trans "Advanced Features" %} +
- {% trans "Best Practices" %} +
- {% trans "Security Guidelines" %} +
- {% trans "Testing & Debugging" %} +
- {% trans "Packaging & Distribution" %} +
- {% trans "Troubleshooting" %} +
- {% trans "Examples & References" %} +
{% trans "Introduction" %}
+{% trans "CyberPanel's plugin system allows developers to extend the control panel's functionality with custom features. Plugins integrate seamlessly with CyberPanel's Django-based architecture, providing access to the full power of the platform while maintaining security and consistency." %}
+ +{% trans "What Can Plugins Do?" %}
+-
+
- {% trans "Add new administrative features" %} +
- {% trans "Integrate with external services (APIs, webhooks, etc.)" %} +
- {% trans "Customize the user interface" %} +
- {% trans "Extend database functionality" %} +
- {% trans "Add automation and monitoring capabilities" %} +
- {% trans "Create custom reporting tools" %} +
- {% trans "Integrate security features" %} +
{% trans "Prerequisites" %}
+{% trans "Required Knowledge" %}
+-
+
- Python 3.6+: {% trans "Basic to intermediate Python knowledge" %} +
- Django Framework: {% trans "Understanding of Django views, URLs, templates, and models" %} +
- HTML/CSS/JavaScript: {% trans "For creating user interfaces" %} +
- Linux/Unix: {% trans "Basic command-line familiarity" %} +
- XML: {% trans "Understanding of XML structure for meta.xml" %} +
{% trans "Plugin Architecture Overview" %}
+{% trans "How Plugins Work" %}
+-
+
- {% trans "Plugin Source Location" %}:
/home/cyberpanel/plugins/+-
+
- {% trans "Plugins are stored here before installation" %} +
- {% trans "Can be uploaded as ZIP files or placed directly" %} +
+ - {% trans "Installed Location" %}:
/usr/local/CyberCP/+-
+
- {% trans "After installation, plugins are copied here" %} +
- {% trans "This is where CyberPanel loads plugins from" %} +
+
{% trans "Creating Your First Plugin" %}
+{% trans "Step 1: Create Plugin Directory Structure" %}
+# Navigate to plugins directory
+cd /home/cyberpanel/plugins
+
+# Create your plugin directory
+mkdir myFirstPlugin
+cd myFirstPlugin
+
+# Create required subdirectories
+mkdir -p templates/myFirstPlugin
+mkdir -p static/myFirstPlugin/css
+mkdir -p static/myFirstPlugin/js
+mkdir -p migrations{% trans "Step 2: Create meta.xml (REQUIRED)" %}
+<?xml version="1.0" encoding="UTF-8"?>
+<cyberpanelPluginConfig>
+ <name>My First Plugin</name>
+ <type>Utility</type>
+ <description>A simple example plugin</description>
+ <version>1.0.0</version>
+ <url>/plugins/myFirstPlugin/</url>
+ <settings_url>/plugins/myFirstPlugin/settings/</settings_url>
+</cyberpanelPluginConfig>{% trans "Step 3: Create urls.py" %}
+from django.urls import path
+from . import views
+
+app_name = 'myFirstPlugin'
+
+urlpatterns = [
+ path('', views.main_view, name='main'),
+ path('settings/', views.settings_view, name='settings'),
+]{% trans "Step 4: Create views.py" %}
+from django.shortcuts import render, redirect
+from functools import wraps
+
+def cyberpanel_login_required(view_func):
+ """Custom decorator for CyberPanel session authentication"""
+ @wraps(view_func)
+ def _wrapped_view(request, *args, **kwargs):
+ try:
+ userID = request.session['userID']
+ return view_func(request, *args, **kwargs)
+ except KeyError:
+ from loginSystem.views import loadLoginPage
+ return redirect(loadLoginPage)
+ return _wrapped_view
+
+@cyberpanel_login_required
+def main_view(request):
+ context = {
+ 'plugin_name': 'My First Plugin',
+ 'version': '1.0.0'
+ }
+ return render(request, 'myFirstPlugin/main.html', context){% trans "Step 5: Create Templates" %}
+{% trans "Templates must extend baseTemplate/index.html:" %}
+ {% verbatim %} +{% extends "baseTemplate/index.html" %}
+{% load static %}
+{% load i18n %}
+
+{% block title %}
+ My First Plugin - {% trans "CyberPanel" %}
+{% endblock %}
+
+{% block content %}
+
+ {{ plugin_name }}
+ Version {{ version }}
+
+{% endblock %}
+ {% trans "Important" %}: {% trans "Always use the @cyberpanel_login_required decorator for all views to ensure users are authenticated." %}
+
+
+ {% trans "Plugin Structure & Files" %}
+{% trans "Required Files" %}
+-
+
__init__.py- {% trans "Required" %} - {% trans "Python package marker" %}
+ meta.xml- {% trans "Required" %} - {% trans "Plugin metadata" %}
+ urls.py- {% trans "Required" %} - {% trans "URL routing" %}
+ views.py- {% trans "Required" %} - {% trans "View functions" %}
+
{% trans "Optional Files" %}
+-
+
models.py- {% trans "Optional" %} - {% trans "Database models" %}
+ forms.py- {% trans "Optional" %} - {% trans "Django forms" %}
+ utils.py- {% trans "Optional" %} - {% trans "Utility functions" %}
+ templates/- {% trans "Optional" %} - {% trans "HTML templates" %}
+ static/- {% trans "Optional" %} - {% trans "CSS, JS, images" %}
+
{% trans "Version Numbering (Semantic Versioning)" %}
+{% trans "CyberPanel plugins use semantic versioning (SemVer) with a three-number format (X.Y.Z) to help users understand the impact of each update:" %}
+ +
+
+
+ {% trans "Major Version (X.0.0)" %} ▼
+{% trans "Breaking changes that may require action from users. New major features, complete redesigns, or changes that break existing functionality." %}
+{% trans "Example" %}: 2.8.0 → 3.0.0
+
+
+
+ {% trans "Minor Version (0.X.0)" %} ▼
+{% trans "New features added in a backward-compatible manner. Enhancements and improvements that don't break existing functionality." %}
+{% trans "Example" %}: 3.0.0 → 3.1.0
+
+
+
+ {% trans "Patch Version (0.0.X)" %} ▼
+{% trans "Bug fixes and minor improvements. Backward-compatible fixes that address issues without adding new features." %}
+{% trans "Example" %}: 3.1.0 → 3.1.1
+
+ {% trans "Important" %}: {% trans "Always use the three-number format (X.Y.Z) in your meta.xml file. This makes it easier to track updates and understand the scope of changes. Start with version 1.0.0 for your first release." %}
+
+
+ {% trans "Version Format in meta.xml" %}
+<version>1.0.0</version>{% trans "Never use formats like '1.0' or 'v1.0'. Always use the full semantic version: '1.0.0'" %}
+ +{% trans "Core Components" %}
+{% trans "1. Authentication & Security" %}
+{% trans "Always use the cyberpanel_login_required decorator:" %}
+@cyberpanel_login_required
+def my_view(request):
+ # Your view code
+ pass{% trans "2. URL Routing" %}
+from django.urls import path
+from . import views
+
+app_name = 'myPlugin'
+
+urlpatterns = [
+ path('', views.main_view, name='main'),
+ path('item/<int:item_id>/', views.item_detail, name='item_detail'),
+]{% trans "3. Templates" %}
+{% trans "Always extend baseTemplate/index.html:" %}
+ {% verbatim %} +{% extends "baseTemplate/index.html" %}
+{% load static %}
+{% load i18n %}{% trans "Advanced Features" %}
+{% trans "Database Models" %}
+from django.db import models
+
+class MyModel(models.Model):
+ name = models.CharField(max_length=255)
+ created_at = models.DateTimeField(auto_now_add=True)
+
+ class Meta:
+ db_table = 'my_plugin_mymodel'{% trans "Forms" %}
+from django import forms
+
+class MyForm(forms.Form):
+ name = forms.CharField(max_length=255, required=True)
+ email = forms.EmailField(required=True){% trans "API Endpoints" %}
+from django.http import JsonResponse
+
+@cyberpanel_login_required
+def api_endpoint(request):
+ data = {'status': 'success'}
+ return JsonResponse(data){% trans "Best Practices" %}
+-
+
- {% trans "Keep files under 500 lines - split into modules if needed" %} +
- {% trans "Use descriptive names for functions and variables" %} +
- {% trans "Follow PEP 8 Python style guide" %} +
- {% trans "Add comments for complex logic" %} +
- {% trans "Always validate user input" %} +
- {% trans "Use Django ORM instead of raw SQL" %} +
- {% trans "Test your plugin thoroughly before distribution" %} +
{% trans "Security Guidelines" %}
+
+ {% trans "Security is Critical" %}: {% trans "Always validate input, use parameterized queries, sanitize output, and check user permissions." %}
+
+ -
+
- {% trans "Always validate and sanitize user input" %} +
- {% trans "Use Django ORM or parameterized queries" %} +
- {% trans "Escape HTML in templates (Django does this by default)" %} +
- {% trans "Validate file uploads (type, size, content)" %} +
- {% trans "Use HTTPS for sensitive operations" %} +
- {% trans "Implement rate limiting for API endpoints" %} +
{% trans "Testing & Debugging" %}
+{% trans "Common Issues" %}
+-
+
- {% trans "Template Not Found" %}: {% trans "Check template path and name" %} +
- {% trans "URL Not Found" %}: {% trans "Verify URL patterns and app_name" %} +
- {% trans "Import Errors" %}: {% trans "Check Python syntax and import paths" %} +
- {% trans "Static Files Not Loading" %}: {% trans "Run collectstatic command" %} +
{% trans "Debugging Commands" %}
+# Check Python syntax
+python3 -m py_compile views.py
+
+# Check XML validity
+xmllint --noout meta.xml
+
+# View logs
+tail -f /usr/local/lscp/logs/error.log{% trans "Packaging & Distribution" %}
+{% trans "Create Plugin Package" %}
+cd /home/cyberpanel/plugins/myPlugin
+zip -r myPlugin-v1.0.0.zip . \
+ -x "*.pyc" \
+ -x "__pycache__/*" \
+ -x "*.log"{% trans "Troubleshooting" %}
+{% trans "Installation Issues" %}
+-
+
- {% trans "Check meta.xml format and validity" %} +
- {% trans "Verify plugin directory exists" %} +
- {% trans "Check file permissions" %} +
- {% trans "Review CyberPanel logs" %} +
{% trans "Runtime Issues" %}
+-
+
- {% trans "Verify URL routing" %} +
- {% trans "Check authentication decorator" %} +
- {% trans "Review template paths" %} +
- {% trans "Check for JavaScript errors" %} +
{% trans "Examples & References" %}
+{% trans "Reference Plugins" %}
+-
+
- examplePlugin: {% trans "Basic plugin structure" %}
+
-
+
- {% trans "Location" %}:
/usr/local/CyberCP/examplePlugin/
+ - {% trans "URL" %}:
/plugins/examplePlugin/
+
+ - {% trans "Location" %}:
- testPlugin: {% trans "Comprehensive example" %}
+
-
+
- {% trans "Location" %}:
/usr/local/CyberCP/testPlugin/
+ - {% trans "URL" %}:
/plugins/testPlugin/
+ - {% trans "Author" %}: usmannasir +
+ - {% trans "Location" %}:
- discordWebhooks: {% trans "Discord webhook integration plugin" %}
+
-
+
- {% trans "Location" %}:
/usr/local/CyberCP/discordWebhooks/
+ - {% trans "URL" %}:
/plugins/discordWebhooks/
+ - {% trans "Author" %}: Master3395 +
+ - {% trans "Location" %}:
{% trans "Useful Resources" %}
+-
+
- {% trans "CyberPanel Documentation" %} +
- {% trans "Django Documentation" %} +
- {% trans "CyberPanel GitHub Repository" %} +
- {% trans "Full Plugin Development Guide (Markdown)" %} +
+ {% trans "Ready to Start?" %} {% trans "Begin with a simple plugin and gradually add more features as you become familiar with the system. Check the examplePlugin and testPlugin directories for complete working examples." %}
+
+
+
+
+ + {% trans "Author" %}: master3395 | + {% trans "Version" %}: 2.0.0 | + {% trans "Last Updated" %}: 2026-01-04 +
+{{ plugin.name }}
+
+
+
@@ -430,10 +936,14 @@
+ {% trans "Status:" %}
+ {% if plugin.installed %}
+ {% trans "Installed" %}
+ {% else %}
+ {% trans "Not Installed" %}
+ {% endif %}
+
+
+ {% trans "Active:" %}
+ {% if plugin.installed %}
+ {% if plugin.enabled %}
+ {% trans "Yes" %}
+ {% else %}
+ {% trans "No" %}
+ {% endif %}
+ {% else %}
+ -
+ {% endif %}
+
+ | {% trans "Name" %} | -{% trans "Type" %} | -{% trans "Description" %} | +{% trans "Plugin Name" %} | {% trans "Version" %} | +{% trans "Modify Date" %} | +{% trans "Status" %} | +{% trans "Action" %} | +{% trans "Active" %} | +{% trans "Help" %} | +{% trans "About" %} | {{ plugin.name }} | -- {{ plugin.type }} - | -{{ plugin.desc }} | {{ plugin.version }} | ++ + {{ plugin.modify_date|default:"N/A" }} + + | ++ {% if plugin.installed %} + {% trans "Installed" %} + {% else %} + {% trans "Not Installed" %} + {% endif %} + | +
+
+ {% if plugin.installed %}
+ {% if plugin.manage_url %}
+
+ {% trans "Settings" %}
+
+ {% endif %}
+ {% if plugin.enabled %}
+
+ {% else %}
+
+ {% endif %}
+
+ {% else %}
+
+ {% endif %}
+
+ |
+ + {% if plugin.installed %} + {% if plugin.enabled %} + + {% else %} + + {% endif %} + {% else %} + - + {% endif %} + | ++ + {% trans "Help" %} + + | ++ + {% trans "About" %} + + | {% endfor %}
|---|
@@ -466,6 +1033,96 @@
{% endif %}
+
+
+
+
+
+
+
+
{% endblock %}
\ No newline at end of file
diff --git a/pluginHolder/urls.py b/pluginHolder/urls.py
index a3fdf954d..b6d0fe13d 100644
--- a/pluginHolder/urls.py
+++ b/pluginHolder/urls.py
@@ -3,8 +3,12 @@ from . import views
urlpatterns = [
path('installed', views.installed, name='installed'),
+ path('help/', views.help_page, name='help'),
path('api/install/
+
+
+
+
+
+
+
+
+
+
+
+ {% trans "Notice" %}
+
+
+
+
+ {% trans "The versions displayed here represent the latest plugins from the CyberPanel Plugin Store repository. They may or may not represent the latest available versions. Additionally, the plugin repository may only contain plugins released within the last few months." %}
++ + {% trans "Cache Information:" %} + {% trans "Plugin store data is cached for 1 hour to improve performance and reduce GitHub API rate limits. New plugins may take up to 1 hour to appear after being published." %} +
++ + {% trans "Use at Your Own Risk" %} +
+{% trans "The plugins displayed here are contributed by both the CyberPanel Developers and independent third parties. We make no guarantees that the plugins available here are functional, tested, or compatible with your system. You are encouraged to read the information found in the help and about links for each plugin before attempting the installation." %}
+Plugin Information
+Name: {plugin_display_name}
+Type: {plugin_type}
+Version: {plugin_version}
+Author: {plugin_author}
+ +Description
+{plugin_description}
+ +Usage
+For detailed information about this plugin, please visit the GitHub repository or check the plugin's documentation.
+""" + else: + # Convert markdown to HTML (basic conversion) + import re + # Convert linked images first (badges): [](link_url) + help_content = re.sub( + r'\[!\[([^\]]*)\]\(([^\)]+)\)\]\(([^\)]+)\)', + r'\1
', help_content, flags=re.MULTILINE) + help_content = re.sub(r'^## (.*?)$', r'\1
', help_content, flags=re.MULTILINE) + help_content = re.sub(r'^# (.*?)$', r'\1
', help_content, flags=re.MULTILINE) + # Convert formatting + help_content = re.sub(r'\*\*(.*?)\*\*', r'\1', help_content) + help_content = re.sub(r'\*(.*?)\*', r'\1', help_content) + help_content = re.sub(r'`([^`]+)`', r'\1', help_content)
+ # Convert lists
+ help_content = re.sub(r'^\- (.*?)$', r'\1
', changelog_html, flags=re.MULTILINE) + changelog_html = re.sub(r'^### (.*?)$', r'\1
', changelog_html, flags=re.MULTILINE) + changelog_html = re.sub(r'^\- (.*?)$', r'Version History
{changelog_html}