Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

CleverMaps supports creating public projects where users are not forced to log in nor register. It is usable for a marketing presentation. The link to such project can be shared on social media, during a conference or as a result of a hackathon. The aim of this article is to provide a complete tutorial on how to configure such functionality and share the project. 

Tip: With this feature, you can publicly share the project for just limited time period (e.g. a conference) or make available just part of your data (e.g. just one region). This tutorial does not cover those advanced topics. Contacts us if needed. 

Further sections describe how CleverMaps can be embedded in your website.

Prerequisite

0. You have admin access to the project you want to share with the world.

Brief content

  1. Create a service user with the email you have access to with credentials https://secure.clevermaps.io/#/signup.
  2. Invite the service user to the project you want to share as a viewer.
  3. Accept the invitation.
  4. Contact us at support@clevermaps.io with request to enable anonymous access.
  5. Go to the page where you want public audience will land and copy the link.
  6. Concatenate the registered service user credentials in format 
    • https://secure.clevermaps.io/ui/#/yufqzxkbiecj7jot/map/catchment_area_view?username=service.user@company.com&password=P455W0RD
  7. Share this link with the world (smile)

Step by step tutorial

0. You have access to the project you want to share with the world

  • For example your registered account with admin rights is ondrej.velisek@example.com

1. Create a service user with the email you have access to - https://secure.clevermaps.io/#/signup

  • Keep in mind that the service user's credentials are not secret and will be publicly shared.
  • Tip: Create an alias for your email or mailing-list or some email providers (such as gmail) provides an easy way to create distinguishable emails referencing one inbox https://gmail.googleblog.com/2008/03/2-hidden-ways-to-get-more-from-your.html 
  • Example: username eu.election.anonym@example.com and password 'NotRealSecret'

2. Invite the service user as a viewer to the project you want to share

  • Access the project with your admin account ondrej.velisek@example.com
  • In the project menu access User management section and invite email to the eu.election.anonym@example.com as a viewer
  • Be careful to invite the service user with viewer role otherwise, anyone could modify the data and metadata of your project.

3. Accept the invitation

  • Access the inbox of eu.election.anonym@example.com and click the invitation link you received
  • Use registered credentials from step 1. (username eu.election.anonym@example.com and password 'NotRealSecret')

4. Contact us at support@clevermaps.io with a request to enable anonymous access

  • Please include the registered service user email (eu.election.anonym@example.com), project name and the reason why you want to publicly publish the project
  • Wait for our response until we enable the anonymous feature for your service user email
  • Note for CleverMaps support: to enable anonymous access functionality set user attribute isAnonymous to true in Okta
  • Access the project with arbitrary account and go to the place you want the public audience will land and copy the link in the browsers address bar
  • It should look something like: https://secure.clevermaps.io/ui/#/yufqzxkbiecj7jot/map/catchment_area_view

6. Concatenate the registered service user credentials with the link from previous step

  • In format https://secure.clevermaps.io/ui/#/yufqzxkbiecj7jot/map/catchment_area_view?username=eu.election.anonym@example.com&password=NotRealSecret
  • Do not forget to URL encode special characters in the username and password values. https://www.w3schools.com/tags/ref_urlencode.asp

7. Share this link with the world (smile)

Embed the project in your website

Embedding is done via iframe HTML tag. Simply place the iframe tag with the link from the previous section into your website. 

<iframe src="https://secure.clevermaps.io/#/yufqzxkbiecj7jot/map/catchment_area_view?username=eu.election.anonym@example.com&password=NotRealSecret"></iframe>

Do not forget to properly style the iframe tag. e.g. remove default borders, set width and height.

Tip: You can use iframe even without concatenated credentials. The audience will be forced to log in resp. register an account.

Note: Currently, we do not support a dynamic exchange of any parameters


  • No labels