Membuat lisensi mengendaikan update siste,: lisensi Manager Plugin

() translation by (you can also view the original English article)

Sebagai besar sebagai resmi WordPress theme dan plugin direktori, ada saat-saat ketika Anda tidak ingin menggunakannya untuk mendistribusikan plugin atau tema. Mungkin itu adalah karena Anda menjual plugin atau tema, atau mungkin Anda hanya ingin menyimpannya untuk diri sendiri, membuat mereka hanya tersedia dalam organisasi atau kelompok teman-teman Anda.

Tapi bagaimana tentang pembaruan?

Jika Anda hanya pengguna, hanya meng-upload plugin atau tema secara manual bekerja dengan cukup baik. Tetapi bila Anda memiliki lebih banyak pengguna daripada, menggunakan Updates halaman admin dalam WordPress akan menjadi berguna.

Fungsi update WordPress yang telah dirancang dengan hanya resmi WordPress plugin dan tema direktori dalam pikiran, tetapi jangan khawatir: WordPress memiliki action dan filter yang memungkinkan kita untuk menghubungkan ke bahwa fungsi dan menambahkan server kita sendiri dalam campuran kita.

Apa yang akan Anda Pelajari

Dalam tutorial ini pertama dalam seri, kita akan mulai dengan menciptakan sebuah plugin untuk mengubah website Anda menjadi lisensi manajemen server. Dalam bagian kedua, kami akan terus membangun plugin dengan menambahkan sebuah API untuk itu. Dalam bagian tiga, kita akan menggunakan API membuat WordPress plugin atau tema bicara kembali ke lisensi manager untuk update.

Ketika membuat plugin, di bagian pertama ini, Anda akan belajar tentang teknik pengembangan plugin WordPress berikut:

Menggunakan WordPress Plugin Boilerplate untuk memulai dengan cepat.
Membuat custom post type baru dengan meta box untuk menyimpan custom meta data.
Membuat tabel database maintainable untuk plugin Anda.
Menambahkan item ke tabel database.
Daftar item menggunakan WordPress sendiri daftar tabel implementasi.

Jika Anda ingin melihat plugin bekerja, Anda dapat men-download versi terbaru dari plugin dari WordPress.org. Untuk kode sumber yang tepat digunakan dalam tutorial ini, Periksa repositori Tuts+ Github terkait (di sebelah kanan). Kita akan pergi melalui setiap langkah dari membuat plugin satu per satu, tetapi jika Anda tidak ingin membangun segala sesuatu dari awal, mengikuti bersama dengan kode sumber adalah cara yang baik untuk mengatur belajar Anda.

Sekarang, mari kita mendapatkan untuk bekerja.

1. Buat Plugin yang menggunakan Boilerplate WordPress Plugin

Memulai dengan plugin WordPress baru terdiri dari banyak berulang-ulang pekerjaan yang Anda lakukan berulang-ulang dengan setiap plugin yang Anda buat, seperti menulis kode baru atau menyalin dan membersihkan proyek lama.

Tapi ada cara yang lebih baik.

Saat ini, daripada menyalin proyek yang sudah ada atau memulai dari awal, kita akan menggunakan Tom McFarlin WordPress Plugin Boilerplate, titik awal yang dirancang untuk mendapatkan Anda mulai dengan sebuah plugin WordPress yang terstruktur dengan baik, berorientasi objek dalam waktu singkat.

Jadi, sebelum kita mulai menambahkan fungsi kita sendiri, mari kita mengatur plugin dasar yang menggunakan plugin boilerplate.

Download Boilerplate dan membuat Anda sendiri

Cara termudah untuk men-download plugin boilerplate adalah untuk mengunjungi situs web proyek dan download versi terbaru sebagai zip file.

Setelah Anda download dan membongkar paket zip, Letakkan map trunk folder di dalamnya, salin ke lokasi pilihan Anda dan mengubah nama wp-license-manager.

Kemudian, saatnya untuk pergi melalui plugin boilerplate file dan membuat mereka sendiri:

Pergi melalui semua file dalam direktori plugin (dan subdirektorinya) mengganti semua kemunculan plugin-name ke wp-license-manager dan Plugin_Name untuk Wp_License_Manager. Pastikan untuk mengubah nama class dan file yang mengandung mereka. Ini akan mengambil sedikit waktu dan pekerjaan manual, jadi menggunakan PHP IDE untuk membantu dalam mengubah nama adalah ide yang baik.
Tambahkan informasi plugin plugin bootstrap file, sekarang disebut wp‑license-manager.php dan terletak di direktori root plugin. Anda akan menemukan informasi dalam komentar blok di bagian atas file, tepat setelah PHPDoc tag @wordpress-plugin.

Sekarang, Anda telah menciptakan plugin kosong dengan beberapa konfigurasi dasar, dan itu hanya menunggu Anda untuk mulai menambahkan fungsionalitas. Sudah waktunya untuk membangun manajer lisensi kami!

Jika Anda ingin membaca lebih lanjut tentang menggunakan boilerplate, memeriksa seri tutorial Tom McFarlin, mengembangkan plugin dengan WordPress Boilerplates. Ini didasarkan pada versi sebelumnya boilerplate, tetapi masih akan memberi Anda pemahaman yang lebih dalam ide di balik plugin boilerplate dan bekerja dengan salah satu.

2. membuat Custom Post Type untuk produk

lisensi manajer kita plugin cukup sederhana dan akan menyimpan dan menggunakan hanya dua jenis data: products dan licenses. Sebagai produk diperlukan untuk menciptakan lisensi (dan produk yang mudah dari dua), itu adalah dimana kita akan mulai.

Berikut adalah apa yang akan Anda membangun dalam bagian ini:

product akan mewakili WordPress plugin atau tema yang Anda ingin mengelola melalui server manajer lisensi. Seperti posting blog atau page, product memiliki nama dan deskripsi. Selain itu, memiliki beberapa bidang tambahan untuk menentukan produk informasi spesifik:

Version: Nomor versi produk. Bidang ini akan digunakan untuk memeriksa pembaruan di bagian dua dan tiga seri tutorial ini.
File bucket: The Amazon S3 bucket di mana file akan disimpan.
File name: nama file zip produk disimpan di Amazon S3. Kita akan berbicara tentang pilihan file ini di bagian kedua dari seri.
Diuji dengan versi WordPress, WordPress memerlukan versi, terakhir diperbarui, tinggi Banner, dan Banner rendah: pilihan ini akan ditampilkan dalam plugin update UI dalam bagian ketiga dari seri tutorial.

Sekarang, mari kita membangun ini dengan menciptakan custom post type dan menambahkan meta box.

