Utilities

Istruzioni rapide per configurare lo script di sync (sync-operation.sh) e il toolchain SASS basato su Gulp (frontend_tools).

Prerequisiti

• Accesso SSH e SCP verso il server remoto con la stessa utenza configurata nello script.
• WP-CLI installato e funzionante sia in locale sia sul remoto (wp deve essere nel PATH).
• Node.js e npm installati per il compilatore SASS (versioni LTS consigliate).
• Struttura file: questa cartella affianca frontend_tools/ e, se usi il workflow WordPress, wp-content/ si trova un livello sopra frontend_tools (vedi percorso di output in Gulp).

sync-operation.sh

1. Configura le variabili in testa al file sync-operation.sh:
   • RC_USER, RC_SERVERNAME: utente e host SSH.
   • RC_APP_NAME: nome della webapp su remote (cartella webapps/$RC_APP_NAME).
   • W_URL_REMOTE, W_URL_LOCAL: URL usati da wp search-replace per riallineare i link.
2. Crea la cartella tmp/ nella root del progetto (usata per i dump SQL).
3. Esegui lo script dalla root con i comandi disponibili:
   • ./sync-operation.sh db:pull
     Esporta il DB remoto via WP-CLI, lo copia in tmp/, lo importa in locale e aggiorna gli URL, poi fa wp rewrite flush.
   • ./sync-operation.sh db:push
     Esporta il DB locale in tmp/, lo carica su remote, fa wp search-replace con gli URL remoti e flush dei permalink.
   • ./sync-operation.sh git:status
     Mostra lo stato Git nella cartella remota webapps/$RC_APP_NAME.
   • ./sync-operation.sh console
     Apre wp shell sul remoto nella cartella dell’app.
   • ./sync-operation.sh ssh
     SSH diretto sul server con l’utente configurato.
4. Requisiti lato server: WP-CLI installato, permessi per eseguire ssh, scp e accesso a webapps/$RC_APP_NAME.

Compilatore SASS (frontend_tools)

1. Spostati in frontend_tools/ e installa le dipendenze:

   cd frontend_tools
   npm install

2. Configura proxy_url e theme_name in frontend_tools/gulpfile.js (oppure copia gulpfile-template.js e rinominalo a gulpfile.js):
   • proxy_url: URL del sito locale da proxare con BrowserSync.
   • theme_name: cartella del tema in ../wp-content/themes/<theme_name>, dove verranno scritti style.css, JS e immagini compilati.
3. Comandi principali:
   • npm run start — ambiente di sviluppo: compila SASS/JS, avvia BrowserSync su proxy e attiva i watcher.
   • npm run build — build veloce senza minificazione: genera asset in ../wp-content/themes/<theme_name>.
   • npm run prod — build di produzione con NODE_ENV=prod, minifica CSS/JS e ottimizza immagini.
4. Struttura sorgenti: file SASS entry assets/sass/style.scss; JS in assets/js/ (bundle in theme.js); immagini in assets/img/.
5. In caso di nuove installazioni, se il tema non esiste ancora in ../wp-content/themes/<theme_name>, crealo prima di lanciare i task per evitare errori di output.