WordPress

提供：GNU social JP Wiki

About

WordPressは世界の多くのウェブサイトで使用されているCMSだ。PHPで記述されている。

WordPressの外観や挙動はPHPのプログラムを書いてカスタマイズできる。また、プラグイン機構を持ち、世界中の開発者によるプラグインを導入することで簡単にウェブサイトを拡張できる。

Install

WordPress.comなどのホスティングサービスを使用することもできるが、レンタルサーバーやVPSに設置することが好ましい。

ActivityPub

WordPressはActivityPubを実装している。WordPressへの投稿時に分散SNSにも投稿される、分散SNSからWordPressの投稿にコメントできるなどの機能がある。

WordPressの公式ホスティングサービスであるWordPress.comもActivityPubに対応している。分散SNSの中でも巨大なサーバーと言え、無視できない存在だ。

Function

Comment

Ref:

このあたりの関数で定義されている。フィルターを挟むことで変更できる模様。

PV

WordPressでPV数を表示させる方法がいくつかある。

WP-PostViewsプラグインのほうが柔軟性がある？ (WordPressで記事ランキングを設置するならWP-PostViewsが最適なのでは？ | kanae-design-works、「WP-PostViews」と「WordPress Popular Posts」の違い | クロジカ)。

WordPressの分析プラグインはDBにアクセ格納するから重くなるらしい

Jetpackの統計情報から閲覧数を取得表示することができる。これが一番手っ取り早い気がする。

<p>
<?php // 全体、月別、週別、日別のPV表示
  global $post;
  $views_all = 0;
  $views_monthly = 0;
  $views_weekly = 0;
  $views_daily = 0;
  //Jetpack利用時
  if (is_jetpack_stats_module_active()) {
    $jetpack_views = stats_get_csv( 'postviews', array('days' => -1, 'limit' => 1, 'post_id' => $post->ID ));
    if (isset($jetpack_views[0]['views'])) {
      $views_all = $jetpack_views[0]['views'];
    }
    $jetpack_views = stats_get_csv( 'postviews', array('days' => 30, 'limit' => 1, 'post_id' => $post->ID ));
    if (isset($jetpack_views[0]['views'])) {
      $views_monthly = $jetpack_views[0]['views'];
    }
    $jetpack_views = stats_get_csv( 'postviews', array('days' => 7, 'limit' => 1, 'post_id' => $post->ID ));
    if (isset($jetpack_views[0]['views'])) {
      $views_weekly = $jetpack_views[0]['views'];
    }
    $jetpack_views = stats_get_csv( 'postviews', array('days' => 1, 'limit' => 1, 'post_id' => $post->ID ));
    if (isset($jetpack_views[0]['views'])) {
      $views_daily = $jetpack_views[0]['views'];
    }
  }
  echo '<span class="daily">日:<span class="pv-count">', $views_daily, '</span></span>';
  echo '<span class="weekly">週:<span class="pv-count">', $views_weekly, '</span></span>';
  echo '<span class="monthly">月:<span class="pv-count">', $views_monthly, '</span></span>';
  echo '<span class="all">全体:<span class="pv-count">', $views_all, '</span></span>';
?>
</p>

上記コードをウィジェットに貼り付けたらうまくいった。

Language

WordPressで多言語対応サイトも構築できる。

情報源:

いろいろ方式があるが、サブディレクトリー形式が手軽な感じがする。

英語で情報発信できると、かなりの数のユーザーにアプローチできる。単に機械翻訳にするだけでも検討する価値はあるだろう。

広告ブロッカー対策

出典: 【WordPress編】広告ブロッカーからサイトコンテンツと収益を守る！ | SEの良心。

[CHP Ads Block Detector] というプラグインで実現できるらしい。

「プラグイン: WordPressの広告ブロッカー対策CHP Ads Block Detector | GNU social JP Web」の通り、簡単にできた。

Widget内でのPHP実行

