User:Sent~metawiki/RandomPoll (nl)
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
- Upload de free2xs/RandomPoll.php naar de extensions.
- Voeg de lijn
include("extensions/free2xs/RandomPoll.php");
toe aan het eind van jouwLocalSettings.php
. - Voeg de namespace Poll: toe.