Langkah 1: Buat Post Type

Plugin boilerplate membagi fungsi plugin secara logis menjadi dua bagian: Umum menghadapi fungsi dan fungsi admin. Sementara pemisahan ini masuk akal dalam kebanyakan kasus, post type adalah suatu tempat di antara, dan Anda bisa berpendapat untuk menempatkan mereka di salah satu dari dua. Aku memutuskan untuk pergi dengan publik.

Jadi, mencari fungsi define_public_hooks di dalam class Wp_License_Manager includes/class-wp-license-manager.php, dan menambahkan action baru berikut tepat setelah dua action wp_enqueue_scripts yang sudah ada:

1	$this->loader->add_action( 'init', $plugin_public, 'add_products_post_type' );

Baris ini menggunakan boilerplate action dan filter loader untuk menambahkan sebuah action handler ke WordPress action init. Fungsi, add_products_post_type, pergi ke class Wp_License_Manager_Public.

Berikut adalah seluruh fungsi:

/**
 * Register the new "products" post type to use for products that
 * are available for purchase through the license manager.
 */
public function add_products_post_type() {
    register_post_type( 'wplm_product',
        array(
            'labels' => array(
                'name' => __( 'Products', $this->plugin_name ),
                'singular_name' => __( 'Product', $this->plugin_name ),
                'menu_name' => __( 'Products', $this->plugin_name ),
                'name_admin_bar' => __( 'Products', $this->plugin_name ),
                'add_new' => __( 'Add New', $this->plugin_name ),
                'add_new_item' => __( 'Add New Product', $this->plugin_name ),
                'edit_item' => __( 'Edit Product', $this->plugin_name ),
                'new_item' => __( 'New Product', $this->plugin_name ),
                'view_item' => __( 'View Product', $this->plugin_name ),
                'search_item' => __( 'Search Products', $this->plugin_name ),
                'not_found' => __( 'No products found', $this->plugin_name ),
                'not_found_in_trash' => __( 'No products found in trash', $this->plugin_name ),
                'all_items' => __( 'All Products', $this->plugin_name ),
            ),
            'public' => true,
            'has_archive' => true,
            'supports' => array( 'title', 'editor', 'author', 'revisions', 'thumbnail' ),
            'rewrite' => array( 'slug' => 'products' ),
            'menu_icon' => 'dashicons-products',
        )
    );
}

Mari kita pergi melalui fungsi dan apa yang dilakukannya — dengan kata lain, parameter ke WordPress fungsi register_post_type.

Parameter pertama, $post_type, (baris 6) mendefinisikan pengenal dari post type yang digunakan di WordPress admin link dan query post type ini (aku pergi dengan wplm_product untuk menjaga dari bertabrakan dengan post type yang dibuat oleh plugin dan tema lain).

Parameter kedua (baris 7 – 28) adalah sebuah array yang mendefinisikan sifat post type (untuk daftar lengkap pilihan yang dapat Anda gunakan, periksa WordPress Codex):

label mendefinisikan sebuah set string label digunakan untuk merujuk kepada post type di WordPress admin area.
public mendefinisikan visibilitas post type baru ini. Saya ingin produk harus ditelusuri oleh orang-orang yang mengunjungi situs sehingga saya menetapkan ini ke true. Jika, di sisi lain, Anda ingin menyimpan produk hal yang private, hanya menyetel opsi ini ke false.
has_archive menetapkan apakah WordPress menyajikan halaman arsip untuk daftar posting jenis ini atau tidak.
supports mendefinisikan fitur mengedit post yang ditampilkan di post editor.
rewrite mendefinisikan bagaimana permalinks untuk jenis produk ini akan terlihat.
menu_icon menentukan ikon untuk menggunakan jenis post di admin menu. Kunjungi situs WordPress pengembang untuk daftar lengkap dari dashboard ikon yang tersedia.

Daftar, menambahkan dan mengedit produk semuanya sekarang ditangani oleh WordPress. Apa yang tersisa untuk kita lakukan adalah menambahkan meta box dengan pengaturan kustom yang tercantum di atas.

Langkah 2: Tambahkan Meta box untuk informasi produk

Sekarang bahwa kita telah menciptakan custom post type untuk produk, kami memiliki segala sesuatu yang kita butuhkan untuk menyimpan produk dalam sistem manajemen lisensi. Tetapi untuk membuat jenis post lebih bermanfaat, mari kita lanjutkan dengan menambahkan meta box untuk informasi produk tertentu.

Berikut adalah apa yang meta box akan terlihat sepert apai:

Pertama, mari kita mengambil action untuk menambahkan meta box. add_meta_boxes_ {post_type} merupakan pilihan bagus: cukup tambahkan post type {post_type} dan action Anda akan dipanggil ketika saatnya untuk menambahkan meta box untuk post ini diberikan jenis (dalam kasus kami, wplm_product).

Seperti yang kita kerjakan admin area, tambahkan kode berikut dalam define_admin_hooks() fungsi di dalam class utama plugin Wp_License_Manager:

1	$this->loader->add_action( 'add_meta_boxes_wplm_product', $plugin_admin, 'add_product_information_meta_box' );

Fungsi, add_product_information_meta_box() di Wp_License_Manager_Admin, hanya mendefinisikan meta box dan fungsi render untuk menampilkan isinya:

/**
 * Registers a meta box for entering product information. The meta box is
 * shown in the post editor for the "product" post type.
 *
 * @param   $post   WP_Post The post object to apply the meta box to
 */
public function add_product_information_meta_box( $post ) {
    add_meta_box(
        'product-information-meta-box',
        __( 'Product Information', $this->plugin_name ),
        array( $this, 'render_product_information_meta_box' ),
        'wplm_product',
        'side'
    );
}

Fungsi berisi hanya panggilan untuk add_meta_box fungsi WordPress yang akan menentukan meta box. Parameter dalam urutan tampilan adalah sebagai berikut:

$id: nilai bidang id HTML untuk elemen meta box.
$title: judul meta box, di atas box.
$callback: fungsi yang akan melakukan render meta box.
$post_type: jenis posting Editor Halaman di mana meta box ini harus ditampilkan.
$context: mana meta box harus ditempatkan ('normal', 'advanced', atau 'side').

Selanjutnya, tambahkan fungsi render yang kami didefinisikan dalam parameter ketiga:

/**
 * Renders the product information meta box for the given post (wplm_product).
 *
 * @param $post     WP_Post     The WordPress post object being rendered.
 */
