Leggimi.txt per lApp Rest Web Panel Evolution by Fix


- 1 - Dichiarazione di licenza associata a un programma software .
- 2 - Premessa...
- 3 - Funzionalit...
- 4 - Requisiti di installazione e predisposizione dellambiente operativo
- 5 - File di configurazione (serv_inc.php e config.php) da editare..
- 6 - Configurazione del plug-in Rest Server sulla regia RadioDJ
- 7 - Download e installazione di XAMPP.....
- 8 - Scegliere il gestore di database vecchio o il nuovo MySQL di XAMPP..
- 9 - Copia delle ArtWork (copertine dei file mp3) dalla cartella della regia alla cartella della Web App

- 10 - Come avviare le applicazioni in modalit amministratore.....
- 11 - Collaudare lApp Rest Web Panel e soluzione dei problemi
- 12 - Come ottenere le migliori prestazioni con lApp
- 13 - Modalit e ordine di avvio delle applicazioni RadioDJ, Xampp e dellApp Rest Web Panel Evolution

- 14 - Connessioni tra mixer e scheda audio per la diretta con Rest Web Panel e speaker remoto
- 15 - Procedura e predisposizione per la trasmissione con lo speaker remoto

- 16 - Limitare laccesso a phpMyAdmin nel tuo ambiente XAMPP solo al localhost.
- 17 - Utilizzare una password forte per laccount root di MySQL in XAMPP......

- 18 - Limitare laccesso allApp Rest Web Panel Evolution...

------------------------------------------------------------------------------------------------------------------------

- 1 - Dichiarazione di licenza associata a un programma software .

Versione 3, 29 giugno 2007

Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
Tutti i diritti riservati.

Questo programma  un software libero: puoi ridistribuirlo e/o modificarlo
sotto i termini della Licenza Pubblica Generale GNU, come pubblicata dalla
Free Software Foundation, sia la versione 3 della Licenza o 
qualunque versione successiva.

Questo programma viene distribuito con la speranza che sia utile,
ma SENZA ALCUNA GARANZIA; senza nemmeno la garanzia implicita di
COMMERCIABILIT o IDONEIT PER UN PARTICOLARE SCOPO. Consulta la
Licenza Pubblica Generale GNU per ulteriori dettagli.

Per la Licenza Pubblica Generale GNU, vedi <https://www.gnu.org/licenses/>.



- 2 - Premessa
Lo sviluppatore fornisce il software gratuitamente e chiede agli utenti, se hanno apprezzato il propositi del pannello di controllo remoto, di fare una donazione volontaria per sostenere lo sviluppo continuo delApp ed in questo caso non  richiesta la donazione per utilizzare il software. Si declina ogni responsabilit per danni causati dallutilizzo del software o da una configurazione errata dellambiente operativo, ivi compresi errori di redazione contenute nel file leggimi.txt. LApp Rest Web Panel Evolution non  n propriet di RadioDJ n propriet di societ collegata a RadioDJ. Per qualsiasi dubbio circa linstallazione e/o configurazione, siete pregati di contattare prima lo sviluppatore, o collegarsi al forum di RadioDJ dove  stato aperto un topic allindirizzo: https://www.radiodj.ro/community/index.php/topic,17558.0.html. Lo stesso topic  raggiungibile direttamente dall App seguendo il link ASSISTANCE.

Linterfaccia Rest Web Panel Evolution  un ottimo strumento per le web radio e le radio on-air, che rende disponibili molte funzionalit della regia allinterno del pannello di controllo remoto, tramite connessione internet e protocollo HTTP. Linterfaccia  stata realizzata da Fix un appassionato del mondo dellinformatica che ha studiato e analizzato diversi linguaggi web (HTML, CSS, PHP, SQL, JSON) e analizzato diverse interfacce con licenza GPL . Linterfaccia Rest Web Panel Evolution permette di effettuare una trasmissione a distanza con uno o pi speaker situati in una localit remota rispetto al luogo in cui si trova la regia RadioDJ. Lo speaker remoto dispone di un pannello di controllo Web accessibile, tramite browser web allindirizzo: http://IP-REMOTO/esempio-radiodj-esempio/. Per le funzionalit dellApp Rest Web Panel Evolution vedi Funzionalit al Capitolo - 3 -

