 |
Sommario | Trasforma una tabella in un argomento in elementi ricercabili che i membri possono menzionare con +, completi di link e anteprime onebox. |
 |
Repository | Discourse Mentionables |
 |
Guida all’installazione | Installare plugin su un sito Discourse self-hosted |
 |
Sponsorizzazione | Si prega di considerare la sponsorizzazione dello sviluppo continuo per aiutare a mantenere questi plugin aggiornati e funzionanti con le versioni correnti di Discourse. |
Fornisci alla tua community un vocabolario condiviso per gli argomenti di cui parla: libri,
prodotti, progetti, luoghi, risorse di supporto o qualsiasi altra cosa con un URL.
I membri digitano + e parte di un nome, scelgono una suggerimento e ottengono un link leggibile senza dover ricordare l’indirizzo.
Funzionalità
- Inizia solo con gli URL. L’importatore recupera i nomi e genera gli slug; aggiungi
i tuoi nomi e slug come override opzionali. - Cerca mentre scrivi. Digita
+o usa il pulsante della barra degli strumenti del compositore per cercare
nel tuo catalogo. Funziona sia nei compositori Markdown che in quelli con testo ricco. - Link inline leggibili. Le menzioni appaiono come pillole compatte utilizzando il nome visualizzato dell’elemento, con uno slug stabile nel Markdown del post.
- Onebox nativi. Metti una menzione su una riga propria per mostrare un onebox utilizzando
i layout esistenti di Discourse e le destinazioni supportate. - Anteprime desktop. Passa il mouse o metti a fuoco una pillola inline per aprire un’anteprima fluttuante
con un link Apri pagina originale. I clic normali aprono la destinazione. - Un catalogo che i tuoi amministratori possono modificare in Discourse. Importa da una tabella Markdown
nel post iniziale di un argomento. Non sono necessari account Google o credenziali API. - Un pulsante tabella per gli amministratori. Inserisci una tabella mentionables vuota dalla
barra degli strumenti del compositore, quindi compila i tuoi elementi.
L’aspetto dell’onebox dipende dalla destinazione e dal normale supporto onebox di
Discourse. Le destinazioni non supportate rimangono link. Le card fluttuanti richiedono il login;
gli ospiti possono comunque seguire il link di destinazione. Le menzioni nel codice vengono lasciate invariate,
e le menzioni nelle elenchi e nelle citazioni restano inline.
Basic Mentionables e l’estensione Pro
Basic Mentionables è il plugin di base. Pro è un plugin compagno opzionale
installato insieme ad esso; Pro include le funzionalità di base tramite quella dipendenza.
| Funzionalità | Basic Mentionables | Con estensione Pro |
|---|---|---|
| Importa una tabella Markdown dal post iniziale di un argomento | Sì | Sì |
| Mantieni l’argomento sorgente in una categoria riservata | Sì | Sì |
| Pulsante compositore solo per amministratori per inserire uno scheletro di tabella | Sì | Sì, incluse le colonne icone |
Cerca con + nei compositori Markdown e testo ricco |
Sì | Sì |
| Pillole di menzione inline e onebox nativi autonomi | Sì | Sì |
| Anteprime fluttuanti al passaggio del mouse o focus da tastiera su desktop | Sì | Sì, nella modalità hover predefinita |
| Importa da Google Sheets usando un account di servizio | — | Sì |
| Seleziona tra tabelle degli argomenti e Google Sheets | Solo tabelle argomenti | Sì |
| Sincronizzazione automatica ogni 12 ore | — | Opzionale, disattivata di default |
| Importa nomi icone e colori HTML opzionali | — | Sì, da entrambe le sorgenti |
| Apri anteprime fluttuanti al click o tap, inclusi dispositivi touch | — | Opzionale |
Le colonne icon e icon_colour di Pro aggiungono un’icona colorata prima del nome
della menzione. Ad esempio, usa book e #2563eb per un manuale. Con
mentionables_pro_click_to_preview abilitato, facendo clic o toccando una pillola si apre la sua
anteprima; il link Apri pagina originale nell’anteprima ti porta alla destinazione.
Configurazione rapida
-
Installa il plugin di base utilizzando la guida all’installazione sopra. Ricostruisci Discourse
dopo l’installazione. -
Crea un argomento per il tuo catalogo. Come amministratore, usa Inserisci tabella mentionables
nella barra degli strumenti del compositore o incolla questa tabella nel post iniziale:| name | url | slug | image_url | | ------------------ | ----------------------------------- | ------------------ | --------- | | Getting started | https://example.com/getting-started | getting-started | | | Community handbook | https://example.com/handbook | community-handbook | | | Events calendar | https://example.com/events | events-calendar | | -
Sostituisci gli URL di esempio con i tuoi, salva il post e imposta
mentionables_topic_idsull’ID numerico di quell’argomento. Mantienimentionables_enabled
abilitato. Le installazioni Pro dovrebbero selezionaretopic_tableinmentionables_source
per questa configurazione. -
Apri Admin → Plugin → Mentionables, fai clic su Avvia importazione, quindi su
Aggiorna per ispezionare il report. Il worker dei job in background deve essere in esecuzione. -
Ricarica il browser, apri un compositore e digita
+per provare i tuoi elementi.
Usa nomi delle colonne in minuscolo. Solo url è obbligatorio, che inizia con http://
o https://. Le righe con solo URL recuperano un nome dalla destinazione e generano
uno slug. Puoi fornire name, slug o entrambi per sovrascrivere quei valori predefiniti, mescolando
queste opzioni all’interno di una tabella. Se non è disponibile un titolo, l’URL diventa il
nome visualizzato. Gli URL esistenti mantengono i loro slug quando la sorgente li omette.
image_url e description sono opzionali.
L’importatore legge la prima tabella non quotata con una colonna url nel post iniziale.
Le risposte, le tabelle quotate e gli esempi di codice recintati vengono ignorati. Gli argomenti sorgente
devono essere argomenti regolari, non eliminati, anziché messaggi personali.
Privacy della sorgente e aggiornamento del catalogo
Puoi mantenere l’argomento sorgente in Staff o in un’altra categoria riservata in modo che solo
persone fidate possano mantenerlo. I nomi, gli URL e le immagini importati sono
accessibili agli utenti di mentionables. Limitare l’argomento non rende privato il
catalogo importato. Tieni le informazioni riservate fuori dalla tabella.
Ogni importazione sincronizza per URL: gli URL corrispondenti vengono aggiornati, i nuovi URL creano record,
e gli URL rimossi dalla sorgente eliminano i record. L’intera sorgente deve essere
valida; URL o slug duplicati, righe non valide, fallimenti di fetch e set di dati vuoti
lasciano il catalogo invariato. Usa Elimina tutto per una cancellazione intenzionale.
Gli argomenti sorgente e i fogli di calcolo non vengono mai modificati. L’impostazione opzionale di Pro
mentionables_pro_sync_enabled esegue la stessa importazione ogni 12 ore.
Ricarica il browser dopo l’importazione. I post cotti esistenti non vengono automaticamente
ricotti, e la modifica esplicita di uno slug può rompere i riferimenti precedenti +slug.
Impostazioni e ulteriori informazioni
| Impostazione | Scopo |
|---|---|
mentionables_enabled |
Abilita o disabilita Mentionables. |
mentionables_topic_id |
Argomento contenente la tabella sorgente nel suo post iniziale. |
mentionables_autocomplete_limit |
Numero massimo di suggerimenti; predefinito a cinque. |
mentionables_onebox_fallback |
Recupera anche immagini/descrizioni mancanti quando viene fornito un nome; disattivato di default. |
Vedi il README per la guida completa alla configurazione, il comportamento di importazione e
la risoluzione dei problemi. Gli screenshot utilizzano dati di esempio dai fixture di test del plugin.
