Descrizione
Asset Lending Manager è un plugin WordPress open source che aiuta una organizzazione a gestire risorse fisiche condivise e flussi interni di prestito.
È pensato per club, associazioni, scuole, enti pubblici, biblioteche, laboratori, makerspace e per qualunque gruppo che presta attrezzature o materiali ai propri membri.
I membri possono consultare le risorse disponibili e inviare richieste di prestito, mentre operatori e amministratori possono gestire assegnazioni e cronologia dei prestiti.
Nato all’interno di un’associazione di astrofili per gestire telescopi e attrezzature, è pubblicato come strumento generico utilizzabile da qualsiasi organizzazione.
Richiede il plugin Advanced Custom Fields (ACF), nella versione gratuita, per salvare e gestire i dettagli delle risorse.
Funzionalità
- Gestione di risorse e kit (un kit è un gruppo di elementi prestati insieme come insieme unico)
- Pagina pubblica per la consultazione con ricerca, filtri per tassonomia, etichette QR e ricerca tramite scanner QR
- Flusso di richiesta di prestito con approvazione, rifiuto, assegnazione diretta e annullamento configurabile delle richieste concorrenti in sospeso
- Modulo di contatto opzionale per inviare messaggi email all’attuale proprietario della risorsa
- Notifiche email per i principali eventi del flusso dei prestiti
- Gestione dello stato delle risorse nel frontend per gli operatori: imposta lo stato di manutenzione o ritirata, forza la restituzione delle risorse in prestito e ripristina le risorse come disponibili
- Cronologia completa dei prestiti, oltre a una pagina dedicata alla cronologia completa delle risorse per gli operatori tramite
[almgr_asset_history]. - Due ruoli utente inclusi: Membro e Operatore.
- API REST JSON in sola lettura all’indirizzo
/wp-json/almgr/v1/per l’elenco delle risorse, i dettagli delle risorse, l’elenco dei membri e le risorse dei membri. - Pagina Strumenti nel back-office (ALM Strumenti) con schede Importa, Esporta e Utilità
- Importazione ed esportazione CSV di utenti e risorse, inclusi i componenti dei kit e i relativi campi ACF nei file CSV delle risorse.
- Pronto per la traduzione
Requisiti
Richiede il plugin Advanced Custom Fields (è sufficiente la versione gratuita):
Il plugin registra automaticamente il proprio gruppo di campi ACF, quindi non è necessaria alcuna configurazione manuale dei campi.
Flusso di prestito
- Un membro consulta le risorse disponibili.
- Viene inviata una richiesta di prestito per una risorsa selezionata.
- Le email di notifica vengono inviate al richiedente e, quando applicabile, al proprietario corrente.
- Il proprietario corrente può approvare o rifiutare la richiesta.
- In caso di approvazione, la risorsa viene contrassegnata come in prestito e viene registrato il nuovo assegnatario.
- Operatori e amministratori possono anche assegnare direttamente qualsiasi risorsa che non sia ritirata o in manutenzione, senza una richiesta precedente (quando l’assegnazione diretta è abilitata).
- Gli operatori possono forzare la restituzione di una risorsa in prestito rendendola nuovamente disponibile, oppure ripristinare una risorsa dallo stato di manutenzione o ritirata allo stato disponibile.
- Tutte le decisioni, le assegnazioni e i cambiamenti di stato vengono registrati nella cronologia dei prestiti.
Crediti
Questo plugin include le seguenti librerie JavaScript di terze parti:
- qrcode-generator di Kazuhiko Arase (http://www.d-project.com/), licenza MIT
- jsQR di cozmo (https://github.com/cozmo/jsQR), licenza Apache License 2.0
Entrambe le licenze sono compatibili con GPLv2 o successiva. I file di licenza sono inclusi in assets/js/vendor/.
Screenshot
Installazione
- Installa e attiva il plugin Advanced Custom Fields (ACF); la versione gratuita è sufficiente: https://wordpress.org/plugins/advanced-custom-fields/ Il plugin registra automaticamente il proprio gruppo di campi ACF. Non è richiesta alcuna configurazione manuale di ACF.
- Nell’amministrazione di WordPress vai in Plugin > Aggiungi nuovo > Carica plugin.
- Carica il file ZIP del plugin, fai clic su Installa ora, quindi attivalo.
Temi classici
- Le pagine delle risorse vengono servite automaticamente, senza shortcode:
/asset/— catalogo risorse con ricerca e filtri/asset/nome-risorsa/— pagina di dettaglio della singola risorsa
- Se
/asset/restituisce errore 404, vai in Impostazioni > Permalink e fai clic una volta su Salva modifiche. - La pagina della cronologia completa delle risorse non viene creata automaticamente. Crea una normale pagina di WordPress con lo shortcode
[almgr_asset_history]e assegnala in ALM > Impostazioni > Frontend come Asset history page.
Temi a blocchi
- I temi a blocchi non supportano le sovrascritture automatiche dei template PHP. Crea manualmente tre pagine:
- Aggiungi
[almgr_asset_list]a una pagina: questo sarà il catalogo delle risorse. - Aggiungi
[almgr_asset_view]a una seconda pagina: questa sarà la pagina dei dettagli della risorsa. - Aggiungi
[almgr_asset_history]a una terza pagina: questa sarà la pagina completa della cronologia delle risorse per gli operatori.
- Aggiungi
- In ALM > Impostazioni > Frontend, imposta “Pagina archivio risorse”, “Pagina dettaglio risorsa” e “Pagina cronologia risorsa” sulle pagine appena create. In questo modo, tutti i link alle risorse e alla cronologia rimanderanno alle pagine corrette.
Comune a entrambi
- Configura facoltativamente le impostazioni del mittente delle email in wp-admin alla voce ALM > Impostazioni.
FAQ
-
A chi è destinato questo plugin?
-
A qualsiasi organizzazione che gestisce un insieme condiviso di oggetti fisici: associazioni, scuole, enti pubblici, biblioteche, laboratori, makerspace, società sportive e molto altro.
Il plugin è nato per un’associazione di astrofili, ma è progettato per essere generico e adatto a qualsiasi contesto. -
Questo plugin richiede Advanced Custom Fields?
-
Sì. ACF (versione gratuita) è necessario per salvare e recuperare i campi personalizzati delle risorse. Se ACF non è attivo, il plugin mostra un avviso nell’area di amministrazione.
-
Il plugin gestisce la consegna fisica delle risorse?
-
No. Consegna e passaggio materiale delle risorse avvengono offline. Il plugin tiene traccia solo delle richieste e delle assegnazioni.
-
Esiste una pagina impostazioni in wp-admin?
-
Sì. Nel menu ALM di wp-admin puoi configurare il mittente email, le regole dei prestiti (numero massimo di prestiti attivi per membro, limiti di lunghezza dei messaggi) e altre opzioni del flusso di lavoro.
-
Quali shortcode sono disponibili e quando devo usarli?
-
Il plugin fornisce tre shortcode:
[almgr_asset_list] per il catalogo delle risorse,
[almgr_asset_view] per la visualizzazione dei dettagli della singola risorsa,
and[almgr_asset_history]per la pagina della cronologia completa delle risorse (solo operatori).
On classic themes, le pagine del catalogo e dei dettagli vengono generalmente fornite automaticamente, quindi lo shortcode della cronologia è quello più comunemente necessario.
On block themes, crea e assegna manualmente tutte e tre le pagine degli shortcode in ALM > Impostazioni> Frontend. -
Il plugin è pronto per la traduzione?
-
Sì. Inglese e italiano sono inclusi. Altre lingue possono essere aggiunte tramite gli strumenti standard di traduzione di WordPress.
-
Quali dati vengono rimossi quando il plugin viene disinstallato?
-
La disinstallazione del plugin rimuove le impostazioni del plugin, la cronologia delle richieste di prestito, le richieste di prestito in sospeso e i ruoli utente personalizzati.
Per impostazione predefinita, l’inventario delle risorse (post e relativi dati) viene mantenuto.
Se vuoi rimuovere tutti i dati del plugin, definisciALMGR_REMOVE_ALL_DATAcometrueinwp-config.phpprima della disinstallazione. -
Qual è la differenza tra una risorsa e un kit?
-
Una risorsa è un singolo oggetto fisico (per esempio un telescopio, un libro o una fotocamera). Un kit è una raccolta di elementi prestati insieme come gruppo (per esempio un telescopio con oculari e custodia). La gestione dei kit consente di tracciare tutti i componenti sotto un’unica richiesta di prestito.
-
Più membri possono richiedere la stessa risorsa contemporaneamente?
-
Sì. Più membri possono inviare contemporaneamente richieste per la stessa risorsa. Per impostazione predefinita, quando una richiesta viene approvata o la risorsa viene assegnata direttamente, tutte le altre richieste in sospeso per quella risorsa vengono annullate automaticamente (questo comportamento è configurabile) e i richiedenti ricevono una notifica via email quando le notifiche sono abilitate.
-
Serve uno sviluppatore per configurare questo plugin?
-
Sui temi classici, la configurazione di base richiede generalmente solo l’installazione del plugin e l’attivazione di ACF; le pagine delle risorse vengono create automaticamente, ad eccezione dell’eventuale pagina completa della cronologia delle risorse.
Sui temi a blocchi, è necessario creare manualmente tre pagine con shortcode e assegnarle nelle impostazioni del plugin: catalogo, dettaglio della risorsa e cronologia completa delle risorse.
Recensioni
Non ci sono recensioni per questo plugin.
Contributi e sviluppo
“Asset Lending Manager” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.
Collaboratori
Traduci “Asset Lending Manager” nella tua lingua.
Ti interessa lo sviluppo?
Esplora il codice segui il repository SVN, segui il log delle modifiche tramite RSS.
Changelog
Per le note di rilascio complete consulta CHANGELOG.md.
0.3.2
- Risolto: Formattazione di installazione per i temi classico e a blocchi.
0.3.1
- Corretto: verificata la compatibilità con WordPress 7.1; non sono state necessarie modifiche al codice.
0.3.0
- Aggiunta: pagina della cronologia completa delle risorse per gli operatori tramite
[almgr_asset_history]. - Aggiunto: modulo di contatto opzionale per inviare messaggi email all’attuale proprietario della risorsa.
- Corretto: l’approvazione dei prestiti dei kit, l’assegnazione diretta e le modifiche dello stato ora interessano solo i componenti idonei; i componenti esclusi vengono ignorati in modo sicuro e segnalati all’operatore.
- Corretto: il comportamento dei kit durante le operazioni di manutenzione e ripristino e la gestione della scrittura dei dati ACF sono ora più solidi e coerenti.
- Corretto: le azioni degli operatori (assegnazione diretta, modifica dello stato e ripristino) ora rifiutano le risorse non pubblicate.
- Corretto: il campo di ricerca dell’elenco delle risorse non entra più in conflitto con la variabile di query di ricerca riservata da WordPress.