Skip to content

andreapianidev/PrestaSQLeditor

Repository files navigation

🚀 PrestaSQLeditor

Editor e Gestore SQL Potente per PrestaShop

Version PrestaShop PHP License Italian Contributions Welcome

Un modulo PrestaShop potente e intuitivo per gestire facilmente il database del tuo negozio direttamente dal backoffice, basato su Adminer.

CaratteristicheInstallazioneUtilizzoContribuisciDocumentazione


PrestaSQLeditor Dashboard Screenshot dell'interfaccia principale - Coming soon


✨ Caratteristiche

🚀 Funzionalità Core

  • 🗄️ Gestione Database Completa: Accedi e gestisci il tuo database MySQL/MariaDB direttamente da PrestaShop
  • ⚡ Interfaccia Intuitiva: Powered by Adminer, uno degli strumenti più leggeri e potenti
  • 📦 Export Multipli: Esporta dati in SQL, CSV, XML, JSON con un click
  • 🔒 Sicurezza Integrata: Credenziali PrestaShop gestite in modo sicuro
  • 🎯 Zero Configurazione: Pronto all'uso subito dopo l'installazione
  • 🌐 Multi-versione: Compatibile con PrestaShop 1.6.x, 1.7.x e 8.x

🎨 Funzionalità Avanzate v2.0

Feature Descrizione
📊 Dashboard Statistiche Visualizza dimensione database, numero tabelle e metriche in tempo reale
💾 Sistema Backup Crea, gestisci e scarica backup del database con un click
📝 Cronologia Query Tracciamento automatico di tutte le operazioni SQL eseguite
Query Salvate Salva query frequenti con esempi PrestaShop pre-caricati
🔐 Sicurezza Avanzata Accesso limitato a Super Administrator, logging completo
🎨 UI Moderna Design responsive con supporto dark mode
🇮🇹 100% Italiano Interfaccia e documentazione completamente tradotte

📋 Requisiti

Componente Versione Minima Consigliata
PrestaShop 1.6.0 1.7.8+ o 8.x
PHP 7.1 7.4+ o 8.0+
MySQL 5.5 5.7+
MariaDB 10.0 10.5+

🚀 Installazione

Metodo 1: Download Release (Consigliato)

  1. Scarica l'ultima versione dalla sezione Releases
  2. Accedi al backoffice di PrestaShop
  3. Vai su Moduli > Module Manager
  4. Clicca su Carica un modulo
  5. Seleziona il file ZIP scaricato
  6. Clicca su Installa e sei pronto!

Metodo 2: Installazione Git

# Clona la repository
git clone https://github.com/andreapianidev/PrestaSQLeditor.git

# Copia nella directory moduli
cp -r PrestaSQLeditor /percorso/prestashop/modules/prestasqleditor

# Imposta i permessi corretti
chmod -R 755 /percorso/prestashop/modules/prestasqleditor

Poi installa dal Module Manager di PrestaShop.

Metodo 3: Download Diretto

# Download ZIP e estrazione
cd /percorso/prestashop/modules/
wget https://github.com/andreapianidev/PrestaSQLeditor/archive/refs/heads/main.zip
unzip main.zip
mv PrestaSQLeditor-main prestasqleditor

📖 Utilizzo

Quick Start

  1. Dopo l'installazione, vai su Moduli > Module Manager
  2. Cerca "PrestaSQLeditor" e clicca su Configura
  3. Accedi all'interfaccia con credenziali precompilate
  4. Inizia a gestire il tuo database! 🎉

Funzionalità Principali

📊 Esplora Database

Visualizza struttura tabelle, indici e relazioni

⚡ Query SQL

Scrivi ed esegui query personalizzate

💾 Backup

Crea backup sicuri del database

📥 Import/Export

Importa ed esporta dati in vari formati

✏️ Modifica Dati

Modifica record direttamente dall'interfaccia

📝 Query Salvate

Accesso rapido alle query più usate


🔒 Sicurezza

⚠️ IMPORTANTE: Questo modulo fornisce accesso completo al database.

