Contentweergave en functionele problemen

Pictogrammen worden niet correct weergegeven op de gebruikerssite

In sommige gevallen worden pictogrammen op de gebruikerssite niet correct weergegeven, vooral wanneer er veel iconen zijn voor verschillende navigaties. De belangrijkste reden voor kapotte pictogrammen is een onbedoelde aanpassing van de FontAwesome-familie die door Document360 is geleverd. Dit gebeurt wanneer wijzigingen in andere klassen of HTML-tags op de gebruikerssite onbedoeld de icon-lettertypeinstellingen wijzigen.
Om dit probleem te voorkomen,

• Zorg ervoor dat wijzigingen in de styling of klassedefinities van de site geen invloed hebben op de FontAwesome-klassen of lettertypefamilie-instellingen.

• Bij het aanpakken van specifieke elementen controleer dan nog eens of icon-gerelateerde stijlen intact blijven en niet overschreven zijn.

Stappen om op te lossen:

1. Inspecteer het gebroken icoon:

1. Gebruik de ontwikkelaarstools van je browser om de gebruikerssite te inspecteren.

2. Klik op het kapotte pictogram met de selectortool om het probleem te identificeren.

2. Controleer aangepaste CSS:

1. Navigeer naar Instellingen () > Kennisbanksite > Site aanpassen > Aangepaste CSS en JavaScript in de Kennisbankportal.

2. Bekijk alle lettertyperegels die op verschillende klassen van toepassing zijn. In sommige gevallen kunnen lettertypewijzigingen onbedoeld van toepassing zijn op bredere klassen, wat de iconen beïnvloedt.

3. Zorg ervoor dat lettertypewijzigingen alleen worden toegepast op de specifieke klassen die ze vereisen. Dit helpt om de standaardinstellingen van Font Awesome te behouden en onbedoelde effecten op iconen te voorkomen.

De pagina reageert niet tijdens het bewerken van een artikel

Fout: De pagina werkt niet. example.com Je te vaak omgeleid. ERR_TOO_MANY_REDIRECTS.

Tijdens het bewerken van een artikel kan de pagina niet reageren of fouten laten zien die verband houden met doorverwijzingen. Enkele veelvoorkomende oorzaken zijn:

• Verouderde browsercache die de paginalaad verstoort

• Groot artikelformaat met te veel afbeeldingen, tabellen of lange inhoud

• Onjuiste of ontbrekende HTML-sluittags (vooral in Markdown)

• Overmatige doorverwijzingen door verkeerde opstelconfiguratie

• Platformgerelateerde kwesties die alle artikelen betreffen, niet alleen een specifiek artikel

Stappen om op te lossen:

• Maak de cache leeg, laad de browser opnieuw en kijk of het probleem blijft bestaan. Een corrupte of verouderde cache kan de functionaliteit van de pagina verstoren.

• Gebruik een privé/incognito venster. Dit helpt om cache- en cookiegerelateerde problemen uit te sluiten.

• Bepaal de omvang van het probleem. Controleer of het probleem voor alle artikelen voorkomt of alleen voor een specifieke.

  Als Alle artikelen worden getroffen:

  • Genereer een HAR-bestand en stuur het naar support@document360.com voor analyse.

  • Ga naar () > Knowledge base portal > Algemeen en zet de Support-toegangsschakelaar aan zodat het supportteam dit kan onderzoeken.

  Als een specifiek artikel wordt getroffen:

  • Grote artikelen kunnen prestatieproblemen veroorzaken. Overweeg om de inhoud op te splitsen in kleinere artikelen en deze onder passende categorieën te organiseren.

  • Zorg ervoor dat alle HTML-tags in het artikel overeenkomende slottags hebben (bijv. <table>, <div>, ), <p>vooral in Markdown-formaat.

• Als het probleem aanhoudt, neem dan contact op met support@document360.com met de volgende details:

  • Een screenshot van het probleem

  • Het HAR-dossier ter analyse

  • Supporttoegang is ingeschakeld in jouw project

Knowledge base site laadt zonder CSS-styling

Dit probleem doet zich meestal voor wanneer de site wordt benaderd vanuit een netwerk waarbij Document360-domeinen door uw bedrijf of organisatie zijn geblokkeerd of niet op de whitelist staan.

Stappen om op te lossen:

1. Controleer of de site correct werkt wanneer je vanaf een ander netwerk wordt bezocht. Als dat zo is, heeft het probleem waarschijnlijk te maken met netwerkbeperkingen.

2. Om dit op te lossen, zet je de volgende domeinen op de whitelist in je netwerkinstellingen om goede toegang en functionaliteit te garanderen.

Profielfoto's van gebruikers/lezers zijn kapot

