Verouderde WooCommerce-sjablonen in je thema herstellen

Vind verouderde WooCommerce-sjablonen in je thema, controleer welke bestanden moeten worden bijgewerkt en test de wijzigingen eerst op een testsite.

Laatst bijgewerkt:

Engelstalig origineel op juistheid gecontroleerd door Jesse Nickles

Het verouderde sjabloon vinden

  1. Open in WP Admin WooCommerce → Status → System status.
  2. Scrol naar Templates en zoek naar overschreven bestanden die als verouderd zijn gemarkeerd.
  3. Noteer het relatieve bestandspad en de versie van elke gemarkeerde override. Controleer daarna of het bestand in de map woocommerce/ van het actieve hoofdthema of childtheme staat. Voor de vergelijking met het originele WooCommerce-bestand heb je het exacte pad nodig.

Een thema kan PHP-sjablonen van WooCommerce naar de eigen map woocommerce/ kopiëren om de indeling of werking van de winkel aan te passen. Anders dan de ingebouwde WooCommerce-sjablonen worden die kopieën niet automatisch bijgewerkt met de plugin. WooCommerce vergelijkt de opmerking @version bovenaan elke override met de versie van het huidige standaardsjabloon. Een waarschuwing wijst op een versieverschil dat je op compatibiliteit moet controleren. Dat bewijst niet dat de winkel defect is en betekent niet dat elke override direct moet worden vervangen. Zie de officiële instructies voor sjabloonupdates.

Deze stappen gaan over PHP-sjabloonoverrides. Blokthema's kunnen in plaats daarvan HTML-sjablonen gebruiken die je via Appearance → Editor beheert. Die werken anders en herstel je niet door WooCommerce-PHP-sjablonen te kopiëren. Bewaar je aanpassingen voordat je een aangepast sjabloon in de Site Editor terugzet, want bij het herstellen gaan de opgeslagen wijzigingen in dat sjabloon verloren. Zie de WooCommerce-documentatie over blokthema's.

Werk eerst je thema bij

Begin niet met het bewerken van sjabloonbestanden in een livewinkel. Maak een back-up van de sitebestanden en database en test de wijzigingen vervolgens op een testkopie.

  1. Controleer of er een update is voor het actieve thema en installeer die eerst in de testomgeving. Themaontwikkelaars nemen bijgewerkte WooCommerce-sjablonen vaak op in hun releases.
  2. Gebruik je een childtheme, controleer de overrides in de map woocommerce/ daarvan dan apart. Die kunnen voorrang krijgen op dezelfde bestanden in het hoofdthema en worden niet vervangen door een update van het hoofdthema.
  3. Ga terug naar WooCommerce → Status → System status → Templates en kijk of de waarschuwingen verdwenen zijn.
  4. Test een betrokken productpagina, productvariaties, de winkelwagen en het afrekenen. Als een e-mailsjabloon was gemarkeerd, test dan ook de betreffende transactionele e-mail.

Als je thema nog steeds verouderde sjablonen bevat, vraag de ontwikkelaar dan om een bijgewerkte versie voordat je zelf aan de bestanden begint.

HoverCraft overschrijft bewust global/quantity-input.php om via een themaspecifieke hulpfunctie de keuzelijst met aantallen te tonen. Vervang je dat bestand door het standaardsjabloon van WooCommerce, dan kan die werking verdwijnen. Verwijder of vervang het bestand dus niet alleen om een waarschuwing te verhelpen. Raadpleeg eerst Thema-updates en WooCommerce-productpagina’s.

Een aangepast sjabloon herstellen

Als je het thema of childtheme zelf onderhoudt, vergelijk het gemarkeerde bestand dan met het overeenkomstige sjabloon in de geïnstalleerde WooCommerce-versie. De paden komen doorgaans als volgt overeen:

Behoud eventuele submappen uit [relative-path]. Zo hoort emails/admin-new-order.php in de map woocommerce/emails/ van het childtheme, niet in de hoofdmap ervan.

  1. Maak een back-up van de bestaande override en vergelijk deze met het oorspronkelijke sjabloon uit de WooCommerce-versie die op de testsite is geïnstalleerd. Noteer zowel je eigen aanpassingen als wijzigingen in WooCommerce-hooks, PHP-variabelen en HTML-markup.
  2. Bepaal of een update nodig is. Maak zo nodig een bijgewerkt bestand op basis van het geïnstalleerde WooCommerce-sjabloon en breng alleen de noodzakelijke eigen aanpassingen zorgvuldig opnieuw aan. Vervang de override niet blindelings.
  3. Plaats het aangepaste bestand op het juiste relatieve pad in je childtheme op de testsite. Bewerk niet de pluginsjablonen of het hoofdthema dat door de ontwikkelaar wordt onderhouden.
  4. Test de betrokken productpagina, winkelwagen, checkout of e-mail en controleer het statusrapport opnieuw voordat je de wijzigingen live zet.

Wijzig niet alleen de @version-kop om een waarschuwing te laten verdwijnen: daarmee wordt de code niet bijgewerkt. Bewerk nooit rechtstreeks de sjablonen in de WooCommerce-plugin, want een pluginupdate vervangt die wijzigingen. Ook aanpassingen in het hoofdthema kunnen bij een update verdwijnen. De WooCommerce-documentatie over sjabloonoverrides legt de bestandsstructuur uit en waarom een childtheme veiliger is voor sitespecifieke wijzigingen.

Als de waarschuwing blijft of iets niet werkt