Cara membuat custom post types di WordPress

WordPress menyediakan berbagai jenis postingan untuk membantu Anda menata konten website. Dengan fitur ini, Anda bisa membuat blog dengan urutan kronologis atau menampilkan halaman statis dengan mudah.

Namun, jenis postingan default ini mungkin masih kurang memadai untuk untuk website besar dengan jenis konten yang lebih beragam. Dalam hal ini, Anda bisa membuat jenis postingan khusus yang disebut custom post type.

Mau tahu lebih lanjut? Yuk, lanjutkan membaca! Di artikel ini, Anda juga akan mempelajari cara menyesuaikan custom post type untuk menambahkan lebih banyak fungsi yang Anda butuhkan.

Meskipun Anda bisa mengelompokkan konten menggunakan kategori, semua postingan akan tetap muncul dalam daftar yang sama kalau dimasukkan dalam jenis postingan default. Hal ini membuat proses pengelolaan postingan jadi lebih sulit.

Secara default, WordPress memiliki tujuh jenis postingan:

1. Posts (Pos) – untuk postingan reguler, misalnya artikel blog.
2. Pages (Laman) – untuk konten statis yang tidak diurutkan berdasarkan tanggal.
3. Attachments (Lampiran) – semua media website, termasuk gambar, video, atau file PDF.
4. Revisions (Revisi) – menyimpan versi sebelumnya dari semua jenis postingan.
5. Navigation Menus (Menu Navigasi) – daftar link yang digunakan pengunjung untuk mengakses website.
6. Custom CSS (CSS kustom) – jenis konten yang bisa diedit untuk menyesuaikan tema WordPress.
7. Changesets – riwayat perubahan yang dilakukan melalui Customizer.

Dengan custom post type, Anda bisa mengelompokkan konten ke dalam bagian khusus tanpa harus bergantung pada kategori. Hasilnya, pengelolaan konten menjadi lebih rapi dan proses pencarian konten juga menjadi lebih mudah.

Selain itu, custom post type mendukung berbagai opsi penyesuaian yang lebih lengkap daripada postingan default. Misalnya, Anda bisa mengatur ulang posisi menu custom post type, menyesuaikan tampilan layar editor, atau mengaktifkan fitur tambahan seperti featured image (gambar unggulan) dan ringkasan.

Elemen-elemen penting dalam custom post type WordPress

Sebelum membuat custom post type, ada dua istilah penting yang sebaiknya Anda pahami dulu: array dan element. Keduanya adalah bagian inti dari kode custom post type.

Sederhananya, array adalah struktur data yang menyimpan pasangan kunci dan nilai, yang disebut element. Dalam konteks WordPress, array digunakan untuk menyimpan properti dari custom post type.

Untuk membuat custom post type, ada tiga array utama yang berisi elemen berbeda: $args, $labels, dan $supports. Array utama, $args (singkatan dari arguments), berisi pasangan kunci-nilai, termasuk:

• description – ringkasan singkat tentang jenis postingan. Anda hanya bisa menampilkannya di template jenis postingan.
• public – menentukan apakah custom post type bisa diakses penulis dan pengunjung. Pilih TRUE untuk menampilkannya di dashboard WordPress maupun hasil pencarian kustom pengunjung.
• menu_position – menentukan lokasi jenis postingan baru di menu admin WordPress. Lihat halaman WordPress Codex untuk mengetahui nilai dan posisinya.
• has_archive – menentukan arsip custom post type, struktur URL, dan nama slug berdasarkan parameter 1 dari register_post_types().
• show_in_admin_bar – mengatur apakah jenis postingan ini muncul di admin bar atas, di bawah bagian +New.
• show_in_nav_menus – menentukan apakah Anda bisa menambahkan postingan jenis ini ke menu navigasi yang dibuat melalui Appearance (Tampilan) → Menus (Menu).
• query_var – mengatur apakah pengunjung website bisa memasukkan jenis dan judul postingan sebagai kueri di URL untuk melihatnya.