- 3 - Funzionalit
Linterfaccia Rest Web Panel Evolution offre le seguenti funzionalit:
1) visualizzazione sulla parte alta di sx dei counter intro, outro, remaining, elapsed, duration, della foto della Cover, dell artista, del titolo e dellanno. Inoltre, sulla parte centrale sx viene visualizzato il now playing ed il next track come artista e titolo. Il next track viene visualizzato quando il remaining  inferiore a 40.
2) visualizzazione sulla parte bassa di sx  unarea adibita alla playlist in cui trovano posto le tracce. Questultime forniscono informazioni circa lartista e il titolo, il counter duration, lintro, loutro, lend_of_the_track lanno, il SongID ed una miniatura della cover del file mp3.
3) ricerca delle tracce audio all'interno del database, ovvero Musica, stationID, Jingle, Commerciali, poi si pu scegliere il genere musicale e tenere docchio anche il parametro Count played. Quando questo parametro  uguale zero (count played = 0), indica una traccia mai riprodotta. Per il resto il form di ricerca  molto intuitivo e semplice da usare pur permettendo di articolare la query al database. Inoltre, il form  dotato di memoria circa lultima parola chiave inserita e di un sistema di progressive searching e cio per  ogni carattere inserito viene effettuata una query. Tuttavia,  stato mantenuto operativo il tasto search per questioni di compatibilit con i browser che hanno javascript disattivato;
4) costruzione di una playlist (on-the-fly) per la diretta con speaker remoto. Dopo avere trovato le tracce tramite la sezione dx search si pu costruire la playlist, impilando le tracce in modalit top o bottom. Per impilare una traccia in top  necessario che nellarea playlist ci siano in coda almeno 2 tracce, in caso contrario la traccia verr inserita sempre in modalit bottom;
5) indicazione numerica progressiva dellordine delle tracce pi lindicazione dellultimo elemento in playlist. Ci permette di sapere quante tracce sono presenti nella nostra playlist automatica (tracks rotation) o on-the-fly;
6) visualizzazione della cronologia delle tracce riprodotte in modalit discendente;
7) visualizzazione della classifica (hit interna) delle tracce pi riprodotte;
8) cancellazione dell'intera playlist tramite il pulsante CANC. PLAYLIST;
9) cancellazione delle singole traccie audio, tramite il quadratino rosso con la X;
10) cancellazione della cronologia delle tracce riprodotte;
11) catalogo delle tracce ordinate per artista o gruppo presenti sul Database;
12) modifica dello stato AUTODJ/MANUAL. Lo stato AUTODJ (tasto di colore verde) permette di generare delle playlist automatiche tramite il tracks rotation e questa modalit  indicata per le trasmissioni senza speaker remoto o per rotazioni musicali, mentre lo stato MANUAL (tasto di colore rosso) richiede il caricamento manuale delle tracce e delle playlist ed  indicato per le trasmissioni con lo speaker remoto. Durante la diretta con speaker remoto  necessario commutare in MANUAL (tasto di colore rosso) in modo tale da avere lo spazio playlist libero solo per le playlist on-the-fly. Questa impostazione evita che le playlist on-the-fly si possano mischiare con quelle automatiche prodotte con tracks rotation. Passando da AUTODJ a MANUAL  possibile che lo spazio playlist non sia ancora libero, ma contenga alcune tracce prodotte dal tracks rotation. Se volete pulire larea playlist selezionate il tasto  CANC. PLAYLIST;
13) modificare lo stato AUTOMATED/ASSISTED. In AUTOMATED le tracce della playlist vengono riprodotte in automatico, mentre in modalit ASSISTED  necessario lintervento delloperatore per avviare la traccia. Durante la trasmissione in diretta lo speaker remoto pu decidere di selezionare la modalit AUTOMATED (tasto colore verde), lasciando che la regia intervenga nellinserimento delle tracce in diretta, oppure in modalit ASSISTED (tasto colore rosso) per lasciare allo speaker la possibilit di inserire le tracce rispettando i fade-out delle tracce musicali e i tempi di intervento vocale dello speaker;
14) riprodurre qualsiasi traccia dalla playlist automatica o on-the-fly senza seguire l'ordine prestabilito. E necessario cliccare sullarea che riporta la numerazione progressiva della traccia ed loperazione sar effettuata;
15) mettere una traccia in pausa;
16) mettere una traccia in restart;
17) avviare una traccia dopo lintro;
18) mettere una traccia in stop;
19) mettere una traccia in play;
20) songs details  un riepilogo dettagliato delle informazioni sulla traccia in riproduzione;
21) instant player da 1 a 24. Permette di riprodurre delle tracce in modo instantaneo e che si sovrappongono allaudio che si sta riproducendo. Per usufruire di questa modalit  necesssario pre-impostatare sulla regia le 24 tracce che dovranno andare in diretta;
22) pulsante MICROPHONE-OFF/ON-AIR per abilitare lingresso audio della regia RadioDJ. E necessario un servizio VOIP (chat Facebook, Skype o altro) e le connessioni tra mixer fisico e la scheda audio;


