Baza de cunoștințe eroică – Utilizarea sistemului de șabloane

Dacă petreceți mult timp răspunzând la aceleași întrebări de asistență din nou și din nou, atunci noi, cei de la HeroThemes, avem răspunsul...

Notă: Acest articol presupune că știți cum să instalați WordPress, plugin-uri și aveți cunoștințe despre dezvoltarea temei, inclusiv temele Părinte/Copil, HTML, CSS și o înțelegere de bază a PHP.

Baza de cunoștințe eroică

Pluginul nostru Knowledge Base oferă o soluție rapidă și foarte ușor de configurat pentru a crea o bază de cunoștințe personalizată pe site-ul dvs. Oferindu-le instantaneu clienților tăi răspunsuri la acele întrebări mai frecvente și permițându-vă să reduceți timpul petrecut cu răspunsul la apelurile și e-mailurile de asistență, astfel încât să puteți, în schimb, să treceți peste câmpurile de margarete (sau să faceți orice ați dori să vă concentrați) în schimb) și asigurându-vă că aveți clienți mai fericiți.

La fel ca majoritatea pluginurilor WordPress, instalarea inițială nu ar putea fi mai ușoară. Pur și simplu încărcați pluginul în directorul dvs. de pluginuri prin tabloul de bord și activați-l. Pluginul Knowledge Base se integrează perfect cu cele mai multe teme bine codificate, prin urmare, nu are nicio diferență dacă utilizați o temă complet personalizată, unul dintre produsele noastre premium HeroThemes sau tema implicită pentru WordPress. Veți avea o bază de cunoștințe complet funcțională integrată în site-ul dvs. WordPress în câteva minute, cu foarte puține bătăi de cap.

Dacă aveți cunoștințe despre dezvoltarea temei și doriți să personalizați pluginul în continuare, atunci codul nostru curat, prietenos cu dezvoltatorii, funcțiile conectabile și sistemul de șabloane ușor de urmărit vă permit să faceți personalizări avansate. Acest articol va arunca o privire la unele dintre lucrurile interesante pe care le puteți face pentru a personaliza pluginul folosind sistemul de șabloane.

Voi oferi o scurtă prezentare generală a:

• Instalarea pluginului, setările generale și adăugarea de conținut
• Integrare de bază cu noua temă TwentySixteen disponibilă cu WordPress 4.4
• Integrare avansată: modificarea șabloanelor pentru personalizare ulterioară

Noțiuni de bază

După instalarea inițială a WordPress, asigurați-vă că aveți atât tema TwentySixteen, cât și pluginul Knowledge Base instalate și activate.

TwentySixteen este noua temă implicită livrată cu WordPress 4.4. Dacă, după actualizarea instalării WordPress, nu aveți noua temă listată sub Aspect > Teme , o puteți descărca de pe pagina de teme TwentySixteen de pe WordPress.org

Pluginul de bază de cunoștințe

La fel ca WordPress însuși, configurarea pluginului Knowledge Base este foarte ușoară. Odată ce pluginul este activat, sunteți direcționat automat către un ecran „Noțiuni introductive”, care acoperă câteva sfaturi de bază pentru a vă ajuta să începeți. Există, de asemenea, un nou element de meniu în meniul din stânga tabloului de bord numit Knowledge Base.

Baza de cunoștințe funcționează într-un mod foarte similar cu tipul de postare standard utilizat de WordPress. Articolele pot fi organizate pe categorii și, de asemenea, după etichetă. Categoriile pot fi adăugate sau eliminate oricând, la fel ca în cazul postărilor, totuși, pentru a vă asigura că baza de cunoștințe este cât mai utilă, este recomandabil să vă planificați structura categoriilor înainte de a începe să creați conținut.

În mod implicit, articolele din baza de cunoștințe sunt afișate în ordinea datei postării exact așa cum o fac postările standard, cu toate acestea, puteți modifica acest lucru în setările pluginului.

Baza de cunoștințe vine cu o gamă largă de setări pentru a vă putea personaliza instalarea fără a fi nevoie să vă aprofundați deloc în șabloane.

