最近、Plugin Check というプラグインチームが作成したプラグインで自分のプラグインをチェックしているのですが、以下の様な警告が出てきます。

「json_encode を、wp_json_encode にしなさい」というのと、「fopen、fclose、fputcsv などの php のファイルシステムは使用せずに、WP_Filesystem を使用しなさい」というのが主です。

Plugin Check (PCP)

Plugin Check は WordPress.org のツールで、プラグインがディレクトリの要件を満たし、様々なベストプラク…

作者: WordPress.org

(32) 最終更新: 2週間 前

8,000以上サイトで有効化中 検証済み: 7.0

ダウンロード: リリース: 2011-09-04

2026-03-31 09:30 時点の統計

WP_Filesystem に関しては、テーマなどで、file_get_contents、file_put_contents などの代わりに使用するように推奨していたようですが、プラグインに関しても推奨するようになってきたのかという感じです。しかし、必ずしもすべてこの通りにしなければならないというものでもないようで、その辺りの事が、FAQ に書かれています。実際、上記の非推奨のものを使用していてトラブルになったおぼえはありません。

自分の場合には、CSV 出力関連ですが、WP_Filesystem には、fputcsv の代替えのものがありません。file_put_contents の代替えのものはあるのですがコードが煩雑になり遠回りになってしまいます。そこで、SplFileObject クラス を使用してみたところ、Plugin Check に怒られなく？なりました。

コード

$csvs は、CSV にするための配列とします。$csv_file は、フルパスを含むファイル名です。フィルターに関しては無くても動作しますが、Windows の Excel で直接開きたい場合には、必要です。

fputcsv を用いたコード

$f = fopen( $csv_file, 'w' );
stream_filter_prepend( $f, 'convert.iconv.utf-8/cp932//TRANSLIT' );
if ( $f ) {
	foreach ( $csvs as $line ) {
		fputcsv( $f, $line );
	}
}
fclose( $f );

SplFileObject クラスを用いたコード

$filter = urlencode( 'convert.iconv.utf-8/cp932//TRANSLIT' );
$file = new SplFileObject( 'php://filter/write=' . $filter . '/resource=' . $csv_file, 'a' );
foreach ( $csvs as $line ) {
	$file->fputcsv( $line );
}
$file = null;

現在、自作ブロックの日本語化を、「ブロックエディターハンドブック／開発ガイド／国際化」に準じて行っていますが、現在の、block.json でスクリプトをロードする方法には適していないので、ここに捕捉事項として記す事にします。

ja.wordpress.org

国際化 – Japanese Team – WordPress.org 日本語

国際化とは何か ? 国際化とはソフトウエア、特にここでは WordPress に対して複数言語のサポートを提供…

ハンドル名の指定

上記でのハンドル名の指定方法は、以下の様になっています。この方法では、wp_register_script で、ハンドル名 myguten-script を指定し、register_block_type の、editor_script で、myguten-script を再度指定しています。

<?php
/**
 * Plugin Name: Simple Block
 * Text Domain: myguten
 */
function myguten_simple_block_init() {
    wp_register_script(
        'myguten-script',
        plugins_url( 'block.js', __FILE__ ),
        array( 'wp-blocks', 'wp-element', 'wp-i18n', 'wp-block-editor' )
    );
 
    register_block_type( 'myguten/simple-block', array(
        'api_version' => 2,
        'editor_script' => 'myguten-script',
    ) );
}
add_action( 'init', 'myguten_simple_block_init' );

その後に、php で、wp_set_script_translations の第一引数に registrer_block_type で登録したハンドル名 myguten-script を指定する方式です。

developer.wordpress.org

wp_set_script_translations() – Function | Developer.WordPress.org

Sets translated strings for a script.

<?php
function myguten_set_script_translations() {
    wp_set_script_translations( 'myguten-script', 'myguten' );
}
add_action( 'init', 'myguten_set_script_translations' );

上記のやり方を、現在の block.json で読み込む方式に置き換えると以下の様になります。

<?php
/**
 * Plugin Name: Simple Block
 * Text Domain: myguten
 */
function myguten_simple_block_init() {
	register_block_type(
		__DIR__ . '/block/build',
	);
}
add_action( 'init', 'myguten_simple_block_init' );

block.json を置いたディレクトリを検索してそれを読み込むという形です。ここでは、ハンドル名は指定していません。block.json の方を見てみると、editorScript の項目がそれらしいのですが、スクリプトのハンドルという言葉はあるのですが、ファイルへのパスを指定するのが通常の様です。

developer.wordpress.org

Metadata in block.json – Block Editor Handbook | Developer.WordPress.org

