User:Sent~metawiki/RandomPoll (nl)

 
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.