「WordPressのウィジェットでPHPコードを実行する方法 – FOXWP」

function widget_text_exec_php( $widget_text ) {
    if( strpos( $widget_text, '<' . '?' ) !== false ) {
        ob_start();
        eval( '?>' . $widget_text );
        $widget_text = ob_get_contents();
        ob_end_clean();
    }
    return $widget_text;
}
add_filter( 'widget_text', 'widget_text_exec_php', 99 );

上記コードをfunction.phpに配置すると、テキストウィジェット内でPHPコード<?php ?>を実行できる模様。

Linkage

WordPressの記事・投稿を他のSNSに自動投稿する方法がいくつかある。

There has been a critical error on this website. Please check your site admin email inbox for instructions.

プラグインを無効にしようと

How to deactivate all plugins when not able to access the administrative menus?


Reference

Ref: Reference | Developer.WordPress.org.

WPCode

Shortcodeの定義はくせがある。

[Insert Method]=[Shortcode] を選ぶと [wpcode id="10405"] のようなショートコードが定義される。これを [wpcode id="10405"][/wpcode]のようなブロックで使う。

Code Previewには、関数の本文を指定して、表示する場合echoなどで出力させる。

無料版だとshortcodeの名前を指定できない。

Auto Insertで自分で定義したらどうだろう？それで問題ない。

Plugin

Ref: Plugin Handbook | Developer.WordPress.org.

WordPresの拡張性のコア機能。

Hook

Ref: Hooks – Plugin Handbook | Developer.WordPress.org.

フックはあるコードから別のコードに干渉するための仕組み。プラグインやテーマへの干渉のコア機能。拡張も可能。ActionとFilterの2種類がある。コールバックと一般的に呼ばれる関数を定義して引っ掛けて処理に干渉する。

  • Action: WordPressの操作操作に、データの追加や変更を行う。内部的にデータを処理するので、何も返さない。
  • Filter: WordPressコア機能の実行時にデータを変更する。データを受け取ってそれを次に渡す。

基本はFilterだと思う。Actionの用途がいまいちわからない。

Filter

Ref

add_filter/remove_filter

shortcode

Ref:

WordPressにはショートコードというのがある。角括弧 [shortcode][/shortcode] のような形式。本来ならHTML/JavaScriptしか使えない投稿本文に、PHP側の処理を仕込める。

新規作成する場合、書式がだいたい決まっている。

    function callback_function($atts, $content = null, $tag ) {
      extract(shortcode_atts(array(
        //属性
        'パラメータ1' => 'デフォルトの値1',
        'パラメータ2' => 'デフォルトの値2',
        ･･･
      ), $atts));
      //ショートコードの処理（動作）の記述
      return $value;
    }
    add_shortcode('my_shortcode', 'callback_function');

こえrでmy_shortcodeというショートコードが使用可能になる。

shortcode_atts

shortcode_atts( array $pairs, array $atts, string $shortcode = ” ): array

ユーザーが指定した属性と、使用可能な属性のデフォルト値を結合する。使用不能な属性を無視してくれる。

  • $pairs: 使用可能な属性とそのデフォルト値。
  • $atts: ショートコードでユーザーが指定した属性。
  • $shortcode: ショートコードの名前。これを指定するとshortcode_atts_$shortcode フィルターで外部から属性をフィルターできる。通常は使わない。



About

PMPro。有料会員サービスを実現するプラグイン。

ソースコード内のincludes配下の関数は自分でも使用可能。

Free

PMProは基本的に無料で使える模様 (PMPro: Free WordPress Membership Plugin)。サポートを販売している扱いの模様。ログアウトしていないと表示されない。

「Stranger Studios」がGitHubのリポジトリー。ここに全部のアドオンがある。ここからzipファイル類をダウンロードすれば使える。ただし、一部のプラグインは開発者の経験が必要なため、ライセンスキーの購入をsupportとして販売している。開発経験が一切ない人にはGitHubからのインストールもけっこう面倒くさいからそれでうまくGPLの条件を満たしているのだと思われる。

