User:Sent~metawiki/RandomPoll (nl)

From Meta, a Wikimedia project coordination wiki
 
A proposal to move this page to MediaWiki.org was rejected.

RandomPoll is als een extensie ontwikkeld voor gebruik in verschillende implementaties van MediaWiki. Dit maakt het mogelijk dat de website (op evt verschillende pagina's) een willekeurige poll kunnen bevatten.

RandomPoll heeft Poll nodig om te kunnen werken.

Gebruik RandomPoll[edit]

RandomPoll is een MediaWiki extentie. Om deze te gebruiken moet je de volgende HTML-achtige syntax opnemen in de pagina:

<RandomPoll>
...parameters...
</RandomPoll>

zandbak (voorbeeld maakt een overzicht van alle open (namespace) polls in de categorie Stellingen die gaan over [[Jan Peter Balkenende]] van de laatste 5 weken met één resultaat uitgedrukt in procenten):

<RandomPoll>
//Settings:
#REFOKE OFF
#STYLE {{Poll}}
#CLOSED

//Where Clause:
!CLOSED
DATE=BETWEEN NOW() AND NOW()-5W
NAMESPACE=Poll
CATEGORY=Stellingen
RESULT=AVERAGE PERCENT
+Explaination
+Question
SEARCH=[[Jan Peter Balkenende]]
AMOUNT=ALL
</RandomPoll>

Opmaak[edit]

Hier kunnen de parameters van Poll die beginnen met # worden opgegeven. Plus de parameter #EMPTY.

Let op: Je kan gesloten polls niet openen (CLOSED) én alleen maar de #REFOKE optie op OFF zetten. De parameters #RESULT en #ID worden genegeerd.

Dus effectief kun je hier alleen maar het volgende doen, of het laten aan de eigenschappen van de poll zelf:

#CLOSED
#REFOKE OFF
#STYLE {{mijn opmaak voor een poll}}
#EMPTY[[Geen Poll gevonden]]

EMPTY[edit]

Doel:

Het laden van een pagina, wanneer er geen random Poll gevonden kan worden volgens de condities. Het standaard resultaat - dus wanneer deze niet is gegeven - is dat het niks oplevert.

Voorbeeld:

#EMPTY[[Geen Poll gevonden]]

CLOSED[edit]

Doel:

Te zoeken naar het feit of de poll de mogelijkheid om nog te stemmen is ontnomen. M.a.w: zoeken naar gesloten of open polls.

Voorbeeld:

CLOSED
!CLOSED
NOT CLOSED

DATE[edit]

Doel:

Te zoeken naar een poll gemaakt binnen een definitie van tijd.

Voorbeeld (gemaakt op één bepaalde dag of maand of jaar of week):

DATE=x

Voorbeeld (gemaakt binnen een periode):

DATE=BETWEEN x AND y

x en y kan bestaan uit de volgende typen:

  • NOW()
  • YYYY
  • YYYY-MM
  • YYYY-MM-DD
  • YYYYxWW

Na NOW() kan ook nog de operator + of - worden toegevoegd, gevolgd door een geheel getal en een van de volgende periode-definities: Y, M, W, D.

NAMESPACE[edit]

Doel:

Definiëren in welk zoekgebied word gezocht. De mogelijke pollen die worden bekeken bestaan als individuele poll wanneer de standaard waarde is opgegeven. Standaard zoekt RandomPoll namelijk naar bestanden in de namespace Poll.

Voorbeeld:

NAMESPACE=Poll

CATEGORY[edit]

Doel:

Het afdwingen dat de betreffende poll onderdeel is van deze categorie.

Voorbeeld:

CATEGORY=Stellingen

RESULT[edit]

Voorbeeld:

RESULT=AVERAGE PERCENT

+Explaination[edit]

Doel:

Zorg dat de gevonden poll een Explaination heeft.

+Question[edit]

Doel:

Zorg dat de gevonden poll een Question heeft.

SEARCH[edit]

Doel:

Het afdwingen dat de Poll het betreffende steekwoord bevat. Hier van kunnen er meerdere van worden mee gegeven.

Voorbeeld:

SEARCH=[[Jan Peter Balkenende]]

AMOUNT[edit]

Doel:

Het bepalen hoeveel pollen er worden afgebeeld. Standaard staat het op 1, maar ieder geheel getal is mogelijk, evenals ALL.

Voorbeeld:

AMOUNT=ALL

Bron code[edit]

free2xs/RandomPoll.php


Installatie[edit]

  1. Upload de free2xs/RandomPoll.php naar de extensions.
  2. Voeg de lijn include("extensions/free2xs/RandomPoll.php"); toe aan het eind van jouw LocalSettings.php.
  3. Voeg de namespace Poll: toe.