Planificarea unei baze de cunoștințe WordPress

Cu mulți ani în urmă, scriam manuale tehnice pentru clienți. Acestea ar avea, în general, forma de documente pe suport de hârtie, cu sute de pagini de informații tehnice imprimate și probabil folosite ca un loc la îndemână pentru a odihni o cană de cafea de către majoritatea oamenilor pentru care au fost produse. Dacă clientul a fost extrem de avansat, s-ar putea să fi existat o versiune în format PDF, dar a fost rar utilizată.

Timpurile au trecut mai departe, iar majoritatea manualelor sau bazelor de cunoștințe, așa cum sunt adesea cunoscute, sunt într-o formă digitală. Ele pot lua forma unei aplicații sau a unui site web, sau a unui fel de simulare, dar vor avea întotdeauna date în centrul lor. Bazele de cunoștințe trebuie să fie utile pentru utilizatori în căutarea și navigarea în jurul acestora și trebuie să fie ușor pentru scriitori să adauge conținut sau să editeze conținut, fără a mai fi nevoiți să lucreze la mai multe date mai mult de o dată.

Acesta este motivul pentru care orice sistem care este condus de o bază de date va fi cel mai potrivit. Am folosit WordPress pentru a conduce un astfel de site intern pentru o perioadă de timp și acum găsesc flexibilitatea WordPress vă oferă o privire asupra modului în care afișați și interogați date, combinate cu interfața de administrare care este familiară pentru o mulțime de oameni, o fac ideală instrument.

În această serie, vă arăt că știți să construiți o bază de cunoștințe utilizând WordPress. Vă fac următorii pași:

  1. Planificarea bazei dvs. de cunoștințe, în special planificarea modului în care conținutul dvs. se va potrivi cu tipurile de conținut ale WordPress. Identificarea a ceea ce va trebui să fie structura site-ului și fișierele șablon personalizate pe care va trebui să le creați, dacă există.
  2. Structurarea bazei dvs. de cunoștințe. Crearea fișierelor șablon relevante și scrierea oricărei interogări personalizate.
  3. Crearea bazei dvs. de cunoștințe. Crearea fișierelor șablon, styling-ul acestora și adăugarea de navigație suplimentară, căutare și ajutor.
  4. Realizarea bazei de cunoștințe live. Privind la constrângerile cu care vă puteți confrunta aici, cum veți permite accesul la site și cum va fi menținut și gestionat.

Prima parte a acestui lucru este de planificare, pe care o voi acoperi aici. De-a lungul acestei serii voi lucra pe o bază de cunoștințe imaginară și voi furniza orice cod pentru a putea să-l folosiți singur.

Identificarea conținutului bazei dvs. de cunoștințe

Primul pas este să identificați ce tipuri de conținut va conține baza dvs. de cunoștințe. Baza de cunoștințe va fi o resursă pentru utilizatorii și dezvoltatorii WordPress.

Acesta va conține următoarele tipuri de conținut:

  • Întrebări frecvente
  • Sfaturi rapide
  • Tutoriale
  • Snippeturi
  • Link-uri
  • Videoclipuri

Acest conținut va fi apoi sortat în funcție de publicul țintă și de subiectele de nivel înalt. De asemenea, va utiliza etichetele pentru o sortare mai detaliată.

Publicul meu este împărțit în două grupuri:

  • utilizatori
  • dezvoltatorii

Pentru dezvoltatori, subiectele de nivel înalt sunt:

  • Dezvoltarea temelor
  • Plugin Dezvoltare
  • funcţii
  • Cârlige de acțiune și filtru
  • Interogările și baza de date

Pentru utilizatori, subiectele de nivel înalt sunt:

  • Tabloul de bord
  • Adăugarea și editarea conținutului
  • Biblioteca Media
  • Instalarea, personalizarea și activarea temelor
  • Instalarea, personalizarea și activarea pluginurilor
  • Setări
  • Managementul site-ului

După cum am menționat deja, site-ul va folosi de asemenea etichete care vor fi adăugate de contribuabili. Acestea nu vor fi specifice utilizatorilor sau dezvoltatorilor.

Site-ul va fi gestionat de o echipă imaginară de experți WordPress care sunt ocupați cu alte activități, astfel încât trebuie să poată adăuga conținut rapid. Unii dintre ei vor folosi aplicația mobilă WordPress pentru a adăuga conținut.

