SmartComments extensie

Wat is SmartComments?[bewerken]

De SmartComments extensie maakt het mogelijk om opmerkingen te maken en te reageren op opmerkingen op een wikipagina. Ook kunnen opmerkingen worden afgehandeld en verwijderd door beheerders. De functionaliteiten die deze extensie biedt zijn vergelijkbaar met de opmerkingen-functionaliteiten van Microsoft Word en ondersteunt zo het reviewproces van wikipagina's binnen de wiki.
Helaas werkt de SmartComments extensie niet op mobiele browsers, zoals op telefoons. Alternatieven zijn de overleg pagina, of een emailbericht naar de contactpersoon van de pagina.

Gemaakte opmerkingen zie je alleen als je daar zelf voor kiest[bewerken]

Iedereen die een gebruikersaccount aanmaakt kan in principe opmerkingen plaatsen en lezen. Maar je ziet ze niet zomaar staan als je noraonline bezoekt: Alleen als je inlogt met je gebruikersaccount van noraonline èn SmartComments inschakelt op een pagina kun je gemaakte opmerkingen lezen en je eigen opmerkingen plaatsen. Je wordt dus als lezer niet gestoord door opmerkingen van derden, maar op het moment dat je zelf commentaar achter wilt laten zie je wel wat anderen geschreven hebben en kun je daar op aanhaken.

SmartComments inschakelen[bewerken]

In de werkbalk zie je een grijze 'knop' met SmartComments:Uit. Klik hierop om opmerkingen te kunnen lezen en te plaatsen op deze pagina. Per pagina zul je SmartComments opnieuw aan moeten zetten.

NB: Alleen ingelogde bezoekers kunnen SmartComments aanzetten en je kunt het alleen gebruiken op gewone pagina's, niet op de geschiedenis, semantische eigenschappen et cetera.

Opmerkingen lezen[bewerken]

Als SmartComments eenmaal aanstaan zie je eerder gemaakte opmerkingen op twee manieren gemarkeerd:

Geel gemarkeerde woorden of zinnen in de tekst zelf
Een icoon in de rechterkantlijn op elke regel met comment(s)
Klik op een geel woord of een icoon in de kantlijn om de opmerking te openen, je kunt die nu rechts in beeld lezen en er op reageren als je dat wilt.

Het icoon in de kantlijn wordt groen wanneer er een reactie is geweest op een comment. Helemaal onderaan de pagina tref je soms een rood icoon in de kantlijn, dat betekent dat er een comment gemaakt is over een tekst of object dat niet meer op de pagina staat (een 'weescomment'). Alleen opmerkingen die niet gemarkeerd zijn als voltooid (afgehandeld) staan in de kantlijn aangegeven. Afgehandelde opmerkingen kunnen wel teruggevonden worden in het opmerkingenoverzicht.

Nieuwe opmerking plaatsen[bewerken]

Als je een opmerking wilt maken:

selecteer een woord of een enkele zin met je muiscursor, of klik op een afbeelding waar je iets over wilt zeggen. Er opent zich direct een popup-venster waarin je je opmerking kunt typen. Het geselecteerde woord of object zie je terug bovenin het venster.
type je opmerking en klik op opslaan of annuleer.

Je keert nu automatisch weer terug naar je pagina en kunt je opmerking direct terug zien op de pagina. Ben je niet helemaal tevreden over je opmerking, dan kun je die niet bewerken, maar wel verwijderen, van een reactie met extra toelichting voorzien of als afgehandeld markeren.

Opmerkingen afhandelen of ze bekijken in een overzicht[bewerken]

Als je een opmerking geopend hebt zie je in de balk aan de overkant drie puntjes. Klik hierop voor een aantal extra opties:

Opmerking verwijderen. Gebruik dit alleen om je eigen (foutieve) opmerking weg te halen. Beheerders mogen ook ongepaste opmerkingen verwijderen. De opmerking verdwijnt en kan op geen enkele manier meer teruggehaald worden.
Opmerking markeren als afgehandeld. De eigenaar, contactpersoon of beheerder van een pagina gebruiken dit om opmerkingen die niet meer relevant zijn niet langer te tonen op de pagina. Het betekent dat de inhoud al verwerkt is, bijvoorbeeld als het een suggestie of antwoord op een vraag inmiddels in de tekst is opgenomen. Of een suggestie juist is verworpen en de indiener daar al over geïnformeerd is. Afgehandelde opmerkingen kunnen via het overzicht van opmerkingen teruggevonden worden en als dat nodig is hersteld.
Paginaoverzicht bekijken: klik hier op om alle opmerkingen die op een pagina gemaakt zijn te bekijken (inclusief de afgehandelde). Je komt op de pagina Speciaal:SmartComments met als filter de pagina waar je staat.

Overzicht van opmerkingen gebruiken[bewerken]

Standaard krijg je met de link Speciaal:SmartComments alle opmerkingen van alle gebruikers over alle pagina's te zien. Heb je vanaf een comment doorgeklikt naar het overzicht dan is er al een filter op de pagina aangezet, dat je uiteraard ook weer kunt verwijderen. Gebruik de de filters bovenaan de tabel om opmerkingen op specifieke pagina's te bekijken, te filteren op status (afgehandeld of open), of op auteur (persoon die de opmerking heeft aangemaakt).

