Beskrivelse

Yova Game Cards for ludoteca.dev lets any WordPress author paste the URL of a video game page on ludoteca.dev, an international video game database, and automatically display a card with:

Title and release year
Cover art
Short description
Developer, publisher and country of origin (when known)
Direct links to the stores where the game can be bought

Usage via shortcode:

[ludoteca_juego url="https://ludoteca.dev/juego/hades"]
[ludoteca_juego url="https://ludoteca.dev/id/LDT-1234"]
[ludoteca_juego url="https://store.steampowered.com/app/1145360/Hades/"]

[ludoteca_juego id="LDT-1234"] (the ludoteca.dev id, LDT-<number>, shown on every game page: it never changes, so it is the most robust option)
[ludoteca_juego steam="1145360"]

If a game is not in ludoteca.dev yet, using its Steam URL creates its page on the fly (it may take a few minutes to be ready).

or via the “Game Card (ludoteca.dev)” Gutenberg block, by pasting the URL in the block settings panel. Pasting a ludoteca.dev or Steam store game URL on its own line in the block editor converts it into the block automatically.

Data is fetched live from a public ludoteca.dev endpoint and cached locally (12 hours) to avoid unnecessary traffic.

External services

This plugin connects to the ludoteca.dev API (https://ludoteca.dev/api/v1/juego/, https://ludoteca.dev/api/v1/id/ or https://ludoteca.dev/api/v1/steam/) to retrieve the public data of the game whose URL, id or slug the author has entered. Only that slug, numeric id or Steam appid is sent; no personal data about the site or its visitors is transmitted. The request is made from the WordPress server when the card is rendered and its result is cached for 12 hours.

Cover images are loaded by the visitor’s browser from ludoteca.dev (lightweight WebP copies). Only if ludoteca.dev does not respond, the browser falls back to the original image on the store’s CDN (Steam, Nintendo…).

Credits

Store icons: Steam, Epic Games, GOG, itch.io, PlayStation, App Store and Google Play from Simple Icons (https://simpleicons.org, CC0 1.0). Xbox from Font Awesome Free (https://fontawesome.com, CC BY 4.0). The Nintendo icon is a generic handheld console drawn for this plugin. All trademarks belong to their respective owners.

Skærmbilleder

A game card inside a post with a light theme: cover, studio, publisher, country, short description and a button for every store where the game is sold.

The same card with a dark theme: it inherits the theme's text color, so it fits light and dark sites alike. — A game card inside a post with a light theme: cover, studio, publisher, country, short description and a button for every store where the game is sold.

Blokke

Dette plugin giver 1 blok.

Game Card (ludoteca.dev)

Installation

Upload the yova-game-cards folder to /wp-content/plugins/.
Activate the plugin from the WordPress Plugins screen.
Use the shortcode [ludoteca_juego url="..."] or insert the “Game Card (ludoteca.dev)” block in the editor.

FAQ

Does it work with any URL?: With game pages on ludoteca.dev (https://ludoteca.dev/juego/<slug> and permanent links https://ludoteca.dev/id/LDT-<number>) and with Steam store pages (https://store.steampowered.com/app/<appid>/...). Only the slug or the numeric id/appid is sent, always to ludoteca.dev.
Does the plugin connect to any database?: No. It only performs a read-only HTTP request to a public ludoteca.dev endpoint and caches the response.

Anmeldelser

Der er ingen anmeldelser for denne widget.

Bidragsydere & udviklere

“Yova Game Cards for ludoteca.dev” er open source-software. Følgende personer har bidraget til dette plugin.

Yova Turnes

Oversæt “Yova Game Cards for ludoteca.dev” til dit eget sprog.

Interesseret i udvikling?

Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.

Ændringslog

1.5.2

Renamed to “Yova Game Cards for ludoteca.dev”, with the slug yova-game-cards. The [ludoteca_juego] shortcode and the block keep working as before.

1.5.1

New name and slug: ludoteca.dev – Game Cards (ludoteca-dev-game-cards). The [ludoteca_juego] shortcode and the block keep working as before.
Store icons are printed through wp_kses() with an SVG allowlist (WordPress coding standards: escaped output).

1.5.0

ludoteca.dev ids (LDT-): new [ludoteca_juego id=”LDT-1234″] attribute and support for permanent links (https://ludoteca.dev/id/LDT-1234), also when pasted in the block editor.
Uses the versioned ludoteca.dev API (/api/v1/).

1.4.0

Covers are served from ludoteca.dev as lightweight WebP copies (up to 7x smaller), with automatic fallback to the store image. Visitors’ browsers no longer contact the stores’ servers.

1.3.0

itch.io store support (icon).
Games that are also on DeVuego (Spain, Latin America, Portugal) show a link to their DeVuego page.

1.2.0

Store icons on the buttons (inline SVG, no external requests).
The card adapts to light and dark themes: it inherits the theme’s text color instead of forcing a white background.
The service is now always referred to as ludoteca.dev.

1.1.1

Vertical spacing around the card, so it no longer sticks to the following paragraph.

1.1.0

Steam store URLs are accepted too (and the [ludoteca_juego steam=””] attribute). If the game is not in ludoteca.dev yet, its page is created on the fly.

1.0.1

Upcoming games show “(próximamente)” next to the title instead of an empty year.

1.0.0

Initial release: shortcode and Gutenberg block to display a ludoteca.dev game card.