Polla Mundial 2026 documentation.

Table of contents

Installation

Method 1: WordPress Admin (Recommended)

Recommended Setup Updated 1.6

For a typical pool, create these four pages and paste the matching shortcode in each one:

Shortcodes Reference

Four shortcodes power every front-end view. All parameters accept aliases — use whichever feels natural.

[polla_partidos_pendientes]

[polla_partidos_pendientes]
[polla_partidos_pendientes cantidad="5"]
[polla_partidos_pendientes fase="octavos"]
[polla_partidos_pendientes cantidad="10" fase="fase-grupos"]

[polla_partidos_pronosticados]
// alias:
[polla_mis_pronosticos]

[polla_mis_pronosticos]
[polla_partidos_pronosticados cantidad="20"]
[polla_partidos_pronosticados limite="10"]

[polla_ranking]

[polla_ranking]                // every participant, paginated 100/page
[polla_ranking limite="10"]    // Top 10 with podium
[polla_ranking limite="3"]     // podium-only

[polla_perfil_usuario]

[polla_perfil_usuario]                  // current logged-in user
[polla_perfil_usuario usuario_id="5"]   // specific user

Use in PHP templates

<?php echo do_shortcode('[polla_ranking limite="10"]'); ?>

Configuration Page New in 1.6

A dedicated Settings screen at Polla Mundial → Settings (built on the WordPress Settings API).

Profile Page assignment

Pick which page hosts [polla_perfil_usuario] from a dropdown. The plugin uses this value to build the profile URLs that the ranking links to. Behaviour:

• If a page is explicitly assigned → that one wins.
• If not → the plugin auto-detects via cache + slug/title fallbacks (legacy: "perfil", "mi-perfil", "profile").
• You can override entirely from code with the polla_laooz_perfil_page_url filter (see "For Developers").

Closing time before kickoff

Configure how many minutes before kickoff predictions lock automatically.

• Default: 15 minutes
• Range: 0 – 120 minutes
• Recommended: 10 – 30 minutes

Importer with Timezone Conversion New in 1.6

The importer ships with the official 2026 World Cup JSON and a full IANA timezone dropdown. Pick the source timezone of the JSON and the plugin auto-converts kickoff times to your site's timezone.

Multi-language New in 1.6

The plugin is 100% translatable — 231 source strings, professionally translated into 8 languages out of the box (1,848 translations total).

Languages included +4 NEW

How language switching works

The plugin reads WordPress' active language and loads the matching translation file automatically:

1. Go to Settings → General → Site Language
2. Pick a language WordPress supports (e.g. Português do Brasil)
3. Save — done. Plugin strings switch on the next page load.

Adding a new language

Roughly a 15-minute process:

1. Translate the .pot file (/languages/laooz-world-cup-predictor.pot) using Poedit, Loco Translate or Crowdin.
2. Save the result as laooz-world-cup-predictor-{LOCALE}.po (e.g. laooz-world-cup-predictor-fr_FR.po).
3. Generate the binaries:

   wp i18n make-mo /path/to/languages/
   wp i18n make-php /path/to/languages/

   This creates the .mo and the modern .l10n.php files.
4. Drop the files into /wp-content/plugins/laooz-world-cup-predictor/languages/ and select the matching language in Settings → General.

Theme Shield & CSS Namespace New in 1.6

Every plugin module renders inside the .polla-laooz-root namespace and is bulletproofed against theme styles:

• Links: no underline leak from the theme
• Lists: no inherited bullets / numbering
• Tables: clean reset (borders, padding, hover)
• Headings: normalized sizes and weights
• FontAwesome icons: immune to theme overrides

The shield is fully scoped — it never leaks styles to the rest of your site. To customize plugin styles from your theme, just scope your CSS:

/* In your theme's stylesheet */
.polla-laooz-root .polla-ranking-card {
    background: #yourbrand;
    border-radius: 12px;
}

.polla-laooz-root .polla-score-pill button {
    background: #yourbrand-accent;
}

Managing Match Results

After each match finishes, enter the final score so the plugin can calculate points and update the ranking.

Points System

A multi-level scoring system that rewards both accuracy and smart predictions.

Calculation table

For Developers New in 1.6

Public constants

Available everywhere after the plugin loads:

Filters

// In your theme's functions.php or a mu-plugin
add_filter( 'polla_laooz_perfil_page_url', function( $url, $user_id ) {
    // Send everyone to a custom profile area
    return home_url( '/users/' . $user_id . '/' );
}, 10, 2 );

CSS namespace for customization

Every plugin module renders inside .polla-laooz-root. Use it as a scope when overriding styles from your theme:

.polla-laooz-root .polla-ranking-card { ... }
.polla-laooz-root .polla-score-pill   { ... }
.polla-laooz-root .polla-prediction   { ... }

Text domain

Use this text domain to add or override translations:

// Translate a plugin string
__( 'Ranking', 'laooz-world-cup-predictor' );

Frequently Asked Questions

Changelog

Support