Football Pool

Descripción

This plugin adds a fantasy sports pool to your blog. Visitors of your website can predict outcomes of matches and earn extra points with bonus questions. Every player can view scores and charts of the other pool contenders.

Este plugin instala algunas tablas personalizadas en la base de datos y lleva información de partidos para al copa del mundo FIFA 2022, pero se puede rellenar fácilmente con la información de partidos para otros campeonatos o deportes. Por favor, ten en cuenta que al desactivar este plugin también pueden borrarse todos los datos del plugin de la base de datos, por lo que, por favor, asegúrate de que está activada la opción «Mantener los datos al desinstalar» en la página de ajustes si no quieres perder tus datos (está activado por defecto desde la versión 2.3.1).

Originalmente programé esta quiniela en PHP como una web independiente para el campeonato UEFA 2000 y, desde entonces, volví a escribirlo varias veces para cada campeonato europeo y la copa del mundo. Cada año le añadía nuevas características. En 2012 decidí volver a escribirlo como un plugin para WordPress y lo subí al directorio de plugins. Espero que te guste.

¡Un agradecimiento especial a todos los usuarios del plugin que han donado algo de dinero! Y también a los traductores que han encontrado tiempo para traducir las muchas etiquetas de este plugin. Y gracias a todos los usuarios que han informado de fallos y ayudado a mejorar el plugin.

Características

  • Los usuarios pueden predecir el resultado de los partidos.
  • Cálculo automático para la clasificación de la quiniela o define tu propia clasificación personalizada para un grupo de partidos.
  • Puedes añadir preguntas de bonificación para más diversión (respuesta simple o elección múltiple).
  • Añade tu propio información de equipos y partido para usar el plugin en otra competición (nacional).
  • Importar o exportar la programación de los partidos.
  • Cálculo automático para la clasificación del torneo.
  • Opciones configurables para los marcadores.
  • Usa las páginas integradas y/o shortcodes para añadir la quiniela a tu blog.
  • Usa ligas diferentes para tus usuarios (opcional).
  • Los usuarios tienen gráficos donde sus puntuaciones son representadas a través del tiempo y pueden compararse con otros jugadores. (Solo está disponible si se descarga por separado la API de gráficos Highcharts. Mira la ayuda para más detalles).
  • Muchos widgets y shortcodes para mostrar información del campeonato o de la quiniela.
  • Páginas de información adicional para estadios y equipos.
  • Add your own functionality via filters and actions (see help page in the admin or this post in the forum for some examples).
  • WP-CLI support for calculating the user ranking (much faster than a calculation via the admin).
  • WP-CLI support for importing match results via a csv file.

Documentation
The plugin has a help file in the admin that contains a lot of information. But if you like a step by step tutorial, I can recommend the following: Janek from WP Simple Hacks website made a very nice guide about my plugin. It even has a video where he explains how to set up the plugin.

Otras cosas

  • This plugin requires WordPress 4.8 or higher, PHP 7.4 or higher and jQuery 1.4.3 or higher.
  • If you want to use the charts feature, please download the Highcharts API (see «Installation» or the plugin’s Help page in the WordPress admin for details).

If you find bugs, please contact me via the support forum. If you like the plugin, please rate it on the plugin page on WordPress.org.

Localizaciones

If someone wants to help translate the plugin in another language, or help keeping the existing translations up-to-date, please visit the plugin’s page on translate.wordpress.org. Please read the information on the website carefully if you want your translation work to be reviewed and approved: After your contribution.

A big shout-out to all the translation contributors and editors that helped translating the plugin so far. Thank you!

The FAQ contains information on how to use a custom translation. I will keep including the pot language file in the plugin as a starting point for custom translations.

Accesos Directos

El plugin tiene los siguientes shortcodes. Mira la página de ayuda en la administración para información adicional.

  • 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

Plugins y temas incompatibles

Los siguientes plugins se han reportado como incompatibles con el plugin Football Pool. Si tienes una solución y/o eres el autor del plugin puedes contactarme en wordpressfootballpool [at] gmail [dot] com. Si tienes problemas con otro plugin que no está en la lista, por favor házmelo saber.

