Skip to main content

WordPress

Objectives

Learn how to use the PuzzleMe™ WordPress plugin to embed puzzles in your WordPress site.

Integrating PuzzleMe™ with WordPress is straightforward with our official plugin. This integration allows you to display puzzles on any page or post on your WordPress site.

Do I need to purchase anything? The PuzzleMe WordPress plugin is free, but you need a PuzzleMe account to create and manage puzzles.

Technical requirements:

  • You need to have admin or editor access to a WordPress instance.
  • Your WordPress site should allow installation of plugins.
    • If you host your own WordPress instance, you can easily install plugins.
    • If you use wordpress.com, you need a paid account to install plugins.

Installation​

Step 1: Install the PuzzleMe WordPress Plugin​

Plugin listing in the WordPress admin dashboard
  1. Go to your WordPress admin dashboard.
  2. Navigate to Plugins > Add New.
  3. Search for "PuzzleMe".
  4. Find "PuzzleMe for WordPress" in the search results.
  5. Click Install Now and then Activate.

Step 2: Configure the Plugin​

The PuzzleMe WordPress plugin works without any special configuration for standard users. You can start embedding puzzles right away using shortcodes.

Configuration for Professional/Enterprise Plans​

note

This step is required only if you are on our Professional or Enteprise plan.

By default, the WordPress plugin points to our server for non commercial users - amuselabs.com . Your commercial account is on a separate production server. To ensure the WordPress plugin points to the correct server, you need to add a definition in your WordPress server's wp-config.php file, as the variable PuzzleMe_BasePath.

  • If you are using our Professional plan, the value of this variable is https://app.amuselabs.com/app/.
  • If you are using our Enterprise plan, the value of this variable is https://[YOUR_SUBDOMAIN].amuselabs.com/pmm/ , where [YOUR_SUBDOMAIN].amuselabs.com is where you login to your PuzzleMe account. For example, if you login to https://cdn2.amuselabs.com/pmm/login , then the PuzzleMe_BasePath would take the value https://cdn2.amuselabs.com/pmm/.

Here is the definition you need to add in your wp-config.php file (replace the URL with your specific one if applicable):

define('PuzzleMe_BasePath','https://cdn2.amuselabs.com/pmm/');

Step 3 - Embedding a puzzle/series on your website​

  • Login to your PuzzleMe account and from the dashboard, click on the Preview icon (eye icon) in front of the puzzle that you want to embed. Image

  • This opens the Preview page. Click the Publish button in the top bar.

  • On the Publish page, click on the WordPress tab. The box will display a WordPress shortcode. Each puzzle in your PuzzleMe account has a unique shortcode.

  • On the Publish page, click on the WordPress tab. The box will display a WordPress shortcode. Each puzzle in your PuzzleMe account has a unique shortcode. Image

  • Copy the shortcode and start editing the WordPress page/blog post where you want to embed the puzzle. Depending on your website theme, the interface to insert a shortcode might look slightly different. The screenshots below are taken from the default Gutenberg editor.

  • In the editor, please insert a shortcode block.

Image

  • In the shortcode block, paste the code you copied from your PuzzleMe dashboard. Image

And that's it! Once your WordPress page/post is updated and published, your readers will be able to access this puzzle.