実行自体はライセンスの有無によらず可能。ただし、ライセンスの有無でStripeの決済手数料が変わる。

「Paid Memberships Pro (@paidmembershipspro) – WordPress user profile | WordPress.org」でも公開しているが、これは全部ではない。サードパーティープラグインとの連携用が大半。

金額変更

定期購読で販売していて、登録後に金額を変更したいことがある。

これは基本的にできない。定期購読は決済サービス側で登録時の金額で固定されるため。

金額を変更したければ、一度キャンセルして、再度チェックアウト・購入してもらうしかない。

既存会員に対しては、更新ではなく、期限を設けて強制的に一度退会させるのがいい。

Restriction

membership short code

Ref:

PMProの基本的なコンテンツ制限の概念がある。

基本は投稿全体を非表示で、excerptで冒頭部分を一部表示これが基本。membershipショートコードはこの逆で、基本全表示で一部だけ非表示。

そもそも仕組みが違う。

だから、カテゴリーで管理していて、一部だけ非表示にしたかったら、末尾にmoreブロックを配置して、membeshipショートコードも使う必要がある。二重に使わないといけない。けっこう面倒くさい。

「Custom Message for Non-Members on Protected Content」がメッセージの変更方法。ただ、制限のロジックを変更できるわけではない。別のフィルターだと思う。

ソースコードを参考に自分で実装するしかないだろう。

message

「Custom Message for Non-Members on Protected Content」に基本的な表示内容やスタイルの設定方法がある。 

<div class="pmpro_content_message">
//custom message here
</div>

表示部分は上記要素になるのでこのクラスでスタイルをあてる。

.pmpro_content_message {
	background: #F1F1F1;
	margin: 0 auto;
	max-width: 700px;
	padding: 15px;
}

他に以下のフィルターが該当するメッセージ表示。

  • add_filter( 'pmpro_non_member_text_filter', 'my_pmpro_non_member_text_filter', 5 );
  • add_filter( 'pmpro_not_logged_in_text_filter', 'my_pmpro_not_logged_in_text_filter', 5 );

例えば、会員限定の文字数表示などをしたければ、自前でやるしかない。基本は自分で上記フィルターで上書きするのがよい。

例

function my_pmpro_non_member_text_filter( $text ) {
	global $post, $post_membership_levels_names;
	$count = mb_strlen( $post->post_content, 'UTF-8' ) - mb_strlen( get_the_excerpt(), 'UTF-8' );
	$access = pmpro_has_membership_access( $post->ID, null, true );
	$text = "<p>残り{$count}文字。続きは" . implode( '/', $access[2] ) . '会員限定。</p><p>Free=0/Bronze=220/Silver=1100/Gold=2200円。</p>'
		. '<p><a href="https://web.gnusocial.jp/member/level/">会員登録</a>/'
		. '<a href="//web.gnusocial.jp/member/login/">ログイン</a> (<a href="//web.gnusocial.jp/about/member/">About Member</a>)。</p>';
	return $text;
}
add_filter( 'pmpro_non_member_text_filter', 'my_pmpro_non_member_text_filter', 5 );
add_filter( 'pmpro_not_logged_in_text_filter', 'my_pmpro_non_member_text_filter', 5 );

Style

「Custom Message for Non-Members on Protected Content」でペイウォールの表示内容・スタイルを制御できる。

ペイウォール (.pmpro_content_message) のスタイルは会員登録の誘発に重要。

有名サービスの例は上記。登録・購入ボタンを大きく押しやすくしている。a要素の他button要素でも実装されている。ここはいろいろ考えてもいいかもしれない。

Category

membershipショートコードやAddon Packagesではカテゴリーやタグでの会員限定に対応していない。これがちょっと困る。既存のカテゴリー、タグでの会員対応の把握方法を確認する。