Basically, every caching solution should be tested with care.

  • DB Cache Reloaded Fix (v2.3)
  • Cimy User Extra Fields (v2.6.1) cuando se usa la opción de confirmación por correo electrónico.
  • Easy Timer (para football pool versión 2.3.8 e inferior)
  • Tema Gadgetry (ThemeFuse framework)
  • memcached

Algunos temas evitan que el plugin muestre su contenido. Mira esta entrada en el foro para tener una idea de como resolverlo.

Capturas

  • Predict matches via a form in your WordPress site
  • Gráficas de marcadores para múltiples jugadores
  • Match predictions and scores per user
  • Clasificaciones de grupo
  • User ranking
  • Football Pool is packed with several widgets
  • Admin Screen: plugin options
  • Pantalla de administrador: cambiar resultados de los partidos.
  • Admin Screen: add a shortcode via the classic editor

Instalación

Para usar tu propia traducción personalizada mira el FAQ para más información acerca de traducir el pugin.

  1. Upload football-pool.zip in the plugin panel (Plugins » Add New » Upload Plugin) or unzip the file and upload the folder football-pool to the /wp-content/plugins/ directory on your server.
  2. Activa el plugin a través del panel Plugins en WordPress.
  3. Edita la configuración del plugin a través del menú del escritorio.
  4. Opcional: añade las páginas de la quiniela a tu menú o usa algún otro método para enlazar a las páginas.
  5. Opcional: añade los widget de «Football pool» a tu barra lateral.
  6. Opcional: añade preguntas de bonificación.
  7. Opcional: «mejora» a los usuarios existentes en tu blog a jugadores de la quiniela.
  8. If you want to use the charts feature please download the Highcharts API and put the highcharts.js file in the following path: /wp-content/plugins/highcharts-js/highcharts.js. Make sure you use the classic js file including the styling. If you use the theme-less version, then you’ll also need to include the highcharts.css code in your theme.

Después de que la quiniela se ha establecido, todo lo que debes hacer es monitorear los usuarios que se suscriben y llenar los resultados correctos para los partidos y las respuestas correctas para las preguntas de bonificación.

Preguntas frecuentes

¿Hay muchas opciones, necesito cambiarlas?

Puedes hacerlo, pero no es necesario. Con los ajustes por defecto el plugin debe estar bien. Puedes jugar con las opciones antes de empezar la quiniela.

El cálculo de la clasificación muestra un tiempo estimado restante de varias horas. ¿Por qué?.

El cálculo de la cantidad total de tiempo restante es basado en el tiempo que tomó completar un solo paso y esto se multiplica por el número total de pasos restantes para el calculo. Si el tamaño de los pasos (puede ser establecido en el wp-config.php) de los primeros cálculos es mucho mas grande que los pasos de los cálculos que siguen, entonces al principio el tiempo total de cálculo puede ser muy alto.

Or maybe you just have a huge database of users, rankings and matches. If that is the case, then the calculation could be right and the total time for the calculation just takes ages to complete. As a reference, I tested with 2000 users, 50 matches, a couple of bonus questions and 3 custom rankings on my laptop and that calculation took approx. 45 minutes to complete with default step sizes. And when doing that same calculation on the command line using WP CLI, it took less than 10 minutes to complete.

¿Tienes un tema que pueda usar con tu plugin?

No, no soy un diseñador, así que no tengo las habilidades para hacer uno.

Instale el plugin, pero no hay partidos, ¿que pasó?

Desde la versión 2.0.0, el plugin no añade los partidos en la primera instalación. Pero sí contiene un ejemplo de programación de partido como un archivo CSV exportado. Ve a la página de administración de partidos y haz una importación de un archivo de programación («Importar partidos») si quieres usar este archivo de ejemplo.

¿Necesito la página de «Predicciones»?