Selain elemen-elemen tersebut, $args menyimpan array $labels dan $supports yang berisi pasangan kunci-nilai yang berbeda. Sebaiknya buat variabel $labels terpisah untuk menyimpan semua pasangan kunci dan nilai agar kode Anda lebih rapi dan mudah dipahami

Array $label mendefinisikan teks custom post type dan menyimpan kunci-kunci berikut:

• name – nama jamak untuk custom post type
• singular_name – nama untuk satu postingan dengan jenis kustom
• add_new – mengganti teks ‘Add New’
• add_new_item – mengubah teks ‘Add New Post’
• edit_item – menyesuaikan teks ‘Edit Post’
• featured_image – mengubah ‘Featured Image’ di editor post
• set_featured_image – mengganti ‘Set Featured Image’
• menu_name – mengubah teks link tingkat atas. Teks default link ini adalah kunci ‘name’

Sementara itu, array $supports berisi elemen yang mendefinisikan fitur-fitur custom post type. Nilai TRUE mengaktifkan fitur-fitur berikut:

• title
• editor
• author
• thumbnail
• excerpt
• trackbacks
• custom-fields
• comments
• revisions
• page-attributes
• post-formats

Cara membuat custom post type di WordPress

Ada tiga cara yang bisa Anda gunakan untuk menambahkan custom post type di WordPress, masing-masing dengan kelebihan dan kekurangannya sendiri:

• Menggunakan plugin biasa – paling mudah, tapi custom post type akan ikut hilang kalau plugin dihapus atau dinonaktifkan.
• Menambahkan kode di file functions.php tema – tidak memerlukan tool tambahan, tapi data bisa hilang setelah tema diupdate.
• Membuat plugin khusus untuk website Anda – lebih aman karena data akan selalu tersimpan dan bebas disesuaikan, tapi membutuhkan pengetahuan teknis.

Dalam artikel ini, kita akan menggunakan metode ketiga. Sebelum melanjutkan, sebaiknya Anda membaca panduan kami tentang cara membuat plugin WordPress agar lebih familiar dengan penggunaan dasar kode kustom.

Untuk membuat custom post type, gunakan fungsi register_post_type(). Fungsi ini membutuhkan dua parameter: nama custom post type dan array $args.

Kode plugin juga harus menyertakan fungsi kustom yang memanggil register_post_type(). Jangan lupa mengaitkan fungsi ini ke hook tindakan init agar custom post type bisa terdaftar dengan benar.

Agar tidak terjadi konflik dengan plugin lain, gunakan prefix khusus pada nama fungsi, misalnya ht_.

Berikut contoh kode plugin sederhana untuk membuat custom post type Custom Article:

<?php
/*
Plugin Name: Custom Post Types
Description: Add post types for custom articles
Author: Hostinger Dev
*/
// Hook ht_custom_post_custom_article() to the init action hook
add_action( 'init', 'ht_custom_post_custom_article' );
// The custom function to register a custom article post type
function ht_custom_post_custom_article() {
    // Set the labels. This variable is used in the $args array
    $labels = array(
        'name'               => __( 'Custom Articles' ),
        'singular_name'      => __( 'Custom Article' ),
        'add_new'            => __( 'Add New Custom Article' ),
        'add_new_item'       => __( 'Add New Custom Article' ),
        'edit_item'          => __( 'Edit Custom Article' ),
        'new_item'           => __( 'New Custom Article' ),
        'all_items'          => __( 'All Custom Articles' ),
        'view_item'          => __( 'View Custom Article' ),
        'search_items'       => __( 'Search Custom Article' ),
        'featured_image'     => 'Poster',
        'set_featured_image' => 'Add Poster'
    );
// The arguments for our post type, to be entered as parameter 2 of register_post_type()
    $args = array(
        'labels'            => $labels,
        'description'       => 'Holds our custom article post specific data',
        'public'            => true,
        'menu_position'     => 5,
        'supports'          => array( 'title', 'editor', 'thumbnail', 'excerpt', 'comments', 'custom-fields' ),
        'has_archive'       => true,
        'show_in_admin_bar' => true,
        'show_in_nav_menus' => true,
        'query_var'         => true,
    );
    // Call the actual WordPress function
    // Parameter 1 is a name for the post type
    // Parameter 2 is the $args array
    register_post_type('article', $args);
}

