Tooltips にハマる

2021年 12月22日wordpress

事の発端は長らく更新を怠り、久しぶり(1年ぶり?)に Opera Lirica CDs(私が運営する別サイト)を訪れてみると Tooltips が機能しなくなっていたのです。文字列にカーソルを乗せても何の反応もありません。Tooltipsとは何かと言いますと、指定した文字列の上にカーソル(マウス)を乗せる(タブレット等では指で触れる)とその語句の説明を吹き出しで表示する機能です。Wikipediaを利用する方にはお馴染みのアレです。Opera Lirica CDsではこの機能を Tooltips Pro というプラグインで実現しています。それがまったく反応しなくなったのです。

空白の1年間に何があったかと言いますと、土台の WordPressのバージョンアップ、使用しているテーマのバージョンアップ、プラグインのバージョンアップ・・です。
私が最初に疑ったのは WordPressのバージョンアップによりプラグインが機能しなくなったのではないかと言う事です。これには Tooltips Pro以外のプラグインとの相性の問題も含みます。
そこで Tooltips Proの開発元に現状を伝えたところ、次のような回答が返ってきました。対応が早く素晴らしい!

Our developer have checked your URL, in the console of the browser, we
found you have a jquery error which is not caused by our plugin, I guess
may be your site have some settings or plugin conflicts, you can find it
by this way:
1: use wordpress backup plugin “duplicator” to make a full backup
2: change your wordpress theme to default theme
3: deactivate other plugins one by one
4: ensure you do not use any cache plugin or cache system, also clear
your browser cache
5: once find any plugin conflict with our plugin, please tell us the
plugin name

ざっくり要約すると、jQuery エラーが検出されたので他のプラグインとのコンフリクトが予想される、ひとつずつ外してどのプラグインが原因なのか特定しなさい (3) 、と言うものです。
その前に現在のテーマを WordPress デフォルトのテーマに変更しなさい (2) という手順があったのですが、、なんと、テーマを Twenty Twenty-Oneに変更しただけでプラグインのどれも外すことなく Tooltips Proが正常に動作するではありませんか。
こうなると、現在使っているテーマ: Clarity が原因である可能性が高いということになります、早速これを Tooltips 開発元に報告すると、その判断はおそらく正しい、残念ながらあなたのテーマについてのサポートはできない・・という返答がありました、当然ですね。

そこで、今度は Clarityの開発元に質問しました。そうすると、こちらも即座に回答が返信されてきました。

「<head>~</head>内のユーザー定義」に
以下のscriptタグ(jquery-migrate)を追加してください。

<script src=”https://code.jquery.com/jquery-migrate-3.3.2.min.js” integrity=”sha256-Ap4KLoCf1rXb52q+i3p0k2vjBsmownyBTE1EqlRiMwA=” crossorigin=”anonymous”></script>

コンフリクトの原因の説明もあって、やはりjQueryの問題でした。Clarityでは最新の jQueryを前提にしているが、Tooltips Pro は古いバージョンのjQueryを使用していて本来は動作しない。上の措置はそれを回避するいわば応急的な措置であるということ。

テーマの開発元、プラグインの開発元、両者ともに原因はjQueryにあることでは一致していました。どちらに非があるとは言えませんが、テーマについては WordPress標準テーマのようにまだ古いバージョンのjQueryにも対応させるべきであったかも知れないし、プラグインについては最新のjQueryに対応するバージョンを早く出してもらって応急措置を回避したいものです。

ところで、Clarityのギャラリー機能は素晴らしい。ギャラリーは素のWordPressでも実現できるし、便利なプラグインがいくつも存在しますが、新しい投稿順に自動的にギャラリーを作成してくれるプラグインやテーマはどこにも見つかりません。一方、Tooltipsには既に300を超える語句を登録しており、いまさら別のプラグインに変更するのは気が重すぎますし、日本語で比較的安定して動作するtooltipsは意外に少ないのです。ですから、Clarityテーマを諦めることはできないし Tooltips Proも外せないプラグインだったのです。ちなみに Takatori.com で使用しているテーマは Clarityではありません。

今回は Tooltipsに数日間ハマってしまったお話でした。楽しくてハマったのではなく不具合解決のために否応なしにヤルしかなかったのです。このようなトラブルはよくあることで数ヶ月も抜け出せないこともありますし、諦めて別の方法に切り替えたり最悪のケースでは放り出してしまうこともあります。2, 3日で解決できたのはラッキーでした。

toshi

toshi