Permiteți utilizatorilor să aleagă entități Drupal cu modulul Entity Browser

În această postare pe blog, vă voi arăta cum să permiteți utilizatorilor Drupal să selecteze entități folosind modulul „Browser de entitate”.

Acest tutorial a fost solicitat de un client OSTraining care construiește un site de recenzii de cărți. Clientul a dorit să folosească Entity Browser pentru a putea crea această caracteristică:

• Site-ul are două tipuri de conținut: Cărți și Recenzii de cărți.
• Când utilizatorii creează o nouă recenzie de carte, pot folosi o vizualizare pentru a căuta și a selecta cartea pe care o revizuiesc. De exemplu, dacă examinează „Război și pace”, pot căuta nodul existent „Război și pace”.
• Când recenzia cărții este publicată, nodul selectat va fi încorporat în recenzia cărții.

Această solicitare a clientului poate fi realizată cu ajutorul modulului Entity Browser. Acest modul oferă un browser pe care utilizatorii Drupal îl pot folosi pentru a încorpora noduri în alte părți ale site-ului lor.

Acest tutorial vă va ghida prin exercițiul de creare a site-ului și vă va arăta cum să utilizați modulul Entity Browser.

Pasul 1. Instalați modulele necesare

Pentru a utiliza Entity Browser, trebuie să instalați următoarele module: Entity Browser și Chaos Tools.

Utilizați metoda preferată pentru a descărca și instala aceste module. Folosesc Composer:

 composer install drupal/entity_browser

 composer install drupal/ctools

Aceasta va plasa modulele în instalația Drupal. După aceea, faceți clic pe Extinde , căutați ambele module, activați-le și faceți clic pe Instalare .

Pasul 2. Creați termenii taxonomiei

În acest exemplu, cărțile sunt clasificate după genul lor, așa că vom avea nevoie de un vocabular numit „Genul cărții”.

• Faceți clic pe Structură > Taxonomie > Adăugați vocabular.
• Dați vocabularului un nume propriu și o descriere.
• Faceți clic pe Salvare.

• În fila Listă , faceți clic pe Adăugați termen.

Adăugați următorii termeni:

• Aventură
• Carte de bucate
• Dramă
• Fantezie
• Groază

Pasul 3. Creați tipul de conținut Carte

În continuare, vom crea tipul de conținut pentru cărțile noastre. Vom folosi taxonomia Genului de carte pe care am creat-o la pasul anterior.

• Faceți clic pe Structură > Tipuri de conținut > Adăugați tip de conținut.
• Creați un tip de conținut numit Carte și adăugați aceste câmpuri cu setările lor implicite:

• Faceți clic din nou pe Adăugați câmp .
• În lista derulantă de sub Referință , selectați Termenul taxonomiei și acordați-i o etichetă adecvată.
• Faceți clic pe Salvați și continuați.

• Lăsați numărul de valori permis la 1 și faceți clic pe Salvați setările câmpului
• Derulați în jos în partea de jos a ecranului Editați și alegeți vocabularul la care doriți să faceți referire în tipul dvs. de conținut. În acest caz: Genul cărții
• Faceți clic pe Salvare setări

• Faceți clic pe fila Gestionați afișarea formularului .
• Căutați câmpul Genul Cărții și schimbați widgetul acestuia în Casete de bifare / butoane radio.
• Faceți clic pe Salvare.

Pasul #4. Creați conținutul cărții

Acum este timpul să creați 5 până la 10 cărți și să atribuiți fiecare dintre ele unui anumit gen.

• Faceți clic pe Conținut > Adăugați conținut > Carte.

Pasul #5. Creați o vizualizare

După ce ați creat un exemplu de conținut, sunteți gata acum să creați vizualizarea. Această vizualizare va fi afișată în browserul entității, astfel încât să puteți alege o carte în timp ce creați o recenzie de carte.

• Faceți clic pe Structură > Vizualizări > Adăugați vizualizare.
• Creați o vizualizare cu titlul Cărți disponibile.
• Afișați conținut de tip Carte.
• Lăsați setările Pagină și Blocare nebifate.
• Faceți clic pe Salvați și editați.

• Faceți clic pe butonul Adăugați din secțiunea DISPLAYS .
• Selectați Entity Browser.

• Faceți clic pe Rearanjare pe lângă criteriile SORT și eliminați criteriul Conținut: creat pe desc .
• Faceți clic pe Aplicare.
• Faceți clic pe ADAUGĂ pe lângă criteriile FILTER și selectați câmpul Gen carte .
• Faceți clic pe Adăugați și configurați criteriile de filtrare.

• Asigurați-vă că este selectat Vocabularul genului cărții .
• Schimbați tipul de selecție în Meniu derulant.
• Faceți clic pe Aplicați și continuați.