- 4 - Requisiti di installazione e predisposizione dellambiente operativo
1) avere gi installato lapplicazione RadioDJ 1.8.2.0 o superiore (2.0.X.X) sul PC che funger da regia;
2) installare Xampp versione 7.1.26 per Windows 10/11 sul pc regia. LApp che andrete ad installare non  stata verificata su una versione di PHP superiore alla 7.1.26, quindi, attenetevi alla versione di Xampp consigliata. Non cercate il massimo della tecnologia installando Xampp 8.2.12, poich lapp non  validata per questa versione ed in tale caso  lApp potrebbe non funzionare correttamente.
Xampp  un ambiente integrato che ci permette di fruire delle funzionalit del gestore di database MariaDB(Mysql), di PHP, di un server Web APACHE, ecc. I pacchetti Xampp che dovrete installare necessariamente sono: PHP e Apache, mentre per il pacchetto MariaDB(Mysql) che  il gestore di database MySql, linstallazione non sar necessaria se continuerete ad utilizzare lattuale (il vostro) gestore di database e cio quello che sta utilizzando la regia RadioDJ. Sembra scontato dirlo, ma in questo caso il gestore di database MySql non va installato. Se avete installato Xampp anche con il gestore di database MariaDB e non volete pi utilizzare il vostro attuale gestore di database, non potrete mantenere lattuale connessione al database, quindi, dovrete rimuovere/disinstallare il vecchio gestore di database e sconfigurare lutility DatabaseSetup.exe, poi seguire la procedura del Capitolo 8;
3) Lapp  stata realizzata rispettivamente in due versioni; 1 per RadioDJ 1.8.2.0 e 2 per le versioni superiori. Perch questa distinzione? Sono state riscontrate alcune differenze di costruzione nel database che non permettevano un App unica. La differenza consiste nel nome della colonna diverso e che contiene le copertine dei file mp3. Il database ha la tabella songs con il nome del campo Album_Art nella versione di RadioDJ 1.8.2.0, mentre la tabella ha il campo con il nome image nelle versioni superiori di RadioDJ 2.0.x.x.
Effettuata la scelta della versione dovrete estrarre il pacchetto zip della Web App, sotto la cartella precedentemente creata con il nome WebApp nel percorso: C:\xampp\htdocs\WebApp. 
4) per il funzionamento della regia ed del sistema voip (di terze parti) sar necessaria una seconda scheda audio. La prima sar utilizzata per la diretta dellapplicazione RadioDJ, di cui siete gi in possesso, mentre la seconda sar utilizzata per effettuare le connessioni con il mixer fisico per effettuare la trasmissione con un speaker remoto;
5) una connessione Internet in Fibra o ADSL2+, per assicurare un buon funzionamento dei servizi Voip di terze parti che utilizzerete. Si sconsiglia lutilizzo di Hot Spot tramite cellulare, poich c molta latenza  non possibile configurare il PORT-FORWARDING, quindi, lApp non sarebbe raggiungibile dallesterno e ci  di fondamentale importanza;
6) configurazione di un PORT-FORWARDING che non  facoltativo, poich  utile per la raggiungibilit della Web App dallesterno. Il port forwarding  una procedura che permette di reindirizzare il traffico da una porta specifica del router a un dispositivo o programma allinterno della rete locale. In altre parole, se volete accedere a una pagina web o a un servizio allinterno della LAN da un luogo esterno, dovete configurare il port forwarding per consentire questo accesso.
Ecco come impostare il port forwarding sul tuo router:
       a) Accedi al pannello di controllo del router: Apri il browser e digita lindirizzo IP del router (solitamente 192.168.1.1 o 192.168.0.1) nella barra degli indirizzi. Inserisci le credenziali per accedere alle impostazioni del router.
       b) Trova la sezione Port Forwarding: Naviga nelle impostazioni avanzate o nelle opzioni di port forwarding. Questa sezione potrebbe avere nomi diversi a seconda del modello del router.
       c) Configura il port forwarding:
          Seleziona il tipo di servizio o applicazione per cui desideri aprire la porta (ad esempio HTTP per una pagina web e questo  il nostro caso).
          Imposta lindirizzo IP locale del dispositivo (il computer o il server che ospita la pagina web hanno un indirizzo IP della Lan locale).
          Specifica la porta esterna (quella che verr aperta) e la porta interna (la porta del dispositivo locale).
          Scegli il protocollo (TCP o UDP. TCP nel nostro caso).
          Abilita la regola di port forwarding.
       Salva le modifiche: Una volta configurato, salva le impostazioni e riavvia il router se necessario.