După ce am identificat conținutul meu, trebuie să îl potrivesc cu tipurile de conținut WordPress.

Potrivirea cerințelor dvs. pentru WordPress

Ca și în multe aspecte ale dezvoltării cu WordPress, nu este neapărat o singură modalitate de a vă potrivi conținutul cu modul în care este organizat WordPress. Deci, pentru a identifica cea mai potrivită pentru dvs., trebuie să începeți prin înțelegerea modului în care WordPress organizează conținut.

WordPress Tipuri de conținut

Din cutie, WordPress vine cu trei tipuri de conținut:

  • posturi
  • pagini
  • atașamente

Rețineți că există alte tipuri de conținut în WordPress, cum ar fi linkuri, comentarii și elemente de meniu de navigare, dar cele trei de mai sus sunt cele mai relevante aici.

De asemenea, puteți adăuga propriile tipuri de conținut, creând câte doriți, utilizând tipuri personalizate de postări. Acestea se pot comporta ca postări sau pagini, principala diferență fiind că paginile sunt ierarhice, iar postările nu sunt. În acest caz, ierarhia nu este o problemă pentru principalele mele tipuri de conținut.

Taxonomiile WordPress

WordPress are două taxonomii încorporate, pe care le puteți utiliza cu postările, paginile și tipurile personalizate de postări:

  • categorie 
  • etichetă

În plus, puteți înregistra taxonomii suplimentare pentru a permite o mai bună sortare și interogare a datelor dvs..

Identificarea a ceea ce aveți nevoie

Dacă baza dvs. de cunoștințe are mai multe tipuri de conținut, puteți face acest lucru în trei moduri:

  • Utilizați un tip de conținut (cum ar fi postările) și categoriile de utilizări pentru a identifica tipul de conținut pe care îl conține fiecare.
  • Utilizați un tip de conținut (cum ar fi postările) și utilizați o taxonomie personalizată pentru a identifica tipul de conținut.
  • Înregistrați un post pentru fiecare dintre tipurile de conținut.

Prima opțiune este cea mai ușoară pentru începători, deoarece nu trebuie să scrieți niciun cod personalizat și să puteți lucra cu WordPress pe măsură ce vine. A doua opțiune vă oferă mai multă flexibilitate și este o abordare eficientă dacă doriți să listați toate tipurile de conținut împreună, mai degrabă decât să le împărțiți întotdeauna. De asemenea, este util dacă o anumită parte a conținutului ar putea fi prezentată în mai mult de un tip de conținut. A treia opțiune vă oferă cea mai mare flexibilitate atâta timp cât tipurile de conținut vor fi întotdeauna separate.

În cazul bazei mele de cunoștințe, o parte din conținutul meu ar putea avea mai mult de un tip de conținut (de exemplu, un sfat rapid ar putea lua forma unui videoclip sau poate include un link), așa că nu voi înregistra tipuri separate de postări . În schimb, voi crea o taxonomie personalizată pentru tipurile mele de conținut.

Pe lângă tipurile de conținut, trebuie să mă gândesc cum sunt clasificate datele mele. Fiecare post va fi în unul sau mai multe subiecte cu unul sau mai multe persoane. Deoarece subiectele sunt în mod clar potrivite celor două grupuri de audiențe, voi înregistra două taxonomii: una pentru subiectele de utilizator și una pentru subiectele dezvoltatorilor. Aceasta înseamnă că pot lista subiectele pentru fiecare public pe paginile relevante ale site-ului.

Aceasta înseamnă că baza mea de cunoștințe va folosi următoarele:

  • posturi
  • pagini
  • Etichete
  • trei taxonomii personalizate: subiect de utilizator, subiect de dezvoltator și tip de conținut

Așadar, va trebui să înregistrez cele trei taxonomii, dar nu va trebui să înregistrez niciun tip de posturi. În plus, deoarece nu voi folosi categorii încorporate, voi renunța la acestea, astfel încât autorii mei să nu atribuie accidental articole în categorii.

Planificarea structurii bazei dvs. de cunoștințe