Perlu diperhatikan bahwa kodenya bisa berbeda tergantung pada custom post type Anda. Setelah selesai menulis kode, ikuti langkah-langkah berikut untuk mengubahnya menjadi plugin:

1. Salin dan tempel kode ke editor teks. Misalnya, kami akan menggunakan Notepad di Windows.
2. Simpan file dengan nama custom-post-type.php dan pilih All Files pada menu Save as type.
3. Klik Save.

4. Buka FTP client atau File Manager di akun hosting Anda. Untuk pengguna Hostinger, buka hPanel → Website → Dashboard di samping website Anda → File Manager.
5. Di File Manager, buka direktori public_html → wp-content → plugins.
6. Buat folder baru bernama custom-post-type.
7. Tempel file tadi ke dalam folder tersebut.

8. Masuk ke dashboard WordPress Anda, lalu buka Plugins (Plugin) → Installed Plugins (Plugin Terpasang).
9. Temukan plugin Custom Post Type dan klik Activate (Aktifkan).

10. Refresh halaman, lalu Anda akan melihat menu Custom Article di menu admin WordPress Anda.

Anda bisa membuat sebanyak mungkin custom post type sesuai kebutuhan. Namun, performa REST API WordPress Anda bisa menjadi lebih lambat, dan menu admin juga bisa tampak lebih rumit.

Cara menyesuaikan custom post type baru

Agar berbeda dari konten lainnya, Anda mungkin perlu menambahkan template khusus untuk custom post type yang sudah dibuat. Untuk melakukannya, buat file template di direktori tema aktif Anda.

Ada dua file yang Anda perlukan: single-{post_type}.php yang merupakan template untuk tampilan satu postingan, dan archive-{post_type}.php untuk halaman arsip custom post type.

Kalau Anda tidak membuat dua file ini, WordPress akan menggunakan file default single.php dan archive.php. Artinya, perubahan yang Anda lakukan bisa memengaruhi seluruh website, bukan hanya custom post type.

Cara paling praktis untuk membuat file template adalah dengan membuat duplikat file single.php dan archive.php dari tema aktif, lalu menggantinya dengan nama baru. Dengan cara ini, struktur tema tetap terjaga dan Anda hanya perlu menyesuaikan bagian kontennya.

Berikut langkah-langkah untuk melakukannya:

1. Akses FTP client atau File Manager akun hosting Anda.
2. Temukan folder tema aktif Anda. Dalam contoh ini, folder kami ada di /public_html/wp-content/themes/twentytwentyfive.
3. Salin file single.php dan archive.php, lalu tempelkan di luar folder tersebut.

4. Ubah nama file tersebut berdasarkan parameter 1 dari register_post_type() Anda. Parameter 1 kami adalah article, jadi nama file kami adalah single-article.php dan archive-article.php.
5. Pindahkan kembali kedua file ke folder twentytwentyfive.

6. Ulangi langkah kedua dan ketiga untuk template custom post type lainnya.

Untuk mengedit file template, Anda bisa mendownloadnya dulu lalu membukanya di aplikasi text editor, atau langsung dari File Manager kalau menggunakan layanan hosting dari Hostinger.

Setelah Anda menyimpan perubahan, template baru ini hanya akan memengaruhi tampilan custom post type yang bersangkutan, baik untuk halaman arsip maupun postingan individual.

Menambahkan meta box ke custom post type

Meta box adalah panel tambahan di layar editor WordPress yang memungkinkan Anda menambahkan metadata ke postingan. Metadata ini bisa berupa informasi tambahan seperti detail penulis, pengaturan publikasi, hingga slug khusus.

WordPress sebenarnya sudah menyediakan beberapa meta box default. Namun, untuk custom post type, biasanya Anda membutuhkan meta box tambahan yang lebih spesifik. Misalnya, custom post type Movies mungkin perlu meta box Genre.