N.B.: Ogni router ha uninterfaccia diversa, quindi i passaggi potrebbero variare. Pertanto, non vengono fornite altre procedure per la configurazione del Port-Forwarding, poich ogni router di un utente e diverso da quello di un altro, quindi, consulta il manuale del tuo router o cerca guide specifiche circa il Port-Forwarding su Internet.
Chiedere alloperatore di servizi Internet se il servizio deve essere attivato dal vostro ISP o se siete abili per agire in automomia tramite il vostro router. Le regole cambiano da operatore ad operatore. Inoltre, chiedete se la configurazione del Port-Forwarding  disponibile a pagamento (chiamando numeri 199*****) oppure  totalmente gratuita.
7) attivare un servizio DDNS (facoltativo) che fornisce un dominio fisso (www.ddns.dominio.com) attraverso cui si pu raggiungere la Web App da remoto. N.B.: non obbligatorio, poich lapp  raggiungibile anche tramite IP, ma il regista dovr sempre comunicare gli eventuali cambiamenti dellIP della regia allo speaker remoto;
8) browser compatibility: Chrome Versione 126.0.6478.127 (Build ufficiale a 64 bit) , Edge Versione 126.0.2592.87 (Build ufficiale) (64 bit)  e Firefox 127.0 (64-bit). E necessario da parte dei browser internet il supporto del linguaggio Javascript, quindi, assicuratevi che sia attivo per potere usufruire di tutte le funzionalit offerte dallApp;
9) risoluzione grafica minima 1600x900 pixel (HD) e dimensione minima del testo. Per risoluzioni inferiori non si garantisce la corretta impaginazione dei contenuti;
10) PC icore5 con minimo 16GB RAM, Windows 10 o 11 e un disco SSD minimo 250GB;
11) soluzione con mixer fisico; un dispositivo audio con almeno 3 canali (1 Mic e 2 tape/aux) ed un numero di cavi fisici il cui numero e tipologia dipende dalle connessioni che si devono effettuare. Il numero di connessioni da effettuare sono 2; la prima tra luscita della scheda audio 2 e lingresso AUX del mixer, mentre la seconda connessione tra lUSCITA del mixer e lingresso LINE IN della scheda audio 2. N.B.: si ricorda che la scheda audio 1 sar utilizzata solo per luscita audio della regia RadioDJ;


- 5 - File di configurazione (serv_inc.php e config.php) da editare
I file si trovano nella cartella C:\xampp\htdocs\VostraCartellaWebApp\. In essi sono contenute righe inerenti i dati di accesso al database ed informazioni per il corretto funzionamento del plug-in Rest Server. Le informazioni devono essere coerenti con lambiente in cui viene eseguita la Web App. Seguono alcune righe dei file che vanno modificate con i dati corretti:

//Inserire le informazioni del Server MySQL
---------------------------------------------- serv_inc.php -----------------------------------------------------
$mysqli_server = "127.0.0.1"; // IP del server MySQL; Se la Web App  installata sullo stesso PC su cui si trova RadioDJ, lIP  127.0.0.1;
$mysqli_database	= "InserireNomeDB";// nome del databse MySQL;
$mysqli_user = "root"; // username del database MySQL. Solitamente root;
$mysqli_pass = "InserisciLaTuaPassword"; // password del database MySQL;
$mysqli_port = "3306"; 	// numero di porta di MySQL. Il valore di default  3306;
$def_timezone = 'Europe/Rome'; // Setting del time-zone. Per lItalia il valore Europe/Rome  corretto;
-----------------------------------------------------------------------------------------------------------------------
//Inserire i dati di configurazione del plug-in REST server.
$ipAddress = "127.0.0.1";	IP del Rest Server. Lasciare lIP di default 127.0.0.1;
$restPort = "5555"; 	Porta TCP/IP. Lasciare il valore di default 5555;
$restPassword = "InserisciLaTuaPassword"; deve essere identica a quella configurata sul plug-in presente nella regia (vedi anche Capitolo 6)
---------------------------------------------- serv_inc.php ------------------------------------------------------
------------------------------------------------ config.php ------------------------------------------------------
//Inserire i dati di configurazione del plug-in REST server.
$ipAddress = "127.0.0.1";	IP del Rest Server. Lasciare lIP di default 127.0.0.1;
$restPort = "5555"; 	Porta TCP/IP. Lasciare il valore di default 5555;
$restPassword = "InserisciLaTuaPassword"; deve essere identica a quella configurata sul plug-in presente nella regia (vedi anche Capitolo 6)
------------------------------------------------ config.php ------------------------------------------------------


- 6 - Configurazione del plug-in Rest Server sulla regia RadioDJ ----
Avviate la regia RadioDJ e dalla barra degli strumenti OPTIONS>PLUG-INS cliccate sul plug-in Rest Server. Si aprir una finestra dove si dovranno configurare dei parametri come per esempio: 1) IP e porta. In questo campo inserire http://127.0.0.1:5555; 2) Password. In questo campo si dovr inserire una password che deve corrispondere alla password che avete inserito nel file serv_inc.php o nel file config.php (vedi Capitolo 5); 3) Auto start. Fare un check sul quadratino blu. Il quadratino deve avere il segno della spunta; 4) Log Activity. Fare un check sul quadratino blu. Il quadratino deve avere il segno della spunta; 5) il tasto di avvio del servizio deve essere su started e di colore verde. Se notate che il servizio  STOPPED cliccate su stopped per avviare il servizio.


- 7 - Download e installazione di Xampp versione 7.1.26
Questa  la procedura per scaricare e installare XAMPP su un pc a 64bit con Windows 10/11:
1) Accedi al sito web di XAMPP allindirizzo www.apachefriends.org. Adesso dovete scaricare la versione per la quale lApp  stata gi testata. Per ottenere questa versione selezionare DOWNLOAD > poi MORE DOWNLOAD > poi XAMPP WINDOWS, poi cercare in fondo ai pacchetti meno recenti e cliccare su 7.1.26 per scaricare xampp-windows-x64-7.1.26-1-VC14-installer.exe, infine doppio click sul file di installazione.
2) Clicca sul pulsante S quando richiesto. In questo modo verr avviata la procedura guidata di installazione di XAMPP.
3) Clicca il pulsante Next. Prima di selezionare le caratteristiche di XAMPP che vuoi installare  necessario scegliere se continuare ad utilizzare lattuale gestore del database o il nuovo gestore di database MySQL di XAMPP. Se si decidesse di non istallare il gestore di database di XAMPP non sar necessario selezionarlo, quindi, sar un elemento in meno da installare. Se invece vorrete utilizzare il nuovo gestore di database MariaDB (MySQL) dovrete mettere il segno di spunta su MYSQL per installare lelemento. La configurazione  descritta nel capitolo che segue che  il nr. 8;
4) Seleziona le caratteristiche di XAMPP che vuoi installare (nel nostro caso MariaDB[Mysql] (SI/NO), la scelta dipende dal gestore per il database che avete scelto di utilizzare (vedi punto 3), PHP (obbligatorio) e APACHE (obbligatorio)). Esamina la lista di funzionalit di XAMPP visualizzata sul lato sinistro della finestra.
5) Clicca il pulsante Next. Seleziona la cartella di installazione. Clicca sullicona a forma di cartella posta sulla sinistra dellattuale directory di installazione. Clicca su OK. In questo modo la cartella selezionata verr utilizzata come directory di installazione per XAMPP.
6) Clicca sul pulsante Next. Deseleziona il pulsante di spunta Learn more about Bitnami, quindi clicca su Next ed avvier linstallazione vera e propria di XAMPP.
7) Una volta completata linstallazione, puoi avviare il pannello di controllo XAMPP, dove puoi avviare e fermare i servizi come Apache e MySQL (facoltativo). Puoi testare la tua installazione aprendo il tuo browser e digitando localhost, che ti porter alla dashboard di XAMPP.


