Football Pool

Beschrijving

Deze plugin voegt een fantasy sport pool toe aan je blog. Bezoekers van je website kunnen de uitslag van wedstrijden voorspellen en extra punten verdienen met bonusvragen. Elke speler kan de scores en grafieken van de andere deelnemers bekijken.

De plugin installeert een aantal aangepaste tabellen in de database en bevat wedstrijdinformatie voor het UEFA kampioenschap van 2024, maar kan eenvoudig worden geüpdatet met wedstrijdinformatie voor andere kampioenschappen of sporten. Let op: het deactiveren van de plugin kan alle plugin gegevens uit je database verwijderen. Om dit te voorkomen, moet je ervoor zorgen dat de optie “Gegevens behouden bij verwijderen” is ingeschakeld in de instellingen (standaard sinds versie 2.3.1).

Ik heb dit pool oorspronkelijk in PHP gecodeerd als een zelfstandige site voor het UEFA 2000-kampioenschap en het meerdere keren herschreven voor elk Europees kampioenschap en Wereldkampioenschap sindsdien. Ik bleef elk jaar functies toevoegen. In 2012 heb ik het omgezet in een WordPress plugin en geüpload naar de plugin directory. Ik hoop dat je ervan geniet.

Wij willen iedereen die een donatie heeft gedaan, heeft geholpen met vertalen, bugs heeft gemeld of op een andere manier heeft bijgedragen aan de verbetering van de plugin, speciaal bedanken!

Kenmerken

  • Spelers kunnen wedstrijduitslagen voorspellen.
  • Automatische berekening van de poolranglijst, of definieer een aangepaste ranglijst voor een groep wedstrijden.
  • Je kan bonusvragen gebruiken voor extra plezier en uitdaging (enkele antwoorden en meerkeuze).
  • Voeg je eigen teams en wedstrijdgegevens voor andere competities toe.
  • Importeer of exporteer wedstrijdschema’s.
  • Automatisch kampioenschap standen berekenen.
  • Flexibele score opties.
  • Ingebouwde pagina’s en shortcodes om de pool op je blog weer te geven.
  • Optionele gebruiker competities.
  • Scoregrafieken met de voortgang en vergelijkingen van spelers (hiervoor is een aparte download van de Highcharts API vereist).
  • Widgets en shortcodes om wedstrijd- en poolinformatie weer te geven.
  • Extra infopagina’s voor stadions of teams.
  • Voeg aangepaste functionaliteit toe met filters en acties.
  • WP-CLI. ondersteuning voor rangschikking berekeningen (sneller dan berekeningen aan de beheer kant).
  • WP-CLI ondersteuning voor het importeren van wedstrijdresultaten uit een CSV bestand.

Documentatie

De plugin bevat een gedetailleerd hulpbestand in het beheerpaneel. Voor een stapsgewijze handleiding, bekijk de handleiding van Janek van WP Simple Hacks. Hij heeft zelfs een video gemaakt waarin hij uitlegt hoe je de plugin installeert.

Overige opmerkingen

  • Vereist WordPress 5.3+, PHP 7.4+ en jQuery 1.4.3+.
  • Voor grafieken, download de Highcharts API (zie de installatie-instructies of de help pagina in het beheer).

Als je bugs vindt, kun je deze melden in het ondersteuningsforum. Als je de plugin goed vindt, stellen we een waardering op WordPress.org zeer op prijs!

Vertalingen

Als je de plugin wilt helpen vertalen naar een andere taal of bestaande vertalingen up-to-date wilt houden, ga dan naar de plugin pagina op translate.wordpress.org.

Lees vooral de gids Na je bijdrage om te begrijpen hoe vertalingen worden beoordeeld en goedgekeurd.

Een grote shout-out naar alle vertaling bijdragers en redacteuren die tot nu toe hebben geholpen — bedankt!

Raadpleeg de FAQ sectie voor het gebruik van aangepaste vertalingen. De plugin bevat ook een .pot bestand als startpunt voor het maken van je eigen vertaalbestanden.

Shortcodes

