Back-up en herstel

Dit document legt uit welke gegevens de ADP Car Market Hub-plugin aanmaakt of beheert, welke componenten moeten worden opgenomen in een back-up en hoe u een site na een storing of migratie kunt herstellen naar een werkende staat.

Wanneer u dit document moet gebruiken

Lees dit document als u een sitebeheerder, hosting-engineer of WordPress-ontwikkelaar bent die verantwoordelijk is voor de back-upstrategie en het herstel na calamiteiten op een site waarop de plugin draait. Neem dit door voordat u een plugin-update, een servermigratie of een belangrijke configuratiewijziging uitvoert.

Overzicht

De plugin slaat gegevens op verschillende locaties binnen de WordPress-installatie op. Een volledige en herstelbare back-up moet al deze componenten bevatten. De plugin zelf biedt geen eigen back-uphulpmiddelen; back-ups zijn afhankelijk van de standaard WordPress-back-upaanpak die wordt gebruikt door uw hostingprovider of back-up-plugin.

Geïmporteerde voertuigadvertenties kunnen opnieuw worden geïmporteerd vanuit AutoScout24 als ze verloren zijn gegaan, maar alleen als er een geldige API-verbinding beschikbaar is. Plugin-configuratie, leads, analytics-gegevens en logbestanden kunnen niet worden hersteld vanuit AutoScout24 en moeten worden beschermd door de back-up van de site.

Wat de plugin opslaat

Systeemvereisten

• Een WordPress-back-upoplossing die in staat is om zowel de database als het bestandssysteem (uploads-map) te back-uppen. Voorbeelden hiervan zijn snapshots op hostingniveau, beheerde back-updiensten of WordPress-back-up-plugins. Controleer deze werking en compatibiliteit met uw huidige omgeving.
• Schrijftoegang tot de staging- of herstelomgeving voor het testen van het herstel.
• Dezelfde PHP-versie en WordPress-versie als productie bij het herstellen naar een testomgeving, om compatibiliteitsproblemen te voorkomen.

Back-upprocedure

Database back-up

1. Maak een back-up van de volledige WordPress-database. Dit omvat wp_options (plugin-instellingen), wp_posts en wp_postmeta (voertuig-ankerberichten en leads), en alle door de plugin beheerde aangepaste tabellen ({prefix}as24_vehicles, {prefix}as24ci_analytics, {prefix}as24ci_search_agents, {prefix}as24ci_content_studio_jobs, {prefix}as24ci_content_studio_assets).
2. Gebruik een back-uptool of hosting-snapshot die een volledige SQL-dump exporteert. Gedeeltelijke back-ups die alleen geselecteerde tabellen bevatten, kunnen de aangepaste tabellen missen.
3. Bij WordPress multisite-installaties heeft elke site in het netwerk zijn eigen set {prefix}_{siteid}_-tabellen. Controleer of uw back-uptool alle sitetabellen meeneemt.

Bestanden back-up

1. Maak een back-up van de WordPress wp-content/uploads/-map. Deze bevat: - Alle geïmporteerde voertuigafbeeldingen (gekoppeld aan voertuigberichten). - De plugin-logmap: as24ci-logs/. Deze map is beveiligd tegen openbare toegang door een .htaccess-bestand; controleer of uw back-uptool verborgen bestanden meeneemt.
2. Maak een back-up van de plugin-map wp-content/plugins/adp-car-market-hub/ als u handmatige wijzigingen op bestandsniveau hebt aangebracht (bijvoorbeeld aangepaste template-overrides). Houd er rekening mee dat de plugin-map zelf normaal gesproken wordt vervangen tijdens updates en niet de primaire plaats voor aanpassingen mag zijn.

Opmerking over configuratie

De API-inloggegevens van de plugin (Client ID, Client Secret) worden opgeslagen in WordPress-opties en zijn opgenomen in de database-back-up. Dit zijn gevoelige waarden. Zorg ervoor dat database-back-upbestanden veilig worden opgeslagen en dat de toegang ertoe is beperkt.

