Skip to content

ヘルプ

Jump to bottom
Heiko Lübbe edited this page Apr 17, 2024 · 16 revisions

Zitat-Service WordPress Plugin 🇯🇵

WordPressプラグイン Zitat-Serviceからのランダムな引用 は、ユーザーコミュニティzitat-service.deのコレクションからランダムな引用を表示します。引用の選択は、5つの言語、500以上の著者の一つ、500以上のカテゴリの一つ、またはユーザー自身が設定した引用のいずれかに限定することができます。2007年以来、広告なしで無料でご利用いただけます。

Note

モジュールのWordPressデモサイトがあります: wp-demo.zitat-service.de

インストール

Zitat-Serviceからのランダムな引用 プラグインは、WordPress プラグインディレクトリから直接インストールするか、プラグインの zip ファイルを手動でアップロードしてインストールできます。WordPress バックエンドで 新規プラグインを追加 をクリックしてから：

その後、プラグインを有効化してください：

plugin_ja

使用方法

投稿、ページ、またはフッターなどの他のウェブサイト要素にランダム引用ブロックを使用してランダムな引用を挿入することができます：

ja1

言語、カテゴリ、引用の著者、または引用を入力したユーザーによって、引用の選択を設定することができます。アスタリスク*は、利用可能なすべてのオプションを代表します。言語選択にはFrontendオプションもあり、これによりWordPressユーザーの言語設定が採用されます。ユーザーの言語がサポートされていない場合は、自動的に英語に切り替わります。次の例では、日本語の引用が選択されます：

select_ja

スタイリング

引用文を様々な方法でデザインすることができます。まず、ブロックエディターの標準機能を使って、色、タイポグラフィ、寸法などのスタイルを設定できます。次の例では、背景色RGB AAFF0033と内側の間隔1を使用しています：

styling_1

次に、WordPressの引用ブロックのフォーマットを使用することもできます。まず引用ブロックを挿入し、その中にランダム引用ブロックを挿入します。Twenty Twenty-Fourテーマを使用すると、外側の引用ブロックはイタリック体のテキストと丸い角を使用します。次の例では、背景色RGB 00FFFF33とテキスト中央寄せが設定されています：

styling_2

第三に、カスケーディングスタイルシート（CSS）を使用できます。quoteクラスのDIV要素は、例えばマージンを設定するために、引用全体を囲みます。実際の引用のためのDIV要素quotationと著者及び出典のためのDIV要素sourceを含んでいます。次の例では、リンクの標準的な装飾（青くて下線がある）が除去され、引用は黒で

styling_3

これを行うには、WordPressのバックエンドで：外観 | エディタ | 🔍 | CSSと入力 | カスタムCSSを選択

以下の行を追加して保存してください：

div.quote {
  border: 1px solid black;
  border-radius: 1em;
  padding: 1em;
  background: #eee;
  text-align: justify;
}
div.quote * a {
  text-decoration: none;
  color: black;
}
div.quote div.source, div.quote div.source a {
  color: gray;
}

API zitat-service.de

WordPressのプラグインはapi.zitat-service.deからすべてのデータを取得します。利用規約とプライバシーポリシーは印刷インプリントで見ることができます。

WordPressウェブサイトでの引用の取得は、WordPressサーバー上で実行されるPHPコードによって行われます。これは、引用を取得するプロセスがフロントエンドでのユーザー固有のデータの追跡や記録を伴わないことを意味します。代わりに、それはサーバー環境内で行われ、ユーザーのプライバシーを保護し、ユーザーの同意なしにユーザーを追跡することを禁じる方針に準拠しています。

表示される引用とそれらのそれぞれの著者や出典は、zitat-service.deやWikipediaなどの外部ウェブサイトにリンクされており、ユーザーに追加のコンテキストと情報を提供します。すべての外部リンクは、リンクされたコンテンツの濫用を避けるために、zitat-service.deの管理チームによる手動のレビューの後にのみ有効化されます。

エラー状況

Error fetching quote

api.zitat-service.deから引用を取得する際に問題がある場合、このエラーが表示されます。例えば、PHPサーバーバックエンドがネットワーク接続をサポートしていないplayground.wordpress.net環境では：

Error fetching quote

👉 サーバー側のネットワーク接続を確認してください。

404 – No quote found for given parameters

パラメーターはANDで組み合わされます。あなたの組み合わせが引用をもたらさない場合、エラーが発生します。

パラメーターは、すべての条件が満たされなければならないように組み合わされます。あなたのパラメーターの組み合わせがどの引用も見つけない場合、このエラーが表示されます。たとえば、農業カテゴリーでのダグラス・アダムスの引用はありません：

Error: 404 – No quote found for given parameters: categoryId=151 (Agriculture), authorId=345 (Douglas Adams).

👉 カテゴリーでアスタリスク*を選択して、ダグラス・アダムスの引用を表示します。

... 「引用がありません」

問題がある場合、ランダムな引用文に三つの点...が置き換えられないプレースホルダーがあります：

...

👉 ブラウザの開発者コンソールで api.zitat-service.de のネットワークリクエストを確認し、JavaScriptのデバッグを有効にしてください。

This block has encountered an error and cannot be previewed.

バックエンドのブロックエディターでブロックに問題がある場合、ランダム引用ブロックは以下を表示します：

This block has encountered an error and cannot be previewed.

👉 ブロックを削除して再作成してください。または、標準のビジュアルエディターモードではなく、コードエディターモードでブロックのソースコードを確認してください。 または、JavaScriptのデバッグを有効にしてください。

JavaScriptのデバッグを有効にしてください。

ブラウザのJavaScriptコンソールで、次のコマンドを実行してください：

> localStorage.setItem('debugMode', 'true');

👉 JavaScriptコンソール内で、Zitat-Serviceからのランダムな引用プラグインからの console.log および console.error メッセージを確認できます。

JavaScriptコンソールで以下の操作をすることで、コンソールメッセージを再び非アクティブにすることができます：

> localStorage.removeItem('debugMode');

チケット

バグがあるか、改善が必要ですか？GitHubのIssueを作成してください。👍

Clone this wiki locally