De plugin biedt de volgende shortcodes. Raadpleeg de hulp pagina in de WordPress beheer voor gedetailleerde gebruiksinstructies.

  • fp-predictions
  • fp-predictionform
  • fp-matches
  • fp-match-scores
  • fp-question-scores
  • fp-next-matches
  • fp-last-matches
  • fp-user-score
  • fp-user-ranking
  • fp-ranking
  • fp-countdown
  • fp-group
  • fp-link
  • fp-register
  • fp-totopoints
  • fp-fullpoints
  • fp-goalpoints
  • fp-diffpoints
  • fp-jokermultiplier
  • fp-plugin-option
  • fp-league-info
  • fp-chart-settings / fp-stats-settings
  • fp-user-list
  • fp-money-in-the-pot
  • fp-last-calc-date
  • fp-next-match-form

Incompatibele plugins & thema’s

De volgende plugins zijn gerapporteerd als incompatibel met Football Pool. Als je de auteur bent en een oplossing heeft, of als je een tijdelijke oplossing kent, neem dan contact met ons op.

Als je problemen ondervindt met een andere plugin die hier niet wordt vermeld, laat het mij dan weten, zodat ik het kan onderzoeken.

De meeste caching oplossingen moeten zorgvuldig worden getest.

  • DB Cache Reloaded Fix (v2.3)
  • Cimy User Extra Fields (v2.6.1) bij gebruik van de e-mail bevestigingsfunctie
  • Easy Timer (in Football Pool versies 2.3.8 en lager)
  • Theme Gadgetry (ThemeFuse framework)
  • memcached

Sommige thema’s kunnen ook de weergave van de plugin verstoren. Zie dit forumbericht voor een mogelijke oplossing.

Schermafbeeldingen

  • Voorspel wedstrijden via een formulier op je WordPress site
  • Scoregrafieken waarin meerdere spelers worden vergeleken
  • Wedstrijdvoorspellingen en scores per gebruiker
  • Overzicht groepsranglijsten
  • Algemene gebruikersrangschikking
  • Football Pool wordt geleverd met verschillende handige widgets
  • Beheerscherm: plugin opties
  • Beheer scherm: bewerk wedstrijdresultaten
  • Beheerscherm: shortcode invoegen met de klassieke editor

Installatie

Als je een aangepaste vertaling wil gebruiken, raadpleeg dan de FAQ voor meer informatie.

  1. Upload football-pool.zip via het plugin paneel, of pak uit en upload de football-pool map naar je /wp-content/plugins/ folder.
  2. Activeer de plugin in het plugin paneel.
  3. Configureer de plugin via het beheermenu.
  4. Optioneel: voeg pool pagina’s toe aan je menu of koppel ze handmatig.
  5. Optioneel: Voeg Football Pool widgets toe aan je zijbalk.
  6. Optioneel: voeg bonusvragen toe.
  7. Optioneel: upgrade bestaande site gebruikers naar pool spelers.
  8. Om de grafiekfunctie te gebruiken, download de Highcharts API en plaats het highcharts.js bestand in /wp-content/plugins/highcharts-js/highcharts.js. Gebruik het klassieke JS-bestand met styling. Als je de versie zonder thema gebruikt, voeg dan de Highcharts CSS toe in je thema.

Zodra alles is ingesteld, hoeft u alleen nog maar de aanmeldingen van gebruikers in de gaten te houden en de wedstrijdscores en antwoorden op bonusvragen te updaten.

FAQ

Wauw, er zijn veel opties. Moet ik die allemaal aanpassen?

Dat kan, maar het is niet vereist. De plugin werkt prima met de standaardinstellingen. Voel je vrij om de opties te verkennen en aan te passen voordat je met je pool aan de slag gaat.

De scoreberekening toont een verwachte tijd van enkele uren. Waarom?

De tijd schatting is gebaseerd op de tijd die een enkele berekening stap in beslag neemt, vermenigvuldigd met het totale aantal resterende stappen. Als de eerste stappen langzamer zijn (vooral als de stapgroottes groot zijn ingesteld in wp-config.php), kan de initiële schatting veel te lang lijken.

