Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Il portale Servizi per gli sviluppatori ti consente di creare blog e forum con conversazioni in thread:
- L'assistenza blog consente agli utenti di creare, modificare ed eliminare i post del blog. Inoltre, le autorizzazioni basate sui ruoli consentono di limitare le azioni del blog a tipi di utenti specifici.
- I forum consentono agli utenti di creare discussioni in thread con moderazione basata sui ruoli. Puoi aggiungere forum al portale, gruppi di forum in una gerarchia e configurare ruoli utente per controllare l'accesso ai forum.
Lavorare con i blog
Il portale consente agli utenti con i privilegi necessari di creare, modificare ed eliminare i post del blog. I blog sono costituiti da singoli post con timestamp e visualizzati per data. Chiunque, inclusi gli utenti anonimi, può visualizzare i post del blog più recenti utilizzando il link di navigazione fornito nella home page del portale.
Qualsiasi utente che disponga dei privilegi necessari può commentare un post del blog. I commenti possono essere visualizzati non appena vengono inseriti, oppure puoi configurare il portale per gli sviluppatori in modo che i commenti vengano moderati prima di essere visualizzati. Per impostazione predefinita, gli utenti anonimi non possono pubblicare commenti.
Informazioni sui tipi di blog
Il portale supporta due tipi di blog a seconda della versione del portale:
- Il blog standard implementato nel modulo Blog di Drupal viene utilizzato per impostazione predefinita con le versioni del portale precedenti alla versione 14.02.156.1.
- Il blog personalizzato Apigee con una visualizzazione personalizzata dei post, supporto per i tipi di contenuti di immagini, audio e video e una barra degli strumenti di modifica in stile Tumblr, come implementata dai moduli Apigee Drupal personalizzati. La versione 14.02.156.1 e successive del portale utilizzano il blog personalizzato Apigee per impostazione predefinita. È possibile eseguire l'upgrade dei portali esistenti per utilizzare il nuovo blog nell'ambito dell'upgrade alla versione 14.02.156.1.
Il blog personalizzato è definito da tre moduli Drupal personalizzati forniti da Apigee. La seguente tabella descrive questi moduli:
| Modulo | Definizione |
|---|---|
| Blog di DevConnect | Definisce le funzionalità di base del blog. |
| Menu creazione contenuti Devconnct | Definisce il menu che ti consente di creare diversi tipi di contenuti del blog. |
| Tipi di contenuti del blog devconnect | Definisce i tipi di contenuti speciali Drupal per il blog: immagine, audio e video. Senza questo modulo, puoi creare solo voci di blog di tipo articolo. |
Determinazione della versione del portale e dei tipi di blog supportati:
Puoi individuare la versione del portale utilizzando il seguente comando cURL:
$ curl <portal url>/buildInfo
Se vuoi utilizzare il blog personalizzato, assicurati che la tua versione sia 14.02.156.1 o successiva.
Upgrade di un portale esistente per utilizzare i moduli di blog personalizzati Apigee:
- Assicurati che sia stato eseguito l'upgrade del portale alla versione 14.02.156.1 o successiva.
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Moduli nel menu Drupal.
- Disattiva il modulo Blog.
- Abilita i seguenti tre moduli personalizzati Apigee:
- Blog di DevConnect
- Devconnct Menu per la creazione dei contenuti
- Tipi di contenuti del blog devconnect
- Salva la configurazione.
Visualizzare un blog
Il portale per gli sviluppatori mostra i post recenti del blog nella pagina del blog. Le voci del blog vengono visualizzate in ordine decrescente in base all'ora di creazione. Per visualizzare la pagina Blog, seleziona Blog nel menu principale del portale per gli sviluppatori.
Inoltre, il portale per gli sviluppatori è inizialmente configurato in modo da visualizzare i post del blog recenti nella home page. Le voci vengono inoltre visualizzate in ordine decrescente in base all'ora di creazione.
Impostazione delle autorizzazioni per il blog
In qualità di amministratore, puoi stabilire le autorizzazioni necessarie per eseguire azioni sul blog, come la creazione, la modifica e l'eliminazione di post.
Puoi anche configurare le autorizzazioni necessarie per pubblicare, modificare ed eliminare i commenti del blog e se il commento di un utente deve essere moderato. Se un commento non deve essere moderato, viene visualizzato immediatamente. Se il commento deve essere moderato, l'approvazione deve essere approvata da un utente del portale con l'autorizzazione necessaria a moderare i commenti.
Per impostare le autorizzazioni per i blog:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Persone nel menu Drupal.
- Seleziona il link Autorizzazioni nella parte superiore della pagina Persone.
- Scorri verso il basso fino all'area Commento della pagina.
- Nell'area Commento, imposta le seguenti autorizzazioni che controllano quali utenti possono aggiungere, visualizzare, modificare e approvare i commenti:
- Amministrazione dei commenti e delle impostazioni dei commenti
- Visualizza commenti
- Commenti al post
- Salta approvazione commento
- Modificare i propri commenti
- Scorri verso il basso fino all'area Nodo della pagina.
- Nell'area Nodo, imposta cinque diverse autorizzazioni per controllare quali utenti possono aggiungere, modificare ed eliminare i post del blog:
- Voce del blog: Creare nuovi contenuti
- Voce del blog: Modificare i propri contenuti
- Voce del blog: modifica i contenuti
- Voce di blog: Eliminare i propri contenuti
- Voce del blog: eliminazione dei contenuti
- Salva la configurazione.
Aggiunta di un post del blog
Tutti gli utenti che dispongono delle autorizzazioni necessarie possono creare un post di blog. Tuttavia, puoi configurare ruoli utente in modo che un utente possa aggiungere e modificare la propria voce del blog, ma non eliminarla. In alternativa, possono aggiungere, modificare ed eliminare la propria voce del blog, ma non modificare le voci del blog di altri utenti.
Se la tua versione del portale utilizza il modulo Blog Drupal, viene visualizzato il seguente pulsante per consentirti di creare un post per il blog:
Viene visualizzata la pagina predefinita per la modifica del blog:
Se utilizzi il blog personalizzato Apigee e hai abilitato il supporto per tutti i tipi di contenuti del blog, viene visualizzato il seguente menu per consentirti di creare voci di blog di diversi tipi:
Seleziona il pulsante relativo al tipo di contenuti appropriato per creare la nuova voce di blog. A seconda del tipo di contenuti selezionato, viene visualizzato il seguente editor:
I pulsanti in basso a destra ti consentono di aggiungere contenuti definiti dal progetto Bootstrap, tra cui un carosello, una featurette, jumbotron e trifold.
L'area inferiore ti consente di aggiungere i contenuti multimediali associati. Ad esempio, nella figura precedente per il tipo di contenuti video, puoi aggiungere un video alla voce del blog.
Per aggiungere un post al blog:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Blog nel menu di navigazione del portale per gli sviluppatori.
- Seleziona Crea nuova voce di blog (modulo Blog Drupal) o il tipo di contenuti (blog personalizzato Apigee).
- Aggiungi i contenuti nelle sezioni Titolo e Corpo.
- Se applicabile, fai clic su Modifica riepilogo per aggiungerne uno.
- Inserisci un elenco di parole chiave separate da virgole. Queste parole chiave vengono utilizzate per popolare la visualizzazione Argomenti più frequenti nella pagina del blog. Facoltativamente, puoi aggiungere la visualizzazione Argomenti principali alla home page o a qualsiasi altra pagina.
A seconda del tipo di voce del blog, potrebbe essere necessario espandere l'area Meta tag della pagina per inserire parole chiave. - Fai clic su Salva.
Il blog viene pubblicato nella prima pagina del blog ed è elencato nella Home page nell'area Post del blog recenti.
Quando crei una nuova voce di blog, il modulo Blog registra informazioni di base sui contenuti, inclusi ID autore, data di creazione e tipo di contenuti.
Moderare i commenti del blog
Gli utenti del portale per gli sviluppatori possono pubblicare commenti nei post del blog. Per impostazione predefinita, un utente deve aver eseguito l'accesso al portale per pubblicare un commento. La possibilità degli utenti di visualizzare, pubblicare, modificare e approvare i commenti dipende dal loro ruolo e dalle autorizzazioni, come descritto sopra.
Per moderare un commento:
- Accedi al portale come utente con privilegi di amministratore o di approvazione dei commenti.
- Seleziona Contenuti > Commenti nel menu di amministrazione di Drupal.
- Seleziona il link Commenti Pubblicati o Commenti Non approvati.
- Utilizza questa pagina per moderare i commenti.
Configurazione della visualizzazione della pagina del blog
Il portale per gli sviluppatori utilizza una visualizzazione Drupal, denominata Elementi taggati come visualizzazione di contenuti del blog, per controllare la visualizzazione delle voci del blog nella pagina del blog. Per impostazione predefinita, le voci del blog sono elencate in ordine decrescente in base alla data di creazione.
Per configurare la visualizzazione del blog:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Struttura > Viste nel menu di amministrazione di Drupal.
- Seleziona il link Modifica nella riga relativa alla visualizzazione Elementi taggati come contenuti del blog (Contenuti). Viene visualizzata la pagina seguente che
puoi utilizzare per configurare la vista:
- Modifica la visualizzazione.
- Salva le modifiche.
Configurazione della visualizzazione degli argomenti più seguiti per le voci di blog
Il portale per gli sviluppatori utilizza una visualizzazione Drupal, chiamata Hot Topics, per controllare la visualizzazione di Hot Topic per le voci del blog nella pagina del blog. Per impostazione predefinita, gli elementi Argomento principale corrispondono alle parole chiave aggiunte ai post del blog.
Per configurare la visualizzazione Argomenti più attivi:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Struttura > Viste nel menu di amministrazione di Drupal.
- Seleziona il link Modifica nella riga della visualizzazione Argomenti di interesse (contenuti). Viene visualizzata la pagina che puoi utilizzare per configurare la vista.
- Modifica la visualizzazione.
- Salva le modifiche.
Lavorare con i forum
I forum consentono agli utenti con i privilegi necessari di creare discussioni in thread con funzionalità simili ad altri sistemi di bacheca. Un argomento è contenuto all'interno di un forum e ogni forum può contenere molti argomenti. Gli argomenti possono anche avere i propri URL.
Gli utenti pubblicano nuovi argomenti in un forum. Ogni argomento del forum è composto da un post iniziale, oltre a risposte o commenti. A seconda dei privilegi dell'utente, quest'ultimo può modificare ed eliminare i propri post, nonché modificare ed eliminare i post di altri utenti.
Per impostazione predefinita, gli utenti anonimi possono visualizzare i post ma non possono pubblicare le risposte. Solo gli utenti autenticati con i privilegi necessari possono rispondere a un post. Le risposte vengono visualizzate non appena vengono inserite, ovvero non vengono moderate.
Gli amministratori impostano le autorizzazioni necessarie per pubblicare, modificare post esistenti ed eliminare post. Gli amministratori possono anche promuovere post del forum nell'area Discussioni dei forum della home page.
Determinazione del modulo Drupal utilizzato dai forum
Il portale utilizza due moduli Drupal per implementare i forum:
- Il modulo Forum Drupal è il modulo del forum principale e viene utilizzato per impostazione predefinita dalle release del portale precedenti alla versione 14.02.156.1.
- Il modulo Drupal Advanced Forum migliora il modulo principale del forum per aggiungere funzionalità aggiuntive, tra cui stili migliorati, ricerca rapida di argomenti attivi, argomenti senza risposta, nuovi argomenti e altro ancora. La versione 14.02.156.1 e successive del portale utilizzano il modulo Drupal Advance Forum per impostazione predefinita.
Per determinare quale modulo è attivo:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Moduli nel menu Drupal.
- Inserisci "forum" nell'elenco dei filtri nella parte superiore della pagina Moduli.
- Se il modulo Forum avanzato è elencato ed è abilitato, significa che stai utilizzando il modulo Forum avanzato.
- Se il modulo Forum avanzato non è presente o è disattivato e il modulo Forum è attivato, significa che stai utilizzando il modulo principale Forum.
In alternativa, puoi individuare la versione del portale utilizzando il seguente comando cURL:
$ curl <portal url>/buildInfo
Configurazione del modulo Forum avanzato
Il modulo Forum avanzato contiene impostazioni di configurazione che controllano la visualizzazione dei forum, i breadcrumb e altre caratteristiche visive dei forum.
Per configurare il modulo Forum avanzati:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Configurazione > Creazione di contenuti > Forum avanzato nel menu Drupal. Viene visualizzata la pagina Forum avanzato.
- Imposta le opzioni di visualizzazione.
- Salva la configurazione.
Impostazione delle autorizzazioni per i forum
In qualità di amministratore, puoi stabilire le autorizzazioni necessarie per eseguire azioni nei forum. Puoi impostare le autorizzazioni utilizzate sia dal modulo Forum avanzati e Forum e impostando autorizzazioni specifiche per ciascun modulo.
Per impostare le autorizzazioni per i forum:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Persone nel menu Drupal.
- Seleziona il link Autorizzazioni nella parte superiore della pagina Persone.
- Se utilizzi il modulo Forum avanzati, scorri verso il basso fino all'area Forum avanzati e imposta le autorizzazioni associate.
- Se utilizzi il modulo Forum, scorri verso il basso fino all'area Forum e imposta le autorizzazioni associate.
- Scorri verso il basso fino all'area Nodo della pagina.
- Nell'area Nodo, imposta cinque diverse autorizzazioni che controllano quali utenti possono aggiungere, modificare ed eliminare i post dei forum:
- Argomento del forum: creare nuovi contenuti
- Argomento del forum: modificare i propri contenuti
- Argomento del forum: modificare i contenuti
- Argomento del forum: eliminare i propri contenuti
- Argomento del forum: eliminare i contenuti
- Salva la configurazione.
Aggiunta di un forum
Per impostazione predefinita, il portale per gli sviluppatori include un unico forum chiamato Discussione generale. Puoi aggiungere altri forum e forum Nest e creare container di forum, ovvero gruppi di forum.
Il contenitore di un forum consente di creare una raccolta di forum. Tuttavia, un container non è un forum stesso, ma definisce semplicemente una raccolta di forum.
Per aggiungere un forum:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Struttura > Forum nel menu Drupal per visualizzare l'elenco dei forum attuali.
In questa pagina puoi modificare i forum esistenti o riorganizzare l'ordine di visualizzazione dei forum nella pagina Forum. - Seleziona +Aggiungi forum.
- Aggiungi informazioni sul nuovo forum, incluso il forum principale se vuoi nidificare il forum.
- Seleziona Salva.
Per riordinare i forum:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Struttura > Forum nel menu Drupal per visualizzare l'elenco dei forum attuali.
- Fai clic e trascina il segno più, +, prima del nome di un forum per modificarne l'ordine o il livello di nidificazione.
- Salva le modifiche.
Per aggiungere un contenitore del forum:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Struttura > Forum nel menu Drupal per visualizzare l'elenco dei forum attuali.
- Seleziona +Aggiungi contenitore.
- Aggiungi le informazioni sul nuovo contenitore, incluso il contenitore principale se vuoi nidificarlo.
- Seleziona Salva.
Si apre la pagina Forum. - Nella pagina Forum, fai clic e trascina il segno più, +, prima del nome di un forum per aggiungerlo al nuovo contenitore.
- Salva le modifiche.
Promozione di un argomento del forum sulla home page
La home page predefinita contiene una visualizzazione Drupal che controlla il contenuto dell'area Discussioni nei forum della home page. Affinché un argomento del forum venga visualizzato nell'area Discussioni del forum, è necessario che un amministratore promuova l'argomento.
Per promuovere un argomento del forum:
- Accedi al portale come utente con privilegi di amministratore o di approvazione dei commenti.
- Seleziona Content (Contenuti) nel menu di amministrazione di Drupal.
- Filtra i contenuti selezionando Argomento del forum nella casella a discesa Tipo, quindi seleziona Applica.
Nell'elenco dei contenuti vengono visualizzati solo gli argomenti del forum. - Seleziona uno o più argomenti del forum da promuovere.
- Nel menu a discesa Operazioni, seleziona Promuovi in prima pagina.
- Seleziona Esegui.
Tutti gli argomenti selezionati ora vengono visualizzati nell'area Discussioni del forum della home page.
In alternativa, puoi modificare un singolo post del forum e selezionare Promuovi in prima pagina nelle Opzioni di pubblicazione per l'argomento.