WordPress教程，如何創(chuàng)建一個頁面來讀取API數(shù)據(jù)

來自：素雅營銷研究院

方知筆記

2025年06月03日 19:37

在當今的網(wǎng)站開發(fā)中，與外部API交互已成為常見需求。WordPress作為全球最流行的內(nèi)容管理系統(tǒng)，提供了多種方式來實現(xiàn)這一功能。本文將詳細介紹如何在WordPress中創(chuàng)建一個專門用于讀取和顯示API數(shù)據(jù)的頁面。

準備工作

在開始之前，請確保您已經(jīng)：

擁有一個正常運行的WordPress網(wǎng)站
具備管理員權(quán)限
了解基本的PHP和HTML知識
獲取了目標API的訪問權(quán)限和文檔

方法一：使用自定義頁面模板

1. 創(chuàng)建自定義頁面模板

在您的WordPress主題文件夾中（通常是/wp-content/themes/您的主題/），創(chuàng)建一個新的PHP文件，例如api-page-template.php，并添加以下代碼：

<?php
/*
Template Name: API 數(shù)據(jù)頁面
*/

get_header();

// 這里將放置API調(diào)用代碼

get_footer();
?>

2. 編寫API調(diào)用邏輯

在模板文件中添加API調(diào)用代碼：

$api_url = 'https://api.example.com/data';
$response = wp_remote_get($api_url);

if (!is_wp_error($response) && $response['response']['code'] == 200) {
$data = json_decode($response['body'], true);

// 顯示數(shù)據(jù)
echo '<div class="api-data-container">';
foreach ($data as $item) {
echo '<div class="api-item">';
echo '<h3>' . esc_html($item['title']) . '</h3>';
echo '<p>' . esc_html($item['description']) . '</p>';
echo '</div>';
}
echo '</div>';
} else {
echo '<p>無法獲取API數(shù)據(jù)，請稍后再試。</p>';
}

3. 在WordPress中創(chuàng)建頁面

登錄WordPress后臺
導航至”頁面” > “添加新頁面”
為頁面命名（如”API數(shù)據(jù)展示”）
在”頁面屬性”中選擇您創(chuàng)建的”API 數(shù)據(jù)頁面”模板
發(fā)布頁面

方法二：使用短代碼

如果您希望在現(xiàn)有頁面中插入API數(shù)據(jù)，可以創(chuàng)建一個短代碼：

1. 在主題的functions.php中添加短代碼

function display_api_data_shortcode() {
ob_start();

$api_url = 'https://api.example.com/data';
$response = wp_remote_get($api_url);

if (!is_wp_error($response) && $response['response']['code'] == 200) {
$data = json_decode($response['body'], true);

echo '<div class="api-data-container">';
foreach ($data as $item) {
echo '<div class="api-item">';
echo '<h3>' . esc_html($item['title']) . '</h3>';
echo '<p>' . esc_html($item['description']) . '</p>';
echo '</div>';
}
echo '</div>';
} else {
echo '<p>無法獲取API數(shù)據(jù)，請稍后再試。</p>';
}

return ob_get_clean();
}
add_shortcode('display_api_data', 'display_api_data_shortcode');

2. 在頁面中使用短代碼

在WordPress編輯器中，只需添加[display_api_data]短代碼即可顯示API數(shù)據(jù)。

高級技巧

1. 添加緩存機制

頻繁調(diào)用API可能會影響性能，可以添加緩存：

$transient_key = 'api_data_cache';
$data = get_transient($transient_key);

if (false === $data) {
$response = wp_remote_get($api_url);

if (!is_wp_error($response) {
$data = json_decode($response['body'], true);
set_transient($transient_key, $data, HOUR_IN_SECONDS * 12); // 緩存12小時
}
}

2. 添加AJAX支持

// 在functions.php中添加
add_action('wp_ajax_get_api_data', 'get_api_data_callback');
add_action('wp_ajax_nopriv_get_api_data', 'get_api_data_callback');

function get_api_data_callback() {
$api_url = 'https://api.example.com/data';
$response = wp_remote_get($api_url);

if (!is_wp_error($response)) {
wp_send_json_success(json_decode($response['body'], true));
} else {
wp_send_json_error('無法獲取數(shù)據(jù)');
}

wp_die();
}