当ブログでは、楽天アフィリエイトを利用して商品を紹介しています。
当ブログでは、Amazonのアソシエイトとして、適格販売により収入を得ています。
WordPressで運営しているブログの記事一覧を、WordPress以外のWebサイトにも表示したいと思ったことはありませんか?
今回は静的HTMLやEC系のカスタマイズ領域、コマースクリエイターのトップページやフリーページなどでも使える方法をご紹介します。
WordPress以外のサイトに記事を表示する方法はいくつかありますが、
今回は WordPress REST API と JavaScript を使って記事情報を取得し、HTMLとして表示する方法を紹介します。
もくじ
WordPressの記事を外部サイトに表示する仕組み
WordPressには、記事やカテゴリー、画像などの情報を外部から取得できる「REST API」という仕組みがあります。このAPIを利用すると、WordPressの管理画面にログインすることなく、公開されている記事の情報を取得できます。
今回使用するのは、WordPressの投稿を取得するためのREST APIです。
https://ブログのURL/wp-json/wp/v2/postsこのURLにアクセスすると、公開記事のタイトルやURL、投稿日などの情報がJSON形式で返されます。
JavaScriptでこのデータを取得し、表示用のHTMLを生成することで、WordPress以外のサイトにも記事一覧を掲載できます。
処理の流れは次のとおりです。
- JavaScriptからWordPress REST APIにアクセスする
- 記事のタイトルやURL、カテゴリー、アイキャッチ画像などを取得する
- 取得したデータをもとにHTMLを生成する
- 指定したHTML要素の中に記事一覧を表示する
WordPressのテーマファイルを直接編集する必要がないため、外部サイトからブログ記事を利用したい場合に便利な方法です。
記事一覧を表示するHTMLとJavaScript
まず、記事一覧を表示するためのHTMLを用意します。
<div id="wplist-feature"></div>この要素の中に、JavaScriptで生成した記事一覧が挿入されます。
続いて、以下のJavaScriptを設置します。
以下のコードは、記事を最大10件取得し、投稿日・カテゴリー・アイキャッチ画像・記事タイトルを一覧表示するサンプルです。
<script>
(function () {
// ===== 設定 =====
var ORIGIN = 'https://blog.kiyo-ali.com';
var API = ORIGIN + '/wp-json/wp/v2/posts'
+ '?per_page=10'
+ '&_embed=wp:featuredmedia,wp:term'
+ '&_fields=link,date,title,categories,_links,_embedded';
var NOIMAGE = ORIGIN + '/hqdNE5W2/wp-content/uploads/2026/10/noimage.png'; // 絶対パス推奨
var CACHE_KEY = 'wplist-feature-v2'; // エスケープ前のキャッシュを使わないよう v2
var CACHE_TTL = 10 * 60 * 1000; // 10分
var TIMEOUT = 8000; // 8秒
// ===== 実行しないページ(決済・会員系)=====
// ※ 実際のURLに合わせて必ず調整してください。先頭一致で判定します。
// ほとんどの場合このあたりは、あまり気にしなくてもいいかもしれません。
var DENY_PATHS = ['/cart', '/order', '/checkout', '/member', '/mypage', '/login', '/regist'];
function isDeniedPage() {
var path = location.pathname.toLowerCase();
return DENY_PATHS.some(function (p) { return path.indexOf(p) === 0; });
}
// ===== 文字列の安全化 =====
// HTML特殊文字を置き換える
function esc(s) {
return String(s)
.replace(/&/g, '&').replace(/"/g, '"').replace(/'/g, ''')
.replace(/</g, '<').replace(/>/g, '>');
}
// – などのHTMLエンティティを文字に戻す(スクリプトは実行されない)
function decode(s) {
var t = document.createElement('textarea');
t.innerHTML = String(s == null ? '' : s);
return t.value;
}
// 表示用テキスト:エンティティを戻してから、改めてエスケープ
function text(s) {
return esc(decode(s));
}
// URLの検証:許可したオリジンのhttpsだけ通す
function safeLink(u) {
u = String(u || '');
return u.indexOf(ORIGIN + '/') === 0 ? u : null;
}
// 画像URLの検証:https のみ(相対パスはNOIMAGE用に許可)
function safeImg(u) {
u = String(u || '');
return (u.indexOf('https://') === 0 || u.charAt(0) === '/') ? u : NOIMAGE;
}
// ===== データ取り出し =====
// サムネイル:なし・削除済み・サイズ未生成でも落ちない
// 登録する画像が小さすぎると各サイズ画像が生成されない場合にエラーになるのを防ぎます
function getThumb(p) {
var m = p._embedded && p._embedded['wp:featuredmedia'];
m = m && m[0];
if (!m || !m.source_url) return { src: NOIMAGE };
var s = m.media_details && m.media_details.sizes;
var pick = s && (s.medium_large || s.medium || s.large);
if (pick && pick.source_url) {
return { src: safeImg(pick.source_url), w: Number(pick.width), h: Number(pick.height) };
}
return { src: safeImg(m.source_url) };
}
// カテゴリ名(埋め込みデータから取得。タグは除外)
function getCats(p) {
var out = [];
var t = p._embedded && p._embedded['wp:term'];
if (!Array.isArray(t)) return out;
t.forEach(function (group) {
if (!Array.isArray(group)) return;
group.forEach(function (term) {
if (term && term.taxonomy === 'category') out.push(term.name);
});
});
return out;
}
// ===== HTML生成 =====
function build(posts) {
if (!Array.isArray(posts) || !posts.length) return '';
return posts.map(function (p) {
var link = safeLink(p.link);
if (!link) return ''; // 想定外のURLの記事は表示しない
var th = getThumb(p);
var date = esc(String(p.date || '').slice(0, 10).replace(/-/g, '.'));
var cats = getCats(p).map(function (c) {
return '<span class="popi">' + text(c) + '</span>';
}).join('');
var size = (th.w > 0 && th.h > 0)
? ' width="' + th.w + '" height="' + th.h + '"' : '';
var title = text(p.title && p.title.rendered);
return '<div class="feature-item"><a href="' + esc(link) + '">'
+ '<p class="thumb"><img src="' + esc(th.src) + '"' + size
+ ' alt="" loading="lazy" decoding="async"></p>'
+ '<p class="date popi">' + date + '</p>'
+ '<p class="category">' + cats + '</p>'
+ '<p class="ttl">' + title + '</p>'
+ '</a></div>';
}).join('');
}
// ===== キャッシュ =====
function readCache() {
try {
var c = JSON.parse(sessionStorage.getItem(CACHE_KEY));
if (c && Date.now() - c.t < CACHE_TTL) return c.html;
} catch (e) {}
return null;
}
function writeCache(html) {
try { sessionStorage.setItem(CACHE_KEY, JSON.stringify({ t: Date.now(), html: html })); }
catch (e) {}
}
// ===== 実行 =====
function init() {
if (isDeniedPage()) return; // 決済・会員系では何もしない
var box = document.getElementById('wplist-feature');
if (!box) return;
var cached = readCache();
if (cached) { box.innerHTML = cached; return; }
var ctrl = window.AbortController ? new AbortController() : null;
var timer = setTimeout(function () { if (ctrl) ctrl.abort(); }, TIMEOUT);
fetch(API, ctrl ? { signal: ctrl.signal } : {})
.then(function (res) {
if (!res.ok) throw new Error('HTTP ' + res.status);
return res.json();
})
.then(function (posts) {
clearTimeout(timer);
var html = build(posts);
if (!html) return;
box.innerHTML = html;
writeCache(html);
})
.catch(function (err) {
clearTimeout(timer);
console.error('WordPressのブログ記事取得に失敗しました。', err);
});
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', init);
} else {
init();
}
})();
</script>読み込みのサンプル
このブログサイトを読み込んでみたページをHTMLで作成しました。
https://blog.kiyo-ali.com/m4b95686.html
コードを設置する際の注意点
ORIGINは記事を取得するWordPressサイトのURLに変更します。NOIMAGEはアイキャッチ画像がない場合に表示する画像のURLです。
実際に利用できる画像のURLに変更してください。DENY_PATHSは記事一覧を表示しないページのパスです。
必要に応じて設置先のURL構成に合わせて変更します。wplist-featureは記事一覧を表示するHTML要素のIDです。
HTML側とJavaScript側で一致させてください。- 今回はカスタム投稿タイプには対応していません。
当然ですが、自分の保有しているサイトを取得しましょう
コードの設定項目を解説
コードの冒頭には、記事の取得先や表示件数、キャッシュの有効期間などを設定する項目があります。
WordPressのURLとAPIを指定する
var ORIGIN = 'https://blog.kiyo-ali.com';
var API = ORIGIN + '/wp-json/wp/v2/posts'
+ '?per_page=10'
+ '&_embed=wp:featuredmedia,wp:term'
+ '&_fields=link,date,title,categories,_links,_embedded';ORIGINには、記事を取得するWordPressサイトのURLを指定します。
APIは、記事情報を取得するためのURLです。
URLにパラメータを追加することで、取得する件数やデータの種類を指定しています。
| パラメータ | 内容 |
|---|---|
per_page=10 | 取得する記事を最大10件にする |
_embed=wp:featuredmedia,wp:term | アイキャッチ画像やカテゴリーなどの関連情報を取得する |
_fields=... | 必要なデータ項目を指定する |
例えば、取得する記事数を5件にしたい場合は、per_page=10をper_page=5に変更します。
また、_embedを指定することで、アイキャッチ画像やカテゴリーなどの関連情報もまとめて取得できます。
アイキャッチ画像がない場合の画像を指定する
var NOIMAGE = ORIGIN
+ '/hqdNE5W2/wp-content/uploads/2026/10/noimage.png';記事にアイキャッチ画像が設定されていない場合や、画像情報を取得できない場合に表示する画像を指定しています。アイキャッチ画像がない記事でも、画像の表示領域を確保しやすくなります。
このURLはサンプルのため、実際に利用するサイトに合わせて変更してください。
特定のページでは処理を実行しない
この設定では、記事一覧を表示しないページのパスを指定しています。
例えば、ECサイトのカートや注文手続きの画面では、ブログ記事を表示する必要がない場合があります。そのようなページで処理を実行しないようにするための設定です。
ただし、すべてのサイトで必須というわけではありません。
記事一覧を表示するページが限られている場合などは、サイトの構成に合わせて調整してください。
なお、この処理は指定したページでJavaScriptを実行しないようにするものであり、決済や会員情報を保護するためのセキュリティ対策ではありません。
ほとんどの場合、逆に表示したいページにだけScriptを設置すればいいので個人的には必要ない部分かと思います。
記事情報を取得してHTMLを生成する
APIから取得した記事情報は、そのままでは記事一覧として表示できません。
そこで、JavaScriptで必要な情報を取り出し、HTMLを生成します。
記事タイトルとリンクを取得する
記事タイトルはp.title.rendered、記事のURLはp.linkから取得します。
var title = text(p.title && p.title.rendered);
var link = safeLink(p.link);タイトルは表示用の文字列に変換し、リンク先は指定したWordPressサイトのURLであることを確認しています。
また、取得した文字列にHTMLの特殊文字が含まれている場合に備えて、エスケープ処理を行っています。
アイキャッチ画像を取得する
var m = p._embedded && p._embedded['wp:featuredmedia'];
m = m && m[0];_embeddedに含まれるアイキャッチ画像の情報を取得しています。
画像がある場合は、medium_large、medium、largeの順で利用可能な画像サイズを探します。
WordPressに登録した画像が小さすぎる場合など、指定したサイズの画像が生成されていないこともあります。その場合は、別のサイズを探すか、元画像を利用することで、画像が取得できないケースに対応しています。
画像そのものが取得できない場合は、先ほど設定した代替画像を表示します。
また、画像の幅と高さが取得できた場合は、HTMLのwidthとheight属性に設定します。これにより、画像の読み込み前に表示領域を確保しやすくなります。
カテゴリー名を取得する
if (term && term.taxonomy === 'category') {
out.push(term.name);
}カテゴリー情報は、_embedded['wp:term']から取得しています。
WordPressではカテゴリーとタグが別の分類として管理されているため、taxonomyがcategoryのデータだけを取り出しています。
取得したカテゴリー名は、記事一覧の中でラベルとして表示します。
カテゴリーを表示する必要がない場合は、カテゴリー取得処理とHTML生成部分を変更すれば対応できます。
投稿日を整形する
var date = esc(
String(p.date || '')
.slice(0, 10)
.replace(/-/g, '.')
);WordPressから取得した投稿日を、YYYY.MM.DDの形式に整形しています。
例えば、2026-10-20という日付は2026.10.20と表示されます。
表示形式を変更したい場合は、日付を整形している部分を変更してください。
記事一覧のHTMLとCSSをカスタマイズする
今回のコードでは、記事1件ごとに次のようなHTMLを生成しています。
<div class="feature-item">
<a href="記事のURL">
<p class="thumb">
<img src="画像のURL" alt="">
</p>
<p class="date popi">2026.10.20</p>
<p class="category">
<span class="popi">カテゴリー名</span>
</p>
<p class="ttl">記事タイトル</p>
</a>
</div>実際には、記事情報に応じてURLや画像、テキストが自動的に挿入されます。
各要素にはクラス名を設定しているため、CSSで見た目を調整できます。
キャッシュを利用してAPIへのアクセスを減らす
今回のコードでは、取得した記事一覧のHTMLをsessionStorageに保存しています。
var CACHE_KEY = 'wplist-feature-v2';
var CACHE_TTL = 10 * 60 * 1000;CACHE_TTLはキャッシュの有効期間で、ここでは10分に設定しています。
一度取得した記事一覧がキャッシュに残っている間は、APIへ再アクセスせず、保存済みのHTMLを表示します。
これにより、同じタブ内でページを移動するような場合に、通信回数を減らせます。
ただし、sessionStorageは基本的にタブ単位で保存され、タブを閉じるとデータが破棄されます。
また、保存容量やブラウザの設定によっては、キャッシュを利用できない場合もあります。
記事の更新をすぐに反映させたい場合は、キャッシュの有効期間を短くするなど、運用に合わせて調整してください。
タイムアウトとエラー処理
APIの応答が遅い場合に備えて、今回のコードではタイムアウトを設定しています。
var TIMEOUT = 8000;設定値はミリ秒で、8秒を意味します。AbortControllerが利用できる環境では、一定時間が経過すると通信を中止します。
また、APIの取得に失敗した場合は、catch()でエラーを処理し、ブラウザのコンソールにメッセージを出力します。
.catch(function (err) {
clearTimeout(timer);
console.error(
'WordPressのブログ記事取得に失敗しました。',
err
);
});実際のサイトで利用する場合は、必要に応じて「記事を読み込めませんでした」といったメッセージを画面に表示する処理を追加してもよいでしょう。
外部サイトに設置するときの注意点
WordPressと記事を表示するサイトが異なるドメインの場合、ブラウザのCORS制限に注意が必要です。
WordPress REST APIのURLを直接開けても、外部サイトからのJavaScriptによるアクセスが許可されているとは限りません。
そのため、次の点を確認しましょう。
- WordPress REST APIから記事情報を取得できること
- WordPress側で外部サイトからのアクセスが許可されていること
- 設置先のCMSでJavaScriptを実行できること
- 画像や記事リンクが正しいURLになっていること
- 設置先のCSSとスタイルが干渉しないこと
また、今回のsafeImg()はHTTPSのURLを許可する仕様です。
画像URLを自サイトのものに限定したい場合は、許可するホスト名を検証するように変更すると、より安全に運用できます。
まとめ
WordPress REST APIとJavaScriptを利用すれば、WordPressで公開している記事を、WordPress以外のWebサイトにも表示できます。
今回のコードでは、記事のタイトルやURL、投稿日、カテゴリー、アイキャッチ画像を取得するだけでなく、代替画像やキャッシュ、タイムアウトなども設定しています。
企業サイトやECサイトにブログの新着記事を掲載したい場合などに活用できる方法です。
外部サイトに設置する際は、REST APIへのアクセス制限やCMSの仕様を確認したうえで、実際の環境に合わせて調整してみてください。
コメント