Si y no. El plugin necesita esta página para mostrar las predicciones de los usuarios, así que no la borres. Pero la puedes quitar de tu menú (escritorio de WordPress » Apariencia » Menús).
Algunos temas o configuraciones de WordPress colocan automáticamente las paginas de alto nivel en la navegación. Mira la información del creador del tema sobre cómo hacer un menú personalizado o como excluir páginas del menú.

Quiero usar el plugin para una competencia nacional, ¿es eso posible?

Sí, hay dos formas de hacerlo:
1. Sube una programación de juego en la administración. Asegúrate de entender el formato necesario; puedes encontrar un ejemplo en la carpeta «/data/schedules» del plugin.
2. Usa las pantallas de administración para añadir todos los equipos, grupos, tipos de partidos, partidos, etc.

Y por supuesto, escoge un tema o crea uno tú mismo que se ajuste a tu competición o blog.

¡Las gráficas se fueron!, ¿qué pasó?

Tuve que borrar la biblioteca requerida debido a la política de licencias de plugin de WordPress. Si quieres activar las gráficas, mira la página de ayuda en el escritorio de WordPress para los detalles sobre cómo instalar la biblioteca requerida.

No veo a los usuarios de mi blog como jugadores de la quiniela.

Dirígete a administración WordPress » Football Pool » pantalla de
usuarios y revisa si los usuarios pertenecen a una liga (si estás usando ligas). Los nuevos usuarios registrados se añaden automáticamente, pero los usuarios que ya existen en el blog deben ser actualizados en la pantalla de administración. Para que sean jugadores en la quiniela añadelos a una liga y guarda. Si borras una liga los usuarios de esa liga deben ser colocados en otra liga.
Si no estás usando ligas, entonces asegurate de que los usuarios no sean borrados de la quiniela a través de la pantalla de usuarios.

¿Hay una traducción disponible?

See this page for the available language packs.

