WP Manifestindependent plugin directory
manifest / content / javascript-content-message

JavaScript Content Message

特定の期間が経過した投稿・固定ページにメッセージを出力します

by ぴいた · github.com/pitolick/javascript-content-message · website

0stars
64release downloads
≈10active sites
0forks

Install

The author publishes release zips, so WP-CLI can install straight from GitHub:

wp plugin install https://github.com/pitolick/javascript-content-message/releases/download/1.2.2/JavaScript-Content-Message.zip

Readme

JavaScript-Content-Message

投稿・固定ページの投稿日もしくは最終更新日が一定期間過ぎている場合、メッセージを表示させます。

特徴

Shifterのようなサーバレス環境での動作を想定しているためJavaScriptを使用してメッセージの表示を制御しています。

インストール

zipでこのプラグインをダウンロードし、WordPressの管理画面にアップロードしてください。

使い方

プラグインを有効にすると、設定 > 投稿設定 内に JavaScript-Content-Message というセクションが追加されます。

適用ページ

メッセージを表示させる投稿タイプを選択します。
選択された投稿タイプをもつページが表示されているとき、出力設定で設定した箇所にメッセージ表示に必要なDOMが挿入されます。

選択項目 投稿タイプ 表示条件
投稿 post is_single()
固定ページ page is_page()

デフォルトでは投稿・固定ページ両方に出力されます。

比較基準日

基準日の設定

表示されている記事の投稿日もしくは最終更新日のどちらを基準日にするかを設定します。

選択項目 日付取得関数
投稿日 get_the_date('Y/m/d')
最終更新日 get_the_modified_date('Y/m/d')

デフォルトでは投稿日が基準日として設定されます。

基準日からの経過時間の設定

基準日からどれだけ経過した場合にメッセージを表示するか設定します。
デフォルトでは1年以上経過した場合にメッセージを表示します。

表示メッセージ

表示させたいメッセージを設定します。
HTMLを使用した場合、そのまま出力されるように構築されているため、自由なDOM構造を作成することができます。
また、以下の特殊文字をメッセージ中に埋め込むことで正規表現を使用し、対応した文字に置換を行います。

特殊文字 説明
%year% 基準日と現在の年差
%monthnum% 基準日と現在の月差(1ヶ月あたり30日で計算のため多少ブレあり)
%day% 基準日と現在の日差
%post_date% 記事の投稿日
%modified_date% 記事の最終更新日

%post_date% %modified_date% で使用する日付フォーマットをカスタマイズする」にチェックを入れると、その隣にあるテキストボックスに入力された日付フォーマットに沿って %post_date% %modified_date% が表示されます。
チェックが入っていないときは 設定 > 一般設定 > 日付のフォーマット 項目で設定された日付フォーマットで表示されます。

CSS設定

表示されるメッセージに適用するCSSを設定します。
オリジナルCSSを使う を選択すると、CSSを記述するためのフィールドが表示されます。
表示されるメッセージは 表示メッセージ で設定する内容とは関係なく <div id="jcm_content_message"> にラップされた状態のDOMを出力するので、 #jcm_content_message をセレクタとすることでCSSを適用することができます。
オリジナルCSSを記述したあとで プラグイン付属のCSSを使う を選択しても記述された内容は保存されています。

出力設定

メッセージの表示方法を設定します。 | 項目 | 説明 | ----|---- | 本文の前 | the_content() の直前にメッセージを連結して表示 | | 本文の後 | the_content() の直後にメッセージを連結して表示 | | 自動出力せずテンプレートタグを使用する | テンプレートタグを echo した箇所に表示 |

※デフォルトでは「本文の前」を設定している状態と同じ表示状態になります。

テンプレートタグ

jcm_add_content_temp() の関数を使用することでメッセージを取得することができます。
指定した箇所に出力したい場合は、echo などを使用して出力を行ってください。
※プラグインのため、function_exists() を利用して関数が定義されているのを確認することを忘れないでください。

サンプルテンプレートタグ

<?php if(function_exists('jcm_add_content_temp')){echo jcm_add_content_temp();} ?>

依存関係

JavaScriptを使用して記述しているため、jQueryが無い環境でも動作します。
閲覧に使用するブラウザがJavaScriptをサポートしていれば動作します。

注意

  • サーバーレス環境での動作を想定してJavaScriptで構築されているため、読み込み時に一瞬チラついて見えることがあります。
  • カスタム投稿への対応はしていません。
  • 特殊文字の %monthnum% は比較した差分の日数を30日で割った結果を月として出力しているため、正確な月ではありません。

Read the full README on GitHub →

Releases

TagPublishedAssetDownloads
1.2.2 Oct 29, 2020 JavaScript-Content-Message.zip 16
1.2.1 Oct 20, 2020 JavaScript-Content-Message.zip 13
1.2.0 Oct 12, 2020 JavaScript-Content-Message.zip 9
1.1.0 Sep 14, 2020 JavaScript-Content-Message.zip 9
1.0.1 Sep 13, 2020 JavaScript-Content-Message.zip 9
1.0.0 Sep 13, 2020 JavaScript-Content-Message.zip 8

Active-site estimate ≈10 comes from the median of recent superseded releases. Method.