Setup ----- Standaard is Planviewer OAuth ingesteld voor de viewers van een applicatie. Hiermee zijn deze viewers zonder login toegangelijk. Voor afgeschermde viewers zie: :ref:`auth0 instellen` Beginnen ******** Begin met het toevoegen van polka op de pagina waar de viewer moet worden getoond. Plak ```` ergens tussen de ```` en ```` Het script zal trachten de kaart te laden binnen een div container met het id 'map'. .. sourcecode:: html
Om de viewer te tonen dient er nog wel het een en ander geconfigureerd te worden. **base: ** *Deze variabel zal komen te vervallen in de uiteindelijke versie.* **Viewer: ** |dashboard_link| **oauth** Polka + maakt gebruikt van een oauth authenticatie. Oauth kan best wel eens lastig zijn om correct in te stellen. Wij helpen je graag hiermee. Neem |contact_link| met ons op bij vragen over polka en Oauth. De Oauth configuratie kan uit meerdere onderdelen bestaan afhankelijk van de gekozen provider. Voor het onderstaande voorbeeld gebruiken wij de provider auth0.com **provider** *De oauth service provider, bijvoorbeeld Auth0* **domain** *Te vinden bij de provider, dit is het domein waar de authentiecatie word opgehaald* **client_id** *Id gebruikt door de provider voor de applicatie waar toegang voor word verleent.* |example_config| **audience** *auth0 stuurt die identifier mee, bij azure (als provider) is dit een uuid* **redirect_url** *url waar de gebruiker terecht komt na validatie (normaliter de pagina met de kaart)* **polka config en kaart koppelen** *Nu moeten de configuratie, het script en de div container elkaar nog kunnen vinden en dat doe je met deze 2 regels* |example_init| |auth0_authentication_link| Voorbeeld applicatie ******************** Hieronder een basis voorbeeld van Polka: .. literalinclude:: ../../../polka/examples/quickstart.html :language: html .. |dashboard_link| raw:: html Je kunt de viewer ID vinden in het Dashboard (ingelogd) .. |contact_link| raw:: html contact .. |example_config| raw:: html 
        const config = {
            base: "",

            /** identifier van de viewer - te vinden in dashboard */
            viewer: "",

            /** OAuth configuratie - te vinden in het dashboard */
            oauth: {
                provider: "provider",
                domain: "provider_domain",
                client_id: "provider_client_id",
                audience: "provider_audience",
                redirect_uri: "page_to_go_to_after_validation"
            },
        };
.. |example_init| raw:: html 
        /** initialiseer applicatie */
        const polka = planviewer.PolkaPlus(config);

        /** initialiseer Polka met de kaart-container */
        polka.viewer.view.map.target(map);
.. |auth0_authentication_link| raw:: html Lees hier meer over het auth0.com validatie proces