Basis Pengetahuan Heroik – Menggunakan sistem Templating

Diterbitkan: 2016-01-11

Jika Anda menghabiskan banyak waktu untuk menjawab pertanyaan dukungan yang sama berulang kali, maka kami di HeroThemes memiliki jawabannya….

Catatan: Artikel ini mengasumsikan Anda tahu cara menginstal WordPress, plugin dan Anda memiliki beberapa pengetahuan pengembangan tema termasuk tema Induk / Anak, HTML, CSS dan pemahaman dasar tentang PHP.

Basis Pengetahuan Heroik

Plugin Basis Pengetahuan kami menyediakan solusi penyiapan yang cepat dan sangat mudah untuk membuat basis pengetahuan khusus di situs web Anda. Memberikan pelanggan Anda jawaban atas pertanyaan yang lebih sering diajukan secara instan dan memungkinkan Anda mengurangi waktu yang dihabiskan untuk menjawab panggilan dan email dukungan sehingga Anda dapat pergi dan melewati bidang bunga aster (atau melakukan apa pun yang Anda ingin fokuskan sebagai gantinya) dan memastikan Anda memiliki pelanggan yang lebih bahagia.

Seperti kebanyakan plugin WordPress, pemasangan awal tidak bisa lebih mudah. Cukup unggah plugin ke direktori plugin Anda melalui dasbor dan aktifkan. Plugin Basis Pengetahuan terintegrasi secara mulus dengan sebagian besar tema yang dikodekan dengan baik, oleh karena itu, tidak ada bedanya apakah Anda menggunakan tema yang sepenuhnya dipesan lebih dahulu, salah satu produk HeroThemes premium kami atau tema default untuk WordPress. Anda akan memiliki basis pengetahuan yang berfungsi penuh yang terintegrasi ke dalam situs WordPress Anda dalam hitungan menit dengan sedikit kerumitan.

Jika Anda memiliki pengetahuan tentang pengembangan tema dan ingin menyesuaikan plugin lebih jauh, kode kami yang bersih dan ramah pengembang, fungsi yang dapat dicolokkan, dan sistem templating yang mudah diikuti memungkinkan Anda membuat penyesuaian tingkat lanjut. Artikel ini akan membahas beberapa hal keren yang dapat Anda lakukan untuk menyesuaikan plugin menggunakan sistem templating.

Saya akan memberikan gambaran singkat tentang:

  • Memasang plugin, pengaturan umum, dan menambahkan beberapa konten
  • Integrasi dasar dengan tema TwentySixteen baru tersedia dengan WordPress 4.4
  • Integrasi lanjutan: Memodifikasi template untuk penyesuaian lebih lanjut

Mulai

Setelah instalasi awal WordPress, pastikan Anda telah menginstal dan mengaktifkan tema TwentySixteen dan plugin Basis Pengetahuan.

TwentySixteen adalah tema default baru yang disertakan dengan WordPress 4.4. Jika, setelah memutakhirkan instalasi WordPress Anda, Anda tidak memiliki tema baru yang terdaftar di Appearance > Themes, Anda dapat mengunduhnya dari halaman tema TwentySixteen di WordPress.org

Plugin Basis Pengetahuan

Sama seperti WordPress itu sendiri, menyiapkan plugin Basis Pengetahuan sangat mudah. Setelah plugin diaktifkan, Anda secara otomatis dibawa ke layar 'Memulai' yang mencakup beberapa tip dasar untuk membantu Anda memulai. Ada juga item menu baru di menu di sebelah kiri dasbor yang disebut Basis Pengetahuan.

Basis Pengetahuan bekerja dengan cara yang sangat mirip dengan jenis posting 'posting' standar yang digunakan WordPress. Artikel dapat diatur berdasarkan kategori dan juga berdasarkan tag. Kategori dapat ditambahkan atau dihapus kapan saja, seperti halnya dengan posting, namun, untuk membantu memastikan basis pengetahuan Anda berguna mungkin, disarankan untuk merencanakan struktur kategori Anda sebelum Anda mulai membuat konten.

Secara default artikel basis pengetahuan ditampilkan dalam urutan tanggal posting persis seperti posting standar, namun, Anda dapat mengubahnya dalam pengaturan plugin.

kb-blog1-pengaturan

Basis pengetahuan hadir dengan beragam pengaturan untuk dapat menyesuaikan pemasangan Anda tanpa perlu mempelajari templating sama sekali.