Acum, că știu ce conținut va include baza mea de cunoștințe și cum vor fi stocate datele, trebuie să mă gândesc la structura paginilor bazei mele de cunoștințe. Site-ul va folosi o combinație de arhive și pagini statice, cu o pagină de pornire care include cele mai recente postări din toate subiectele.

De asemenea, trebuie să mă gândesc la navigarea mea, precum și la navigarea în meniu, voi include navigarea în subiect în bara laterală și o casetă de căutare.

Structura paginii

Deci, site-ul meu va include:

  • o pagină de pornire cu cele mai recente postări din toate subiectele
  • o pagină statică pentru fiecare dintre cele două grupuri de utilizatori și pentru tipuri de conținut
  • o pagină de arhivă pentru fiecare tip de conținut
  • o pagină de arhivă pentru fiecare termen de taxonomie
  • câte o pagină pentru fiecare post

Bara laterală și subsol

Voi include o bara laterala si un subsol pe toate paginile site-ului meu, dar o voi schimba usor in functie de aria in care se afla utilizatorul.

Iată ce va fi în bara laterală:

  • Pe toate paginile va fi o casetă de căutare în partea de sus.
  • Pe pagina de pornire, pagina de căutare și 404 de pagini vor fi linkuri către fiecare dintre paginile utilizatorilor și dezvoltatorilor, cu o listă de termeni de taxonomie relevanți în cadrul fiecăruia cu link-uri și o listă de tipuri de conținut cu link-uri către paginile lor de arhivă.
  • În pagina utilizatorilor și în paginile de arhivare pentru taxonomia subiectului de utilizator, vor exista linkuri către arhivele termenilor de taxonomie a temelor utilizatorilor.
  • Pe pagina de dezvoltatori și paginile de arhivă pentru taxonomia subiectului dezvoltatorului, vor exista linkuri către termenii de taxonomie pentru dezvoltatori.
  • Pe pagina tipului de conținut și a paginilor de arhivare pentru taxonomia tipului de conținut, va fi o listă de tipuri de conținut cu link-uri către paginile lor de arhivă.
  • Pe o singură pagină vom avea legături către arhivele pentru tematica utilizatorului și taxonomiile pentru dezvoltatori.

Toate astea sună puțin complicate, dar va începe să aibă sens când începem să construim. Voi crea fiecare dintre aceste elemente cu o funcție și apoi folosesc etichete condiționate pentru a atașa funcțiile la un cârlig de acțiune pe care îl voi adăuga la șablonul lateral al barei. Voi adăuga, de asemenea, o zonă widget în bara laterală, doar în caz.

În subsolul paginii vor fi incluse liste cu termenii de taxonomie pentru toate cele trei subiecte, plus o listă cu cele mai recente postări.

Fișiere de șabloane

Aceasta înseamnă că am nevoie de următoarele fișiere șablon:

  • index.php
  • page.php
  • archive.php
  • single.php
  • sidebar.php

Cârlige și funcții

Voi adăuga un cârlig de acțiune care mă va ajuta să popula popoarele: a tutsplus_sidebar cârlig de acțiune în sidebar.php.

Voi crea o funcție atașată acestui cârlig, care va conține următoarele liste:

  • link-uri către paginile de arhivă pentru termenii taxonomiei subiectului utilizator
  • link-uri către paginile de arhivă pentru termenii taxonomiei subiectului dezvoltatorului
  • link-uri către arhivele pentru termenii tipologiei tipului de conținut.

Fiecare dintre acestea va include etichete condiționate, astfel încât acestea să fie adăugate în bara laterală din paginile corecte.

rezumat

Acum am un plan pentru conținutul și structura bazei mele de cunoștințe și am reușit să le corespund capabilităților WordPress. Deci, am identificat exact ceea ce va trebui să creez în WordPress pentru a face ca această bază de cunoștințe să funcționeze.

În timp ce este tentant să vă scufundați și să începeți să codificați, este o idee bună să vă petreceți puțin timp planificând baza de cunoștințe în acest fel, astfel încât să știți exact ce fișiere și funcții de șablon veți avea nevoie. În felul acesta, când veniți să scrieți codul, va fi mult mai rapid.

În următoarea parte a acestei serii, vă voi arăta cum să înregistrați tipuri de post și taxonomii pentru datele bazei dvs. de cunoștințe și să eliminați orice nu aveți nevoie.

Cod