Of… je hebt misschien gewoon een enorme database met heel veel gebruikers, matches en rankings. In dat geval zou de schatting wel eens nauwkeurig kunnen zijn. Ter referentie: met 2000 gebruikers, 50 matches, een paar bonusvragen en 3 aangepaste rankings duurde een volledige berekening ongeveer 45 minuten op mijn laptop (met standaard stapgroottes). Dezelfde taak uitvoeren via WP-CLI duurde minder dan 10 minuten.

Heb je een thema dat ik kan gebruiken met de plugin?

Nee. Ik ben een ontwikkelaar, geen ontwerper — dus ik heb geen thema gemaakt.

Ik heb de plugin geïnstalleerd, maar er zijn geen wedstrijden. Wat is er gebeurd?

Sinds versie 2.0.0 worden matches niet meer automatisch toegevoegd. Er is wel een voorbeeldschema (CSV-bestand) bij de plugin inbegrepen. Ga naar de wedstrijden beheer pagina en gebruik de optie ‘Importeer wedstrijdschema’ om het te laden.

Heb ik de “Voorspellingen” pagina nodig?

Technisch gezien wel. De plugin gebruikt deze pagina om gebruikersvoorspellingen weer te geven. Verwijder hem dus niet. Wil je hem echter niet in het menu van je site, verwijder hem dan gewoon via Weergave » Menu’s.

Sommige thema’s voegen automatisch alle hoofdpagina’s toe aan het menu. Raadpleeg de documentatie van je thema om te zien hoe je pagina’s kunt uitsluiten of een aangepast menu kunt maken.

Ik wil de plugin gebruiken voor een nationale competitie. Is dat mogelijk?

Absoluut. Je hebt twee opties:

  1. Upload een wedstrijdschema CSV in het beheer. Je vindt een voorbeeld in /data/schedules in de plugin map.
  2. Gebruik de beheer schermen om handmatig alle teams, groepen, wedstrijdtypes en wedstrijden toe te voegen.

Overweeg ook om een thema te gebruiken dat bij je competitie past, of pas er zelf een aan.

De grafieken zijn weg! Wat is er gebeurd?

Vanwege de WordPress plugin licentie regels moest de vereiste grafiek bibliotheek verwijderd worden. Als je de grafieken terug wilt, controleer de Hulppagina in het beheer voor hoe je de vereiste bibliotheek handmatig kunt installeren.

Zorg er ook voor dat je de ‘eenvoudige berekeningsmethode’ niet hebt ingeschakeld in de plugin instellingen. Die modus slaat historische gegevens over. Het is sneller, maar grafieken werken dan niet.

Ik zie mijn sitegebruikers niet als spelers in de pool.

Ga naar WordPress Beheer » Football Pool» Gebruikers en controleer of deze gebruikers aan een competitie zijn toegewezen (als je competities gebruikt). Nieuwe gebruikers worden automatisch toegevoegd, maar bestaande gebruikers moeten handmatig worden toegevoegd.

Om iemand tot speler te maken: wijs hem of haar toe aan een competitie en sla het op. Als je een competitie verwijdert, moet je de gebruikers opnieuw toewijzen. Gebruik je geen competities? Controleer dan of er nog geen gebruikers uit de pool zijn verwijderd via het scherm Gebruikers.

Is er een vertaling beschikbaar?

Ja! Bekijk deze pagina voor beschikbare taalpakketten.

Om je eigen vertaling te maken:

  • Bezoek translate.wordpress.org
  • Of gebruik een tool als Poedit
  • Upload je vertaling naar de site en neem contact op met een PTE om deze goed te keuren
  • Of meld je aan om zelf een PTE te worden

Raadpleeg de Eerste stappen gids voor meer informatie.

Om een aangepaste vertaling te gebruiken, plaats je je vertaalbestanden in wp-content/uploads/football-pool/languages en gebruikt u deze extensie plugin om ze te laden.

De standaard inhoud voor de regelspagina wordt opgeslagen in rules-page-content-*locale*.txt (bijv. rules-page-content-nl_NL.txt) — dit wordt niet beheerd door het Polyglot-systeem. Als je het vertaalt en naar mij stuurt, voeg ik het toe aan de plugin (uiteraard met bronvermelding).

Ik heb de plugin geïnstalleerd, maar het lijkt niet op je schermafbeeldingen.

