WHA Puzzle
WHA Puzzle
Description
Puzzle is a jigsaw game: a mosaic that has to be assembled from many fragments of various shapes. It is one of the most affordable toys that develop logical thinking, attention, memory and imagination.
The plugin adds a “Puzzle” post type. Each puzzle has its own image, grid size (up to 10×10), canvas colour, ghost-image opacity and a custom congratulations message, and is embedded anywhere with the “Puzzle” block in the block editor or the [game-puzzle id="N"] shortcode.
Features
- HTML5 canvas game with drag-and-drop pieces, snapping and a red hint outline.
- Start / pause, reset, timer and a solved-puzzles counter.
- Full-screen mode.
- Separate images for desktop and mobile.
- Optional front-end upload so visitors can play with their own picture.
- Completion modal with a custom message and Facebook / Twitter / LinkedIn share links.
- “Puzzle” block for the block editor with a puzzle picker and preview; existing shortcodes can be converted to the block.
- Works in sub-directory installs, custom content directories and multisite.
Video: https://www.youtube.com/watch?v=Ojja8RrFU58
Installation
- Upload the
wha-puzzlefolder to/wp-content/plugins/or install it from the Plugins screen. - Activate the plugin.
- Go to Puzzles > Add New, set a featured image and the game settings, and publish.
- In the block editor add the Puzzle block and pick the puzzle, or paste the shortcode shown on the edit screen (
[game-puzzle id="N"]) into any page or post.
Faq
Yes. Add the “Puzzle” block (search for “puzzle” or “jigsaw” in the inserter) and choose the puzzle from the dropdown. Existing [game-puzzle] shortcodes keep working and a Shortcode block containing one can be transformed into the Puzzle block. Puzzles themselves are configured on a classic settings screen under Puzzles.
Yes. Enable “Frontend upload” in the puzzle settings and an upload form appears in the game control panel.
No, one puzzle per page is supported.
Reviews
not working
By Просування сайтів (bogdan2143) on December 9, 2023
not working
Is not mobile friend
By legatti on April 14, 2021
Very nice and stable Plugin
By georgwpfrm on December 20, 2020
Exciting idea with still small weaknesses
By meingarten on November 8, 2020
Images don't Show!!!
By prowebdevelopers on August 13, 2020
Very bad
By ramikanawati on May 26, 2020
Simple and good.
By skullmonkey on May 14, 2020
When bugs worked out this will be a great plugin
By (scrawny) on May 6, 2019
Changelog
1.2.0
- New “Puzzle” block for the block editor: pick a puzzle from a dropdown, see a preview in the editor, convert existing shortcodes to the block. The block renders through the same code as the shortcode.
- Fixed: a puzzle opened from a URL with any query string (e.g.
?page_id=,?utm_source=) got a NaN grid size and no pieces. - Requires WordPress 5.5 or newer.
1.1.0
- Compatibility with PHP 8.x and WordPress 7.1 (no more suppressed notices, undefined-index warnings or removed jQuery APIs).
- Admin assets (jscolor, slider) load only on the Puzzle edit screen and use the jQuery UI slider bundled with WordPress instead of a second copy of jQuery UI.
- Front-end assets load only on pages that contain a puzzle; wp_enqueue_media() is no longer loaded on every page.
- Plugin, uploads and admin-ajax URLs are no longer hard-coded – works in sub-directory installs, custom content dirs and multisite.
- Front-end image upload is protected by a nonce and only accepted for puzzles that allow it; WebP images are accepted.
- Missing featured image shows an admin notice instead of aborting the save.
- Uninstall uses the WordPress API (works with any table prefix and on multisite).
- Text domain unified to “wha-puzzle”.