Starting with the WordPress 5.8 release, we recommend using the block.json metadata file a…

register_block_type では、ハンドル名を渡さずに、WordPress の php の関数 generate_block_asset_handle で第１引数にブロック名、第２引数に editorScript を渡したらハンドル名を取得し国際化が上手くいきましたので、以下に示します。

function myguten_set_script_translations() {
　　$script_handle = generate_block_asset_handle( 'myguten/simple-block', 'editorScript' );
　　wp_set_script_translations( $script_handle, 'myguten' );
}
add_action( 'init', 'myguten_set_script_translations' );

developer.wordpress.org

generate_block_asset_handle() – Function | Developer.WordPress.org

Generates the name for an asset based on the name of the block and the field name provided…

block.json の日本語化

ついでにわかりにくい、block.json の日本語化について以下に記します。上記の、register_block_type に、配列で翻訳対象を列記します。keywords は複数あるので更なる配列にします。

<?php
/**
 * Plugin Name: Simple Block
 * Text Domain: myguten
 */
function myguten_simple_block_init() {
	register_block_type(
		__DIR__ . '/block/build',
		array(
			'title' => _x( 'Simple Block', 'block title', 'myguten' ),
			'description' => _x( 'Example static block scaffolded with Create Block tool.', 'block description', 'myguten' ),
			'keywords' => array(
				_x( 'simple', 'block keyword', 'myguten' ),
				_x( 'static', 'block keyword', 'myguten' ),
				_x( 'tool', 'block keyword', 'myguten' ),
			),
		)
	);
}
add_action( 'init', 'myguten_simple_block_init' );

WordPress 6.4 から、Lightbox 機能が追加されます。投稿内の html のコメント部分を変更します。具体的には、wp:image の中に、lightbox”:{“enabled”:true} を加える形式です。

以前からのサイトに適用させる場合は、html 内の wp:image にこれを追加すれば良いので、WP-CLI でサイト内の全投稿と全固定ページを一括で変更するものを作ってみました。

WP-CLI が必要です。

/* 第１引数：on で、Lightbox を On。off で、Lightbox を Off */
wp box on
wp box off
/* 第２引数：投稿や画像のID を指定できる */
wp box off 9110 /* 投稿 ID 9110 のみ Off */
wp box on 9031 /* メディア ID 9031 のみ On */

コード

github.com

GitHub – katsushi-kawamori/wp-cli-Lightbox-command-on-off · GitHub

Contribute to katsushi-kawamori/wp-cli-Lightbox-command-on-off development by creating an …

使い方

コンテンツの盗用による被害が結構な頻度で見受けられます。それに対応する一番シンプルな方法を以下に記します。以下の方法は、ブラウザや Javascript に少しでも知見のある方なら破れますが、無いよりは良いのではないかと思います。

コード

/* スクリプトを読み込みます */
add_action(
	'wp_enqueue_scripts',
	function() {
		/* 管理画面以外で */
		if ( ! is_admin() ) {
			?>
			<script>
			/* ブラウザの右クリックを無効にします */
			 document.oncontextmenu = function () { return false; }
			</script>
			<style>
			/* タブレットやスマートフォンの長押しを無効にします */
			.nocopy {
			 -webkit-touch-callout: none;
			 -webkit-user-select: none;
			 -khtml-user-select: none;
			 -moz-user-select: none;
			 -ms-user-select: none;
			 user-select: none;
			}
			</style>
			<?php
		}
	},
	10,
	1
);
/* 上記の 'nocopy' クラスを、body タグに追加します */
add_filter( 'body_class',
	function() {
		/* 管理画面以外で */
		if ( ! is_admin() ) {
			return array( 'nocopy' );
		}
	},
	10,
	1
);

プラグインの開発者には、新たなバージョンの WordPress がリリースされる前に、Tested up to:(検証済み最新バージョン:)の値を確認するように、以下の様なメールが届きます。同じ事をやってみようと思いコードを書いてみました。

概要

プラグイン単体の場合は、plugins_api で取得できます。全プラグインの情報の場合、取得できる関数が見当たらないので、プロフィールサイトから取得する事にしました。プロフィールサイトには以下の様に各プラグインのリンクにスタイルをあてるクラス「plugin-info-container」があったので、そこからスクレイピングしました。

WordPress の関数を使えるように、wp-load.php を読み込めるようにしました。

また、コマンドラインオプションを設け、プラグイン単体での各属性を取得できるようにしました。各属性に関しては、plugins_api を参照してください。

以下に動作を動画（倍速）で示します。

コード

