Plairsoft Integration

Plairsoft Integration connects an airsoft field's WordPress site with Plairsoft, the platform where fields publish their games and players sign up for them. Once connected, your site shows:

• A game calendar (grid, list or month view) with the field's upcoming games, prices and free spots.
• A page for each game with its date, schedule, rules, itinerary, power limits, roles and free spots, teams, players, photo gallery, attached files, video, location, sign-up and leave deadlines, rules for minors and a sign-up button. Each game gets its own URL (/partida/{name}-{id}/), title, meta description, canonical link, Open Graph and Twitter tags and structured data (SportsEvent); finished or cancelled games are set to noindex, and upcoming games are added to the sitemap. If the site uses an SEO plugin, the game's tags go through it instead of being printed twice.
• Sign-up and payment from your site. Players log in with their Plairsoft account (or create one, also with Google) in a pop-up window, pick team, role and extras, fill in the insurance form if the field requires it, and pay by card or choose cash. With card, payment happens on Stripe before the sign-up is completed. The price shown is the one Plairsoft charges with each payment method (the early-payment offer only applies paying online in advance).
• Waiting list. When a game is full, players can join its waiting list for free. When a spot frees up it goes to the first in line: those who pay at the field get in directly, and those who pay online get the spot held for a while to pay it. The game page shows their position, the held spot with its countdown, and lets them pay, confirm or leave the list.
• Field closures. If the field closes temporarily or for good, the calendar says so, with the reopening date.
• A user menu for the player: the plugin adds a log-in button to the site's navigation menu (themes that use wp_nav_menu()), and once logged in, the player's name with "Mis partidas" (their upcoming games and waiting lists at this field) and log out. The [plairsoft_user_menu] shortcode shows the same menu anywhere else, for example in a block theme's header.
• Your field's look. Out of the box it uses the Plairsoft colours on a light background and your theme's font. In Plairsoft → Apariencia you choose the main, secondary, background and text colours, corner radius, fonts, content width and how the calendar looks (cards, list or month, with an optional side panel about the field); the calendar, game page, booking window and user menu all follow them.
• A leads register (Plairsoft → Leads) for your site's own forms. The plugin does not replace your form plugin: your theme or form code saves each submission by calling Plairsoft_Leads::record() (and can print the consent checkbox with Plairsoft_Leads::plairsoft_consent_field()). The plugin stores them in WordPress with the consent given and its exact text, lists and counts them, exports them as CSV, and supports WordPress' personal data export and erase tools.

The plugin is for fields that already have a Plairsoft account. The field manager creates the API key in Plairsoft Manager, and the Plairsoft team registers the site's login client. See Installation. The plugin is in Spanish and European Portuguese (pt_PT, also used for other Portuguese locales without their own translation): it follows the site language. On sites in any other language it is shown in Spanish. Currency, time zone and the ID document asked for the insurance follow the country of the field (Spain, Portugal, Colombia…), not the language. Shortcodes

• [plairsoft_calendar] — upcoming games of the field.
• [plairsoft_game_detail] — page of a single game, with sign-up.
• [plairsoft_user_menu] — log-in button or player menu, for the header.

When it is activated, the plugin creates a "Calendario de partidas" page with [plairsoft_calendar] and a "Partida" page with [plairsoft_game_detail] (or reuses the ones a previous installation left, since uninstalling keeps them). If they are deleted, the "Crear páginas automáticamente" button in Plairsoft → Configuración creates them again. Caching Pages seen by a logged-in player include their name, so they are sent with no-cache headers, and the session cookie is registered with LiteSpeed Cache and WP Rocket. With other page caches (Cloudflare "Cache Everything", Varnish…), bypass the cache for the plairsoft_uid cookie.

1.7.0

• New look based on the Plairsoft design system: the brand colours by default (light theme), clearer type hierarchy, tabular figures, visible keyboard focus and larger touch targets. Shadows only on floating elements (booking window and menus).
• Everything follows the colours set in Appearance: the calendar, game page, booking window, user menu, "Mis partidas" and the waiting list (before, some parts kept fixed colours). Sites that never changed the default colours get the new brand ones; custom colours are kept.
• Buttons on the main colour pick a readable text colour automatically (dark on light colours, white on dark ones).
• Icons are drawn as SVG instead of emoji, and a status is never shown by colour alone: it always has its text and an icon.
• Capacity bar: the fuller the game, the greener (as in Plairsoft).
• In block themes (such as Twenty Twenty-Five) the calendar and game page use the content width set in Appearance instead of the narrow reading column, and the empty "Partida" page no longer appears in the page list of the navigation.
• The booking window uses the same payment method names as the game page.
• Fixed: the default skin was never applied, and the Plairsoft logo was always dark (invisible on dark themes): it now takes the text colour.

1.6.1

• The game poster (a portrait image, 4:5) is shown whole on the cards, the list and the game page, over a blurred copy of itself, instead of being cropped. Field photos are shown as before.