Dat is te verwachten. De plugin bevat basis lay-out stijlen, maar verandert niet de hele look van je site. Je moet de stijlen zelf aanpassen om alles bij je ontwerp te laten passen.

Gebruik de CSS van je thema of een aangepaste CSS plugin om stijlen te overschrijven. Bewerk de CSS bestanden van de plugin niet rechtstreeks; je wijzigingen gaan verloren wanneer je de plugin update.

Beoordelingen

11 augustus 2024
“This plugin sounds like an incredible addition for any sports fan running a blog! The ability to create a fantasy sports pool where visitors can predict outcomes and track their progress adds a fun, interactive element to your site. It reminds me of how a pool builder customizes each project to fit the client’s needs—this plugin does the same by allowing users to tailor it for different sports and championships. Kudos to the developer for continually updating and enhancing the plugin over the years. The attention to detail, from custom rankings to user charts, really shows the passion behind this project. If anyone’s using this plugin, I’d love to hear how it’s working for you!”
23 juli 2024
Lo use en toda America para la COPA AMERICA 2024 y estuvo genial
20 juni 2024
Great plugin! Fun to play with friends and see who gets the most results right. the creator AntoineH always available on the blog for consultations and/or additional plugins to do specific things. Excellent.
24 november 2023 1 reactie
Its a nice plugin but I have an issue. The team flags are too large and out of place when viewed in the matches page.. pls how to do I fix this
13 mei 2023
Great plugin with a lof of features for match predictions. The creator is also very helpful for his users.
Lees alle 82 beoordelingen

Bijdragers & ontwikkelaars

“Football Pool” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

“Football Pool” is vertaald in 13 localen. Dank voor de vertalers voor hun bijdragen.

Vertaal “Football Pool” in je eigen taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

2.13.1

  • Bugfix: Oplossing voor XSS kwetsbaarheid (alleen beheerinterface).

2.13.0

  • Nieuw: optie toegevoegd om wedstrijden te bewerken in je lokale tijdzone (op basis van je WP-instelling).
  • Nieuw: ondersteuning toegevoegd voor een nieuwe meta header voor de CSV om een tijdzone-offset te definiëren voor de tijden in het bestand. Dit maakt het mogelijk om bestanden in een andere/lokale tijd te importeren en dienovereenkomstig aan te passen.
  • Update: de minimaal vereiste WP versie gewijzigd naar 5.3.
  • Update: wijzigingen aangebracht in de JavaScript functie van de shortcode voor aftellen. Als je dit in je eigen code gebruikt, zorg er dan voor dat je de start van het aftellen wijzigt door de argumenten als een object door te geven.
  • Verbetering: er zijn enkele wijzigingen aangebracht in de datum verwerking in sommige delen van de plugin.
  • Verbetering: enkele weergaveproblemen in het shortcode MCE dialoogvenster opgelost en titels aan de labels toegevoegd.
  • Bugfix: de XSS preventie in alle shortcode functies is strenger gemaakt.

2.12.6

  • Tweak: wat refactoring van de widget klassen.
  • Bugfix: de activeer functie genereert een “Uncaught TypeError” bij activering via WP CLI.
  • Bugfix: XSS kwetsbaarheid in sommige shortcode functies opgelost.

2.12.5

  • Tweak: enkele updates aan de help pagina.
  • Bugfix: Oplossing voor XSS kwetsbaarheid (alleen beheerinterface).

2.12.4

  • Bugfix: vertaal strings binnen klassen verplaatst om te voorkomen dat het tekst domein te vroeg wordt geladen.

2.12.3

  • Bugfix: oplossing voor CSRF kwetsbaarheid.

2.12.2

  • Bugfix: sommige delen van de code zetten de league niet om naar int bij het doorgeven aan de get_pool_ranking_limited() functie. Bedankt aan Colin voor het rapporteren.

2.12.1

  • Bugfix: per ongeluk tags rond de titel van de widgets verwijderd. Dit is teruggezet. Bedankt aan @spaniole voor het melden.

