Home Homebrew Pubblicato un nuovo aggiornamento per RAWeb

Pubblicato un nuovo aggiornamento per RAWeb

2 Maggio 2025 Data modificata: 2 Maggio 2025

Pubblicato un nuovo aggiornamento per RAWeb, la piattaforma di RetroAchievements.org che gestisce obiettivi, dati di gioco e funzionalità per la community.

L’applicazione, sviluppata con Laravel (TALL stack), permette agli utenti di interagire con il sistema di RetroAchievements per tracciare i progressi nei giochi e condividerli con altri membri della community.

Tra le novità più rilevanti di questa nuova versione spicca l’introduzione del supporto per i maintainer degli achievement, una funzione che permette una gestione più strutturata e collaborativa degli obiettivi nei giochi.

L’interfaccia della sezione Downloads ha ricevuto un restyling significativo sia in termini grafici sia funzionali, grazie alla migrazione a React, migliorando l’esperienza d’uso generale.

Sul fronte forum, sono stati introdotti diversi miglioramenti: i moderatori ora possono bloccare le discussioni, la creazione e modifica dei post è più veloce, e viene mostrato il messaggio “ultima modifica” solo se l’edit avviene dopo più di due minuti dalla pubblicazione.

Inoltre, è stata ottimizzata la compatibilità con strumenti come Google Translate, e il sistema genera ora automaticamente le descrizioni meta dei topic per una migliore indicizzazione.

Anche la sezione messaggi è stata potenziata, con l’introduzione di caselle di posta condivise selezionabili, utili per i team. Alcuni elementi dell’interfaccia, come la paginazione, sono stati riprogettati per una navigazione più chiara.

Sono stati inoltre risolti diversi bug che riguardavano il caricamento delle note codice, la corretta visualizzazione degli orari nei forum, la gestione dei commenti cancellati nei ticket e l’autocompletamento non voluto in alcuni campi.

Infine, sul lato ambientale e infrastrutturale, è stato eliminato codice obsoleto legato a vecchi shortcode nei forum, e sono stati avviati i primi passi per costruire una nuova pagina di gioco in React, segno che la transizione tecnologica continua.

Anche il sistema di logging è stato reso più silenzioso per evitare errori SSR causati da traduzioni automatiche.

Requisiti

Per eseguire RAWeb localmente, sono necessari i seguenti componenti:

Server web locale: È necessario un server web per eseguire l’applicazione.
PHP 8.2: La piattaforma richiede PHP 8.2, con diverse estensioni abilitate (come curl, gmp, mysqli, pdo_mysql, gd, intl, sockets).
Composer: Il gestore di dipendenze PHP, necessario per installare le librerie richieste da RAWeb.
MariaDB 10: Il database supportato per memorizzare i dati.
Node.js 20 e pnpm 9: Questi strumenti sono utilizzati per la gestione dei pacchetti frontend e la build degli asset.

RAWeb è compatibile con i seguenti sistemi operativi e configurazioni:

Windows, macOS, Linux.
Diverse opzioni di configurazione sono disponibili: Docker (con Laravel Sail), XAMPP e Laravel Valet per macOS.

Opzioni di configurazione

Esistono diverse opzioni per configurare RAWeb:

Docker Compose (Windows, Linux, macOS):
Utilizzando Laravel Sail, l’ambiente di sviluppo viene creato automaticamente con i container Docker. La documentazione di Laravel Sail descrive i passaggi dettagliati. Una volta configurato, è possibile avviare i container con il comando sail up o in modalità demone con sail up -d.
XAMPP (Windows, Linux, macOS):
È necessario installare XAMPP con PHP 8.2, che include un server Apache, MySQL/MariaDB e PHP. Si dovranno abilitare alcune estensioni in php.ini (come curl, gmp, mysqli, ecc.) per garantire la compatibilità con le dipendenze di RAWeb.
Laravel Valet (macOS):
Se si utilizza Laravel Valet su macOS, è possibile configurare facilmente l’ambiente locale. Valet agisce come driver per l’ambiente di sviluppo e fornisce una configurazione web locale senza complicazioni.

Installazione di RAWeb

Una volta che il server e le dipendenze sono configurati, l’installazione di RAWeb avviene in due fasi principali:

Installazione delle dipendenze: Dopo aver clonato il repository di RAWeb, eseguire composer install per installare tutte le librerie necessarie. Se si desidera utilizzare la versione locale di composer.phar invece di una globale, si può eseguire php composer.phar install.
Configurazione dell’ambiente: È necessario eseguire il comando composer setup per configurare correttamente l’ambiente. Questo script imposterà le variabili di ambiente e le configurazioni iniziali. Durante questa fase, si consiglia di adattare il file .env con le credenziali del database e l’URL dell’applicazione.

Configurazione dell’ambiente (.env)

Il file .env contiene valori predefiniti sensati, ma potrebbero essere necessarie alcune modifiche:

Credenziali del database: Impostare i valori per la connessione al database locale (DB_*).
Configurazione dell’URL dell’applicazione: Impostare l’URL dell’applicazione (APP_URL). Per esempio, se si usa Docker, l’URL potrebbe essere http://localhost:64000. Con Valet, potrebbe essere https://raweb.test.

Se si sta utilizzando un ambiente Docker, non sono necessarie ulteriori configurazioni specifiche, poiché l’applicazione rileverà automaticamente la configurazione del container Laravel Sail.

Se si utilizza XAMPP o Valet, sarà necessario regolare l’URL dell’applicazione e configurare correttamente i virtual host o il dominio.

Costruzione e configurazione del frontend

Per generare gli asset frontend:

Installazione delle dipendenze frontend: Utilizzare pnpm install per installare le dipendenze necessarie.
Costruzione degli asset: Eseguire pnpm build per creare la build finale. Con Docker Sail, è possibile eseguire questi comandi tramite sail pnpm install e sail pnpm build.
Creazione dei symlink per il filesystem: Per rendere accessibili i file di archiviazione, eseguire php artisan ra:storage:link --relative per creare i collegamenti simbolici necessari. Anche questo comando è disponibile tramite Sail (sail artisan ra:storage:link --relative).

Configurazione del database

Dopo aver configurato l’ambiente e costruito gli asset, è necessario preparare il database:

Esegui la migrazione: Esegui php artisan migrate per applicare le migrazioni e configurare il database.
Popola il database con dati di test: Usa il comando php artisan db:seed per popolare il database con i dati di test. Puoi eseguire anche questo comando tramite Sail (sail artisan db:seed).

Accesso all’applicazione

A seconda dell’ambiente scelto, puoi accedere all’applicazione nel seguente modo:

Docker: http://localhost:64000
XAMPP: in base alla configurazione del vhost di Apache.
Laravel Valet: per esempio, https://raweb.test, a seconda della configurazione del dominio.

Utilizzo per lo sviluppo di obiettivi

Se desideri sviluppare obiettivi localmente, puoi aggiungere un file host.txt nella directory di RALibRetro accanto al file RAIntegration.dll. Questo file deve contenere l’URL del tuo server locale, che potrebbe essere uno dei seguenti:

http://localhost:64000 se stai eseguendo il server tramite Docker.
https://raweb.test se stai utilizzando Valet.
http://raweb.test se il vhost è configurato correttamente.

Sicurezza

Per gestire eventuali vulnerabilità di sicurezza, consulta la Security Policy di RetroAchievements.org, che fornisce indicazioni su come gestire i rischi e proteggere la piattaforma.

In questo modo, puoi configurare e utilizzare RAWeb per gestire obiettivi, giochi e funzionalità della community direttamente dal tuo server locale.

Changelog

Nuove funzionalità

Obiettivi: Aggiunto il supporto per i manutentori degli achievement, by @wescopeland in #3452
Download: Migliorata l’interfaccia utente e l’esperienza d’uso, con migrazione a React, by @wescopeland in #3409, #3465 e #3473
Forum: Consentito ai moderatori di bloccare gli argomenti, by @wescopeland in #3463
Forum: Migliorate le prestazioni dell’interfaccia utente durante la creazione e modifica dei post, by @wescopeland in #3470
Forum: L’etichetta “ultima modifica” appare solo se l’edit avviene più di due minuti dopo la creazione del post, by @wescopeland in #3471
Messaggi: Aggiunto il supporto per caselle di posta selezionabili nei team, by @wescopeland in #3435
Varie: Ridisegnati alcuni controlli di paginazione, by @wescopeland in #3461

Correzioni

Note di codice: Corretta la visualizzazione delle note per i tester di compatibilità, by @Jamiras in #3467
Forum: Generazione delle meta descrizioni degli argomenti ora gestita sul back-end, by @wescopeland in #3464
Forum: Riorganizzazione di alcune proprietà per una migliore compatibilità con Google Translate, by @wescopeland in #3460
Forum: Corretta la visualizzazione del timestamp al momento dell’invio, by @wescopeland in #3457
Varie: Disabilitato l’autocompletamento nativo in alcuni menu a tendina, by @wescopeland in #3469
Ticket: Ora si controlla il ruolo invece dei permessi per la cancellazione dei commenti, by @Jamiras in #3475
Ticket: I commenti eliminati in modo soft non vengono più mostrati, by @wescopeland in #3474

Modifiche alla console di gestione

nessuno

Modifiche alle API

nessuno

Modifiche all’ambiente

Forum: Eliminati numerosi vecchi codici legacy relativi agli shortcode by @wescopeland in #3459
Giochi: Creata una versione molto basilare della pagina di gioco in React by @wescopeland in #3431, #3442, #3439
Log: Silenziati gli errori SSR causati da Google Translate, by @wescopeland in #3451