如何開發一個自動產生留言板的WordPress插件

如何開發一個自動產生留言板的WordPress外掛程式

在創造一個互動的網站時，一個留言板是不可或缺的。在WordPress平台上，為了方便用戶添加留言功能，我們可以開發一個自動產生留言板的外掛程式。本文將介紹如何使用WordPress外掛開發來實現這一目標，並提供相應的程式碼範例。

第一步：建立外掛程式資料夾和主檔案

首先，我們需要在WordPress的外掛目錄下建立一個資料夾，以放置我們的留言板外掛程式。可以將這個資料夾命名為"message-board"。

在這個資料夾中，建立一個主文件，例如"message-board.php"。這個文件將是插件的入口文件。

接下來，將以下程式碼新增至"message-board.php"檔案：

<?php
/*
Plugin Name: 留言板
Plugin URI: https://www.example.com/message-board
Description: 自动生成留言板的WordPress插件
Version: 1.0
Author: Your Name
Author URI: https://www.example.com
*/

// 在这里编写插件的主要代码

?>

這段程式碼為插件提供了基本信息，並創建了一個名為"留言板"的插件。

第二步：建立資料庫表格

為了保存留言數據，我們需要建立一個資料庫表格。這可以透過擴展WordPress的資料庫來完成。

在"message-board.php"檔案的主要程式碼區塊中，新增以下程式碼：

// 当插件激活时，调用该函数创建数据库表格
register_activation_hook( __FILE__, 'create_message_board_table' );

function create_message_board_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'message_board';

    $charset_collate = $wpdb->get_charset_collate();

    $sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        author_name varchar(150) NOT NULL,
        message text NOT NULL,
        submit_date datetime NOT NULL,
        PRIMARY KEY  (id)
    ) $charset_collate;";

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

這段程式碼會在外掛程式啟動時呼叫"create_message_board_table"函數，該函數將創建一個名為"wp_message_board"的資料庫表格。表格包括id、author_name、message和submit_date等欄位。

第三個步驟：建立留言板頁面

現在我們需要在WordPress中建立一個頁面來展示留言板。我們可以在插件的主檔案中加入一個短代碼函數來實現這一目標。

在"message-board.php"檔案中的主要程式碼片段中，新增以下程式碼：

// 注册短代码
add_shortcode( 'message_board', 'display_message_board' );

// 短代码函数
function display_message_board() {
    ob_start();
    ?>

    <h3 id="留言板">留言板</h3>

    <!-- 留言板表单 -->
    <form id="message_form" method="post" action="<?php echo esc_url( admin_url('admin-post.php') ); ?>">
        <input type="hidden" name="action" value="submit_message">
        <label for="author_name">姓名:</label>
        <input type="text" name="author_name" required>
        <br>
        <label for="message">留言:</label>
        <textarea name="message" cols="30" rows="5" required></textarea>
        <br>
        <input type="submit" value="提交">
    </form>

    <!-- 已提交的留言 -->
    <div id="message_list">
        <?php // 调用函数来展示已提交的留言 ?>
        <?php display_submitted_messages(); ?>
    </div>

    <?php
    return ob_get_clean();
}

這段程式碼中，我們註冊了一個名為"message_board"的短程式碼，並建立了一個用於展示留言板的頁面。頁面中包含一個表單用於提交新留言，以及一個用於展示已提交留言的清單。

第四步：處理表單提交資料

當使用者提交留言時，我們需要透過一個後端處理函數來將留言資料保存到資料庫中。

繼續在"message-board.php"檔案中的主要程式碼片段中加入以下程式碼：

// 处理留言提交
add_action( 'admin_post_nopriv_submit_message', 'handle_message_submission' );
add_action( 'admin_post_submit_message', 'handle_message_submission' );

function handle_message_submission() {
    if ( 'POST' === $_SERVER['REQUEST_METHOD'] ) {
        global $wpdb;
        $table_name = $wpdb->prefix . 'message_board';

        $author_name = sanitize_text_field( $_POST['author_name'] );
        $message = sanitize_textarea_field( $_POST['message'] );

        $data = array(
            'author_name' => $author_name,
            'message' => $message,
            'submit_date' => current_time( 'mysql' )
        );

        $wpdb->insert( $table_name, $data );

        wp_redirect( get_permalink() );
        exit;
    }
}

這段程式碼中，我們定義了一個名為"handle_message_submission"的函數，用於處理前端表單的提交。函數會從表單中取得作者姓名和留言內容，並將資料插入資料庫。最後，我們將頁面重新導向到留言板頁面。

第五步：展示已提交的留言

最後，我們需要建立一個函數來展示已提交的留言。

繼續在"message-board.php"檔案中的主要程式碼片段中加入以下程式碼：

function display_submitted_messages() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'message_board';

    $results = $wpdb->get_results( "SELECT * FROM $table_name" );

    if ( $results ) {
        foreach ( $results as $result ) {
            echo '<div class="message">';
            echo '<p><strong>作者: </strong>' . esc_html( $result->author_name ) . '</p>';
            echo '<p><strong>留言: </strong>' . esc_html( $result->message ) . '</p>';
            echo '<p><strong>时间: </strong>' . esc_html( $result->submit_date ) . '</p>';
            echo '</div>';
        }
    } else {
        echo '暂时没有留言';
    }
}

這段程式碼中，我們定義了一個名為"display_submitted_messages"的函數，用於從資料庫中取得已提交的留言並展示在頁面上。

至此，我們已經完成了一個自動產生留言板的WordPress外掛。在WordPress後台的外掛程式管理中啟動這個外掛後，可以透過在頁面中加入短代碼"[message_board]"來展示留言板。

希望本文對您在開發WordPress外掛程式中有所幫助！

以上是如何開發一個自動產生留言板的WordPress插件的詳細內容。更多資訊請關注PHP中文網其他相關文章！