Best Practices

  • ✅ Usa password amministratore forti e uniche
  • ✅ Limita accesso backoffice solo a utenti fidati
  • ✅ Fai backup regolari prima di operazioni massive
  • ✅ Testa query su ambiente di sviluppo prima di produzione
  • ✅ Monitora la cronologia operazioni regolarmente
  • ✅ Mantieni PrestaShop e PHP sempre aggiornati

Protezioni Integrate

  • 🔐 Accesso limitato a Super Administrator
  • 📝 Logging completo di tutte le operazioni SQL
  • 🛡️ Directory backup protetta con .htaccess
  • 🔑 Sanitizzazione input con pSQL()
  • 🚫 Protezione CSRF con token PrestaShop

🤝 Contribuisci

I contributi sono benvenuti e molto apprezzati! 🎉

Come Contribuire

  1. 🍴 Fork il progetto
  2. 🔀 Crea un branch per la tua feature
    git checkout -b feature/NuovaFeatureFantastica
  3. 💻 Committa le tue modifiche
    git commit -m 'Aggiunge NuovaFeatureFantastica'
  4. 📤 Pusha il branch
    git push origin feature/NuovaFeatureFantastica
  5. 🎁 Apri una Pull Request

Idee per Contribuire

Ecco alcune aree dove puoi aiutare:

  • 🐛 Bug Fixes: Correggi bug o problemi
  • Nuove Feature: Implementa funzionalità dalla roadmap
  • 📚 Documentazione: Migliora guide e tutorial
  • 🌍 Traduzioni: Aggiungi supporto per nuove lingue
  • 🎨 Design: Migliora UI/UX dell'interfaccia
  • 🧪 Testing: Scrivi test per aumentare copertura
  • 📝 Esempi: Crea query di esempio utili

Linee Guida

  • Segui le convenzioni PSR-12 per il codice PHP
  • Aggiungi PHPDoc ai metodi pubblici
  • Testa su PrestaShop 1.7+ e 8.x
  • Scrivi messaggi commit chiari e descrittivi
  • Aggiungi documentazione per nuove feature

Leggi la Guida Contributi completa per dettagli.


🗺️ Roadmap

✅ v2.0 - COMPLETATO

  • Traduzione completa interfaccia in italiano
  • Sistema di backup automatico integrato
  • Query salvate e preferiti
  • Log delle operazioni eseguite
  • Dashboard statistiche database
  • UI moderna e responsive

🔜 v2.1 - Prossimo Release

  • Plugin Adminer personalizzato con logging automatico
  • AJAX API per operazioni asincrone
  • Syntax highlighting nell'editor SQL
  • Dark mode completo per tutta l'interfaccia
  • Export schedulati con cron job
  • Notifiche real-time PrestaShop

🚀 v2.2 - Futuro

  • Query Builder UI visuale drag & drop
  • Supporto multi-database (gestione più DB)
  • Sistema rollback automatico backup
  • Dashboard analytics con grafici Chart.js
  • Team collaboration features
  • API REST per integrazioni esterne

Hai un'idea? Apri una Issue con tag enhancement!


📚 Documentazione

Link Utili


🏆 Crediti

Autore Fork
@andreapianidev
Autore Originale
Mediacom87
Powered by
Adminer by Jakub Vrána

📞 Supporto

Hai bisogno di aiuto?

Community

Unisciti alla community di PrestaSQLeditor:

  • ⭐ Lascia una stella se ti piace il progetto!
  • 👀 Watch il repository per ricevere aggiornamenti
  • 🍴 Fork per contribuire con le tue modifiche

📜 Licenza

Questo progetto è rilasciato sotto licenza Academic Free License (AFL 3.0).

Questo significa che puoi:

  • ✅ Usare il software commercialmente
  • Modificare il codice sorgente
  • Distribuire copie del software
  • ✅ Concedere sublicenze

Vedi il file LICENSE per il testo completo della licenza.


📊 Statistiche Progetto

GitHub stars GitHub forks GitHub watchers

GitHub issues GitHub pull requests GitHub last commit


🌟 Se questo progetto ti è stato utile, lascia una stella! 🌟

Sviluppato con ❤️ per la comunità PrestaShop italiana

⬆ Torna su

About

Open Source module for edit database

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published