Integrating PuzzleMe
Overview
Objectives
- Understand the various options available for integrating PuzzleMe puzzles into your websites and apps
There are 3 major ways to integrate our puzzles:
- JS Embed - This is the simplest and quickest option to integrate the puzzles into your website. Use this if you can embed JavaScript on your web page.
- WordPress plugin - PuzzleMe provides a WordPress plugin too! Use this if your website is powered by WordPress.
- Custom - This involves embedding an iframe directly on your page. Use this if your CMS does not allow you to embed JavaScript, or if you follow a nonstandard page design.
The following articles cover related points essential to the embedding process:
- Custom parameters - This article explores URL parameters you can use to easily customize your implementation.
- iFrame size - This article covers best practices for sizing the puzzle iframe.
Choosing your implementation
If you are using iframe embed, several important features of PuzzleMe would require custom implementation done by your engineering team. The JS embed implements most of these features out of the box, reducing engineering effort at your end and helping you launch faster.
| Feature | iframe embed | JS embed | Work required for custom integration |
|---|---|---|---|
| Share direct links to puzzles and puzzle scores | ✗ | ✓ | Check full URL of puzzle page on each load, identify id/ set parameters and pass them to puzzle iframe |
| One click, link based social play | ✗ | ✓ | Check full URL of puzzle page on each load, identify id, set and playId parameters and pass them to puzzle iframe |
| Save puzzle progress robustly | ✗ | ✓ | Place a first party cookie on user's browser, anonymize it and pass it to the puzzle iframe |
For most use cases, we could recommend using a JS embed code based implementation.
Other platforms
Besides mainstream content management systems, we also integrate with documentation tools and learning management systems:
- Google Classroom - This article explores our advanced features available only for Google Classroom.
- PowerPoint - This article explores embedding playable puzzles and pickers in your PowerPoint presentations.