<?php
/**
 * Name:        profiles-plugins.php
 * Version:     1.00
 * Author:      Katsushi Kawamori
 * Author URI:  https://riverforest-wp.info/
 * License:     GPLv2 or later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 *
 * @package     profiles-plugins
 */

/* Your WordPress profile url */
const WP_PROFILE_URL = 'https://profiles.wordpress.org/katsushi-kawamori/';

/* Wp load. This file => wp-content/uploads/profiles-plugins.php */
list( $abspath, $mypath ) = explode( 'wp-content', dirname( __FILE__ ), 2 );
$wp_load_path = $abspath . 'wp-load.php';
require_once( $wp_load_path );

/* For plugins_api */
require_once ABSPATH . 'wp-admin/includes/plugin-install.php';

$cmdoptions = array();
/* Example -a active_installs -p woocommerce */
$cmdoptions = getopt( 'a:p:' );

/* Default atribute 'tested' */
if ( isset( $cmdoptions['a'] ) && ! empty( $cmdoptions['a'] ) ) {
	$atr = $cmdoptions['a'];
} else {
	$atr = 'tested';
}

if ( isset( $cmdoptions['p'] ) && ! empty( $cmdoptions['p'] ) ) {
	$slug = $cmdoptions['p'];
	$plugin_s = array(
		'name' => read_plugins_api( $slug, 'name' ),
		'link' => read_plugins_api( $slug, 'homepage' ),
		'slug' => $slug,
		$atr => read_plugins_api( $slug, $atr ),
	);
	print_r( $plugin_s );
} else {
	/* Scraping */
	$dom = new DOMDocument( '1.0', 'UTF-8' );
	$html = file_get_contents( WP_PROFILE_URL );
	@$dom->loadHTML( $html );
	$xpath = new DOMXpath( $dom );
	/* Get <a> tag within class plugin-info-container */
	$a_tags = $xpath->query( '//div[@class="plugin-info-container"][1]//a' );
	$count = 0;
	foreach ( $a_tags as $node ) {
		/* Get href attribute from within <a> tag */
		$link_url = 'https:' . $node->getAttribute( 'href' );
		/* Get slug from URL */
		$link_s = untrailingslashit( $link_url );
		$links = explode( '/', $link_s );
		$slug = end( $links );

		++$count;
		$plugin_s = array(
			'count' => $count,
			'name' => $node->nodeValue,
			'link' => $link_url,
			'slug' => $slug,
			$atr => read_plugins_api( $slug, $atr ),
		);
		print_r( $plugin_s );
	}
}

/** ==================================================
 * Get api and value
 *
 * @param string $slug  slug.
 * @param string $atr  atribute.
 * @return mixed api value.
 * @since 1.00
 */
function read_plugins_api( $slug, $atr ) {

	/* Call API */
	$call_api = plugins_api(
		'plugin_information',
		array(
			'slug' => $slug,
			'fields' => array(
				'short_description' => true,
				'description' => true,
				'active_installs' => true,
				'downloaded' => true,
				'icons' => true,
				'banners' => true,
				'ratings' => true,
			),
		)
	);

	return $call_api->$atr;

}

今回の記事は、ちょっとしたお遊び記事です。

作成した公式プラグインが、気づいたら「１００万ダウンロード」と「５万以上サイトで有効化中」になっていました。この数値は、Plugin Stats View という私のプラグインで出したもので、plugins_api を利用して集計しています。

ja.wordpress.org

Plugin Stats View – WordPress プラグイン | WordPress.org 日本語

プラグイン情報をブロックあるいはショートコードで表示します。

developer.wordpress.org

plugins_api() – Function | Developer.WordPress.org

Retrieves plugin installer pages from the WordPress.org Plugins API.

ここまで良くやったなあとは思いつつ、今まで何行書いたんだろうと思い、行数とサイズを調べるプログラムを php で作成してみました。

下準備 & 仕様

作業ディレクトリを作成し、６６個のプラグインをコピーしました。あらかじめ、自分以外の方が書いたライブラリなどを削除しました。

• コマンドライン上で実行します。
• コード中に指定したディレクトリを再帰検索して、php, js , css ファイルをカウントします。
• php, js, css のそれぞれと全ての行数の総和と、サイズの総和を出力します。

コード

<?php
/**
 * Plugin Name: Program number of line
 * Author:      Katsushi Kawamori
 * Author URI:  https://riverforest-wp.info/
 * License:     GPL2
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 *
 */