Dengan meta box, Anda tidak perlu lagi mengisi nilai metadata secara manual. Cukup gunakan kolom input yang tersedia sehingga proses pengelolaan konten menjadi lebih cepat dan efisien.

Untuk membuat meta box kustom, Anda bisa menambahkan kode di file functions.php atau ke dalam kode plugin kustom yang tadi dibuat. Dalam tutorial ini, kita akan menambahkan kode langsung ke file plugin custom-post-type.php.

Karena kodenya bisa berbeda-beda tergantung pada konten dan penempatan meta box, kunjungi WordPress Codex untuk mendapatkan informasi lebih lanjut. Untuk tutorial ini, kami akan menjelaskan cara membuat meta box Author kustom:

1. Buka file custom-post-type.php melalui File Manager atau FTP client Anda.
2. Klik dua kali file tersebut untuk membuka layar editor. Atau, Anda bisa mendownload file tersebut lalu membukanya dengan aplikasi text editor.
3. Buat meta box kustom kosong dengan memasukkan kode berikut:

// Add meta box 
add_action("add_meta_boxes", "add_author_meta_box");

function add_author_meta_box()
{
    add_meta_box(
    "author_meta_box", // Meta box ID
    "Author Details", // Meta box title
    "author_meta_box_callback", // Meta box callback function
    "article", // The custom post type parameter 1
    "side", // Meta box location in the edit screen
    "high" // Meta box priority
); 
}
function author_meta_box_callback()
{ 
  wp_nonce_field(‘author-nonce’, ‘meta-box-nonce’);
global $post;
placeholder
}

4. Tambahkan konten meta box dengan mengganti nilai placeholder. Untuk tutorial ini, kita akan menambahkan bidang nama dan ID penulis menggunakan kode berikut:

// Add meta box content 
 ?>
  <th><label for="athor_name_field">Author Name</label><th>
  <td><input 
type="text"
id="author_name" 
class="regular-text" 
name=“Author_Name” 
value=“” 
/> 
    <td> 
    <th><label for="author_id_field">Author ID</label><th>
  <td><input 
type="text" 
id="author_id" 
class="regular-text"
name=“Author_ID”
Value=””
/> 
    <td> 
  <?php  

5. Di bagian bawah kode, tambahkan potongan kode berikut untuk menyimpan nilai yang dimasukkan:

// Save meta box data
add_action ( 'save_post', 'author_save_postdata');
function author_save_postdata( $post_id ) {

// If this is an autosave, our form has not been submitted
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) 
return $post_id;

  // Retrieve post id
  If (‘article’ !== get_post_type() ) {
    return $post_id
}
   // Check the user's permissions
     if ( 'page' == $_POST['post_type'] ) {
  
if ( ! current_user_can( 'edit_page', $post_id ) )
return $post_id;
  
} else {
  
if ( ! current_user_can( 'edit_post', $post_id ) )
return $post_id;
}
  
/* OK, it is safe to save the data now. */
  
// Sanitize user input.

$mydata = sanitize_text_field( $_POST['Author_Name'] );

$mydata = sanitize_text_field( $_POST['Author_ID'] );

  
// Update the meta field in the database.

update_post_meta( $post_id, 'Author_Name', $_POST['Author_Name'] ); 

update_post_meta( $post_id, 'Author_ID', $_POST['Author_ID'] ); 
 }

6. Simpan file plugin. Apabila menggunakan File Manager, klik ikon disk di kanan atas. Kalau Anda mengeditnya secara lokal, upload kembali file yang sudah diedit.

Setelah menyelesaikan langkah ini, Anda akan melihat meta box yang baru di layar editor custom post type.

Untuk memastikan meta box berfungsi dengan benar, coba masukkan nilai di kolom input, lalu simpan postingan. Informasi yang Anda masukkan seharusnya muncul di bidang kustom.

Kalau Anda belum terlalu familiar dengan PHP, gunakan plugin Meta Box. Plugin ini bisa membantu menghasilkan kode meta box secara otomatis, meskipun Anda tetap perlu menambahkan fungsi add_meta_box() sendiri.

