Pubblicato un rapido aggiornamento per RAWeb, la piattaforma sviluppata da RetroAchievements.org per la gestione di obiettivi, dati di gioco e funzionalità dedicate alla community.

L’applicazione, realizzata in Laravel sfruttando il TALL stack, si conferma così uno degli strumenti più versatili e in costante crescita per gli appassionati che vogliono monitorare i propri progressi e condividere le esperienze con altri utenti.

Our latest website update is now live!

– Dedicated page for Patreon.
– Site awards can be reordered based on mastery date.
– Team members can interact with forums through their own accounts.

For all changes, check out https://t.co/Xvtbaymazd or https://t.co/bqcAaACkw2 pic.twitter.com/wr0rNVnnPq

— RetroAchievements (@RetroCheevos) August 28, 2025

L’aggiornamento introduce diverse novità, tra cui la possibilità di creare e gestire discussioni sui forum attraverso account di team, una pagina dedicata ai sostenitori di Patreon e nuove opzioni per riordinare i riconoscimenti del sito.

Migliorato inoltre il sistema di ricerca, che ora mostra informazioni più complete sui giochi, e potenziato il supporto per le integrazioni con Discord.

Sul fronte delle correzioni sono stati risolti numerosi problemi, come la duplicazione degli utenti attivi, la gestione dei profili sviluppatore e dei ticket, oltre a una serie di bug legati a notifiche, impostazioni e tooltip.

Parallelamente, sono stati ottimizzati i tempi di caricamento, in particolare per le pagine delle classifiche e per le query su giocatori e giochi, insieme a un miglioramento della gestione dei bundle JavaScript e delle API, ora più efficienti nella costruzione dei payload.

Non mancano infine le anticipazioni sulle funzionalità future: le pagine dei giochi in React riceveranno nuove schede, elementi grafici migliorati e un sistema di navigazione più chiaro per sviluppatori e contributor.

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:

1. 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.
2. 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.
3. 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:

1. 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.
2. 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:

1. Installazione delle dipendenze frontend: Utilizzare pnpm install per installare le dipendenze necessarie.
2. 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.
3. 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:

1. Esegui la migrazione: Esegui php artisan migrate per applicare le migrazioni e configurare il database.
2. 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à

• Forum: Consentita la creazione di discussioni, risposte e modifiche ai post per conto degli account di team (by @wescopeland in #3796)
• Sostenitori Patreon: Aggiunta una pagina dedicata (by @wescopeland in #3799)
• Riordino Premi del Sito: Aggiunto pulsante per resettare l’ordine (by @ludvigrosenqvist in #3795)
• Search 2.0: Visualizzazione di pointsTotal nei risultati di ricerca dei giochi (by @wescopeland in #3827)
• Inbox dei Team: Migliorati i webhook di Discord (by @wescopeland in #3801)

Correzioni

• Giocatori Attivi: Corretto bug che mostrava più righe per lo stesso utente (by @wescopeland in #3826)
• Profilo Sviluppatore: Risolta perdita di username stabili (by @wescopeland in #3825)
• Multiset: Evitata l’orphanizzazione degli obiettivi quando un set viene declassato (by @Jamiras in #3833)
• Notifiche: Ora rispettano le preferenze dell’utente per le email sui commenti degli obiettivi (by @wescopeland in #3798)
• Impostazioni: Risolto avviso Radix incontrollato nei tooltip (by @wescopeland in #3816)
• Ticket: Corretto bug che impediva a non-sviluppatori con nome personalizzato di chiudere segnalazioni errate (by @Jamiras in #3830)
• Tooltip: Eliminati i tooltip orfani quando le pagine si caricavano troppo velocemente (by @wescopeland in #3814)

Modifiche alla console di gestione

Nessuna

Miglioramenti alle prestazioni

• Conteggio Giocatori per Gioco: Ottimizzata query cold cache (by @wescopeland in #3818)
• Bundle JS: Ottimizzato il caricamento script Vite (by @wescopeland in #3806)
• Pagine Classifiche: Risolto problema N+1 query (by @wescopeland in #3817)

Modifiche alle API

• API_GetGameList: Ottimizzata significativamente la costruzione dei payload (by @wescopeland in #3810)

Modifiche all’ambiente

• Dipendenze: Aggiornato linkify alla versione 4.3.2 (by @wescopeland in #3831)

Funzionalità future

• Pagine Giochi in React: Aggiunta visualizzazione di achievementsFirstPublishedAt (by @wescopeland in #3823)
• Pagine Giochi in React: Introdotti pulsanti per le schede multiset (by @wescopeland in #3824)
• Pagine Giochi in React: Rimosse animazioni al componente playtime al montaggio (by @wescopeland in #3822)
• Pagine Giochi in React: Evitato il conteggio doppio degli autori come contributor (by @wescopeland in #3815)
• Pagine Giochi in React: Attivata la sezione Development nella sidebar per junior developer (by @wescopeland in #3800)
• Pagine Giochi in React: Collegati i redirect per i multiset (by @wescopeland in #3805)

Download: Source code RAWeb 2025.08.28

Fonte: x.com