Herstelprocedure

Volledig siteherstel

1. Herstel de database vanuit de back-up met behulp van uw hosting-controlepaneel, phpMyAdmin of een command-line MySQL-client.
2. Herstel de wp-content/uploads/-map vanuit de bestanden-back-up.
3. Als u herstelt naar een nieuwe server of domein, update dan de WordPress-site-URL in de database (wp_options rijen siteurl en home) met behulp van de WordPress CLI (wp option update) of door de database rechtstreeks te bewerken.
4. Wis eventuele WordPress object-cache na het herstel.
5. Log in op de WordPress-beheeromgeving en navigeer naar ADP Car Market Hub → Systeem & Hulp om de status van de API-verbinding te controleren.
6. Open ADP Car Market Hub → Import & Limieten en controleer of het importschema actief is.
7. Start een handmatige import vanaf het tabblad Import & Limieten en controleer of voertuigen correct worden aangemaakt of bijgewerkt.

Gedeeltelijk herstel: alleen instellingen

Als alleen de plugin-instellingen moeten worden hersteld (bijvoorbeeld na een onbedoelde verkeerde configuratie):

1. Importeer de database-back-up in een tijdelijke of staging-database.
2. Extraheer de relevante wp_options-rijen met sleutels met het voorvoegsel as24ci_ met behulp van een SQL-query of een database-vergelijkingstool.
3. Pas de herstelde optiewaarden toe op de productiedatabase.
4. Test de verbinding en de importpijplijn voordat u bevestigt dat het herstel is voltooid.

Alleen voertuigafbeeldingen herstellen

Als voertuigafbeeldingen per ongeluk uit de mediabibliotheek zijn verwijderd:

1. Herstel de wp-content/uploads/ bestanden-back-up om de originele afbeeldingsbestanden terug te zetten.
2. Voer anders de import opnieuw uit met de import van afbeeldingen ingeschakeld. De importer controleert bestaande bron-URL's van bijlagen (_as24ci_source_url post-meta) en slaat afbeeldingen over die al aanwezig zijn. Ontbrekende afbeeldingen worden opnieuw gedownload van AutoScout24.

Operationele opmerkingen

• De plugin kan back-ups niet zelfstandig beheren of inplannen. De verantwoordelijkheid voor back-ups ligt bij de site-eigenaar, hostingprovider of een speciale WordPress-back-up-plugin.
• De analytics-tabel ({prefix}as24ci_analytics) and de zoekagenten-tabel ({prefix}as24ci_search_agents) bevatten persoonlijke gegevens (bezoekersgebeurtenissen, e-mailadressen van abonnees). Behandel back-upbestanden die deze tabellen bevatten in overeenstemming met de toepasselijke privacywetgeving.
• De analytics-tabel wordt altijd verwijderd door de deïnstallatie-routine van de plugin, zelfs als de optie Gegevens verwijderen bij deïnstallatie is uitgeschakeld. Als u van plan bent om analytics-gegevens te behouden bij een herinstallatie van de plugin, exporteer of bewaar de tabel dan handmatig voordat u deïnstalleert.
• Voertuigafbeeldingen die door de plugin zijn geïmporteerd, worden bijgehouden in post-meta onder _as24ci_image_ids. Deze ID's koppelen voertuigberichten aan hun bijlagen in de mediabibliotheek. Als deze post-meta niet aanwezig is bij een herstel, kunnen de afbeeldingen in de mediabibliotheek achterblijven als weesbijlagen.
• Logbestanden in as24ci-logs/ zijn niet kritiek voor het herstellen van de sitefunctionaliteit, maar ze kunnen nuttige diagnostische informatie bevatten. Als u meer dan 7 dagen loggeschiedenis wilt bewaren, kopieer dan gearchiveerde logbestanden naar een langetermijnopslag voordat de plugin ze opschoont.

Probleemoplossing

Gerelateerde documenten

• Update-proces
• Maandelijks onderhoud
• Deïnstallatie en gegevens opschonen
• Logboekregistratie en monitoring