Anda dapat membiarkan ini persis seperti apa adanya dan basis pengetahuan Anda akan bekerja dengan sempurna, namun, jika Anda ingin mengubah cara artikel diurutkan, bagaimana kategori ditampilkan, menyesuaikan fitur pencarian langsung, mengaktifkan pemungutan suara dan komentar pada artikel dan berbagai sejumlah opsi lain, Anda dapat melakukannya tanpa perlu memiliki pengetahuan pengkodean.

Membuat Konten

Sebelum Anda dapat mulai melakukan penyesuaian lanjutan apa pun pada basis pengetahuan kami, Anda memerlukan beberapa konten. Oleh karena itu hal pertama yang perlu Anda lakukan adalah membuat beberapa artikel. Dengan tema TwentySixteen terpasang, tambahkan layar baru Anda

kb-blog1-tambahkan-layar-baru
kb-blog1-tambah-baru-opsi

Ini akan terlihat sangat familiar jika Anda pernah menggunakan WordPress sebelumnya. Judul postingan, konten, publikasikan, format postingan, kategori, dan kotak tag semuanya sama. Faktanya, satu-satunya area yang berbeda adalah opsi artikel dan opsi pemungutan suara

Atau Anda dapat menginstal konten default dari layar memulai saat Anda memulai.

Mengintegrasikan dengan TwentySixteen

Mengintegrasikan plugin Basis Pengetahuan dengan tema TwentySixteen sangat sederhana. Jika Anda telah mengikuti langkah-langkah di atas, itu saja. Anda bisa meninggalkannya di sana dan Anda akan memiliki basis pengetahuan fungsional yang bagus tanpa perlu melakukan apa pun lebih jauh untuk itu. Sempurna jika Anda tidak tahu banyak kode atau hanya ingin sesuatu yang cepat dan mudah disiapkan.

Tapi… bagaimana jika Anda ingin berbuat lebih banyak?

Apa yang benar-benar bagus tentang plugin untuk pengembang tema adalah sistem templating.

Sistem templating bekerja dengan menyalin file templat yang ingin Anda ubah dari plugin ke folder tema Anda. WordPress kemudian melihat tema Anda terlebih dahulu. Jika ada file template yang relevan di tema Anda, maka itu akan digunakan. Jika tidak, template mundur di dalam folder plugin akan digunakan untuk membajak fungsi the_content() dan memasukkan konten basis pengetahuan ke dalam page.php standar Anda.

Hirarki templat di dalam plugin atau di dalam tema kemudian bekerja dengan cara yang sangat mirip dengan hierarki templat WordPress standar sehingga memudahkan Anda untuk memahaminya.

Misalnya hkb-taxonomy-category.php akan hkb-archive.php dengan cara yang sama seperti category-$slug.php akan menimpa archive.php standar.

kb-blog1-template-heirachy
Template pesanan digunakan tergantung pada konten yang ditampilkan dan jika ada di tema Anda. Misalnya saat melihat kategori, hkb-taxonomy-category.php akan digunakan jika file tersebut ada, jika tidak, hkb-archive.php akan digunakan.

Jika Anda ingin tahu lebih banyak tentang hierarki template WordPress, Anda dapat membacanya di codex pengembang.

Menyesuaikan Template

Secara default bagian Basis Pengetahuan akan terlihat seperti ini saat menggunakan tema TwentySixteen:

Halaman konten Basis Pengetahuan dan satu artikel
Halaman konten Basis Pengetahuan dan satu artikel

Tidak apa-apa, TwentySixteen adalah tema pertama seluler dengan gaya yang sangat bagus. Namun, karena tata letak templat halaman, halaman Basis Pengetahuan memiliki banyak ruang mati dibandingkan dengan halaman lain di situs web:

Halaman konten Basis Pengetahuan yang sama dibandingkan dengan posting blog standar
Halaman konten Basis Pengetahuan yang sama dibandingkan dengan posting blog standar

Anda tidak memerlukan semua ruang putih ini di halaman basis pengetahuan, jadi yang perlu Anda lakukan adalah memodifikasi HTML dari template yang relevan untuk menghapusnya.

Sebelum Anda melakukannya, Anda perlu membuat tema anak untuk TwentySixteen sehingga tidak ada perubahan yang hilang saat pembaruan tema dirilis. Saya telah memanggil folder saya dua puluh enam belas-anak . Informasi lebih lanjut tentang tema Anak dapat ditemukan di artikel kami tentang tema anak.