public function render_product_information_meta_box( $post ) {
    $product_meta = get_post_meta( $post->ID, 'wp_license_manager_product_meta', true );

    if ( ! is_array( $product_meta ) ) {
        $product_meta = array(
            'file_bucket' => '',
            'file_name' => '',
            'version' => '',
            'tested' => '',
            'requires' => '',
            'updated' => '',
            'banner_low' => '',
            'banner_high' => ''
        );
    }

    $this->render_nonce_field( 'product_meta_box' );

    require( 'partials/product_meta_box.php' );
}

Baris 7: Fungsi mulai dengan membaca data meta saat ini.

Baris 9 – 20: jika meta data kosong (itu adalah pada titik ini, benar-benar...), membuat sebuah array data meta default dengan nilai-nilai kosong.

Baris 22: Mencetak bidang kesempatan ini yang akan digunakan untuk keamanan tambahan beberapa saat menyimpan meta data. render_nonce_field adalah fungsi pembantu yang saya buat untuk membantu saya dengan mengingat nama nonce's. Kami akan menambahkannya dalam beberapa saat.

Baris 24: Termasuk meta box sebenarnya HTML. Direktori partials yang merupakan bagian dari WordPress plugin boilerplate dan dimaksudkan untuk memisahkan kode HTML dari PHP. Berikut adalah bagaimana file template untuk meta bo harus:

<?php
/**
 * The view for the plugin's product meta box. The product meta box is used for
 * entering additional product information (version, file bucket, file name).
 *
 * @package    Wp_License_Manager
 * @subpackage Wp_License_Manager/admin/partials
 */