Profielfoto's van gebruikers of lezers kunnen kapot lijken op de Knowledge Base-site. Dit probleem doet zich voor wanneer het type afbeeldingsinhoud verkeerd wordt geïdentificeerd, waardoor het niet correct geladen kan worden.

Stappen om op te lossen:

1. Open een artikel op de Knowledge Base-site en kijk of de profielfoto van de bijdrager kapot lijkt.

2. Klik met de rechtermuisknop in het browsertabblad, klik op Inspecteren en ga naar het tabblad Netwerk in het Devtools-paneel .

3. Zoek de aanvraag die de profielafbeelding laadt en controleer het Inhoudstype:

   • Als het "tekst/plain" is, laadt de afbeelding niet goed.

   • Als het "image/jpeg" is, "application/octet-stream" of een ander geldig formaat, zou de image prima moeten laden.

   

4. Probeer de profielfoto opnieuw te uploaden:

   • Navigeer naar je project via het kennisbankportaal.

   • Klik rechtsboven op je profielicoon.

   • Selecteer Mijn profiel in het keuzemenu.

   • Klik in het Mijn profielpaneel op Bewerken en klik vervolgens op het Bewerken () icoon bij de profielafbeelding.

   • Upload je gewenste profielafbeelding.

   

5. Als het probleem blijft bestaan, maak dan een HAR-bestand aan en dien een supportticket in bij support@document360.io voor verder onderzoek.

Probleem bij het indienen van feedback op een artikel

Mogelijke oorzaken van dit probleem zijn beperkingen op het beveiligingsbeleid van inhoud, netwerk- of firewallproblemen, browserextensies, cachingconflicten of tijdelijke serverproblemen. Deze factoren kunnen het indienen van feedback blokkeren of acties zoals liken, niet leuk vinden of reageren op een artikel voorkomen.

Stappen om op te lossen:

1. Controleer of je het artikel kunt liken of niet .

2. Zorg ervoor dat je opmerkingen kunt invoeren in het feedbacktekstgedeelte.

3. Probeer op de Verzendknop te klikken om te zien of de feedback is vastgelegd.

4. Bepaal of het onderwerp voor één artikel of voor alle artikelen voorkomt.
   

   Controleer op fouten:

5. Open de ontwikkelaarsconsole van de browser (Rechtsklik > Inspecteren > tabblad Console).

6. Let op eventuele consolefouten die verband houden met het Content Security Policy (CSP).

7. Maak een screenshot van het foutbericht.

8. Open het tabblad Netwerk in de ontwikkelaarstools van de browser.

9. Reproduceer het probleem en exporteer het netwerklogboek als een HAR-bestand.

10. Als het probleem zich blijft voordoen na het volgen van deze stappen, neem dan contact op met het Document360-ondersteuningsteam voor verdere hulp: Neem contact op met Document360 Support

11. Geef de volgende gegevens:

    • Screenshots van consolefouten

    • HAR-bestand met netwerklogs

    • Schermopname van het nummer

Aangepaste code aanpassen voor het Single Page Application (SPA)-model in Document360

Met de overgang van de Document360-website naar een Single Page Application (SPA)-model kan elke aangepaste JavaScript die afhankelijk is van paginaverversingsgebeurtenissen niet langer functioneren zoals verwacht. Dit komt doordat SPA's alleen de inhoud van het artikel verversen, niet de hele pagina.

Hieronder staan de gebieden waar gebruikers aangepaste JavaScript kunnen injecteren binnen het Document360-portaal:

1. Aangepaste JavaScript

   1. Navigeer naar () in de linker navigatiebalk in het Kennisbankportaal.

   2. Navigeer in het linker navigatiepaneel naar Knowledge base site > Site customization > Custom CSS & JavaScript.

2. Aangepaste HTML-integraties

   1. Navigeer naar Connections () in de linker navigatiebalk en selecteer Integraties.

   2. Selecteer Aangepaste HTML in het dropdownmenu linksboven.

Aanbevolen oplossing

Om compatibiliteit met het SPA-model te waarborgen, werk je je aangepaste JavaScript bij om het articleload event te gebruiken. Dit event wordt geactiveerd wanneer de inhoud van het artikel wordt ververst, zodat je scripts naadloos werken in de nieuwe architectuur.

1. Vervang elke code die afhankelijk is van paginaverversingsevenementen door een abonnement op het articleload evenement.

2. Gebruik het volgende codefragment om je aangepaste scripts aan te passen:

   panel.addEventListener('articleload', function() {
     // Your custom JavaScript code here
   });

3. Test je bijgewerkte scripts om te bevestigen dat ze correct werken in de SPA-omgeving.

   Als het probleem zich blijft voordoen na het volgen van deze stappen, neem dan contact op met het Document360-ondersteuningsteam voor verdere hulp: Neem contact op met Document360 Support