• Bifați Expuneți acest filtru vizitatorilor, pentru a le permite să-l schimbe.
• Asigurați-vă că Operatorul este selectat ca Este unul dintre.
• Faceți clic pe Aplicare.

• Adăugați câmpul Titlu la criteriile SORT .
• Lăsați configurația implicită Sortare crescător și faceți clic pe Aplicare.

Aceasta va prezenta cărțile în vizualizare în ordine alfabetică. Trebuie să mai introduceți câteva câmpuri pentru a fi afișate în vizualizare. Momentan, este disponibil doar titlul nodului.

• Faceți clic pe butonul Adăugați din secțiunea Câmpuri .
• Căutați câmpul pentru coperta cărții și faceți clic pe Adăugați și configurați câmpuri.

• Selectați Stil imagine (miniatură 100x100) și faceți clic pe Aplicare.
• Faceți clic din nou pe Adăugați pentru a adăuga câmpul formularului de selectare în bloc a browserului entității .
• Faceți clic pe Adăugare și configurați câmpuri.

• Faceți clic pe Aplicare.

Utilizarea acestui câmp este obligatorie dacă doriți să utilizați Entity Browser, așa că acordați o atenție deosebită acestui lucru.

• Schimbați formatul vizualizării, de exemplu în Grid.
• Faceți clic pe Aplicați de două ori.

Configurația vizualizării în interfața de utilizare Views ar trebui să arate ca imaginea de mai jos. Faceți clic pe Salvare pentru a salva vizualizarea.

Pasul #6. Configurați modulul Entity Browser

În acest pas, vom alege setarea modulului cheie din acest tutorial: Entity Browser.

• Faceți clic pe Configurare > Browsere de entitate

• Faceți clic pe Adăugare browser de entitate.
• Dați-i o etichetă adecvată, de exemplu, Browser de cărți.
• Ca plugin de afișare, selectați iFrame.
• Faceți clic pe Următorul.

• Bifați Deschidere automată a browserului Entity și faceți clic pe Următorul.

• Faceți clic pe Următorul de încă două ori până ajungeți la pagina de configurare a widgeturilor .
• Faceți clic pe lista drop-down pentru a selecta pluginul View widget.
• Schimbați eticheta widget-ului, de exemplu: „Alege o carte”.
• Selectați vizualizarea pe care ați configurat-o la Pasul #5.
• Faceți clic pe Terminare.

Pasul #7. Creați tipul de conținut Recenzia cărții

Site-ul nostru este aproape complet. Înainte de a termina, trebuie să creăm tipul de conținut pe care recenzorii de cărți îl pot folosi:

• Faceți clic pe Structură > Tipuri de conținut > Adăugați tip de conținut.
• Denumiți acest tip de conținut Recenzie de cărți.
• Adăugați un câmp nou, din secțiunea Referință alegeți Conținut.
• Dați acestui câmp o etichetă adecvată, de exemplu, Cartea.
• Faceți clic pe Salvați și continuați.
• În opțiunea Tip de articol la care să faceți referire , selectați Conținut.
• Faceți clic pe Salvați setările câmpului.

• Faceți clic pe Salvare setări.
• Faceți clic pe fila Gestionați afișarea formularului pentru acest tip de conținut.
• Găsiți câmpul de referință și schimbați widgetul acestuia în browser Entitate.
• Faceți clic pe roata dințată din dreapta și selectați Browser de cărți (sau cum ați numit browserul pe care tocmai l-ați creat la Pasul #6.
• Faceți clic pe Actualizare.
• Faceți clic pe Salvare.

Observați că aveți și opțiunea de a afișa numai eticheta Entității sau entitatea redată complet . Puteți folosi moduri de vizualizare (de ex. Teaser) pentru a prezenta entitatea pe acest nou tip de conținut de recenzii de cărți .

Pasul #8. Creați recenziile cărților

Acum site-ul nostru este aproape gata de utilizare. Să creăm o recenzie de carte și să vedem dacă totul funcționează corect.

• Faceți clic pe Conținut > Adăugați conținut > Recenzie cărți.
• Dați acestui nod un titlu adecvat și texte de corp.
• Derulați mai jos și veți găsi o secțiune restrânsă numită CARTEA (asta este numele câmpului).
• Faceți clic pe acest câmp și veți vedea Entity Browser unde puteți selecta cartea la care faceți referire în această recenzie a cărții.
• În plus, există un filtru expus în partea de sus, astfel încât să puteți selecta cărți care aparțin doar unui singur gen.
• Selectați un gen și faceți clic pe Aplicare.

Browserul vă va afișa numai cărți din acest gen.

• Selectați o carte și faceți clic pe Selectați entități.

• După încorporarea entității, faceți clic pe Salvare și veți vedea entitatea Book la care se face referire în nodul de revizuire a cărții.

Acest tutorial a demonstrat puterea modulului „Entity Browser” pentru Drupal 8. Sper că v-a plăcut. Multumesc pentru lectura!