Setelah mendownload dan menginstal plugin, ikuti langkah-langkah berikut:

1. Di sidebar WordPress, buka Plugins (Plugin) → Installed Plugins (Plugin Terpasang).
2. Temukan plugin Meta Box dan klik About → Go to Online Generator.

3. Buat meta box kustom.
4. Klik Generate Code → Copy.

5. Tempelkan kode ke file functions.php atau custom-post-type.php.

Cara menampilkan custom post type di halaman depan

Secara default, custom post type tidak langsung ditampilkan di halaman depan WordPress. Untuk mengaktifkannya, tambahkan fungsi kustom yang memanggil metode set dari objek WP_Query WordPress.

Berikut contohnya:

// Pin our custom function to the pre_get_posts action hook
add_action( 'pre_get_posts', 'add_article_to_frontpage' );
// Alter the main query
function add_article_to_frontpage( $query ) {
 if ( is_home() && $query->is_main_query() ) {
        $query->set( 'post_type', array( 'post', 'article' ) );
    }
    return $query;
}

Dalam fungsi ini, $query->set() menerima dua parameter: properti yang diubah dan array yang menentukan nilainya. Pada contoh kami, properti yang dimodifikasi adalah post_type, sementara nilai array adalah post dan article.

Array ini mencakup ‘post’ untuk menampilkan jenis postingan default di halaman depan website Anda. Kalau Anda menghapusnya, halaman depan hanya akan menampilkan postingan dari custom post type saja.

Parameter kedua adalah ‘article’, yang menampilkan postingan artikel reguler dan semua postingan artikel kustom di halaman depan.

Untuk mengaktifkan kode ini, tempelkan ke file functions.php tema Anda atau ke file plugin kustom. Kami akan menunjukkan cara menempel kode tersebut ke dalam file plugin:

1. Akses file website WordPress Anda dan buka folder plugin kustom. Folder kami ada di /public_html/wp-content/plugins/custom-post-type.
2. Buka file .php, lalu salin dan tempelkan kode di atas pada bagian bawah file.

3. Klik ikon disk di kanan atas untuk menyimpan perubahan Anda.

Sekarang, postingan default dan custom post type Anda akan ditampilkan bersama di halaman depan website WordPress Anda.

Cara menambahkan dan menampilkan custom field di WordPress

Setelah membuat custom post type, Anda mungkin perlu menambahkan custom field (bidang kustom) untuk memberikan detail tambahan pada konten.

Ada dua cara yang bisa Anda lakukan: memanfaatkan custom field bawaan WordPress, atau menggunakan plugin tambahan. Keduanya memiliki kelebihan dan kekurangan masing-masing, jadi pilihlah metode yang paling sesuai dengan kebutuhan Anda.

Menggunakan custom field bawaan WordPress

WordPress menyediakan fitur bawaan untuk menambahkan custom field (bidang kustom), hanya saja fitur ini tersembunyi secara default. Untuk mengaktifkannya, buka Editor postingan → Screen Option (Opsi Layar).

Setelah diaktifkan, Anda akan melihat panel custom field di bagian bawah layar editor. Dari sini, masukkan nama dan nilai untuk custom field, lalu klik Add Custom Field (Tambahkan Bidang Kustom).

Namun, perlu diperhatikan bahwa custom field bawaan ini tidak langsung ditampilkan di halaman depan website. Untuk menampilkannya, Anda perlu menambahkan fungsi the_meta() atau echo get_post_meta() ke file tema aktif.

Gunakan the_meta() untuk menampilkan semua custom field dalam postingan. Untuk menampilkan custom field tertentu, gunakan echo get_post_meta( $post->ID, ‘key’, TRUE). Ganti nilai key dengan nama custom field Anda.

Karena ada dua jenis postingan (default dan custom post type), Anda bisa mengedit single.php atau single-article.php, tergantung di mana custom field ingin ditampilkan.