- 8 - Scegliere il nuovo gestore di database MariaDB(MySQL) di XAMPP
Prima di iniziare qualsiasi operazione sul database  necessario fare lexport/backup del database utilizzando lutility DATABASE SETUP di RadioDJ che si trova sul path C:\RadioDJ\Setup\DatabaseSetup.exe. Avviare lutility, selezionare BACKUP DATABASE e verr visualizzato il messaggio EXPORT COMPLETED. Il file prodotto si trova allinterno della cartella C:\RadioDJ\Setup\Backup ed  un file con nome tipo (20240707 160000) e con estensione .SQL. Il nome indica lanno, il mese, il giorno e lora in cui  stato creato.

Se avete scelto di mantenere lattuale gestore del database durante linstallazione di XAMPP non sar necessario scegliere MySQL tra i servizi da installare, ma sar utile selezionare solo i moduli PHP e APACHE.

Se non volete pi utilizzare lattuale gestore di database e volete passare a MySQL di XAMPP dovete prima procedere allinstallazione e avvio del servizio e configurarlo nel seguente modo:
a) avviare phpMyAdmin di XAMPP allindirizzo http://127.0.0.1/
b) dalla barra degli strumenti selezionare PHPMYADMIN e poi selezionare DATABASE;
c) si aprir una finestra in cui  possibile inserire il nome del DATABASE e selezionare il SET di CARATTERI;
d) inserire il NOME del DATABASE e lasciare inalterato il SET di CARATTERI di default ovvero LATIN1_SWEDISH_CI, poi selezionare il tasto CREA;

e) in alto sulla sx vedrete il database che  stato appena creato insieme ad altri gi esistenti. Cliccate sul database appena creato, poi andate su PRIVILEGI per creare lutente del database e relativi permessi;

f) Cliccate su AGGIUNGI ACCOUNT UTENTE e compilare le informazioni di login scegliendo:
-- NOME UTENTE > testing010824
-- NOME HOST > localhost
-- PASSWORD > miapassword
-- RE-INSERISCI PASSWORD > miapassword
scorrere sotto su
-- PRIVILEGI > cliccare su SELEZIONA TUTTO;
andare su ESEGUI scorrendo fino a gi in fondo sulla dx.
g) Adesso  necessario copiare, le info appena inserite, su un foglio, perch andranno riportate sullutility DATABASE SETUP di RadioDJ che si trova sul path C:\RadioDJ\Setup\DatabaseSetup.exe. Avviare lutility e inserire nellordine le seguenti informazioni:
1) MySQL Server > IP_LOCALHOST <  127.0.0.1
2) MySQL Database > NOME_DEL_DATABASE (quello che avete scelto nel Capitolo 5)
3) MySQL Username > TUO_USERNAME (quello che avete scelto nel Capitolo 5)
4) MySQL Password > TUA_PASSWORD (quello che avete scelto nel Capitolo 5)
Selezionare VALIDATE e verificare in basso a sx se il database  on-line. Se tutto  andato bene si vedr - MSQL SERVER IS ON-LINE  di colore verde.
Infine, editare il file serv_inc.php con le informazioni (vedi capitolo 5)


- 9  Spostamento delle ArtWork (copertine degli file mp3) dalla cartella della regia alla cartella della Web App
Loperazione  necessaria per evitare la mancata visualizzazione delle ArtWork allinterno della Web App. Procedere in questo modo: dalla barra degli strumenti di RadioDJ cliccare su OPTIONS> OPTIONS>Other Settings, poi andare su Artwork Storage Path e prendere nota del percorso. Spostare tutte le ArtWork dal percorso dell Artwork Storage Path (quello di cui avete preso nota) a quello di Xampp esempio: C:\xampp\htdocs\CartellaApp\Album-Art.
Poi, per evitare di fare la stessa suddetta operazione di spostamento delle ArtWork ogni volta che importate tracce audio nuove, cambiate lArtwork Storage Path della regia con quello della Web App in modo che ogni file mp3 importato salvi lArtWork sul percorso della Web App: C:\xampp\htdocs\WebApp\Album-Art.