?>
<p>
    <label for="wp_license_manager_product_version">
        <?php _e( 'Version:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_version"
           name="wp_license_manager_product_version"
           value="<?php echo esc_attr( $product_meta['version'] ); ?>"
           size="25" >
</p>
<p>
    <label for="wp_license_manager_product_tested">
        <?php _e( 'Tested with WordPress version:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_tested"
           name="wp_license_manager_product_tested"
           value="<?php echo esc_attr( $product_meta['tested'] ); ?>"
           size="25" >
</p>
<p>
    <label for="wp_license_manager_product_requires">
        <?php _e( 'Requires WordPress version:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_requires"
           name="wp_license_manager_product_requires"
           value="<?php echo esc_attr( $product_meta['requires'] ); ?>"
           size="25" >
</p>
<p>
    <label for="wp_license_manager_product_updated">
        <?php _e( 'Last updated:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_updated"
           name="wp_license_manager_product_updated"
           value="<?php echo esc_attr( $product_meta['updated'] ); ?>"
           size="25" >
</p>

<p>
    <label for="wp_license_manager_product_banner_low">
        <?php _e( 'Banner low:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_banner_low"
           name="wp_license_manager_product_banner_low"
           value="<?php echo esc_attr( $product_meta['banner_low'] ); ?>"
           size="25" >
</p>

<p>
    <label for="wp_license_manager_product_banner_high">
        <?php _e( 'Banner high:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_banner_high"
           name="wp_license_manager_product_banner_high"
           value="<?php echo esc_attr( $product_meta['banner_high'] ); ?>"
           size="25" >
</p>

<h3>Download</h3>

<p>
    <label for="wp_license_manager_product_bucket">
        <?php _e( 'Amazon S3 Bucket:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_bucket"
           name="wp_license_manager_product_bucket"
           value="<?php echo esc_attr( $product_meta['file_bucket'] ); ?>"
           size="25" />
</p>
<p>
    <label for="wp_license_manager_product_file_name">
        <?php _e( 'Amazon S3 File Name:', $this->plugin_name ); ?>
    </label>
    <input type="text" id="wp_license_manager_product_file_name"
           name="wp_license_manager_product_file_name"
           value="<?php echo esc_attr( $product_meta['file_name'] ); ?>"
           size="25" />
</p>

Template adalah agak sederhana HTML, serangkaian label yang diikuti oleh elemen-elemen input dengan nilai-nilai mereka membaca dari $product_meta array kita diperoleh dalam fungsi di atas.

Sekarang, dengan meta box dibuat, mari kita mengurus menyimpan datanya.

Langkah 3: Simpan Meta box Data

Seperti Anda mungkin telah menyadari oleh sekarang, ketika mengembangkan sebuah plugin, menambahkan potongan fungsionalitas baru selalu dimulai dengan menemukan tindakan cocok atau filter untuk itu.

Hal ini berlaku juga untuk menyimpan data meta box.

Kali ini, action untuk menghubungkan ke hook adalah save_post, suatu action yang diaktifkan setiap kali post disimpan dalam WordPress admin. Sekali lagi, dalam class Wp_License_Manager dan define_admin_hooks() fungsi nya, tambahkan baris baru:

1	$this->loader->add_action( 'save_post', $plugin_admin, 'save_product_information_meta_box' );

Fungsi, save_product_information_meta_box, berjalan di class Wp_License_Manager_Admin:

/**
 * Saves the product information meta box contents.
 *
 * @param $post_id  int     The id of the post being saved.
 */
public function save_product_information_meta_box( $post_id ) {
    if ( ! $this->is_nonce_ok( 'product_meta_box' ) ) {
        return $post_id;
    }

    // Ignore auto saves
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return $post_id;
    }

    // Check the user's permissions
    if ( !current_user_can( 'edit_posts', $post_id ) ) {
        return $post_id;
    }

    // Read, sanitize, and store user input
    $meta = get_post_meta( $post_id, 'wp_license_manager_product_meta', true );
    if ( $meta == '' ) {
        $meta = array();
    }

    $meta['file_bucket'] = sanitize_text_field( $_POST['wp_license_manager_product_bucket'] );
    $meta['file_name'] = sanitize_text_field( $_POST['wp_license_manager_product_file_name'] );
    $meta['version'] = sanitize_text_field( $_POST['wp_license_manager_product_version'] );
    $meta['tested'] = sanitize_text_field( $_POST['wp_license_manager_product_tested'] );
    $meta['requires'] = sanitize_text_field( $_POST['wp_license_manager_product_requires'] );
    $meta['updated'] = sanitize_text_field( $_POST['wp_license_manager_product_updated'] );
    $meta['banner_low'] = sanitize_text_field( $_POST['wp_license_manager_product_banner_low'] );
    $meta['banner_high'] = sanitize_text_field( $_POST['wp_license_manager_product_banner_high'] );

    // Update the meta field
    update_post_meta( $post_id, 'wp_license_manager_product_meta', $meta );
}

Mari kita pergi melalui fungsi untuk melihat apa yang dilakukan:

baris 7-9: seperti yang Anda ingat, kami menambahkan bidang kesempatan ini tepat sebelum render meta box produk. Dalam fungsi ini, kita menggunakan kesempatan ini bahwa untuk memverifikasi bahwa orang yang pst data datang dari form (kami akan menambahkan fungsi is_nonce_ok segera).
Baris 11-14: Jangan Simpan meta box data ketika WordPress adalah melakukan auto periodik yang menyelamatkan. Ini adalah karena secara default, WordPress tidak memasukan meta box data ketika membuat panggilan AJAX dilakukan autosave, dan memperbarui meta box data pada saat itu akan mengacaukan segalanya.
Baris 16-19: hanya memungkinkan menyimpan data jika pengguna dapat mengedit post. Satu hal yang perlu dipertimbangkan di masa depan akan menambahkan kemampuan kustom untuk mengedit lisensi manajer produk.
Baris 22-25: membaca produk meta data yang ada, atau membuat array data baru jika tidak ada meta data yang belum disimpan (get_post_meta mengembalikan string kosong ketika meta data item tidak ditemukan dan parameter ketiga diatur ke true).
Baris 27-34: membaca data yang disubmit, melakukan beberapa sanitasi dasar.
Baris 37: Segala sesuatu adalah OK, menyimpan data.

Sekarang, sebelum kita melanjutkan ke lisensi, mari kita melakukan itu satu hal terakhir saya telah janjikan dan menambahkan fungsi helper untuk rendering dan memverifikasi meta box nonce.

Pertama, menciptakan satu:

/**
 * A helper function for creating and rendering a nonce field.
 *
 * @param   $nonce_label  string  An internal (shorter) nonce name
 */
private function render_nonce_field( $nonce_label ) {
    $nonce_field_name = $this->plugin_name . '_' . $nonce_label . '_nonce';
    $nonce_name = $this->plugin_name . '_' . $nonce_label;

    wp_nonce_field( $nonce_name, $nonce_field_name );
}

Inti dari fungsi ini adalah panggilan untuk wp_nonce_field yang melakukan pekerjaan yang sebenarnya menciptakan one-time token digunakan untuk kesempatan dan menulis itu keluar dalam bidang HTML tersembunyi.

Kemudian, cek:

/**
 * A helper function for checking the product meta box nonce.
 *
 * @param   $nonce_label string  An internal (shorter) nonce name
 * @return  mixed   False if nonce is not OK. 1 or 2 if nonce is OK (@see wp_verify_nonce)
 */
private function is_nonce_ok( $nonce_label ) {
    $nonce_field_name = $this->plugin_name . '_' . $nonce_label . '_nonce';
    $nonce_name = $this->plugin_name . '_' . $nonce_label;

    if ( ! isset( $_POST[ $nonce_field_name ] ) ) {
        return false;
    }

    $nonce = $_POST[ $nonce_field_name ];

    return wp_verify_nonce( $nonce, $nonce_name );
}

nonce memeriksa fungsi menggunakan konvensi penamaan yang sama dari fungsi di atas, dan kemudian menggunakan mereka untuk mengambil nonce dari data form yag dikirim (baris 11-15). Kemudian, jika kesempatan ini ditemukan, ia menggunakan WordPress fungsi wp_verify_nonce untuk memeriksa bahwa kode yang diajukan sesuai yang disimpan satu (baris 17).

3. Tambahkan lisensi

Kami sekarang setengah jalan melalui tutorial ini pertama dalam seri: produk di tempat dan sudah waktunya untuk mengambil melihat lisensi.

Lisensi pada yang paling sederhana terdiri dari dua elemen: kunci lisensi dan id pengguna (kami akan menggunakan alamat email untuk itu). Untuk lebih banyak kontrol atas lisensi, kami juga menambahkan elemen ketiga: lisensi kedaluwarsa, tanggal setelah lisensi ini tidak berlaku lagi dan tidak akan menerima update dari server kami manajer lisensi.

Admin UI untuk lisensi akan cukup mirip dengan yang kita dibuat untuk produk: Daftar lisensi dan pilihan untuk membuat yang baru. Implementasi, namun, akan sangat berbeda: sementara produk sesuai metafora post baik dan karena itu natural untuk menerapkan sebagai custom post type, lisensi terbaik diimplementasikan menggunakan tabel database mereka sendiri.

Langkah 1: Buat tabel Database

Bangunan lisensi fungsi dimulai dengan membuat tabel database yang akan memegang lisensi. Waktu yang paling natural untuk membuat tabel database baru tepat di Aktivasi plugin, sebelum pengguna memiliki kesempatan untuk mencoba dan melakukan sesuatu dengan tabel.

WordPress Plugin Boilerplate membuat ini mudah dengan menyediakan fungsi kosong yang kita dapat mulai menulis kode kita. Fungsi, activate, di class Wp_License_Manager_Activator, dipangil setiap kali plugin diaktifkan, baik dengan mengklik Activate dalam menu Plugins atau ketika sebuah plugin update selesai.

Pertama, tambahkan definisi variabel berikut di bagian atas class:

/**
 * The database version number. Update this every time you make a change to the database structure.
 *
 * @access   protected
 * @var      string    $db_version   The database version number
 */
protected static $db_version = 1;

Dan kemudian, memperbarui fungsi aktivasi dengan kode berikut:

/**
 * Code that is run at plugin activation.
 */
public static function activate() {
    // Update database if db version has increased
    $current_db_version = get_option( 'wp-license-manager-db-version' );
    if ( ! $current_db_version ) {
        $current_db_version = 0;
    }

    if ( intval( $current_db_version ) < Wp_License_Manager_Activator::$db_version ) {
        if ( Wp_License_Manager_Activator::create_or_upgrade_db() ) {
            update_option( 'wp-license-manager-db-version', Wp_License_Manager_Activator::$db_version );
        }
    }
}

Berikut adalah apa yang dilakukan:

Baris 6 – 9: membaca dalam pilihan wp-lisensi-manager-db-version. Kami akan menggunakan opsi ini untuk menyimpan plugin database versi saat ini aktif di situs.

Baris 11: Bandingkan versi database saat ini dengan yang didefinisikan dalam plugin atas basis kode ($db_version, definisi di atas). Jika set nomor versi dalam kode plugin lebih tinggi daripada yang disimpan dalam pilihan WordPress, database update yang diperlukan.

Baris 12: Jalankan database update.

Baris 13: Jika database update berhasil, memperbarui opsi wp-lisensi-manager-db-version yang sesuai dengan versi dalam kode.

Sekarang, kami telah menciptakan sebuah sistem untuk melacak versi database dan dapat pindah ke membuat tabel database. Tambahkan fungsi berikut untuk Wp_License_Manager_Activator:

/**
 * Creates the database tables required for the plugin if 
 * they don't exist. Otherwise updates them as needed.
 *
 * @return bool true if update was successful.
 */
private static function create_or_upgrade_db() {
    global $wpdb;

    $table_name = $wpdb->prefix . 'product_licenses';
        
    $charset_collate = '';
    if ( ! empty( $wpdb->charset ) ) {
        $charset_collate = "DEFAULT CHARACTER SET {$wpdb->charset}";
    }
    if ( ! empty( $wpdb->collate ) ) {
        $charset_collate .= " COLLATE {$wpdb->collate}";
    }

    $sql = "CREATE TABLE " . $table_name . "("
         . "id mediumint(9) NOT NULL AUTO_INCREMENT, "
         . "product_id mediumint(9) DEFAULT 0 NOT NULL,"
         . "license_key varchar(48) NOT NULL, "
         . "email varchar(48) NOT NULL, " 
         . "valid_until datetime DEFAULT '0000-00-00 00:00:00' NOT NULL, "
         . "created_at datetime DEFAULT '0000-00-00 00:00:00' NOT NULL, "
         . "updated_at datetime DEFAULT '0000-00-00 00:00:00' NOT NULL, "
         . "UNIQUE KEY id (id)"
         . ")" . $charset_collate. ";";

    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );

    return true;
}

Sebagian besar fungsi ini adalah tentang menciptakan query SQL CREATE TABLE yang kita akan gunakan untuk membuat tabel database:

Baris 10: Membangun nama tabel database.

Baris 12 – 18: beberapa definisi charset yang akan digunakan dalam SQL.

Baris 20-29: The SQL untuk query CREATE TABLE. Tabel akan memiliki kolom berikut:

id: id yang unik untuk baris lisensi.
product_id: id dari produk yang terkait lisensi.
license_key: kunci lisensi string digunakan sebagai password.
email: alamat email pemilik lisensi, yang bekerja sebagai nama pengguna.
valid_until: tanggal kedaluwarsa lisensi.
created_at: timestamp Kapan lisensi diciptakan.
updated_at: timestamp update terbaru.

Baris 31-32: Gunakan WordPress database update metode dbDelta untuk membuat atau memperbarui tabel database. Perhatikan bahwa dbDelta tidak benar-benar menjalankan query CREATE TABLE, tapi menganalisis itu dan membandingkannya kepada struktur tabel saat ini, melakukan modifikasi yang diperlukan.

Jadi, kemudian, jika Anda memutuskan untuk membuat perubahan pada struktur tabel, alih-alih menulis query SQL baru, Anda akan hanya mengedit query CREATE TABLE, memperbarui $db_version parameter dan membiarkan dbDelta menangani sisanya.

Untuk informasi lebih lanjut tentang membuat tabel database di WordPress dan menggunakan dbDelta, baca artikel menciptakan tabel dengan plugin di WordPress codex.

Dan hanya itu. Waktu berikutnya Anda mengaktifkan plugin, tabel database untuk lisensi akan dibuat. Jika Anda sudah mengaktifkan plugin, Anda harus melakukannya lagi (menonaktifkan dan kemudian mengaktifkan lagi) untuk membuat database.

Langkah 2: Buat halaman Menu lisensi

Sekarang bahwa kita telah membuat tabel database untuk menyimpan lisensi, mari kita membuat menu Halaman: "Licenses" dan "Add New".

Sekali lagi, kita mulai dengan mengaitkan untuk action yang tepat dalam fungsi Wp_License_Manager di define_admin_hooks:

1	$this->loader->add_action( 'admin_menu', $plugin_admin, 'add_licenses_menu_page' );

Fungsi action, add_license_menu_page, pergi ke Wp_License_Manager_Admin dan tampak seperti ini:

/**
 * Creates the settings menu and sub menus for adding and listing licenses.
 */
public function add_licenses_menu_page() {
    add_menu_page(
        __( 'Licenses', $this->plugin_name ),
        __( 'Licenses', $this->plugin_name ),
        'edit_posts',
        'wp-licenses',
        array( $this, 'render_licenses_menu_list' ),
        'dashicons-lock',
        '26.1'
    );

    add_submenu_page(
        'wp-licenses',
        __( 'Licenses', $this->plugin_name ),
        __( 'Licenses', $this->plugin_name ),
        'edit_posts',
        'wp-licenses',
        array( $this, 'render_licenses_menu_list' )
    );

    add_submenu_page(
        'wp-licenses',
        __( 'Add new', $this->plugin_name ),
        __( 'Add new', $this->plugin_name ),
        'edit_posts',
        'wp-licenses-new',
        array( $this, 'render_licenses_menu_new' )
    );
}

Mari kita lihat lebih dekat:

Baris 5-13: membuat halaman menu tingkat atas, dengan judul, "Licenses". Fungsi, add_menu_page, mengambil parameter berikut:

$page_title: judul halaman menu (nilai tag judul HTML).
$menu_title: layar judul untuk halaman menu.
$capability: kemampuan yang diperlukan untuk melihat halaman. Saya menggunakan edit_posts, tetapi di masa depan, saya mungkin akan mempertimbangkan menambahkan kemampuan saya sendiri di tempatnya.
$menu_slug: pengenal untuk halaman menu, yang digunakan di URL laman.
$function: fungsi yang akan menangani render halaman menu ini.
$icon_url: bidang ini dapat digunakan dalam banyak cara yang berbeda, tapi aku memilih untuk pergi dengan ikon dashboard seperti dijelaskan sebelumnya dalam tutorial ini.
$position: penempatan menu item dalam WordPress menu. Masalah dengan menggunakan parameter ini adalah bahwa jika dua item menu memiliki nilai $position yang sama, hanya salah satu dari mereka akan ditampilkan. Menurut dokumentasi WordPress, menggunakan desimal nomor, seperti yang telah kita lakukan di sini, membantu sedikit.

Baris 15 – 22: menambahkan submenu untuk daftar lisensi. Parameter untuk add_submenu_page tidak sama untuk add_menu_page tetapi parameter pertama harus id dari menu paling atas yang submenu harus ditambahkan.

Juga harus diingat adalah bahwa kita arahkan submenu pertama untuk fungsi menu paling atas action yang sama. Apa yang dilakukan adalah bahwa ketika pengguna mengklik pada menu tingkat atas, submenu ini pertama dibuka segera.

Baris 24-31: submenu kedua adalah yang kita akan mulai dengan, halaman untuk menambahkan lisensi baru.

Untuk membuat kode berjalan tanpa kesalahan, tambahkan dua fungsi kosong:

public function render_licenses_menu_list() {

}

public function render_licenses_menu_new() {

}

Step 3: Membuat Halaman Add New License

Dengan dua pengaturan halaman dibuat, mari kita menambahkan fungsionalitas ke yang pertama, "Add New License" halaman.

Halaman yang akan terlihat seperti ini:

Sebagaimana kita didefinisikan di atas, fungsi yang akan melakukan render untuk menambahkan Add new page yang disebut render_licenses_menu_new. Fungsi itu sendiri sederhana, dengan sebagian besar jalur yang dihabiskan mempopulasikan daftar produk yang akan digunakan untuk rendering daftar drop-down:

/**
 * Renders the list add new license menu page using 
 * the "licenses_new.php" partial.
 */
public function render_licenses_menu_new() {
    // Used in the "Product" drop-down list in view
    $products = get_posts(
        array(
            'orderby'           => 'post_title',
            'order'             => 'ASC',
            'post_type'         => 'wplm_product',
            'post_status'       => 'publish',
            'nopaging'          => true,
            'suppress_filters'  => true
        )
    );

    require plugin_dir_path( dirname( __FILE__ ) ) . 'admin/partials/licenses_new.php';
}

Baris 7 – 16: mengambil semua diterbitkan post dari wplm_product custom type kami.

Baris 18: Termasuk parsial yang mengandung HTML untuk halaman menu ini.

Dan inilah apa yang terjadi dalam HTML template:

<?php
/**
 * The view for the admin page used for adding a new license.
 *
 * @package    Wp_License_Manager
 * @subpackage Wp_License_Manager/admin/partials
 */
?>
<div class="wrap">
    <div id="icon-edit" class="icon32 icon32-posts-post"></div>

    <h2><?php _e( 'Add New License', $this->plugin_name ); ?></h2>
    <p>
        <?php
            $instructions = 'Use this form to manually add a product license. '
                . 'After completing the process, make sure to pass the license key to the customer.';

            _e( $instructions, $this->plugin_name );
        ?>
    </p>

    <form action="<?php echo admin_url( 'admin-post.php' ); ?>" method="post">
        <?php wp_nonce_field( 'wp-license-manager-add-license', 'wp-license-manager-add-license-nonce' ); ?>
        <input type="hidden" name="action" value="license_manager_add_license">

        <table class="form-table">
            <tr class="form-field form-required">
                <th scope="row">
                    <label for="email">
                        <?php _e( 'Email', $this->plugin_name ); ?>
                        <span class="description"><?php _e( '(required)', $this->plugin_name ); ?></span>
                    </label>
                </th>
                <td>
                    <input name="email" type="text" id="email" aria-required="true">
                </td>
            </tr>
            <tr class="form-field form-required">
                <th scope="row">
                    <label for="email">
                        <?php _e( 'Product', $this->plugin_name ); ?>
                        <span class="description"><?php _e( '(required)', $this->plugin_name ); ?></span>
                    </label>
                </th>
                <td>
                    <select name="product" id="product" aria-required="true">
                        <?php foreach ( $products as $product ) : ?>
                            <option value="<?php echo $product->ID; ?>"><?php echo $product->post_title; ?></option>
                        <?php endforeach; ?>
                    </select>
                </td>
            </tr>
            <tr class="form-field form-required">
                <th scope="row">
                    <label for="valid_until">
                        <?php _e( 'Valid until', $this->plugin_name ); ?>
                    </label>
                </th>
                <td>
                    <input name="valid_until" type="text" id="valid_until" aria-required="false" />
                    <p class="description">
                        <?php _e( '(Format: YYYY-MM-DD HH:MM:SS / Leave empty for infinite)', $this->plugin_name );?>
                    </p>
                </td>
            </tr>
        </table>

        <p class="submit">
            <input type="submit" name="add-license" class="button button-primary"
                   value="<?php _e( 'Add License', $this->plugin_name ); ?>" >
        </p>
    </form>

</div>

Ini adalah fprm agak dasar, menggunakan beberapa CSS class yang didefinisikan di WordPress admin untuk membuat segalanya tampak cara WordPress admin layar seharusnya untuk melihat.

Beberapa baris yang Anda harus memperhatikan adalah:

Baris 22: Ketika pengguna mengirimkan form, itu akan post ke WordPress admin-post.php.

baris 23: Hanya seperti dengan meta box, tambahkan nonce ini untuk memastikan bahwa seseorang post untuk menambah lisensi adalah benar-benar melakukannya melalui halaman ini.

Baris 24: Menentukan bidang tersembunyi bernama action dengan nilai 'license_manager_add_license'. Bidang ini akan digunakan untuk menambahkan fungsi penanganan form pengajuan — kita akan mendapatkan ini berikutnya.

Langkah 4: Menyimpan lisensi

Di langkah sebelumnya, kami membuat formulir "Add New License". Sekarang adalah waktu untuk membuat fungsi untuk menyimpannya.

Kembali ke fungsi define_admin_hooks di Wp_License_Manager dan menambahkan action baru:

1	$this->loader->add_action( 'admin_post_license_manager_add_license', $plugin_admin, 'handle_add_license' );

Saat ini, kita menggunakan admin_post_ {action}, action yang pintar untuk menangani form kustom.

Ketika form dengan action bidang tersembunyi yang dikirim, WordPress mencari bidang nilai dan menggunakan ini untuk membuat memanggil action yang cocok. Nilai yang kita digunakan untuk bidang tersembunyi adalah "license_manager_add_license" dan sehingga kita dapat menambahkan action dengan nama admin_post_license_manager_add_license.

Fungsi, handle_add_license, pergi ke Wp_License_Manager_Admin:

/**
 * Handler for the add_license action (submitting 
 * the "Add New License" form).
 */
public function handle_add_license() {
    global $wpdb;

    if ( ! empty( $_POST )
        && check_admin_referer( 'wp-license-manager-add-license', 
            'wp-license-manager-add-license-nonce' ) ) {

        // Nonce valid, handle data

        $email = sanitize_text_field( $_POST['email'] );
        $valid_until = sanitize_text_field( $_POST['valid_until'] );
        $product_id = intval( $_POST['product'] );
        
        $license_key = wp_generate_password( 24, true, false );

        // Save data to database
        $table_name = $wpdb->prefix . 'product_licenses';
        $wpdb->insert(
            $table_name,
            array(
                'product_id' => $product_id,
                'email' => $email,
                'license_key' => $license_key,
                'valid_until' => $valid_until,
                'created_at' => current_time( 'mysql' ),
                'updated_at' => current_time( 'mysql' )
            ),
            array(
                '%d',
                '%s',
                '%s',
                '%s',
                '%s',
                '%s'
            )
        );

        // Redirect to the list of licenses for displaying the new license
        wp_redirect( admin_url( 'admin.php?page=wp-licenses' ) );
    }
}

Mari kita pergi melalui fungsi untuk melihat apa yang dilakukan:

Baris 8-10: memverifikasi kesempatan ini yang ditambahkan dalam form HTML.

Baris 14-16: mengumpulkan dan membersihkan data lisensi yang disubmit.

Baris 18: Menghasilkan kunci lisensi. Dalam plugin ini, kami memperlakukan kunci lisensi seperti password yang selalu digunakan bersama dengan alamat email pengguna, jadi saya memutuskan untuk tidak memerlukan kunci lisensi untuk menjadi unik. WordPress fungsi password generasi adalah cara sederhana untuk membuat sandi acak — mungkin tidak yang paling aman pilihan sepanjang masa, tetapi cukup baik.

Baris 21 – 40: menyimpan data untuk tabel di database kami. Parameter pertama ke fungsi insert di $wpdb adalah nama tabel. Yang kedua adalah sebuah array dengan kolom database dan nilai-nilai mereka. Ketiga menentukan jenis parameter untuk memformat query (%s berarti string dan dikutip, nilai-nilai numerik yang ditentukan dengan %d dibiarkan tanpa tanda kutip).

Baris 43: Mengarahkan ulang pengguna ke daftar lisensi. Kita akan membangun berikutnya.

4. daftar lisensi

Sekarang bahwa kita menyimpan beberapa data untuk lisensi, sudah waktunya untuk langkah terakhir dalam tutorial ini: membangun daftar untuk browsing lisensi.

Saya selalu ingin membuat tampilan UIs admin saya sebagai banyak seperti admin WordPress itu sendiri yang saya bisa, dan Jadi, ketika membuat daftar ini, saya memutuskan untuk pergi dengan kode yang sama yang menggunakan WordPress inti untuk render daftar sendiri: class Wp_List_Table , digambarkan sebagai "[b]ase class untuk menampilkan daftar item dalam tabel ajaxified HTML" dalam dokumentasi PHPDoc .

class membuatnya sangat mudah untuk membuat baik mencari daftar tabel seperti yang Anda lihat di atas di WordPress, tapi datang dengan pengecualian:

WordPress pengembang telah mendokumentasikan clas sebagai @private, berarti bahwa mereka berhak untuk mengubah secara radikal waktu yang mereka Harap. Dengan kata lain, menggunakan class adalah risiko dan berarti bahwa Anda akan memiliki untuk menguji plugin Anda dengan hati-hati sebelum setiap rilis WordPress baru untuk memastikan daftar masih bekerja.

Jika itu terdengar terlalu berisiko untuk Anda, ada pilihan lain: Salin versi saat ini dari class ke dalam proyek Anda sendiri, mengubah dan menggunakan dicopy filenya sebagai class dasar daftar Anda sendiri. Pada akhirnya, saya memutuskan untuk pergi dengan menyalin pilihan sendiri, untuk memastikan semuanya bekerja masih di masa depan.

Langkah 1: Buat List Table class

Pertama, mencari class Wp_List_Table (it's in wp-admin/includes/class-wp-list-table.php) dan menyalinnya ke proyek Anda sendiri. Pastikan untuk mengubah nama class dan file sehingga mereka tidak akan konflik dengan class asli dari WordPress core (misalnya Wp_License_Manager_List_Table).

Kemudian, membuat class dari kelas Anda sendiri untuk memperpanjang base class ini. memanggil class Licenses_List_Table dan tempatkan di direktori admin. Kemudian tambahkan baris berikut require_once ke fungsi load_dependencies di Wp_License_Manager:

/**
 * The classes responsible for rendering the list of licenses.
 */
require_once plugin_dir_path( dirname( __FILE__ ) ) . 'includes/class-wp-license-manager-list-table.php';
require_once plugin_dir_path( dirname( __FILE__ ) ) . 'admin/class-licenses-list-table.php';

Membuka class yang baru anda buat, Licenses_List_Table, dan menambahkan konstruktor yang mengambil teks domain untuk lokalisasi sebagai parameter dan field untuk menyimpan nilai. Satu ini tidak perlu penjelasan:

class Licenses_List_Table extends Wp_License_Manager_List_Table {

    /**
    * The plugin's text domain.
    * 
    * @access  private
    * @var     string  The plugin's text domain. Used for localization.
    */
    private $text_domain;

    /**
     * Initializes the WP_List_Table implementation.
     *
     * @param $text_domain  string  The text domain used for localizing the plugin.
     */
    public function __construct( $text_domain ) {
        parent::__construct();

        $this->text_domain = $text_domain;
    }
    
}

Langkah 2: Mendefinisikan daftar kolom-kolom

Wp_List_Table dilengkapi dengan satu set fungsi yang dapat kita override untuk menentukan data dan format aturan untuk daftar.

Mari kita mulai dengan mendefinisikan kolom untuk menampilkan daftar, pesanan mereka dan header untuk setiap kolom. Tambahkan fungsi ini untuk class Licenses_List_Table.

/**
 * Defines the database columns shown in the table and a 
 * header for each column. The order of the columns in the 
 * table define the order in which they are rendered in the list table.
 *
 * @return array    The database columns and their headers for the table.
 */
public function get_columns() {
    return array(
        'license_key' => __( 'License Key', $this->text_domain ),
        'email'       => __( 'Email', $this->text_domain ),
        'product_id'  => __( 'Product', $this->text_domain ),
        'valid_until' => __( 'Valid Until', $this->text_domain ),
        'created_at'  => __( 'Created', $this->text_domain )
    );
}

Perhatikan bahwa tombol dalam array harus sesuai dengan nama-nama kolom dalam tabel database.

Jika kita tidak ingin menampilkan kolom created_at, kita dapat dengan mudah menyembunyikan menggunakan get_hidden_columns fungsi:

/**
 * Returns the names of columns that should be hidden from the list table.
 * 
 * @return array    The database columns that should not be shown in the table.
 */
public function get_hidden_columns() {
    return array( 'created_at' );
}

Mendefinisikan kolom yang dapat digunakan untuk menyortir daftar data dilakukan dengan cara yang sama:

/**
 * Returns the columns that can be used for sorting the list table data. 
 * 
 * @return array    The database columns that can be used for sorting the table.
 */
public function get_sortable_columns() {
    return array(
        'email' => array( 'email', false ),
        'valid_until' => array( 'valid_until', false )
    );
}

Selanjutnya, mari kita lihat memformat kolom data. Format dapat dilakukan dengan dua cara: baik dengan mendefinisikan fungsi format kustom dengan nama column_ {column_name} yang mana column_name adalah nama kolom seperti yang tercantum di get_columns di atas, atau dengan menggunakan fungsi renderer default, column_default.

Mari kita gunakan column_default untuk kolom yang akan ditampilkan. Fungsi mengambil dua parameter: baris database yang sedang ditangani ($item) dan nama kolom ($column_name).

/**
 * Default rendering for table columns.
 *
 * @param $item         array   The database row being printed out.
 * @param $column_name  string  The column currently processed.
 * @return string       The text or HTML that should be shown for the column.
 */
function column_default( $item, $column_name ) {
    switch( $column_name ) {
        case 'email':
        case 'created_at':
            return $item[$column_name];

        default:
            break;
    }

    return '';
}

Kemudian, mari kita ambil contoh dari fungsi kustom output. Melihat kode sumber plugin, Anda dapat melihat bahwa saya telah menciptakan sekelompok itu.

Berikut adalah contoh, renderer kolom valid_until:

/**
 * Custom renderer for the valid_until field.
 *
 * @param $item     array   The database row being printed out.
 * @return string   The text or HTML that should be shown for the column.
 */
function column_valid_until( $item ) {
    $valid_until = $item['valid_until'];

    if ($valid_until == '0000-00-00 00:00:00') {
        return __( 'Forever', $this->text_domain );
    }

    return $valid_until;
}

Renderer ini menampilkan "Forever" ketika nilai bidang adalah ' 0000-00-00 00:00:00 ' dan sebaliknya nilai itu sendiri. Anda mendapatkan titik.

Langkah 3: Query daftar Data

Sekarang bahwa kami telah mendefinisikan pengaturan render untuk daftar, mari kita tambahkan beberapa data ke dalam campuran. Hal ini dilakukan dalam WP_List_Table fungsi prepare_items.

Berikut adalah fungsi:

/**
 * Populates the class fields for displaying the list of licenses.
 */
public function prepare_items() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'product_licenses';

    $columns = $this->get_columns();
    $hidden = $this->get_hidden_columns();
    $sortable = $this->get_sortable_columns();

    $this->_column_headers = array( $columns, $hidden, $sortable );

    // Pagination
    $licenses_per_page = 20;
    $total_items = $wpdb->get_var( "SELECT COUNT(id) FROM $table_name" );

    $offset = 0;
    if ( isset( $_REQUEST['paged'] ) ) {
        $page = max( 0, intval( $_REQUEST['paged'] ) - 1 );
        $offset = $page * $licenses_per_page;
    }

    $this->set_pagination_args(
        array(
            'total_items' => $total_items,
            'per_page' => $licenses_per_page,
            'total_pages' => ceil( $total_items / $licenses_per_page )
        )
    );

    // Sorting
    $order_by = 'email'; // Default sort key
    if ( isset( $_REQUEST['orderby'] ) ) {
        // If the requested sort key is a valid column, use it for sorting
        if ( in_array( $_REQUEST['orderby'], array_keys( $this->get_sortable_columns() ) ) ) {
            $order_by = $_REQUEST['orderby'];
        }
    }

    $order = 'asc'; // Default sort order
    if ( isset( $_REQUEST['order'] ) ) {
        if ( in_array( $_REQUEST['order'], array( 'asc', 'desc' ) ) ) {
            $order = $_REQUEST['order'];
        }
    }

    // Do the SQL query and populate items
    $this->items = $wpdb->get_results(
        $wpdb->prepare( "SELECT * FROM $table_name ORDER BY $order_by $order LIMIT %d OFFSET %d", $licenses_per_page, $offset ),
        ARRAY_A );
}

Mari kita pergi melalui fungsi untuk melihat apa yang dilakukan:

Baris 8 – 12: mengumpulkan tajuk kolom dan penyortiran informasi menggunakan fungsi-fungsi yang kami ciptakan di atas.

Setelah ini, Bagian yang tersisa adalah tentang query data.

Baris 15 – 22: menghitung pagination informasi. Jika pengguna telah meminta halaman, parameter paged berisi nomor halaman (mulai dari 1), sehingga kita dapat menggunakannya untuk menghitung offset untuk SQL query.

Baris 24 – 30: menyampaikan informasi pagination untuk daftar tabel sehingga ia dapat menampilkan tombol navigasi yang benar ketika rendering tabel.

Baris 33 – 46: mempersiapkan jenis kolom dan urutan berdasarkan input pengguna.

Baris 49-51: menggunakan variabel yang ditetapkan di awal fungsi untuk melakukan database query dan mengisi variabel class $items.

Dan hanya itu: Anda sekarang membuat tabel paged dan sortable untuk menampilkan lisensi.

Langkah 4: Gunakan daftar tabel

Sebelumnya dalam tutorial ini, kami menciptakan sebuah fungsi yang kosong untuk menampilkan isi dari halaman Licenses. Sekarang bahwa kita telah menciptakan daftar tabel, kita dapat mengisi yang berfungsi (render_licenses_menu_list di Wp_License_Manager_Admin) dan akhirnya membuat lisensi terlihat:

/**
 * Renders the list of licenses menu page using the "licenses_list.php" partial.
 */
public function render_licenses_menu_list() {
    $list_table = new Licenses_List_Table( $this->plugin_name );
    $list_table->prepare_items();

    require plugin_dir_path( dirname( __FILE__ ) ) . 'admin/partials/licenses_list.php';
}

Fungsi pertama membuat instance class kami, Licenses_List_Table, kemudian memanggil dengan fungsi prepare_items (didefinisikan di atas) untuk menginisialisasi data, dan akhirnya memasukan template HTML untuk merender halaman.

Template ini juga mengandung sebuah panggilan ke $list_table-> display(), yang membuat daftar pada halaman:

<?php
/**
 * The view for the admin page used for listing licenses.
 *
 * @package    Wp_License_Manager
 * @subpackage Wp_License_Manager/admin/partials
 */
?>

<div class="wrap">
    <h2>
        <?php _e( 'Licenses', $this->plugin_name ); ?>
        <a class="add-new-h2" href="<?php echo admin_url( 'admin.php?page=wp-licenses-new' );?>">
            <?php _e( 'Add new', $this->plugin_name ) ?>
        </a>
    </h2>

    <?php $list_table->display(); ?>
</div>

Apa berikutnya?

Kami sekarang telah menciptakan sebuah plugin dasar untuk menyimpan produk dan lisensi. Ini bukan akhir, namun.

Dalam bagian kedua dari seri tutorial, kami akan terus bekerja pada plugin dan memperpanjang dengan API yang plugin dan tema dapat digunakan untuk memeriksa pengguna lisensi dan men-download pembaruan.

Ketemu lain kali!