U opent een pagina om een prijs aan te passen en de helft van uw tekst zit ineens in een geel omrand kader met de mededeling dat dit blok onverwachte of ongeldige inhoud bevat. Daaronder staan knoppen om het blok op te lossen, om te zetten naar HTML of te herstellen. Wat u kiest, bepaalt of uw opmaak overleeft.
De melding klinkt alsof er iets stuk is, maar dat valt mee. Uw tekst is er nog. De editor kan alleen niet meer met zekerheid vaststellen hoe het blok in elkaar hoort te zitten, en waarschuwt liever dan dat hij zomaar iets weggooit.
Wat er onder de motorkap gebeurt
Elk blok in de WordPress-editor bestaat uit twee delen: de zichtbare HTML en een onzichtbaar briefje er direct boven, in de vorm van een commentaarregel. In dat briefje staat om welk blok het gaat en welke instellingen erbij horen.
Bij het openen van een pagina bouwt de editor het blok opnieuw op aan de hand van dat briefje en vergelijkt hij het resultaat met wat er werkelijk in de database staat. Komen die twee niet exact overeen, dan volgt de waarschuwing. Eén ontbrekende klasse of één extra spatie is al genoeg.
Dat verklaart waarom de melding vaak verschijnt zonder dat u iets heeft gedaan. Er hoeft alleen iets veranderd te zijn aan de manier waarop het blok wordt opgebouwd.
De vijf gebruikelijke aanleidingen
Een update van een plugin die het blok levert. Bij een nieuwe versie verandert soms de structuur van de uitvoer. Bestaande blokken op uw pagina’s zijn dan nog van de oude vorm en botsen met de nieuwe.
Een blok van een plugin die niet meer actief is. Het briefje verwijst naar een blok dat niemand meer herkent. U ziet dan de rauwe inhoud met een waarschuwing eromheen.
Handmatig bewerkte code. Iemand heeft in de code-editor iets aangepast en daarbij het briefje niet meegewijzigd, of een tag niet netjes afgesloten.
Geplakte inhoud uit Word of een pdf. Daar zitten opmaakcodes in die de editor niet verwacht, inclusief onzichtbare tekens.
Een migratie of zoek-en-vervangactie over de database. Een grootschalige vervanging van bijvoorbeeld een domeinnaam raakt soms ook de briefjes en verstoort de structuur.
De vier knoppen en wat ze doen
Klik op de drie puntjes bij het blok en u ziet de opties. Ze doen echt verschillende dingen.
- Blokherstel proberen. De editor probeert het briefje en de inhoud weer op één lijn te krijgen. Dit is altijd uw eerste keus. Lukt het, dan bent u klaar en verandert er visueel niets.
- Omzetten naar HTML. Het blok wordt een aangepast HTML-blok met precies de huidige inhoud erin. Uw pagina blijft er hetzelfde uitzien, maar u kunt het blok niet meer met de gewone knoppen bewerken. Een prima noodoplossing bij tabellen of ingewikkelde opmaak.
- Omzetten naar blokken. De editor probeert de inhoud opnieuw in te delen in gewone blokken. Bij eenvoudige tekst werkt dat goed; bij complexe opmaak verliest u vormgeving.
- Bewerken als HTML. U ziet de ruwe code en kunt zelf zoeken waar het misgaat. Handig als u weet wat u doet, gevaarlijk als u dat niet weet.
Wat u nooit doet: het blok verwijderen om er een nieuw voor in de plaats te zetten zonder eerst de tekst te kopiëren. Dat lijkt de snelste route en levert het vaakst spijt op.
Zo pakt u het aan zonder risico
Werk in deze volgorde, en begin bij de belangrijkste pagina.
- Maak eerst een back-up van de database, of gebruik in elk geval de revisiefunctie. Bekijk in de zijbalk hoeveel revisies er zijn, zodat u weet dat u terug kunt.
- Kopieer de zichtbare tekst van het probleemblok naar een kladbestand. Kost tien seconden en redt u bij elke misstap.
- Probeer eerst het herstel. Werkt het, sla dan op en controleer de pagina aan de voorkant.
- Werkt het niet, kies dan omzetten naar HTML als het om opmaak gaat die u wilt behouden, of omzetten naar blokken als het gewone tekst is.
- Controleer de pagina in een privévenster na het opslaan, en niet alleen in de editor.
Gaat het om een blok van een plugin die niet meer actief is, zet die plugin dan tijdelijk weer aan voordat u iets doet. Dan kunt u de inhoud netjes overzetten in plaats van hem te reconstrueren.
Als het om tientallen pagina’s gaat
Na een grote update kan de melding op veel pagina’s tegelijk verschijnen. Ga dan niet blind alles herstellen.
Kijk eerst of de melding samenhangt met één plugin. Zo ja, controleer of er een nieuwere versie is die het probleem oplost, en of de maker er iets over meldt. Vaak is er binnen een week een correctie, en dan hoeft u niets handmatig te doen.
Belangrijk in de tussentijd: kijk aan de voorkant of de pagina’s er nog goed uitzien. In veel gevallen is de melding alleen zichtbaar in de editor en merkt de bezoeker er niets van. Dan heeft u tijd en hoeft u niet in de avonduren aan de slag.
Een uitgeverij met ruim vierhonderd artikelpagina’s kreeg deze melding op alle pagina’s met een bepaald opsommingsblok, na een update van hun themapakket. De voorkant was ongemoeid. Twee weken later kwam er een correctie van de maker en verdween de melding vanzelf. Wie in paniek alles had omgezet naar HTML, had daarna vierhonderd onbewerkbare pagina’s gehad.
Voorkomen: drie gewoontes
Plak inhoud altijd zonder opmaak. In de editor gebruikt u daarvoor de sneltoets met control, shift en v. Dat scheelt het grootste deel van de vervuilde blokken.
Beperk het aantal plugins dat eigen blokken toevoegt. Elke extra bloklibrary is een extra bron van dit soort meldingen bij updates, en u gebruikt in de praktijk maar een klein deel van wat zo’n pakket biedt.
Test updates van themapakketten en blokplugins eerst op een kopie van uw site. Dat is precies waarvoor een testomgeving bedoeld is, en het scheelt het herstelwerk achteraf. De basis van werken met blokken staat trouwens uitgelegd in de introductie op de blokkeneditor.
Wanneer het geen blokprobleem is
Verschijnt de melding niet alleen, maar laadt de hele editor traag of helemaal niet, dan speelt er iets anders. Dat is een scriptconflict en dat lost u niet op door blokken te herstellen; wat u dan doet, staat in het artikel over een editor die niet laadt.
Blijft de melding terugkomen op dezelfde pagina’s, hoe vaak u ook herstelt, dan schrijft iets uw inhoud steeds opnieuw weg in een vorm die niet klopt. Voor dat soort editorproblemen die uw pagina's blokkeren loont het om iemand in de opgeslagen code te laten kijken; bij WebMaintor is dat vrijwel altijd terug te voeren op één plugin.
Doe dit als eerste: kopieer de tekst uit het gemarkeerde blok naar een kladbestand voordat u op één van de knoppen klikt. Dat is de enige stap waar u later nooit spijt van krijgt.