2.12.0

  • Nieuw: het doelsaldo bonus heeft nu een instelling die bepaalt op welke scores de bonus van toepassing is (bestaande installaties blijven de oude regels gebruiken totdat je de instelling wijzigt).
  • Nieuw: de voorspellingen weergave op de statistieken pagina heeft nu enkele extra CSS klassen op de tabel rij om te laten zien hoe de score is opgebouwd (bijv. toto score plus doelpunten bonus).
  • Nieuw: een print stylesheet toegevoegd voor de audit log om wat rommel van de print van de pagina te verwijderen.
  • Nieuw: extra optie om het weergeven van het beheerder antwoord voor gesloten bonusvragen op het voorspellingsformulier in of uit te schakelen.
  • Nieuw: optie toegevoegd om een e-mail melding te versturen wanneer een nieuw shoutbox bericht is opgeslagen. Gebruikt de standaard wp_mail()-functie.
  • Update: het maximale aantal tekens voor de shoutbox berichten is gewijzigd naar 65.535 (maar de standaardinstelling is nog steeds maximaal 150 tekens).
  • Update: wanneer het opslaan van een bericht in de shoutbox mislukt, wordt er een bericht voor de gebruiker weergegeven en blijft de tekst in het invoerveld staan, zodat de gebruiker het opnieuw kan proberen.
  • Update: ook de today CSS klasse toegevoegd aan de weergave van wedstrijden.
  • Aanpassing: wat opruimen in de widget klassen.
  • Verbetering: enkele waarschuwingen over veroudering opgelost (explode(): Null doorgeven aan parameter #2).
  • Verbetering: Enkele wp_doing_cron() controles toegevoegd.
  • Tweak: wat code herformattering.
  • Bugfix: In zeldzame gevallen werd de eerste grafiek voor de statistieken pagina gedefinieerd als een lijndiagram, terwijl het een kolom diagram had moeten zijn. Dank aan @pekos voor het melden van de bug.
  • Bugfix: XSS kwetsbaarheid in de bonus vragen beheeromgeving verwijderd.
  • Bugfix: er is een XSS kwetsbaarheid verwijderd van de teams pagina en de wedstrijden pagina.

2.11.10

  • Bugfix: XSS kwetsbaarheid in de bonus vragen beheeromgeving verwijderd.

2.11.9

  • Update: het speelschema voor het Copa América 2024 kampioenschap is toegevoegd.
  • Bugfix: verwijderd een bug in de CSV importeerfunctie.

2.11.8

  • Bugfix: enkele PHP8 taalconstructies verwijderd die een kritieke fout veroorzaakten bij PHP7 installaties. Dank aan @batigol09 en @ryan944 voor het melden.

2.11.7

  • Update: ook de beheerdersrollen van de voetbalpool (voetbal pool beheerder, wedstrijd redacteur en vragen redacteur) krijgen de WP toolbar te zien wanneer ze zijn ingelogd. Gebruikers kunnen hun persoonlijke voorkeuren (tonen of verbergen) in hun profiel instellen.
  • Update: er zijn een aantal extra klassen toegevoegd aan de wedstrijdkaarten op het voorspellingsformulier: no-prediction voor wedstrijden zonder voorspelling, today voor wedstrijden die op de huidige dag plaatsvinden.
  • Bugfix: opgelost: een “Undefined index” bericht in het CLI-commando voor het aanmaken van testgebruikers wanneer er geen overeenkomsten zijn.

2.11.6

  • Update: de locaties voor de laatste ronden in het speelschema van het UEFA EURO 2024 kampioenschap zijn vastgelegd.

2.11.5

  • Update: het speelschema voor het UEFA EURO 2024 kampioenschap is toegevoegd.
  • Bugfix: shortcode [fp-countdown] wordt nu netjes afgesloten wanneer deze is ingesteld om af te tellen naar een match, maar er wordt geen eerste of volgende match gevonden. Bedankt Frans Jansen voor het melden van deze fout.

2.11.4

  • Nieuw: [fp-next-match-form] shortcode om alleen een formulier van de volgende wedstrijd(en) weer te geven.
  • Verbetering: kleine wijziging in de CLI methode voor testgegevens.
  • Verbetering: de jQuery-versie voor het TinyMCE dialoogvenster is verhoogd naar 3.7.1.
  • Bugfix: XSS kwetsbaarheid verwijderd uit enkele shortcodes (lage prioriteit).

2.11.3

  • Update: beheer icoon verwijderd uit plugin assets en SVG base64 URI toegevoegd in menu definitie.
  • Tweak: verwijderd verouderde waarschuwing voor dynamische eigenschap in Football_Pool_Pool klasse.
  • Aanpassing: wat refactoring van code.
  • Verbetering: stop het laden van de plugin wanneer je cron acties uitvoert (alleen nodig als ik ooit besluit om cron acties toe te voegen).
  • Bugfix: in sommige edge cases kon de instelling “Oplossing onvolledige voorspellingen” ervoor zorgen dat punten werden toegekend wanneer beide scores voor een wedstrijd ontbreken. Bedankt fimo66 en Markus Höcker voor het rapporteren van de bug.

2.11.2

  • Aanpassing: wat refactoring van code.
  • Update: vereiste PHP versie gewijzigd naar 7.4.
  • Bugfix: league dropdown in de gebruikersbeheer veroorzaakte een fatale fout in bepaalde gevallen. Bedankt Ron Robinson voor het melden van het probleem.

2.11.1

  • Bugfix: fp-matches veroorzaakte een fatale fout bij lege parameters. Bedankt @wongjowo voor het melden van het probleem.

2.11.0

  • Nieuw: audit log in het beheer voor de beheerder om alle opslagen te bekijken die gebruikers in hun voorspellingen hebben gedaan.
  • Nieuw: cache groep toegevoegd aan WP object cache aanroepen, zodat deze kan worden uitgesloten van persistente cache plugins.
  • Nieuw: optie om een nul waarde voor een onvolledige voorspelling (bijv. alleen de thuisscore ingevoerd) als geldig te beschouwen en de ontbrekende waarde standaard op 0 in te stellen.
  • Nieuw: shortcode [fp-last-matches] die de laatst gestarte wedstrijden toont voor een bepaalde datum. Vergelijkbare parameters als [fp-next-matches].
  • Nieuw: parameters toegevoegd aan de [fp-user-list] om de output te beperken met de ‘num’ parameter en om alleen de nieuwste registraties weer te geven (gebaseerd op en gerangschikt door het WP_User’s user_registered veld) met de ‘latest’ parameter.
  • Nieuw: parameter ‘favoriet team’ toegevoegd aan teams. Deze parameter wordt gebruikt om een extra CSS klasse toe te voegen aan matches.
  • Update: AJAX opslag op de front-end is nu standaard uitgeschakeld. Ik heb dit ingesteld als een instelling in het optiescherm (maar het kan ook nog steeds worden gewijzigd via de constante FOOTBALLPOOL_FRONTEND_AJAX in wp-config).
  • Update: vereiste PHP versie gewijzigd naar 7.3.
  • Update: verwijderd verouderde code voor het laden van aangepaste MO-bestanden. Dit moet gedaan worden via de ‘override_load_textdomain’ filter. Zie FAQ voor meer info.
  • Update: league ID verwijderd uit de sortering van de ranglijst.
  • Tweak: Verschillende beheer schermoptie ‘items per pagina’ instellingen toegevoegd voor bonusvragen en gebruikersantwoorden.
  • Verbetering: de oude wp_enqueue_media-controle voor WP-versies lager dan 3.5 is verwijderd (dit is niet langer nodig).
  • Verbetering: enkele verouderde waarschuwingen opgelost (getest in PHP 8.1).
  • Verbetering: toast op het voorspellingsformulier heeft nu een standaard z-index van 10.
  • Aanpassing: kleine wijzigingen in de CSS van de bonusvraag.
  • Bugfix: de countdown shortcode voor de eerste match verwijderde één element uit de matches array, wat problemen veroorzaakte voor andere elementen in de plugin die dezelfde array referentie gebruiken. Bedankt @angelo079 voor het melden en @shuhads voor je hulp bij het oplossen hiervan.
  • Bugfix: dubbele berekening knoppen verwijderd bij het in één keer verwijderen van meerdere match typen.
  • Bugfix: opgelost de Bonus vraag cirkeldiagram. Bedankt @fimo66 voor het rapporteren van het probleem.

earlier versions

  • De volledige changelog kun je hier vinden.