includes/contents.phpのpmpro_has_membership_accessのコードが参考になる。

	if(isset($mypost->post_type) && $mypost->post_type == "post")
	{
		// Get the categories for this post.
		$post_terms = wp_get_post_categories( $mypost->ID );

		// Get the tags for this post.
		$post_terms = array_merge( $post_terms, wp_get_post_tags( $mypost->ID, array('fields' => 'ids' ) ) );

		if( ! $post_terms )
		{
			//just check for entries in the memberships_pages table
			$sqlQuery = "SELECT m.id, m.name FROM $wpdb->pmpro_memberships_pages mp LEFT JOIN $wpdb->pmpro_membership_levels m ON mp.membership_id = m.id WHERE mp.page_id = '" . esc_sql( $mypost->ID ) . "'";
		}
		else
		{
			//are any of the post categories associated with membership levels? also check the memberships_pages table
			$sqlQuery = "(SELECT m.id, m.name FROM $wpdb->pmpro_memberships_categories mc LEFT JOIN $wpdb->pmpro_membership_levels m ON mc.membership_id = m.id WHERE mc.category_id IN(" . implode(",", array_map( 'intval', $post_terms ) ) . ") AND m.id IS NOT NULL) UNION (SELECT m.id, m.name FROM $wpdb->pmpro_memberships_pages mp LEFT JOIN $wpdb->pmpro_membership_levels m ON mp.membership_id = m.id WHERE mp.page_id = '" . esc_sql( $mypost->ID ) . "')";
		}
	}
	else
	{
		//are any membership levels associated with this page?
		$sqlQuery = "SELECT m.id, m.name FROM $wpdb->pmpro_memberships_pages mp LEFT JOIN $wpdb->pmpro_membership_levels m ON mp.membership_id = m.id WHERE mp.page_id = '" . esc_sql( $mypost->ID ) . "'";
	}

    $post_membership_levels = $wpdb->get_results($sqlQuery);

普通にSQLで取得している。このへんのコードを流用すれば対応できる気はする。ただ、ちょっと面倒くさい。

Analytics

PMProの流入元の記事を分析・特定する方法がある。

GA4を使った一般的なサイト分析になる。有料プラグインでもできる。

Sell

Single

WooCommerceと連携したり、PMProの有料プラグインを使うとか。他にも方法を以前調査したの後日追記する。

理想としては、単品販売と、会員を両立したい。2個以上買うなら会員のほうがいいみたいな。

単品販売の方法。有料アドオン、LearnDash、後はWooCommerce連携など。

Addon Packagesがいい。PMProのAddon Packagesは、まずあるメンバーシップレベルのユーザーに購入権利を与えて、そこから購入する形。

あくまで単品販売で、定期販売はできない。記事別に金額の入力欄が表示されてそれで単品販売する形。悪くない。こちらの理想に近い。単品販売することにした記事は買うしかない。あるメンバーレベルなら買わなくても見れるというようにはできなさそう。いや。1レベルだけ全アクセス可能はできる。

Course

LearnCashはちょっといまいち。外部のプラグインとの連携。この機能自体はPMProのあるレベルが、LernDashのあるコースにアクセス可能にするだけだから、あまり意味ない。PMProだけでも似たようなことはできる。

単独販売の本質は、1ユーザーに複数のレベル・会員の所属。これはレッスンなどで、上位・下位の関係がない場合にあり得るケース。上位・下位がある場合は、1ユーザーは1レベルになる。

方法がいくつかある。

  1. Multiple Membership Per user Addon: 1ユーザーが複数のレベルに参加できるプラグインがある。がベータ版で他のプラグインと互換がなかったりする。ちょっと危ない。
  2. Addon Package: これが無難。
  3. フィールド: メインレベル加入時にオプションフィールドをつけて金額を変える。
  4. Multisite: サイトの内容次第だが、いっそ別サイトにするというのもある。