Setelah tema anak Anda diatur, Anda sekarang dapat mulai mengedit template. Buat folder baru di dalam folder dua puluh enam belas anak dan beri nama hkb-templates . Kemudian, salin template yang ingin Anda edit dari folder plugin ke folder template yang baru dibuat.

Untuk mengubah halaman arsip Basis Pengetahuan, template yang perlu Anda edit adalah hkb-archive.php . Setelah disalin, buka di editor kode Anda. Anda harus melihat:


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

<?php get_header(); ?>

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

<?php get_footer(); ?>

Catatan: Karena templat di dalam plugin menyuntikkan konten basis pengetahuan ke halaman menggunakan fungsi the_content() WordPress, struktur lengkap halaman awalnya tidak disertakan dalam templat. Karena Anda mengganti template default, Anda perlu menambahkan HTML tambahan ke halaman.

Oleh karena itu kode di hkb-archive.php harus diubah agar terlihat seperti:

<?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(); ?>

Catatan: Tidak perlu menyertakan loop while dalam template ini

kb-blog1-basis-pengetahuan-unformat

Simpan file Anda dan lihat halamannya. Sekarang seharusnya terlihat seperti ini:

Ini sekarang menggunakan tata letak halaman page.php dalam tema dua puluh enam belas dan menghapus ruang putih dari kiri. Namun, itu sebenarnya telah menghapus semua gaya plugin juga dan sebagai gantinya sekarang beralih ke gaya default tema.

Ini karena segera setelah Anda mulai menyesuaikan tema, plugin mengasumsikan Anda menginginkan kebebasan untuk menulis gaya Anda sendiri sehingga tidak memuat lembar gaya. Ini sangat berguna ketika Anda sedang membangun tema yang benar-benar dipesan lebih dahulu, namun, jika Anda ingin mempertahankan gaya yang ada, Anda dapat menyalin dan menempelkan gaya dari hkb-style.css ke style.css di tema anak Anda. Atau jika Anda membuat tema yang dipesan lebih dahulu, Anda bisa menyalin stylesheet dari folder plugin ke folder tema Anda dan kemudian mengantrekannya di functions.php Anda menggunakan baris kode berikut:


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

Catatan: Jika Anda menggunakan metode ini dengan tema anak, Anda harus menggunakan get_stylesheet_directory_uri() alih-alih get_template_directory_uri() . Ini karena get_stylesheet_directory_uri() akan melihat struktur file untuk tema anak Anda, get_template_directory_uri() menunjuk ke folder tema induk sebagai gantinya.

Jika Anda sedang membangun tema yang dipesan lebih dahulu daripada memodifikasi yang sudah ada dengan tema anak, maka saya pribadi lebih suka memisahkan lembar gaya dan menggunakan metode enqueue untuk memasukkan gaya ke dalam tema dengan benar. Ini karena style.css sering kali menjadi sangat besar dan sulit untuk dikelola dengan cepat, memisahkan gaya yang relevan membuatnya mudah ditemukan jika Anda perlu mengeditnya lebih lanjut. Organisasi yang sama dapat digunakan jika Anda menggunakan praprosesor seperti SASS karena Anda dapat @import stylesheet baru Anda sehingga digabungkan menjadi style.css secara otomatis yang kemudian dapat disuntikkan ke dalam tema Anda menggunakan wp_enqueue_style() .

Setelah gaya diterapkan kembali, lihat halaman lagi dan Anda sekarang akan melihat:

kb-blog1-berbasis-pengetahuan-diformat

Halaman tersebut kini telah diformat ulang dan ruang kosong di sebelah kiri telah dihapus sehingga semuanya terlihat lebih rapi tanpa kehilangan gaya dan desain tema. Jika ada templat halaman lain yang ingin Anda terapkan perubahan tata letak ini, cukup salin templat yang relevan ke tema anak Anda dan selesai!

Pikiran Akhir

Mudah-mudahan saya telah menunjukkan betapa dapat disesuaikannya plugin Heroic Knowledge Base. Ada banyak hal yang dapat Anda lakukan di luar kotak tanpa perlu mengetahui kode apa pun, namun, jika Anda ingin menyesuaikan lebih lanjut dan Anda memiliki pemahaman tentang standar kode WordPress dan pengembangan tema, Anda dapat melakukannya dengan sangat mudah.