- 10 - Avviare RadioDJ e Xampp in modalit amministratore
Questa procedura  strettamente necessaria perch senza questo permesso non si pu accedere alla modalit di configurazione per modificare alcuni parametri di RadioDJ e di Xampp. Per accedere alla modalit Amministratore selezionare licona dellapplicazione da avviare; in questo caso RadioDJ o Xampp, e cliccare sul pulsante destro del mouse, selezionare Mostra altre opzioni> Propriet > Avanzate > poi > Esegui come amministratore (mettere il segno di spunta)> OK > Ok e uscire.


- 11 - Collaudare lApp Rest Web Panel e soluzione dei problemi
Al termine delle varie configurazioni e settaggi  necessario collaudare lApp in locale prima di renderla disponibile allo speaker remoto. Pertanto, allindirizzo http:\localhost\WebApp o http:\127.0.0.1\WebApp si pu visualizzare lApp. Questa  costituita da una parte destra e da una parte sinistra che mostreranno avvisi in caso di problemi di configurazione dei file serv_inc.php o config.php. La parte sx dar avviso di eventuali problemi relativi al Rest Server plug-in, mentre la parte di dx dar avviso di eventuali problemi rigurdanti il database. Per ci che concerne la mancata visualizzazione delle Artwork ripetere i passi del capitolo 9, mentre per i problemi di visualizzazione della sezione di dx o sx si rimanda la ri-lettura dei capitoli 5 e 6. 


- 12 - Come ottenere le massime prestazioni e le migliori condizioni di operativit dallApp Rest Web Panel Evolution
LApp normalmente opera in primo piano (foreground) e solo in alcuni casi operer in secondo piano (background) per esempio quando operiamo con unaltra applicazione in contemporanea. In questultimo caso i timing potrebbero subire delle variazioni rispetto ai contatori della regia. Per porre rimedio ad eventuali variazioni dei timing  necessario fare un reload della pagina web, cos tutti i contatori torneranno ad essere sincronizzati con quelli della regia RadioDJ.
C un altro caso in cui dovrete fare un reload dellApp, ovvero quando ci sono degli errori HTTP (errore di trasmissione dati) rilevati da alcuni script dellApp e gli errori si manifestano sulla finestra di sx. I messaggi visualizzati si possono e si devono cancellare, con un reload, per evitare un blocco dellApp.


- 13 - Modalit e ordine di avvio delle applicazioni RadioDJ, Xampp e dellApp Rest Web Panel Evolution
a) avviare XAMPP (con o senza MySQL) ed APACHE, tramite pannello di controllo, poi verificare tramite DatabaseSetup.exe che il server MYSQL sia on-line e se tutto  ok si pu passare al passo successivo b) avviare RadioDJ e quando questultimo sta riproducendo delle tracce audio potete andare oltre c) avviare Rest Web Panel Evolution per effettuare un test e questultimo  possibile avviando il browser web allindirizzo: http://127.0.0.1/TuaCartellaWebApp.



- 14 - Connessioni tra mixer e scheda audio per la diretta con Rest Web Panel e speaker remoto
I contributi audio, possono essere derivati da chat (singole o di gruppo) Facebook o Skype (singole o di gruppo), ecc. e verrano canalizzati allinterno della regia tramite un mixer fisico e cablaggi di cavi fisici. Per questo setup, avrete bisogno di un mixer audio con due canali audio disponibili: uno per il microfono e laltro per ausiliario (aux).
Il canale del microfono sar utilizzato nello studio in cui si trova la regia RadioDJ da uno speaker o da un regista come interfono per dialogare con lo speaker remoto. Il canale AUX deve essere collegato alluscita della seconda scheda audio 2 (quella supplementare). Infine, luscita del mixer deve essere collegata allingresso LINE IN della stessa scheda audio. Effettuare dei test al fine di regolare i livelli dei vari slider.
Questo setup permette una comunicazione fluida e di alta qualit durante la diretta con uno speaker remoto. Ricorda, la qualit del suono pu dipendere anche dalla qualit del tuo hardware (microfono e mixer) e dalla connessione internet. Fatto ci lo speaker remoto prima di parlare deve attivare il canale di comunicazione agendo sul tasto MICROPHONE-OFF dal pannello di controllo remoto, che diventer ROSSO lampeggiante con lindicazione ON-AIR. Dopo avere terminato di parlare cliccare sul tasto ON-AIR (ROSSO lampeggiante) per chiudere il canale di comunicazione e il tasto da ON-AIR (ROSSO lampeggiante) diventer MICROPHONE-OFF, quindi, non sar pi possibile parlare.