Addon Packageが無難。Addon PackageとWP coursewareと連携したりもできるらしい。

Addon Packages

About

記事の単品販売用にAddon Packagesがあるのでこれを試す。このプラグインは将来的にPMPro本体に取り込まれるもので、一時的な解決用という位置づけ。

Usage

インストールしたらpost/page画面に金額設定画面が表示されるので、ここで金額をいれて、[Require Membership] も指定すると単品販売できる。

カテゴリーでのレベル指定は無効。一番レベル低いFreeなどを1個指定すれば、自動的に全部に適用される。レベルの指定が若干使いにくい。カテゴリーで指定できれば楽だった。やむを得ない。PMPro 3で取り込まれたりしないかな。

しないでしょうね。コンテンツの部分非表示と同じで、ページ単位で会員レベルを指定する必要があるのが作りとしていまいち。だがこれに従うしかないか。基本は変えない運用にすればいいのか。

Configuration
  • define( 'PMPROAP_EXP_DAYS', 0 );: 有効期限の設定デフォルト0 (無期限)。基本はデフォルトでOK。
  • apply_filters( 'pmproap_all_access_levels', array(), $user_id, $post_id );: 単品購入を無視してアクセスできる神レベル的なものを指定できる。
  • apply_filters( 'pmproap_text_level_id', $text_level_id, $post_id, $user_id, $post_levels );: 未ログインユーザー向けの新規購入時に必要なレベルID。
  • apply_filters( 'pmproap_supported_post_types', array( 'page', 'post' ) );
  • do_action( 'pmproap_action_add_to_package', $user_id, $post_id );
  • do_action( 'pmproap_action_remove_from_package', $user_id, $post_id );

pmproap_all_access_levels を使うと、単品購入を無視してアクセスできる神レベル的なものを指定できる。

例えば、最上位だけ除外するとか。金額でレベル指定できればなおよかったがしかたない。

/*
	Set levels as "all access levels" so members of these levels will be able to view all Addon Packages.
	Requires Paid Memberships Pro and the pmpro-addon-packages plugin.
*/
function my_pmproap_all_access_levels($levels, $user_id, $post_id)
{
	//I'm just adding the level, but I could do some calculation based on the user and post id to programatically give access to content
	$levels = array(16);	
	return $levels;
}
add_filter("pmproap_all_access_levels", "my_pmproap_all_access_levels", 10, 3);
Message

pmpro_non_member_text_filter/pmpro_not_logged_in_text_filterをpmproap_pmpro_text_filterで上書きしている。この実装を参考に、自分で元のフィルターを上書きすれば、表示文を変更できる。 

<div class="pmpro_content_message"><p>This content requires that you purchase additional access. The price is ¥220 or free for our Gold members.</p><p><a href="https://web.gnusocial.jp/member/checkout/?level=1&amp;ap=10307">Purchase this Content (¥220)</a> <a href="https://web.gnusocial.jp/member/level/">Choose a Membership Level</a></p></div>

Addon Package有無の両方の考慮が必要でちょっと複雑になる。

Shortcode

[pmpro_addon_packages] のショートコードを使うと、単品販売の記事一覧を出力できる。

Addon Pakacage用改造

既存のAddon Packageがブロックに未対応、ページのレベル指定が必要な点が気に入らないので改造する。

  • 金額があればAPとみなす。

作業手順

  • my_pmproap_membership_content_filter でコンテンツの制限のロジックにAP (金額があれば制限・制限文表示) を組み込む。
  • 表示文。
  • paywallショートコード追加。

pmpro_non_member_text_filterなどで表示させる表示文のロジックをどうするか。

ショートコードと基本ロジックは同じだが、非表示部分の文字数の扱いがある。引数の$notloggiedintextは管理画面の設定したメッセージ。

共通関数を作って、それを流用して、引数で文字数を受け取るようにするか。

「https://wiki.gnusocial.jp/index.php?title=WordPress&oldid=296」から取得