Zum Inhalt springen

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.

  • 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_heading und wpcars24_sync_batch_size, mit ihren Argumenten.
  • Anfrageparameter in der Adresse: wpcars24_page, wpcars24_sort und die Felder des Filterformulars wie wpcars24_make oder wpcars24_price_to. Bei einer Liste mit id steht deren Name dahinter, etwa wpcars24_page_bestand. Besucher legen solche Adressen als Lesezeichen ab, und Suchmaschinen merken sie sich.
  • Vorlagen vehicle-card.php und vehicle-empty.php mit ihren Namen und der Variablen $wpcars24_args.
  • Handles der Dateien, für wp_dequeue_style() und wp_dequeue_script(): wpcars24-base und wpcars24-theme für die Stylesheets, wpcars24-gallery für das Skript der Galerie.
  • 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 li der Blätterung. Gestalten Sie sie über die Klasse ihres Elternelements.
  • Pfade der Dateien im Plugin; sie stehen nur zur Orientierung in dieser Dokumentation.

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 eingeschaltetem WP_DEBUG als 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.