- 15 - Procedura e predisposizione per la trasmissione con lo speaker remoto
Lo speaker/regista remoto dopo essersi collegato e autenticato allindirizzo http:\INDIRIZZO_IP\WebApp\ deve porre il selettore AUTODJ/MANUAL in MANUAL (tasto di colore ROSSO). In questa modalit la playlist non verr pi generata in automatico dal track rotation, ma si dovr creare una playlist on-the-fly, addizionando le tracce con ADD TOP o ADD BOTTOM della sezione search dalla sezione di destra. Poi, si deve operare sul selettore AUTOMATED/ASSISTED per decidere se le tracce devono andare in diretta in automatico o con lintervento dello speaker/regista. Se avete scelto la modalit  AUTOMATED (tasto di colore VERDE) le tracce saranno avviate in automatico, mentre in modalit ASSISTED (tasto di colore ROSSO) avvierete manualmente le tracce delle playlist on-the-fly e potrete intercalare la parte vocale dello speaker con le tracce musicali.


- 16 - Limitare laccesso a phpMyAdmin nel tuo ambiente XAMPP solo al localhost
Modifica le impostazioni del tuo server Apache per consentire laccesso solo da localhost (127.0.0.1). Ecco come potresti farlo:
       a) Trova il file di configurazione di Apache (httpd.conf), che si trova solitamente nella cartella apache\conf nella directory di installazione di XAMPP.
       b) Apri il file httpd.conf con un editor di testo.
       Cerca la sezione <Directory> che contiene il percorso alla directory di phpMyAdmin. Potrebbe assomigliare a questo:
<Directory "c:/xampp/phpMyAdmin">

</Directory>
c) Allinterno di questa sezione <Directory>, aggiungi le seguenti righe:
Order Deny,Allow
Deny from All
Allow from 127.0.0.1
Il tuo file dovrebbe ora assomigliare a questo:
<Directory "c:/xampp/phpMyAdmin">
    Order Deny,Allow
    Deny from All
    Allow from 127.0.0.1

</Directory>
       d) Salva il file httpd.conf e riavvia Apache.
Questo dovrebbe limitare laccesso a phpMyAdmin solo a localhost (127.0.0.1), che significa che solo il computer che ospita il server XAMPP pu accedere a phpMyAdmin.
Dovresti anche considerare luso di una password forte per laccount root di MySQL (vedi capitolo 16).


- 17 - Utilizzare una password forte per laccount root di MySQL in XAMPP
E molto importante utilizzare una password forte per laccount root di MySQL(MAriaDB) in XAMPP per migliorare la sicurezza. Ecco come puoi cambiare la password dellaccount root in XAMPP:
       a) Apri il pannello di controllo XAMPP e fai clic su Shell per aprirlo.
       b) Nel prompt dei comandi, digita il seguente comando per cambiare la password:
mysqladmin.exe -u root password NuovaPassword
Dove NuovaPassword  la nuova password che desideri impostare.
Quando usi il comando mysqladmin.exe -u root password NuovaPassword, non devi inserire la vecchia password. Al posto di NuovaPassword, inserisci la nuova password che desideri impostare per laccount root di MySQL.
Inoltre,  una buona pratica di sicurezza cambiare le password periodicamente. Questo aiuta a prevenire attivit malevole, specialmente se utilizzi la stessa password in pi account.
Infine, assicurati di aggiornare la password nel file di configurazione di phpMyAdmin che si trova nella cartella C:\xampp\phpMyAdmin (config.inc.php) . Dovresti cercare la seguente riga e sostituire con la tua nuova password:
PHP
$cfg['Servers'][$i]['password'] = 'NuovaPassword';

Ricorda di riavviare Apache e MySQL dopo aver cambiato la password.

- 18 - Regolazione degli accessi (autenticazione) allApp Rest Web Panel Evolution
Lapp  dotata di un sistema di autenticazione semplice per gruppi di speaker, tramite password fissa (default), che pu essere cambiata a proprio piacimento, editando il file login.php.

Ecco quali parti del file editare:
-------------------------------------------  login.php ------------------------------------------------------------
<?php 
	session_start();
	$username = 'rotartsinimda';<---- cambiare lusername lasciando i doppi apici
	$password = 'Ufolino2024$';<---- cambiare la password lasciando i doppi apici
