Zum Inhalt springen

Teile und Abschnitte umstellen

Die Teile einer Karte und die Abschnitte einer Detailseite hängen an Einhängepunkten (Aktionen von WordPress), jeder mit einer Priorität in Zehnerschritten. Wer die Reihenfolge ändern, etwas weglassen oder ergänzen will, hängt um, statt eine Vorlage zu kopieren. Ein Update des Plugins kann die Karte dann erweitern, ohne dass die Anpassung verloren geht.

Die Zeilen gehören in die functions.php des Child-Themes. Das Plugin meldet seine Teile schon beim Laden an, also bevor das Theme geladen wird; remove_action() wirkt deshalb direkt, ohne eigenen Haken drumherum. Für die Beispiele steht am Anfang der Datei:

use WPCars24\Frontend\VehicleCard;
use WPCars24\Frontend\VehicleDetail;

Die Teile einer Fahrzeugkarte mit Methode und Priorität: media 10, title 20, facts 30, price 40, emissions 50

EinhängepunktMethodePrioritätTeil
wpcars24_vehicle_cardVehicleCard::media10Bild mit Verweis auf die Fahrzeugseite
wpcars24_vehicle_cardVehicleCard::title20Titel
wpcars24_vehicle_cardVehicleCard::facts30Erstzulassung, Kilometerstand, Leistung, Kraftstoff
wpcars24_vehicle_cardVehicleCard::price40Preis mit Hinweis zur Mehrwertsteuer
wpcars24_vehicle_cardVehicleCard::emissions50Verbrauch und CO₂, nur bei Fahrzeugen mit diesen Angaben

Jeder Teil bekommt die Nummer des Beitrags (int $post_id).

Den Preis über den Titel setzen:

remove_action( 'wpcars24_vehicle_card', array( VehicleCard::class, 'price' ), 40 );
add_action( 'wpcars24_vehicle_card', array( VehicleCard::class, 'price' ), 15 );

Einen eigenen Teil ergänzen, hier zwischen Preis und Umweltangaben:

add_action(
'wpcars24_vehicle_card',
function ( int $post_id ) {
echo '<p class="mein-hinweis">Finanzierung möglich</p>';
},
45
);

Die Detailseite hat zwei Hälften: den Kopf an wpcars24_vehicle_header und den Rumpf an wpcars24_vehicle_details. Die Einhängepunkte heißen wie die Shortcodes der beiden Hälften und wie die Gruppen in sections=.

Die Abschnitte einer Detailseite mit Einhängepunkt und Priorität, vom Preis bis zum Verweis auf die Quellplattform

EinhängepunktMethodePrioritätAbschnitt
wpcars24_vehicle_headerVehicleDetail::price10Preis mit Hinweis zur Mehrwertsteuer
wpcars24_vehicle_headerVehicleDetail::gallery20Bildergalerie mit Vorschaubildern
wpcars24_vehicle_detailsVehicleDetail::specs10Fahrzeugdaten
wpcars24_vehicle_detailsVehicleDetail::envkv20Verbrauch und CO₂ nach Pkw-EnVKV, nur bei Fahrzeugen mit diesen Angaben
wpcars24_vehicle_detailsVehicleDetail::description30Beschreibung aus dem Inserat
wpcars24_vehicle_detailsVehicleDetail::equipment40Ausstattung
wpcars24_vehicle_detailsVehicleDetail::seller50Anbieter mit Anschrift und Kontakt
wpcars24_vehicle_detailsVehicleDetail::source60Verweis auf das Inserat bei AutoScout24

Die Methoden heißen wie die Abschnitte in sections= (siehe Fahrzeugseite und Abschnitte). Jeder Abschnitt bekommt wie die Teile der Karte die Nummer des Beitrags (int $post_id).

Die Galerie über den Preis setzen:

remove_action( 'wpcars24_vehicle_header', array( VehicleDetail::class, 'gallery' ), 20 );
add_action( 'wpcars24_vehicle_header', array( VehicleDetail::class, 'gallery' ), 5 );

Einen Abschnitt weglassen, hier den Anbieter:

remove_action( 'wpcars24_vehicle_details', array( VehicleDetail::class, 'seller' ), 50 );

Einen eigenen Abschnitt ergänzen, hier zwischen Beschreibung und Ausstattung:

add_action(
'wpcars24_vehicle_details',
function ( int $post_id ) {
echo '<section class="mein-abschnitt">';
echo '<h2>Probefahrt</h2>';
printf(
'<p>Sie möchten den %s fahren? Rufen Sie uns an: 0123 456789.</p>',
esc_html( get_the_title( $post_id ) )
);
echo '</section>';
},
35
);

Die Einhängepunkte gelten für die Fahrzeugseiten, für die Shortcodes [wpcars24_vehicle_header] und [wpcars24_vehicle_details] und für die Karten in jeder Liste. Der Shortcode [wpcars24_vehicle sections="…"] dagegen ruft die gewählten Abschnitte direkt in der angegebenen Reihenfolge auf; dort ändern Sie die Reihenfolge über sections (siehe Fahrzeugseite und Abschnitte).

Der Titel einer Karte ist ein h3, die Überschrift eines Abschnitts der Detailseite ein h2. Steht eine Liste direkt unter dem Titel der Seite, ist für die Karten h2 richtig; setzen Sie einen Abschnitt in einem Page Builder unter eine eigene Überschrift, braucht er keine zweite.

Einzeln geht das über Angaben der Shortcodes: title_tag an der Liste (h2 bis h4) und heading an den Abschnitten (h2 bis h4, no für keine), siehe Listen und Filter und Fahrzeugseite und Abschnitte. Für die ganze Website, auch für die Detailseite, die das Plugin selbst anhängt, setzen Sie die Vorgabe mit den Filtern wpcars24_card_title_tag und wpcars24_section_heading. Eine Angabe im Shortcode geht dem Filter vor.

// Kartentitel als h2.
add_filter( 'wpcars24_card_title_tag', fn() => 'h2' );
// Die Beschreibung ohne eigene Überschrift, alle anderen Abschnitte als h3.
add_filter(
'wpcars24_section_heading',
function ( string $heading, string $section ) {
return 'description' === $section ? 'no' : 'h3';
},
10,
2
);

wpcars24_card_title_tag bekommt die Vorgabe h3 und die Nummer des Beitrags. wpcars24_section_heading bekommt die Vorgabe h2, den Namen des Abschnitts (envkv, description, equipment oder seller; die übrigen haben keine Überschrift) und die Nummer des Beitrags. Ein unbekannter Wert lässt es bei der Vorgabe. Die Größe der Überschriften ändert sich mit der Ebene nicht; sie steht im Stylesheet an den Klassen.