1.6.0

• Waiting list for full games: join it for free, see your position, pay or confirm the held spot with its countdown, or leave it. Your waiting lists also appear in "Mis partidas".
• A game with people on the waiting list is full for everyone else, as in Plairsoft, even if a spot is free.
• Field closures (temporary or permanent) are shown above the calendar.
• The price is the one Plairsoft charges with each payment method. The early-payment offer only applies paying online in advance, and is shown as such.
• The game page shows the itinerary, photo gallery, attached files, roles with free spots, location, sign-up and leave deadlines, rules for minors and the photo policy. Cancelled and finished games say so.
• If the field hides how many players are signed up, the plugin hides it too.
• A signed-up player can leave a full game, and leaving explains who gets the spot and the refund policy.
• Clearer messages for more errors (sign-ups closed, bans, invalid team…).

1.5.2

• Activating the plugin creates the calendar and game pages, as described (until now only the button in the settings did). If a previous installation left them, they are reused instead of creating duplicates.
• "Mis partidas" (the player's upcoming games) is also in the [plairsoft_user_menu] shortcode.
• Each game page has its own meta description, Open Graph and Twitter tags, structured data (SportsEvent) and sitemap entry on any site. If the site uses an SEO plugin, the game's title, description, address and robots go through it, so nothing is printed twice.
• The description says exactly what the plugin does, including that the leads register is for your own forms.

1.5.1

• The calendar and game pages are created with the address in the site language (/jogo/ in Portuguese, /partida/ in Spanish), whatever the language of the administrator's profile.
• If the game page changes its address, links to the old one redirect to the new one (301).

1.5.0

• European Portuguese translation of the whole plugin: game calendar and page, booking window, user menu, settings, appearance, leads and Site Health.
• The insurance form asks for the ID document of the field's country (DNI/NIE in Spain, Cartão de Cidadão or NIF in Portugal, cédula in Colombia).
• Requests to the Plairsoft API carry the site language, so texts translated by the API match the page.
• The month view starts the week on the day set in Settings → General.
• Power limits and ratings use the decimal separator of the site language.
• Fixed: after paying by card, the confirmation showed the amount in euros even for games in other currencies.
• Fixed: in the list view on mobile, long prices (such as Colombian pesos) overlapped the game name.

1.4.4

• A sold-out extra stays visible in the booking with a «Agotado» (sold out) badge instead of its price and a note that no units are left, so players don't think they have to ask the field for it.

1.4.3

• Game times are shown in the time zone of the field where the game is played, in 24-hour format, instead of the WordPress site time zone. If the visitor is in another time zone, the game page also shows their local time.
• The month view asks the API for the month in the field time zone.
• Prices use the currency of each game, and day and month names follow the site language.
• Fixed: with some WordPress languages (such as Portuguese AO90), the game page could lose its log-in and leave buttons when the visitor was in another time zone.
• Until the Plairsoft API sends each field's time zone, fields in the Canary Islands, the Azores and Madeira get it from their province name.

1.4.2

• Extras with no units left in a game are shown as sold out and can't be chosen; with 10 or fewer left, the booking says how many remain.
• If an extra sells out while the player is booking, Plairsoft rejects the booking without charging; the plugin now says which extra it was, removes it from the selection and goes back to the extras step.

1.4.1

• Sending the site's technical information to Plairsoft is now opt-in (off by default), with a setting in Configuración. Without it, only the plugin version is sent with the regular API requests, and there is no daily request.
• The automatic updates notice can be dismissed.

1.4.0

• The site tells Plairsoft its plugin version and technical setup with each API request and once a day (see External services), so the Plairsoft team can see which sites need an update or are failing.
• A response from Plairsoft with an unexpected format no longer replaces the last good copy: the site keeps showing it and the administrator sees a notice.
• The login check (Site Health and "Comprobar inicio de sesión") reads a status code from Plairsoft instead of the text of the page.
• Clear messages when Plairsoft disables this site's login client or a game belongs to another field.
• The insurance details (ID number, address, birth date) are only requested when the player logs in to sign up for a game of a field that requires insurance.
• The player's name is shown again after logging in (it was read from the wrong fields).
• A notice with a button to turn on automatic updates on the plugin's screens.

1.3.3

• Filter callbacks (page title, SEO title, description and canonical) return escaped values.

1.3.2

• All CSS and JS is now loaded with the WordPress enqueue functions.
• Appearance font settings only accept valid font-family values; inline CSS values are validated when printed.
• Video embeds are filtered with an HTML allowlist.
• The OAuth client secret is stored exactly as entered.

1.3.1

• Clearer payment method names: "Pago online" (card, online), "Efectivo en el campo" (cash at the field) and "Tarjeta en el campo" (card terminal at the field).

1.3.0

• With card, payment now happens on Stripe before the sign-up, and Stripe sends the player back to the same game page.
• A game that no longer exists returns 404.
• Settings, caching, Site Health checks and many security fixes.