In de laatste kolom van de tabel zie je per SmartComment iconen staan. Het spraakwolkje brengt je naar de gemaakte opmerking, in de context van de pagina waarop die gemaakt is. Met het vinkje kun je een opmerking als afgehandeld markeren (al afgehandelde commentaren hebben geen vinkje maar een pijltje terug, waarmee je het weer als open markeert). En de prullenbak is om een commentaar te verwijderen - verwijder alleen je eigen commentaren. Ongepaste commentaren mag je uiteraard melden bij NORA Beheer, die de opmerkingen verwijdert en/of contact opneemt met de maker.

Krijg ik bericht als er commentaar is achtergelaten op mijn pagina?[bewerken]

Op het moment zijn er nog geen automatische notificaties mogelijk als er een commentaar wordt achtergelaten. Daarom hebben we als NORA Beheer de taak op ons genomen om het overzicht van commentaar regelmatig te checken en handmatig notificaties te versturen.

Je zult dus maximaal een week nadat het commentaar is achtergelaten (en meestal een stuk sneller) een berichtje krijgen dat er een commentaar is, met een link naar het comment en het overzicht van alle comments. Je krijgt geen notificatie als je zelf al gereageerd hebt op het comment, of wanneer je dat zo afspreekt (bijvoorbeeld wanneer je in een groep aan een pagina gaat werken en veel notificaties verwacht in een afgebakende periode waar je geen mail over wilt ontvangen).

Krijg ik bericht als iemand reageert op mijn commentaar?[bewerken]

Ook daar is geen automatische notificatie voor mogelijk. Het is aan de eigenaar van de pagina om te beoordelen of een reactie in de wiki afdoende is, of er verder contact met de maker nodig is. Wel proberen we in de notificatie aan de eigenaar van de pagina de maker van de opmerking in de cc te zetten (als die mailadres deelt op de profielpagina). Als er geen contactinformatie is opgegeven in de profielpagina kan de eigenaar ook via de wiki contact met je opnemen.

Bekende beperkingen[bewerken]

Het is alleen mogelijk om opmerkingen te plaatsen op tekst zonder regelafbrekingen. Dat betekent dat het op het moment niet mogelijk is om bijvoorbeeld een opmerking te plaatsen op een stuk tekst dat HTML-breaks bevat.
Een reactie zorgt voor een wijziging op de pagina zelf, maar deze wijziging zie je niet in de revisiegeschiedenis van de pagina.
Er is geen automatische notificatie mogelijk van nieuwe comments op een pagina, of reacties op jouw comments
Bestaande opmerkingen kunnen niet tekstueel worden aangepast, alleen op afgehandeld worden gezet of verwijderd.

Verdere beheertaken SmartComments[bewerken]

NORA Beheer checkt zoals gezegd het opmerkingenoverzicht op ongepaste opmerkingen en notificeert eigenaren van pagina's als er opmerkingen gemaakt worden. Daarnaast hebben ze nog een aantal beheerdersopties vanuit het overzicht:

Commentaar blokkeren: Uitzetten van commentaar voor de hele website (tijdelijk in noodgevallen). Er kunnen dan geen nieuwe opmerkingen geplaatst worden, of gereageerd worden op bestaande opmerkingen. We kunnen bestaande opmerkingen nog wel afhandelen of verwijderen.
Alle afgehandelde opmerkingen verwijderen: met deze knop kunnen alle opmerkingen die de status afgehandeld ("completed") hebben verwijderd worden. Als er veel comments achtergelaten worden gaan dit waarschijnlijk periodiek doen, bijvoorbeeld met de start van een nieuw kalenderjaar.
"Alle opmerkingen verwijderen": met deze knop kunnen alle opmerkingen op de wiki, ongeacht de status, verwijderd worden. Dit is een noodgreep die we niet verwachten te gebruiken.

Meer over de extensie SmartComments voor semantische mediawiki's[bewerken]

De extensie maakt onderscheid tussen twee verschillende soorten gebruikersgroepen: normale gebruikers en beheerders. Normale gebruikers hebben alleen de mogelijkheid om opmerkingen aan te maken en op bestaande opmerkingen te reageren. Beheerders kunnen opmerkingen afhandelen en heropenen, opmerkingen verwijderen, en de opmerkingenmodus voor iedereen aan- of uitzetten. De gebruikersgroep 'Beheerders' beschikt dus over de mogelijkheden die een inhoudelijk eigenaar van een wikipagina zou moeten hebben.

De extensie is open-source ontwikkeld door ArchiXL en te vinden via Extensie:SmartComments. De werking ervan is uitgelegd op deze pagina, naast het feit dat je als gebruiker mee kan helpen testen.

Video[bewerken]

Wil je een nog uitgebreidere uitleg, kijk dan de volgende video SmartComments op SMWCon Fall 2023.

Op deze pagina