設定APIとテーマカスタマイザー


20

設定APIを使用するのが適切な場合と、テーマカスタマイザーを使用する方が適切な場合はいつですか?

午前中ずっとGoogleで検索してみましたが、この問題に関するよく考えられた最新のガイダンスを見つけることができませんでした。言うのはまだ早いですが、テーマカスタマイザーは、Squarespaceのような編集機能を取り入れるための示唆的な最初のステップだと感じています。テーマカスタマイザーを支持して設定APIを廃止する計画を知っている人はいますか?ゆっくりと進んでいくべきでしょうか、それとも設定APIに固執する方が良いでしょうか?彼らは隣り合って住むことができますか?もしそうなら、責任の分担はどこにありますか?

回答:


21

質問の前提には欠陥があります。カスタマイザーのAPIはないオプションの APIのではなく、オプションのプレビュー API。Customizer APIは、Settings APIまたはTheme Mods APIに依存して、2つのAPIのいずれかを介して追加された既存の設定のコントロールを登録します。

カスタマイザーはない-とすることはできません -登録/定義新しいすでに設定APIやテーマモッズAPIのいずれかを介して登録されていない設定を。別の言い方をすると、カスタマイザーAPIは、設定をデータベースに直接追加したり、データベースから直接設定を取得したりするAPIではありません。むしろ、カスタマイザーAPI 、設定APIまたはテーマMods APIのいずれかを使用して、データベースに設定を保存したり、データベースから設定を取得したりします。

したがって、カスタマイザーAPIは、既存のオプションAPIの 1つに代わるものではありません。むしろ、設定ページの代替です。カスタマイザーは、設定がSettings APIまたはTheme Mods APIのどちらを介して登録されているかを気にしません。そのような設定は、Customizerで混合して一致させることができます。実際、ほとんどの場合、このような設定混在しており、カスタムヘッダーとカスタムバックグラウンドはテーマMods、サイトタイトルと説明はSettings APIです。

カスタマイザーAPIを介して設定とコントロールがどのように登録されるかを正確に理解するには、Ottoの優れたチュートリアルを読むことをお勧めします。

だから、問題はないのいずれか/または指定のAPIに関して。適切などちらかまたは両方の質問は次のとおりです。

  • 使用のいずれかの設定API テーマモッズAPIする既存の設定を登録介して、プレビューにカスタマイザーのAPI
  • 使用のいずれかカスタマイザのAPI カスタムテーマの設定ページにユーザーを許可するのconfigureテーマオプション

チップありがとう。私はまだ100%あなたをフォローしていませんが、あなたは私にもう少し問題を調べに行くのに十分与えてくれました。私の混乱は機能の重複と名前の類似性に起因すると思います。さまざまなAPIのユースケースを(より抽象化された方法で)明確に文書化したページはありますか?コーデックスを調べてみると、あまり運がありません。APIの適用の要点に焦点を合わせています。
ドレ

もう少し詳しく説明するために、さらに追加しました。特に、Ottoのカスタマイザーチュートリアルへのリンクも参照してください。それらは物事を明確にするのに役立つと思います。
チップベネット

あなたは紳士です。
ドレ

5

簡単なこともあります:Settings APIはTheme Customizerではありません。両方とも、タスクごとに異なります。

設定API

プラグインを書いているか、視覚的なフィードバックを必要としないオプションのないテーマを持っていますか?このオプションを選択してください。

テーマカスタマイザー

ユーザーが見ることができる視覚的な影響を持つオプションが必要ですか?このオプションを選択してください。


これが私の最初の結論でした。ただし、この2つの機能には多くの機能的な重複があり、これが元の質問につながります。さらに、テーマオプションを視覚的かどうかに応じて2つの場所に分割するという考えは、UXの観点からは問題があると思います。それは私があなたに同意しないということではありません。この段階で意見を募集しているだけです。トピック自体はやや不明瞭です。おそらく、「上から」という明確に定義されたガイダンスが有益だろう。ご意見ありがとうございます!
ドレ

@Dre少し誤解していると思います:視覚的なフィードバックが必要なオプションが1つでもある場合は、ThemeCustomizerを使用してください。経験則は次のとおりです。テーマ->テーマカスタマイザー| プラグイン->設定API。
カイザー

原則として、すべてのテーマ定義オプションはプレゼンテーションに影響を与える必要があります。:)それは言った:カスタマイズAPIが必要とするいずれかの設定API テーマモッズAPIが存在するためには。カスタマイズAPIは、これら2つのAPIの1つに代わるものではなく、カスタムテーマ設定ページに代わるものです。
チップベネット

カスタマイザーに応答性の問題がありますか?3.5.1と3.6(トランク)の両方で、私には非常に気まぐれなようです。私は見出しと閉じる/保存ボタンがクリックに対して適切に応答しないことが多く、時々それらを数回クリックしなければならないことを発見しました(トランクでもそうです)。これはFFとChromeの両方にあります。
t31os

@ t31os以前はこの問題がありましたが、一貫性はありませんでした。しかし、かなり長い間試していません。console.log()トリガーされたものと中断しているものを確認できるように、すべてのアクションに提案したいと思います。JavaScriptのデバッグは簡単ではありません
...-kaiser
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.