Kommentointityökalu

Opasnet Suomista
Versio hetkellä 21. kesäkuuta 2014 kello 10.07 – tehnyt Jouni (keskustelu | muokkaukset) (→‎Perustelut: päivitetty mallineen mukaiseksi)
Siirry navigaatioon Siirry hakuun




Kysymys

Millainen on kommentointityökalu, joka

  • toimii osana Opasnetiä,
  • on avointa lähdekoodia,
  • kommentteja voidaan hallinnoida riippumatta ulkopuolisista palveluista?

Vastaus

Kommentointityökalu tallentaa käyttäjien antamia kommentteja tietokantaan. Tallennettava taulu on tämän näköinen, ja jokainen kommentti tallennetaan omalle rivilleen.

Kommentit
Obs Aika Kommentti Liittymä Result
Juokseva numero Kommentin tallennusaika Kommentin sisältö Jos kommentti liittyy toiseen kommenttiin tai asiaan sivulla, kommentin numero tai asian nimi tai kuvailu Tekninen sarake, jota ei tällä hetkellä käytetä.

Kommentteja voi myös poistaa näkyvistä. Tietokannasta ei kuitenkaan poisteta tietoa, vaan tällaiseen tauluun laitetaan kommentille poistomerkintä.

Kommenttipoistot
Kommenttinro Syy Result
Kommentin numero Obs-sarakkeesta Poistamisen syy. Käyttöliittymässä on tarjottuna pudotusvalikossa olennaiset syyt. Tekninen sarake
Ohjeita kommentointityökalun käyttöönottoon
  • Sijoita työkalu kakkostason väliotsikon "Kommentoi kirjautumatta" alle.
  • Kommentointityökalu pitää alustaa kopioimalla alla oleva koodi kyseiselle sivulle. Esikatsele sivu, jolloin alustuskoodi ajetaan automaattisesti. Sivua ei tarvitse tallentaa tässä vaiheessa.
<rcode live=1 variables="
	name:pagename|type:hidden|default:'{{PAGENAME}}'|
	name:ident|type:hidden|default:'Op_fi{{PAGEID}}'
">

library(OpasnetUtils)

dat1 <- data.frame(
	Obs = 1, 
	Aika = date(), 
	Kommentti = paste("Alustettu sivu", pagename, ident), 
	Liittymä = 0, 
	Result = 1
)

opbase.upload(dat1, ident = ident, name = pagename, subset = "Kommentit", act_type = "replace", 
	language = "fin", who = wiki_username)

dat2 <- data.frame(Kommenttinro = 0, Syy = "Alustus", Result = 1)

opbase.upload(dat2, ident = ident, name = pagename, subset = "Kommenttipoistot", act_type = "replace", language = "fin",
	who = wiki_username)

cat("Alustus onnistui.\n")
</rcode>

Kun saat ilmoituksen alustuksen onnistumisesta, voit poistaa alustuskoodin sivulta ja kopioida varsinaisen mallineen:

{{kommentointityökalu}}

Mallineelle voi antaa kaksi parametria, mutta yleensä näitä ei tarvita.

  • Voit laittaa sivutunnisteen ensimmäiseksi parametriksi, mutta tätä tarvitaan vain poikkeustapauksissa, jos kommentit halutaan tallentaa jonkin muun sivun kuin oman sivun kohdalle. Sivutunniste on muotoa Op_fi1234.
  • Jos kakkoskysymys eli liittymä toiseen kommenttiin halutaan piilottaa, pitää toiseksi parametriksi laittaa hidden.

Ota uudestaan esikatselu ja varmista, että malline toimii oikein ja että se löytää yhden kommentin, jonka sisältö on "Alustettu sivu X", jossa X on sinun sivusi nimi.

{{kommentointityökalu|Op_fiXXXX|hidden}}

Perustelut

Vastauksessa on tuontantokäytössä oleva työkalu. Perusteluissa on kehitysvaiheen malli.


Voit kommentoida sisältöä myös kirjautumatta Opasnetiin yksinkertaisesti kirjoittamalla kommenttisi alla olevaan kenttään. Sivun moderaattori siirtää kommenttisi asiasisällön osaksi sivun tekstiä ja siirtää kommentin sitten arkistoon: {{#opasnet_base_link:Op_fi4224}} .

Kommenttisi tämän sivun sisältöön tai keskusteluun:

Mihin sivun kohtaan kommenttisi liittyy?:

Tämänhetkiset kommentit, jota ei ole vielä sisällytetty sivulle tai keskustelusivulle.

Jos haluat löytää tällä sivulla aiemmin olleen kommentin, mene sivulle Kommenttihaku ja anna kommentin tunnistelinkki.

Poistettavat kommentit (varsinaiseen tekstiin siirretyt)

Poistettavan kommentin Obs-numero:

Poiston syy:

Katso myös