/*
	Copyright (c) 2021- Katsushi Kawamori (email : dodesyoswift312@gmail.com)
	This program is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation; version 2 of the License.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the Free Software
	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

$line_all = pnol_scan_file( 'ディレクトリをフルパスで指定します' );

foreach ( $line_all as $key => $value ) {
	echo $key . ' : ' . number_format( $value['line'] ) . '行 - ' . number_format( $value['size'] / 1024 / 1024, 2 ) . 'Mbyte' . PHP_EOL;
}

echo PHP_EOL;

/** ==================================================
 * Scan file
 *
 * @param string $dir  dir.
 * @return array $count
 * @since 1.00
 */
function pnol_scan_file( $dir ) {

	$iterator = new RecursiveDirectoryIterator(
		$dir,
		FilesystemIterator::CURRENT_AS_FILEINFO |
		FilesystemIterator::KEY_AS_PATHNAME |
		FilesystemIterator::SKIP_DOTS
	);
	$iterator = new RecursiveIteratorIterator( $iterator );
	$iterator = new RegexIterator( $iterator, '/\.php$|\.js$|\.css$/i', RecursiveRegexIterator::MATCH );

	$count = array(
		'all' => array(
			'line' => 0,
			'size' => 0,
		),
		'php' => array(
			'line' => 0,
			'size' => 0,
		),
		'js' => array(
			'line' => 0,
			'size' => 0,
		),
		'css' => array(
			'line' => 0,
			'size' => 0,
		),
	);
	if ( ! empty( $iterator ) ) {
		foreach ( $iterator as $file_path => $file_info ) {
			if ( $file_info->isFile() ) {
				$line = exec( 'wc -l '. $file_path );
				$count['all']['line'] += trim( str_replace( $file_path, '', $line ) );
				$count['all']['size'] += $file_info->getSize();
				switch ( $file_info->getExtension() ) {
					case 'php':
						$count['php']['line'] += trim( str_replace( $file_path, '', $line ) );
						$count['php']['size'] += $file_info->getSize();
						break;
					case 'js':
						$count['js']['line'] += trim( str_replace( $file_path, '', $line ) );
						$count['js']['size'] += $file_info->getSize();
						break;
					case 'css':
						$count['css']['line'] += trim( str_replace( $file_path, '', $line ) );
						$count['css']['size'] += $file_info->getSize();
						break;
				}
			}
		}
	}

	return $count;

}

?>

実行

以下の様な結果になりました。

終わりに

最近、自プロダクトの「競技会採点システム」の方に時間を割く事が多くなったので、今後、公式プラグインの方はあまり力を入れないと思います。フォーラムで応答が無くても、ご容赦ください。

WordPress 5.3 から、メディアアップロード時に大画像を検知して、スケーリングする機能が追加されました。デフォルトでは 2560px 以上の画像で動作します。この事が、大画像を扱う方達の間で問題を引き起こしています。

オリジナル画像は？

大画像をアップロードすると以下のように、元ファイルに「-scaled」と付加されたファイルがメディアライブラリの画像になります。スケーリングされた画像であり元の画像ではありません。

サーバーを見てみると、元の画像は存在しますが、管理画面からは見れません。

どのように管理されているかデータベースを調べてみると、メタデータの中に original_image というメタデータがありそこにファイル名が記されていました。

この動作を抑制するには？

以下のフィルターを使用して抑制するとスケーリングしなくなります。

add_filter( 'big_image_size_threshold', '__return_zero', 10, 2 );

また私の作成したプラグイン Disable Generate Thumbnails では、設定メニューから ON・OFF できます。

Disable Generate Thumbnails

サムネイルと機能を選択して無効にします。

作者: Katsushi Kawamori

(15) 最終更新: 2日 前

6,000以上サイトで有効化中 検証済み: 7.0

ダウンロード: リリース: 2019-11-06

2026-03-31 09:30 時点の統計

オリジナル画像の URL は？

メディアライブラリのファイル名から「-scaled」をとったものです。

URL は、以下の関数で取得できます。

developer.wordpress.org

wp_get_original_image_url() – Function | Developer.WordPress.org

Retrieves the URL to an original attachment image.

フルパスは、以下の関数で取得できます。

developer.wordpress.org

wp_get_original_image_path() – Function | Developer.WordPress.org

Retrieves the path to an uploaded image file.

また私の作成したプラグイン Media Metadata List からオリジナル画像の URL とサイズを知る事ができます。

Media Metadata List

メディアライブラリのリストビューにメタデータのリストを表示します。

作者: Katsushi Kawamori

(2) 最終更新: 2日 前

100以上サイトで有効化中 検証済み: 7.0

ダウンロード: リリース: 2019-07-26

2026-03-31 09:30 時点の統計

その他

私の作成したプラグイン Media from FTP でスケーリングされた画像を再検索してしまう問題を、Version 11.03 で修正しました。