Ustawienia API vs Theme Customizer

Kiedy należy użyć interfejsu API ustawień, a kiedy lepiej użyć dostosowania motywu?

Po przejściu przez Google przez cały ranek nie byłem w stanie znaleźć dobrze przemyślanych i najnowszych wskazówek w tej sprawie. Chociaż jest jeszcze za wcześnie, myślę, że dostosowanie motywu jest sugestywnym pierwszym krokiem w kierunku wprowadzenia więcej funkcji edycji podobnych do Squarespace . Czy ktoś wie o jakichkolwiek planach wygaśnięcia interfejsu API ustawień na rzecz dostosowania motywu? Czy wszyscy powinniśmy powoli iść w tym kierunku, czy lepiej byłoby pozostać przy interfejsie API ustawień? Czy mogą żyć obok siebie, a jeśli tak, to gdzie podział się podział obowiązków?

settings-api theme-customizer

— Dre
źródło

Odpowiedzi:

Przesłanka pytania jest błędna. Customizer API nie jest opcji API, ale raczej opcje podglądu API. Dostosowany interfejs API opiera się na interfejsie API ustawień lub interfejsie API modów tematycznych w celu zarejestrowania formantów dla istniejących ustawień dodanych za pomocą jednego z dwóch interfejsów API.

Customizer nie definiuje ani nie rejestruje nowych ustawień, które nie zostały jeszcze zarejestrowane za pośrednictwem interfejsu API ustawień lub interfejsu API modów tematycznych. Powiedział inaczej: interfejs API Customizer nie jest interfejsem API służącym do dodawania ustawień bezpośrednio do bazy danych lub pobierania ustawień bezpośrednio z bazy danych; raczej Customizer API używa albo Settings API, albo Theme Mods API do zapisywania ustawień lub pobierania ustawień z bazy danych.

Zatem interfejs API Customizer nie jest alternatywą dla jednego z istniejących interfejsów API ; jest raczej alternatywą dla strony ustawień . Personalizator nie dba o to, czy ustawienie jest rejestrowane za pośrednictwem interfejsu API ustawień lub interfejsu API modów tematycznych, a takie ustawienia można mieszać i dopasowywać w programie Customzer. W rzeczywistości w większości przypadków takie ustawienia są mieszane i dopasowane: niestandardowy nagłówek i niestandardowe tło to Mody motywów, a tytuł i opis witryny to Ustawienia API.

Aby dokładnie zrozumieć, w jaki sposób ustawienia i elementy sterujące są rejestrowane za pośrednictwem interfejsu API Customizer, polecam przeczytanie doskonałych samouczków Otto:

Zatem pytanie nie dotyczy albo określonych interfejsów API. Odpowiednie pytanie lub pytanie to:

Zastosowanie zarówno Settings API lub Motyw Mods API aby zarejestrować istniejących ustawień do podglądu poprzez API Customizer
Zastosowanie zarówno Customizer API lub danej strony motyw niestandardowy Ustawienia , aby umożliwić użytkownikowi opcji Configure tematu .

— Chip Bennett
źródło

Dzięki Chip. Nadal nie śledzę cię w 100% , ale dałeś mi wystarczająco dużo, aby przyjrzeć się temu problemowi. Myślę, że moje zamieszanie wynika z nakładania się funkcjonalności i podobieństwa nazw. Czy istnieje strona, która wyraźnie dokumentuje przypadki użycia (w bardziej abstrakcyjny sposób) różnych interfejsów API? Nie miałem dużo szczęścia, przeglądając kodeks; koncentruje się na nakrętkach i śrubach związanych z zastosowaniem API.

— Dre

Dodałem więcej, aby spróbować wyjaśnić nieco bardziej dogłębnie. Zobacz także w szczególności linki do samouczków dostosowywania Otto; Myślę, że pomogą wyjaśnić.

— Chip Bennett

Pan jest dżentelmenem.

— Dre

Tak proste, jak to czasami bywa: Interfejs API ustawień nie jest dostosowaniem motywu. Obie są różne dla różnych zadań.

Ustawienia API

Jesteś albo napisanie wtyczki lub mieć motyw, który nie ma opcji, które nie będą potrzebne żadne wizualnie? Idź z tą opcją.

Dostosowywanie motywu

Potrzebujesz opcji, które mają wizualny efekt, który użytkownik powinien widzieć? Idź z tą opcją.

— kajzer
źródło

To był mój początkowy wniosek. Istnieje jednak wiele nakładających się funkcji między nimi, co prowadzi do pierwotnych pytań. Dodatkowo pomysł podzielenia opcji motywu na dwie lokalizacje w zależności od tego, czy są one wizualne, czy nie, wydaje mi się problematyczny z punktu widzenia UX. Nie oznacza to, że się z tobą nie zgadzam; Na tym etapie tylko szukam opinii. Cały temat jest nieco mętny. Być może jakieś dobrze określone wytyczne „z góry” byłyby korzystne. Dzięki za wkład!

— Dre

@ Dre Zgadnij, że źle go odczytałeś: jeśli masz choć jedną opcję, która wymaga wizualnej informacji zwrotnej, wybierz ThemeCustomizer. Zatem podstawową zasadą jest: Motyw -> Dostosowywanie motywu | Wtyczka -> Ustawienia API.

— kaiser

Zasadniczo wszystkie opcje zdefiniowane w temacie powinny mieć wpływ na prezentację . :) To powiedział: API Dostosowanie wymaga zarówno z API Ustawienia lub z Theme Mods API , aby istnieć. Interfejs API dostosowywania nie jest alternatywą dla jednego z tych dwóch interfejsów API, ale raczej alternatywą dla strony ustawień niestandardowych motywów .

— Chip Bennett

Czy macie jakieś problemy z reagowaniem przy dostosowywaniu? Wydaje mi się dość temperamentny zarówno w wersji 3.5.1, jak i jeszcze bardziej w wersji 3.6 (tułowia). Uważam, że przyciski nagłówka i zamykania / zapisywania często po prostu nie reagują prawidłowo na kliknięcia i czasami muszę je klikać kilka razy (a bardziej w bagażniku). Dotyczy to zarówno FF, jak i Chrome.

— t31os

@ t31os Miałem ten problem wcześniej, ale bez konsekwencji. Ale nie próbowałem od dłuższego czasu. Proponuję console.log()wszystkim twoim działaniom, abyś zobaczył, co się uruchomiło, a co przeszkodzi. Debugowanie JavaScript nie jest łatwe ...

— kaiser