Le puteți lăsa exact așa cum sunt, iar baza dvs. de cunoștințe va funcționa perfect, totuși, dacă doriți să schimbați modul în care sunt ordonate articolele, cum sunt afișate categoriile, să personalizați funcția de căutare live, să activați votul și comentariile la articole și o gamă largă. de alte opțiuni, puteți face acest lucru fără a fi nevoie să aveți cunoștințe de codificare.

Crearea Conținutului

Înainte de a putea începe să faceți personalizări avansate în baza noastră de cunoștințe, aveți nevoie de conținut. Prin urmare, primul lucru pe care va trebui să-l faceți este să creați niște articole. Cu tema TwentySixteen instalată, adăugați un nou ecran

Acest lucru ar trebui să pară foarte familiar dacă ați mai folosit WordPress înainte. Titlul postării, conținutul, publicarea, formatele postării, casetele de categorie și etichete sunt toate aceleași. De fapt, singurele domenii care sunt diferite sunt opțiunile de articol și opțiunile de vot

Alternativ, puteți instala conținutul implicit din ecranul de pornire în timp ce începeți.

Integrarea cu TwentySixteen

Integrarea pluginului Knowledge Base cu tema TwentySixteen este foarte simplă. Dacă ai urmat pașii de mai sus, asta este. L-ai putea lăsa acolo și ai avea o bază de cunoștințe funcționale arătătoare, fără a mai fi nevoie să faci nimic în plus. Perfect dacă nu știi prea mult cod sau vrei doar ceva rapid și simplu de configurat.

Dar... ce se întâmplă dacă vrei să faci mai mult?

Ceea ce este cu adevărat frumos la plugin pentru dezvoltatorii de teme este sistemul de șabloane.

Sistemul de șabloane funcționează prin copierea fișierelor șablon pe care doriți să le modificați din plugin în folderul dvs. de teme. WordPress se uită apoi la tema dvs. mai întâi. Dacă există un fișier șablon relevant în tema dvs., acesta va fi folosit. Dacă nu, șablonul de rezervă din folderul plugin va fi folosit în schimb pentru a deturna funcția the_content() și pentru a insera conținutul bazei de cunoștințe în page.php standard.

Ierarhia șabloanelor din plugin sau din cadrul temei funcționează apoi într-un mod foarte asemănător cu ierarhia standard de șabloane WordPress, făcându-vă ușor să vă înțelegeți.

De exemplu hkb-taxonomy-category.php va depăși hkb-archive.php în același mod în care category-$slug.php ar suprascrie standardul archive.php .

Dacă doriți să aflați mai multe despre ierarhia șabloanelor WordPress, puteți citi despre aceasta codexul pentru dezvoltatori.

Personalizarea șabloanelor

În mod implicit, secțiunea Baza de cunoștințe va arăta astfel când utilizați tema TwentySixteen:

Este în regulă, TwentySixteen este o primă temă mobilă foarte frumos stilată. Cu toate acestea, din cauza aspectului șabloanelor de pagină, paginile din baza de cunoștințe au mult spațiu mort în comparație cu alte pagini de pe site:

Nu aveți nevoie de tot acest spațiu alb din paginile bazei de cunoștințe, așa că ceea ce va trebui să faceți este să modificați HTML-ul șablonului relevant pentru a-l elimina.

Înainte de a ajunge la asta, va trebui să creați o temă secundară pentru TwentySixteen, astfel încât niciuna dintre modificările dvs. să nu se piardă atunci când sunt lansate actualizări ale temei. Mi-am numit folderul twentysixteen-child . Mai multe informații despre temele pentru copii pot fi găsite în articolul nostru despre temele pentru copii.

După ce ați configurat tema copilului, acum puteți începe să lucrați la editarea șabloanelor. Creați un folder nou în dosarul twentysixteen-child și numiți-l hkb-templates . Apoi, copiați șablonul pe care doriți să-l editați din folderul plugin-ului în folderul șablon nou creat.

Pentru a schimba pagina de arhivă a bazei de cunoștințe, șablonul pe care va trebui să îl editați este hkb-archive.php . Odată copiat, deschideți-l în editorul de cod. Ar trebui sa vezi:

<?php /** * Theme template for archive display */ ?>

<?php get_header(); ?>

<?php hkb_get_template_part('hkb-compat', 'archive'); ?>

<?php get_footer(); ?>

Notă: Deoarece șabloanele din plugin injectează conținutul bazei de cunoștințe în pagină folosind the_content() a WordPress, structura completă a paginii nu este inclusă inițial în șablon. Deoarece suprascrieți șablonul implicit, va trebui să adăugați codul HTML suplimentar la pagină.

Prin urmare, codul din hkb-archive.php ar trebui schimbat pentru a arăta ceva de genul:

<?php /** * Theme template for archive display */ ?>
<?php get_header(); ?>

<div id="primary" class="content-area">
<main id="main" class="site-main" role="main">
<?php // Include the page content template. hkb_get_template_part('hkb-compat', 'archive'); ?>
</main><!-- .site-main -->

<?php get_sidebar( 'content-bottom' ); ?>
</div>

<!-- .content-area -->

<?php get_sidebar(); ?><?php get_footer(); ?>

Notă: nu este nevoie să includeți bucla while în acest șablon

Salvați fișierul și vizualizați pagina. Acum ar trebui să arate cam așa:

Acest lucru folosește acum aspectul page.php standard în tema twentysixteen și a eliminat spațiul alb din stânga. Cu toate acestea, de fapt, a eliminat tot stilul pluginului și, în schimb, se apropie acum de stilul implicit al temei.

Acest lucru se datorează faptului că, de îndată ce începeți să personalizați tema, pluginul presupune că doriți libertatea de a vă scrie propriile stiluri și, prin urmare, nu încarcă foaia de stil. Acest lucru este cu adevărat util atunci când construiți teme complet personalizate, cu toate acestea, dacă doriți să păstrați stilurile existente, puteți copia și lipi stilurile din hkb-style.css în style.css în tema copilului. Sau dacă creați o temă personalizată, puteți copia foaia de stil din folderul plugin-ului în folderul temei dvs. și apoi o puneți în coada în functions.php folosind următoarele linii de cod:

// Knowledge Base plugin styles
wp_enqueue_style( 'hkb-style', get_template_directory_uri() . '/css/hkb-style.css', array( 'twentysixteen-style' ), '20151217' );

Notă: Dacă utilizați această metodă cu o temă copil, va trebui să utilizați get_stylesheet_directory_uri() în loc de get_template_directory_uri() . Acest lucru se datorează faptului că get_stylesheet_directory_uri() se va uita la structura fișierului pentru tema copilului, get_template_directory_uri() indică în schimb folderul temei părinte.

Dacă construiți o temă personalizată în loc să modificați una existentă cu o temă copil, atunci personal prefer să păstrez foile de stil separate și să folosesc metoda încodare pentru a injecta corect stilurile în temă. Acest lucru se datorează faptului că style.css poate deveni adesea foarte mare și greu de gestionat rapid, menținerea separată a stilurilor relevante le face ușor de găsit dacă trebuie să le editați în continuare. Aceeași organizație ar putea fi folosită dacă utilizați un preprocesor precum SASS, deoarece apoi puteți @import noua foaie de stil, astfel încât să fie combinată automat în style.css , care poate fi apoi injectată în tema dvs. folosind wp_enqueue_style() .

Odată ce stilurile au fost reaplicate, vizualizați pagina din nou și acum ar trebui să vedeți:

Pagina a fost acum reformatată, iar spațiul mort din stânga a fost eliminat, făcând totul să arate mult mai ordonat, fără a pierde stilul și designul temei. Dacă există și alte șabloane de pagină la care doriți să aplicați această modificare de aspect, pur și simplu copiați șabloanele relevante în tema copilului și ați terminat!

Gânduri finale

Sper că am demonstrat cât de personalizabil este pluginul Heroic Knowledge Base. Există multe lucruri pe care le puteți face din cutie, fără a fi nevoie să cunoașteți niciun cod, totuși, dacă doriți să personalizați mai mult lucrurile și aveți o înțelegere a standardelor de cod WordPress și a dezvoltării temei, puteți face foarte ușor.