Was stabil ist
Worauf Sie ein Child-Theme, eine Vorlage im Page Builder oder eigenes CSS bauen können, ändert sich nur mit einer neuen Hauptversion des Plugins, also etwa beim Schritt von 2.x auf 3.0.0.
Stabil
Section titled “Stabil”- Klassen aus den Tabellen unter Klassen und Einzelne Felder ansprechen, mit ihren Varianten und ihrer Verschachtelung, dazu die Selektoren der Schutzregeln.
- CSS-Variablen aus der Tabelle unter CSS-Variablen, mit ihren Vorgaben.
- Shortcodes mit ihren Angaben und deren Werten, wie unter Shortcodes beschrieben.
- Einhängepunkte mit Methode, Priorität und Argumenten aus den Tabellen unter Teile und Abschnitte umstellen.
- Filter:
wpcars24_load_stylesheet,wpcars24_force_assets,wpcars24_append_details,wpcars24_image_sizes,wpcars24_card_title_tag,wpcars24_section_headingundwpcars24_sync_batch_size, mit ihren Argumenten. - Anfrageparameter in der Adresse:
wpcars24_page,wpcars24_sortund die Felder des Filterformulars wiewpcars24_makeoderwpcars24_price_to. Bei einer Liste mitidsteht deren Name dahinter, etwawpcars24_page_bestand. Besucher legen solche Adressen als Lesezeichen ab, und Suchmaschinen merken sie sich. - Vorlagen
vehicle-card.phpundvehicle-empty.phpmit ihren Namen und der Variablen$wpcars24_args. - Handles der Dateien, für
wp_dequeue_style()undwp_dequeue_script():wpcars24-baseundwpcars24-themefür die Stylesheets,wpcars24-galleryfür das Skript der Galerie.
Nicht stabil
Section titled “Nicht stabil”- alle übrigen PHP-Klassen, Methoden und Konstanten des Plugins. Die Methoden aus den Tabellen der Einhängepunkte zählen zu den Einhängepunkten; aufrufen sollten Sie sie nur über diese.
- Namen von Optionen und Metafeldern in der Datenbank (
_wpcars24_…). - Elemente ohne eigene Klasse, etwa die
lider Blätterung. Gestalten Sie sie über die Klasse ihres Elternelements. - Pfade der Dateien im Plugin; sie stehen nur zur Orientierung in dieser Dokumentation.
Wie sich Stabiles ändert
Section titled “Wie sich Stabiles ändert”Nur mit einer Hauptversion, und alte Namen bleiben dann noch eine Hauptversion lang erhalten:
- ein umbenannter Shortcode unter seinem alten Namen als zweiter Name,
- ein umbenannter Filter über
apply_filters_deprecated(); WordPress meldet ihn dann bei eingeschaltetemWP_DEBUGals veraltet, - eine umbenannte Klasse als zweite Klasse am selben Element,
- bei geänderter Verschachtelung ein Schalter, der das alte Markup zurückholt.
Neue Klassen, Variablen, Angaben, Filter und Einhängepunkte können mit jeder Version dazukommen. Ihre Vorgabe lässt die bisherige Ausgabe, wie sie ist. Jede Änderung an der Ausgabe steht im Changelog und in WordPress unter Details anzeigen.