It gives your visitors a seamless experience as they do not have to leave the your website. It provides an easy user journey focused on contributions. And it works for map and proposal surveys.
You can see an example of an embedded Commonplace below. For more examples, please visit: https://www.commonplace.is/commonplace-embedded.
Commonplace Embed works like an Iframe but focuses on the contributions flow only, by removing the ability for users to navigate out to other pages of the projects. This allows you to have individual surveys on your own websites.
Accessing the functionality is very easy:
create your map or proposal tile as you normally do on Commonplace
add ?embed=true at the end of the proposal or map URL
For example. The standard URL for a proposal tile might be: https://yourproject.commonplace.is/proposals/user-test/step1
To be able to add it as an Iframe add ?embed=true to the end: https://yourproject.commonplace.is/proposals/user-test/step1?embed=true
and it will activate the functionality. You can use the new URL in an iframe on your own websites. Here is some example code you can use:
<p>
<iframe src="https://yourproject.commonplace.is/proposals/user-test/step1?embed=true" width="100%" height="1000px">
</iframe>
</p>
Adding ?embed=true at the end of the URL removes all ways for visitors to navigate out of the proposals (preventing them to go to the hub page or to other pages on Commonplace). This allows you to have access to the full Commonplace functionalities whilst keeping the experience on your website.
Here is what the ?embed=true actually does:
Removes the top nav bar to prevent users to navigate back to the hub page
Removed the back button on the 1st step of a multiple step proposal
Removed the “View more proposals” component
Still unsure about anything? There's lots more information here on the Commonplace Help Centre - alternatively, contact the support team and we'll be happy to help 👋