If you want to make your own translation, please visit the translate.wordpress.org site and view the possibilities for your language. You can also use an editor like Poedit (http://www.poedit.net/) to create the translations and upload the results to the aforementioned website. Make sure you reach out to a PTE for your language to get your translations approved. Or if there is none, then you can apply for the job yourself. Also see the first steps page for more information on the general translation process within the WordPress universe.

If you have a custom translation, you can put the translation files in the wp-content/uploads/football-pool/languages dir (create it, if it doesn’t exist yet) and use this extension plugin to load it.

The default content for the rules page is in the rules-page-content-*locale*.txt file (e.g. rules-page-content-nl_NL.txt) and is not handled by the polyglot. If you’ve made your own translation and mail it to me, I’ll add it to the plugin and give you the credits.

Instalé el plugin, pero no se ve como en tus capturas de pantalla.

That’s correct. The plugin has some basic styling to position or size elements, but it will not change your entire blog or automagically fit perfect in your website. You will have to adjust the styling yourself to make it look good in your site. Change your theme to overwrite/change the style of the plugin, or use a plugin to add extra custom stylesheets. Please do not change the CSS in the plugin folder; if you ever update the plugin, all your hard work will be gone.

Reseñas

24 de noviembre de 2023 1 respuesta
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 de mayo de 2023
Great plugin with a lof of features for match predictions. The creator is also very helpful for his users.
11 de enero de 2023
So easy to use and implement. Antoine is amazing and supportive. Favorite plugin for Wordpress!
29 de diciembre de 2022
Awesome plugin with super awesome support.Complemento impresionante con soporte súper increíble.
26 de noviembre de 2022
Awesome plugin with super awesome support.
Leer todas las 78 reseñas

Colaboradores y desarrolladores

«Football Pool» es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

«Football Pool» ha sido traducido a 12 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce «Football Pool» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

2.11.6

  • Update: Fixed the venues for the final rounds in the UEFA EURO 2024 championship schedule.

2.11.5

  • Update: Added the UEFA EURO 2024 championship schedule.
  • Bug fix: Shortcode [fp-countdown] now exits gracefully when it is set to countdown to a match, but no first or next match is found. Thanks Frans Jansen for reporting this error.

2.11.4

  • New: [fp-next-match-form] shortcode to show a form of only the next match(es).
  • Tweak: Small change in the test data CLI method.
  • Tweak: Bumped the jQuery version for the TinyMCE dialog to 3.7.1.
  • Bug fix: Removed a XSS vulnerability from some shortcodes (low priority).

2.11.3

  • Updated: Removed admin icon from plugin assets and added SVG base64 URI in menu definition.
  • Tweak: Removed deprecated warning for dynamic property in Football_Pool_Pool class.
  • Tweak: Some refactoring of code.
  • Tweak: Stop loading of plugin when doing cron actions (only needed if I ever decide to add cron actions).
  • Bug fix: In some edge cases the setting «Fix incomplete predictions» could cause points to be awarded when both scores for a match are missing. Thanks fimo66 and Markus Höcker for reporting the bug.

2.11.2

  • Tweak: Some refactoring of code.
  • Updated: Changed the required PHP version to 7.4.
  • Bug fix: League dropdown in the user admin caused a fatal error in certain cases. Thanks Ron Robinson for reporting the issue.

2.11.1

  • Bug fix: fp-matches caused a fatal error for empty parameters. Thanks @wongjowo for reporting the issue.

2.11.0

  • New: Audit log in the admin for the administrator to view all saves that users did in their predictions.
  • New: Added cache group to WP object cache calls to be able to exclude it from persistent caching plugins.
  • New: Option to consider a null value for an incomplete prediction (e.g. only home score entered) as valid and default the missing value to 0.
  • New: Shortcode [fp-last-matches] that displays the last started matches before a certain date. Similar parameters as [fp-next-matches].
  • New: Added parameters to the [fp-user-list] to limit the output with the ‘num’ parameter and to display only the latest registrations (based on and ordered by the WP_User’s user_registered field) with the ‘latest’ parameter.
  • New: Added ‘is_favorite’ parameter to teams. This parameter is used to add an extra CSS class to matches.
  • Updated: AJAX saves on the frontend are now disabled by default and I made it a setting in the options screen (but it can also still be changed via the FOOTBALLPOOL_FRONTEND_AJAX constant in the wp-config).
  • Updated: Changed the required PHP version to 7.3.
  • Updated: Removed deprecated code for loading custom MO files. This should be done via the ‘override_load_textdomain’ filter. See FAQ for more info.
  • Updated: Removed league ID from the sorting of the ranking.
  • Tweak: Added different admin screen option ‘items per page’ settings for bonus questions and user answers.
  • Tweak: Removed the old wp_enqueue_media check for WP versions lower than 3.5 (this is no longer needed).
  • Tweak: Fixed some deprecated warnings (tested in PHP 8.1).
  • Tweak: Toast on the prediction form now has a default z-index of 10.
  • Tweak: Minor changes to the bonus question CSS.
  • Bug fix: The countdown shortcode for the first match removed one element of the matches array and this caused trouble for other elements in the plugin that use the same array reference. Thanks @angelo079 for reporting and @shuhads for helping to sort this out.
  • Bug fix: Removed duplicate calculation buttons when removing multiple match types at once.
  • Bug fix: Fixed the Bonus question pie chart. Thanks @fimo66 for reporting the issue.

2.10.3

  • Updated: Changed the match schedule because some matches had the wrong UTC time (last games of the group phase and in the final rounds).

2.10.2

  • Updated: Changed the match schedule because the first couple of lines had the wrong year.

2.10.1

  • Updated: Changed the match schedule because FIFA changed the Qatar vs. Ecuador match date.
  • New: Added a setting to also show the actual result on the prediction form.
  • New: Added a setting to be able to disable the ‘unsaved changes check’ on the prediction form.
  • New: Shortcode [fp-user-score] now also supports the «use_querystring» parameter.
  • New: Added a setting to disable the automatic selection of the logged on user for the compare function in the charts.

2.10.0

  • New: Multiple joker support (for the entire pool or per match type). I also renamed the Joker to ‘multiplier’.
  • New: Multiplier, bonus question answers and match predictions are now automatically saved via AJAX calls on the front-end (on change). AJAX saves can be disabled via the FOOTBALLPOOL_FRONTEND_AJAX constant in the wp-config if you do not like the new asynchronous method.
  • New: The default delimiter for CSV files (match import) is changed to a comma. If you want to keep using the old delimiter (semicolon), you can override this setting in the wp-config (see help page for details).
  • New: If you want to use an alternative date format in a matches CSV file, you can now define constant FOOTBALLPOOL_CSV_DATE_FORMAT in your wp-config file. The constant uses the date format convention of PHP’s DateTime object and applies to both import and export files.
  • New: CLI command ‘football-pool test-data’ that creates test users in your database with random predictions (for testing purposes).
  • New: Added support for the WP Personal Data Exporter tool. Users can request to export their personal data which now will also include their Football Pool data (league name, match predictions and bonus question answers).
  • New: Added support for the WP Personal Data Eraser tool. When the option is set to true (defaults to false) the plugin will also erase predictions and question answers for a user when using WP’s Personal Data Eraser tool.
  • Tweak: Renamed the [fp-scores] shortcode to [fp-match-scores]. Old name is deprecated and will remain available for a couple of versions before I will remove it.
  • New: [fp-match-scores] shortcode can now also show the row total via the ‘show_total’ parameter.
  • New: [fp-match-scores] shortcode can now also output the user’s prediction per match (instead of or next to the points).
  • New: [fp-question-scores] to show a matrix of users and the scores they got on questions (uses same principles as the [fp-match-scores] shortcode for matches).
  • New: [fp-last-calc-date] to show the date and time of the last ranking calculation.
  • New: Two new admin roles (match editor and question editor).
  • New: Bonus question output now also has a filter that can be used in an extension. Also, the code for user view and prediction page is combined into one output function (to get the same HTML structure for the question blocks).
  • New: Bonus question statistics view now also has a template that can be overwritten with a filter.
  • New: Added ‘joker_used’ indicator to the score history tables.
  • New: Added constant FOOTBALLPOOL_TOP_PLAYERS that you can set in the wp-config if you want to show a different number of players in the default statistics page (default is 5).
  • Tweak: Bumped the jQuery version for the TinyMCE dialog to 3.6.0.
  • Tweak: Some small additions to the help page.
  • Tweak: Updated the icon font that comes with the plugin (also some class names have changed).
  • Tweak: Optimized the ranking query for big data sets when selecting ranking for a small league (sub set of users).
  • Tweak: Changed all colors in the admin to match the new admin WP 5.7 color palette.
  • Tweak: Added floating ‘back to top’ button to all admin pages and a scroll progressbar.
  • Tweak: Minor changes to the match table CSS.
  • Tweak: Clean up of bonus question CSS.
  • Tweak: Added maxWidth and maxHeight to the ColorBox modal that is used for displaying team photos on the front-end.
  • Tweak: Question’s answer-before-date is now also localized on the front-end.
  • Tweak: Score calculation now throws a fatal error when the default ranking is missing in the database.
  • Tweak: Increased the max int sizes for the counter columns in the scorehistory tables.
  • Bug fix: Fixed a compatibility problem with the Max Mega Menu plugin (thanks Holger for reporting this).
  • Bug fix: User profile page showed the wrong active league for the user.
  • Bug fix: Match types could be deleted when there were still matches linked to it. This resulted in orphaned matches in the database. Thanks Andreas Neubrech for reporting this.
  • Bug fix: When a logged in user, but not a player in the pool, visited the stats page, then an empty page was shown, instead of the top X players.
  • Bug fix: When a logged in user, but not a player in the pool, visited the user page, an incorrect page was shown.
  • Bug fix: When score date is automatically filled by the plugin, then the question was not included in the calcution when immediately starting the calculation. Thanks fimo66 for reporting this.
  • Bug fix: Fixed some translations. Thanks digiblogger for reporting this.
  • Clean-up: I removed all old translation files from the package. Contents of the translation files were imported to the WordPress translation website and can be maintained from there. The POT-file is still available as start point for custom translations, or you can download a PO language file from the translation website.
  • Clean-up: I removed the logout widget from the plugin since WordPress comes with its own widget.

2.9.7

  • Updated: Prepared the widgets for the new Widget blocks admin that will be introduced in WP 5.8.
  • Tweak: Changed the moment when the admin menu gets initiated.
  • Bug fix: When a joker is used and activated, the joker icon should be disabled on the form. This did not work when using the date descending sort for matches or when the ‘only open matches’ plugin was activated (thanks Roy te Lindert for reporting).
  • Bug fix: In some cases the v2.9.0 db update script was not executed (thanks @potjekak for reporting).

2.9.6

  • Bug fix: Flex layout for bonus questions was broken on the user page with a combination of certain settings and linked questions (thanks Frans Jansen for reporting).
  • Bug fix: Score date input for bonus questions showed the current date when you saved the form with an empty score date (thanks fimo66 for reporting).
  • Tweak: Changed the group standing rules to make it easier to override the sorting manually, because the rules of the UEFA for the UEFA 2020 championship did not match the general rules in the code (thanks af3 for reporting).

2.9.5

  • Updated: EURO 2020 schedule.

2.9.4

  • Bug fix: Football Pool widgets couldn’t be saved anymore (thanks to dar26ber and Ernst for reporting).

2.9.3

  • Tweak: Database optimization for scorehistory table. Retrieving data from the table is now much faster, which should improve the performance of the ranking page, widget and shortcode.
  • Tweak: Renamed some indices in the database for more consistency.
  • Bug fix: Shoutbox widget not showing an input for new messages for logged in users.
  • Bug fix: Plugin labelled some dates in format «Y-m-d H:i:s» as invalid for the import. Check was updated to also support this format (thanks to Kristin for supplying the data that helped me detect this problem).
  • Bug fix: Setting the matches sort method to an option with match type first in the plugin options caused a database query to fail. Result was an empty prediction form (thanks to Kristin and sopanstha for identifying and helping to solve this problem).
  • Bug fix: Teams class did not declare the comments property.

2.9.2

  • Bug fix: Fixed error in the calculation step ‘compute_ranking’. Larger data sets gave a problem in the AJAX JSON handling.
  • Bug fix: TinyMCE dialog for adding shortcodes showed only one user-defined ranking in the ranking selector.
  • Bug fix: Fixed display of form with shortcode [fp-predictionform] with the use of the match type parameter.
  • Tweak: Refactored some code.

2.9.1

  • Changed PHP version requirement to PHP 5.6 or higher.
  • Tweak: Added «open» or «closed» CSS class to bonus questions to indicate their status.
  • Bug fix: The check for joker saves was not working correctly when using invisible match types or the [fp-predictionform] shortcode with only a subset of matches.
  • Bug fix: League detection bug in Football_Pool_Pool class constructor.

2.9.0

  • New: Added sorting method options for bonus questions.
  • Tweak: Updated styling for bonus questions and we now show the admin answer next to the user answer.
  • Tweak: Updated the standard styling for the prediction table (classic layout only) a bit to make sure all elements are visible. Still needs to be changed to match your theme’s layout.
  • Bug fix: Option «user_page_show_predictions_only» did not work for bonus questions (‘Undefined index: answer’).
  • Bug fix: Option «user_page_show_correct_question_answer» did not work for linked bonus questions.
  • Bug fix: ‘Undefined index: league_id’ warning on the ranking page when switching between leagues enabled and leagues disabled without doing a recalculation.
  • Bug fix: Fixed the «An active PHP session was detected» warning in the Site Health scan (thanks fimo66 for reporting).
  • Bug fix: User predictions table showed a zero in the score column for users that did not have a prediction when option «Always show predictions» is enabled (should be left blank).
  • Bug fix: CLI command ‘import’ failed with an error in test mode when a match id was not found.

earlier versions

  • Full changelog can be found here.