Sebagai contoh, Anda ingin menambahkan custom field Author untuk custom post type Article. Dalam hal ini, tambahkan fungsi tadi di file single-article.php. Berikut langkah-langkahnya:

1. Dari Dashboard WordPress, buka Appearance (Tampilan) → Theme Editor (Editor Tema).

2. Dari menu Theme Files (File Tema) di sisi kanan layar, pilih single-article.php.

3. Temukan The Loop WordPress dan cari baris berikut:

get_template_part( 'template-parts/post/content', get_post_format() );

4. Tempelkan salah satu kode fungsi di bawah baris tersebut.
5. Klik Update File (Perbarui File).

Sekarang, custom field Author akan ditampilkan di bawah postingan artikel kustom Anda.

Membatasi custom field untuk jenis postingan tertentu dengan plugin

Sayangnya, Anda tidak bisa menggunakan tool bawaan WordPress untuk menambahkan custom field bagi jenis postingan tertentu. Tool ini akan secara otomatis menambahkan custom field baru untuk semua jenis postingan.

Untuk mengatasinya, gunakan plugin Advanced Custom Fields (ACF). Dengan plugin ini, Anda bisa menentukan custom field yang hanya berlaku pada jenis postingan tertentu.

Setelah plugin aktif, ikuti langkah-langkah berikut untuk membuat dan mengaktifkan custom field bagi jenis postingan tertentu:

1. Dari sidebar WordPress, buka Custom Fields → Add New.

2. Masukkan nama untuk New Field Group.
3. Isi detail berikut untuk bidang kustom baru Anda:
   • Field Label – nama custom field yang akan ditampilkan di halaman editor.
   • Field Name – ID custom field yang akan digunakan untuk ditampilkan pada tema.
   • Field Type – pilih antara teks, kotak centang, URL, atau yanglainnya sesuai kebutuhan Anda.
4. Setelah selesai, klik Close Field.
5. Scroll ke bawah ke bagian Settings dan pilih tab Location Rules.
6. Isi kolom Show this field if untuk menentukan visibilitas custom field. Misalnya, agar custom field bisa dipilih pada jenis postingan Custom Article, pilih Post Type → is equal to → Custom Article.

7. Klik tombol Save Changes.

Karena bidang ini dibuat melalui plugin, Anda harus menggunakan fungsinya untuk menampilkan custom field. Langkah-langkahnya mirip dengan menambahkan custom field default, tapi kali ini masukkan fungsi the_post( ‘key’ );.

Kesimpulan

Custom post type di WordPress membantu Anda menata konten ke dalam kategori yang lebih spesifik. Namun, untuk website besar dengan konten yang lebih beragam, fitur default saja sering kali belum cukup.

Dalam hal ini, Anda bisa membuat plugin khusus untuk menambahkan custom post type lengkap dengan meta box, custom field, hingga pengaturan tampilan. Berikut ringkasan langkah-langkahnya:

1. Tulis kode plugin di editor teks lalu simpan sebagai file .php.
2. Buat folder custom post type di direktori plugin website Anda.
3. Salin file ke folder baru.
4. Buka dashboard admin WordPress → Plugins (Plugin) → Installed Plugins (Plugin Terpasang).
5. Temukan plugin custom post type, lalu klik Aktifkan.

Custom post type juga memiliki banyak opsi penyesuaian. Misalnya, Anda bisa mengonfigurasi layar pengeditan, menambahkan meta box, mengedit visibilitas jenis postingan, dan mengaktifkan fitur bawaan WordPress.

Fitur-fitur ini memungkinkan Anda membuat jenis postingan yang secara khusus disesuaikan dengan konten Anda. Hasilnya, website Anda menjadi lebih rapi, profesional, dan mudah dikelola.

Tanya jawab (FAQ) custom post type WordPress

Bagian ini akan menjawab pertanyaan umum tentang custom post type WordPress. Kalau ada pertanyaan lain, silakan sampaikan lewat kolom komentar di bawah artikel ini.

Semua konten tutorial di website ini telah melalui peninjauan menyeluruh sesuai standar dan komitmen editorial Hostinger.