ARVAS PRODUCT SYNC FOR WOOCOMMERCE 1.0.0
INSTALLATIE-INSTRUCTIE (LITE, GRATIS)
=========================================

Dit is de gratis Lite-editie: de volledige import, zonder de Pro-extra's.
De Pro-editie voegt fotokoppeling, categorie-afdelingen, uitsluitingen, de
GTIN-herstelfunctie en een servercron-script toe. Eenmalig 99 euro inclusief
een jaar updates en support: https://verkoop.arvashosting.eu

VEREISTEN
- WordPress 6.4 of nieuwer
- WooCommerce 8.0 of nieuwer (getest tot 11.0)
- PHP 7.4 of nieuwer
- Toegang tot de server waar de kassa-export staat (SFTP/FTPS/FTP/HTTPS)


STAP 1 - PLUGIN INSTALLEREN
---------------------------
1. Ga in WordPress naar Plugins > Nieuwe plugin > Plugin uploaden.
2. Kies arvas-product-sync.zip en klik op Nu installeren.
3. Bestaat de plugin al? Kies "Huidige vervangen door geuploade".
4. Activeer de plugin.
5. Ga naar WooCommerce > Arvas Sync.

Bij activatie scant de plugin de installatie: WooCommerce-versie, aanwezige
merk-taxonomieen, bestaande productattributen, andere import-plugins en of er al
producten zijn. Het resultaat staat onder "Omgeving".


STAP 2 - VERBINDING MET DE KASSASERVER
--------------------------------------
Draait de webshop op DEZELFDE server als de kassa-export?
   Kies "Op DEZE server" en vul het absolute pad in, bijvoorbeeld:
   /home/gebruiker/winstore
   Een map mag ook; de plugin pakt dan het nieuwste bestand.

Draait de kassa op een ANDERE server? (meest voorkomend)
   Kies "Op een ANDERE server" en vul in:

   Protocol : SFTP als het account SSH heeft, anders FTPS
   Host     : het IP of de hostnaam van de kassaserver
   Poort    : 22 voor SFTP, 21 voor FTPS/FTP
   Pad      : het pad ZOALS HET FTP-ACCOUNT DAT ZIET, dus geen URL
              en meestal niet het volledige serverpad
   Gebruiker en wachtwoord van het account
   URL      : LEEG laten, tenzij je HTTPS gebruikt

   Weet je het pad niet zeker? Gebruik "Externe map bekijken": vul / in en klik
   op "Map tonen". Je ziet dan waar het account uitkomt en hoe de bestanden
   precies heten.

   Klik daarna op "Alleen verbinding testen". Die haalt het bestand op zonder
   iets te importeren.

WACHTWOORD BUITEN DE DATABASE (optioneel)
   Zet in wp-config.php:
   define( 'ARVAS_WOO_SYNC_REMOTE_PASS', 'het-wachtwoord' );
   Deze constante heeft voorrang op het invoerveld.


STAP 3 - INSTELLINGEN CONTROLEREN
---------------------------------
Productstructuur : Alles variabel - Kleur en Maat als variaties
Parent-SKU       : Modelnaam uit de feed
Batchgrootte     : 40
Tijdsbudget      : 20 seconden
Veiligheidsdrempel: 40 procent
Dry-run          : AAN tijdens het testen

Draait er al een andere import-plugin op hetzelfde bestand, zet die planning dan
uit. De plugin waarschuwt hiervoor onder "Omgeving".


STAP 4 - TESTEN ZONDER RISICO
-----------------------------
1. Laat Dry-run AAN staan.
2. Vul bij "Alleen deze artikelnummers" enkele nummers in, komma-gescheiden.
3. Klik op "Test import nu (dry-run, schrijft niets)".
4. Controleer het rapport: aantallen, voorgenomen acties, en of bestaande
   producten worden opgepakt in plaats van opnieuw aangemaakt.


STAP 5 - EERSTE ECHTE IMPORT
----------------------------
1. Haal het vinkje bij Dry-run weg.
2. Klik op "Nu echt importeren" (met de testartikelnummers nog ingevuld).
3. Controleer in WooCommerce:
   - het product staat als Variabel product
   - alle maten en kleuren staan als variatie
   - voorraad en prijs kloppen met de kassa
   - de EAN staat in het GTIN-veld
   - het merk is zichtbaar
   - de categorie klopt (Dames/Heren + subcategorie)
4. Klopt alles? Maak het veld "Alleen deze artikelnummers" leeg.
5. Klik nogmaals op "Nu echt importeren". De plugin werkt per blok en plant zelf
   vervolgruns in tot de hele catalogus is gedaan. Volg dit via de
   voortgangsbalk.


STAP 6 - AUTOMATISCH DRAAIEN
----------------------------
De plugin plant zelf een WP-Cron van 30 minuten. WP-Cron draait alleen wanneer
er bezoekers op de site zijn; op een rustige webshop kan een sync daardoor
uitblijven.

De Pro-editie bevat een servercron-script met slot en logboek dat buiten de
webroot draait, zodat de sync altijd op tijd loopt.

BELANGRIJK: zet het vinkje Dry-run UIT. Staat het aan, dan draait alles netjes
maar wordt er niets weggeschreven.

STAP 7 - CATEGORIEEN EN MENU
----------------------------
Producten komen in de categorie die de kassafeed aangeeft.

De Pro-editie zet daar een afdeling boven (Dames > T-shirt, Heren > T-shirt),
kan merken en categorieen uitsluiten, en bevat een knop om de indeling volledig
opnieuw op te bouwen.

Het navigatiemenu wordt niet automatisch aangepast. Bouw dat op onder
Weergave > Menu's nadat de import heeft gedraaid.


PROBLEMEN OPLOSSEN
------------------
Bronpad werkt niet
   De instellingenpagina toont een diagnose met wat PHP werkelijk ziet. Let op
   open_basedir (PHP mag niet buiten de webroot lezen) en op leesrechten.

SFTP loopt in een timeout
   Het account heeft waarschijnlijk geen SSH-toegang. Gebruik FTPS op poort 21.

Bestand niet gevonden bij een kloppende verbinding
   Het pad is te lang. FTP-accounts zitten opgesloten in hun thuismap. Gebruik
   "Externe map bekijken" om het juiste pad te zien.

Import lijkt te blijven staan
   Kijk naar de voortgangsbalk, niet naar het rapport: dat is een momentopname.
   Loopt de balk niet op, controleer dan de servercron en of Dry-run uit staat.

Alles wordt nieuw aangemaakt, niets bijgewerkt
   Dat wijst op duplicaten. Stop de import en controleer of de bestaande
   producten hun SKU nog hebben.

GTIN-velden blijven leeg
   Levert de kassa voor die artikelen geen EAN, dan blijft het veld leeg. De
   Pro-editie bevat een controle en een knop om ontbrekende codes aan te vullen.


SUPPORT
-------
Arvas Beheer B.V. - https://arvashosting.eu
