Depanare

Cele mai multe cereri de suport se reduc la baseline-uri de scanare, starea licenței, prospețime, interpretarea greșită a scope-ului inventarului sau batch-uri Refactor care au nevoie de un pas suplimentar de review. Începe cu secțiunea care se potrivește simptomului pe care îl vezi.

Nu apar rânduri indexate după instalare #

Rulează un full scan cel puțin o dată.
Verifică ultimul status al scanării în tab-ul Scans.
Confirmă că utilizatorul curent are capabilități de admin.
Tratează produsul ca nepregătit pentru raportare până când există un baseline complet finalizat.

Controalele de scanare sunt read-only #

Licența poate lipsi, poate fi invalidă sau expirată.
Refă starea licenței din tab-ul License.
Reactivează cheia dacă este nevoie.
Folosește wp dxm-block-toolkit scan --dry-run dacă ai nevoie de o cale de validare read-only cât timp se rezolvă licențierea.
Acțiunile Refactor pentru apply și rollback rămân indisponibile până când revine accesul cu write.

Erori la activarea licenței #

Verifică dacă cheia se potrivește cu înregistrarea achiziției.
Folosește portalul de facturare pentru a confirma că abonamentul este activ.
Încearcă din nou după o scurtă pauză dacă rețeaua a fost instabilă.
Refă starea licenței din tab-ul License după activare.

Rânduri Unknown pentru pattern, template-part sau navigation #

Rândurile Unknown sunt semnale de follow-up, nu erori automate de produs.
Patterns acoperă entitățile reutilizabile sau sincronizate și referințele lor prin core/block.
Template Parts și Navigations urmăresc referințe directe și pot grupa ținte nerezolvate ca Unknown.
Rerulează un full scan dacă s-au schimbat recent conținutul sau entitățile referențiate, apoi inspectează sursele potrivite pentru rândul nerezolvat.

Exportul pare incomplet #

Exporturile de inventar și surse sunt limitate implicit la primele 5.000 de rânduri filtrate per acțiune de export.
Restrânge filtrele și exportă în bucăți mai mici pe site-urile mai mari.
Dacă ai nevoie de praguri mai mari, aceasta este o setare de dezvoltator, nu un flux admin standard.

Filtrele avansate pentru surse nu returnează rezultate #

Rulează un full scan proaspăt ca indexul de atribute să fie populat.
Când filtrezi după conținutul blocului, confirmă că fragmentul de text distinctiv este chiar în conținutul indexat al blocului, nu doar în alta parte a paginii.
Confirmă că rândul de sursă al blocului conține efectiv acel class, ID, anchor sau valoare scalară de atribut.
Dacă propoziția întreagă variază între surse, încearcă mai întâi un fragment distinctiv mai scurt înainte să presupui că lipsește din index.
Verifică scrierea dot-path pentru atribute nested, precum style.color.text.
Folosește câmpurile dedicate Attribute Path când valoarea conține spații; compact queries nu suportă valori quoted.

Preview-ul Refactor nu a returnat rânduri #

Confirmă că blocul, entitatea sau scope-ul de filtre mai corespund cu rânduri indexate reale.
Revizuiește filtrele avansate sau setările de scope ale batch-ului pentru condiții prea restrictive.
Rulează un full scan proaspăt dacă modificările recente de conținut ar fi putut elimina sau redenumi potrivirile inițiale.

Ținta Refactor pare invalidă sau nepotrivită pentru modul ales #

Confirmă că modul Refactor se potrivește cu lucrul pe care chiar vrei să îl schimbi.
Folosește block_instance pentru instanțe de bloc potrivite, entity_reference pentru referințe către entități partajate și entity_definition pentru entitatea partajată în sine.
Dacă ținta nu se mai rezolvă curat, rerulează un full scan și reconstruiește preview-ul din dovezile actuale ale inventarului.

Apply a fost skipped după schimbări de conținut #

Un apply skipped înseamnă de obicei ca conținutul stocat s-a schimbat după generarea preview-ului.
Revizuiește Batch details ca să vezi care rânduri nu mai corespund presupunerilor din preview.
Rerulează un full scan dacă s-a schimbat semnificativ conținutul, apoi generează un preview nou înainte să aplici din nou.

Rollback a fost skipped sau failed #

Rândurile skipped la rollback înseamnă de obicei că conținutul stocat nu mai corespundea presupunerilor batch-ului aplicat anterior.
Rândurile failed la rollback au nevoie de follow-up manual după ce revizuiești Batch details și starea curentă a conținutului.
Dacă a apărut drift de conținut după apply, rerulează un full scan înainte să decizi dacă încerci din nou rollback-ul sau tratezi manual rândurile.

Date de scanare învechite sau esuate #

Folosește ultimul full scan finalizat ca baseline autoritativ.
Rerulează un full scan dacă baseline-ul este învechit pentru fereastra ta de raportare.
Dacă ultima rulare a eșuat sau a fost anulată, tratează datele actuale de inventar ca potențial incomplete până când există un nou baseline finalizat.
Fă același lucru înainte să ai încredere în preview-urile Refactor sau în deciziile de apply.

Validare avansată cu WP-CLI #

Dacă ai nevoie de o verificare CLI rapidă, folosește:

wp dxm-block-toolkit scan --dry-run
wp dxm-block-toolkit stats --format=json
wp dxm-block-toolkit doctor --format=json

Folosește aceste comenzi ca să validezi scope-ul, statisticile sau integritatea indexului fără să transformi acest set de documentație într-o referință CLI completă.

Ai nevoie de actualizări de facturare sau anulare #

Folosește portalul de facturare pentru actualizarea cardului, facturi și anularea abonamentului.

Încă ești blocat? #

Contactează asistența și include: [email protected].

Versiunea de WordPress și versiunea PHP
Captura de ecran cu starea licenței
Ultimul status al scanării și timestamp-ul
Ce vedere de inventar sau acțiune de export foloseai